ometra/hela-alize

Portability services and tools for the Auster application.

dev-main 2025-12-15 22:23 UTC

Requires

• php: ^8.1
• equidna/laravel-toolkit: ^1.0.3
• illuminate/support: ^10.0|^11.0|^12.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.92
• larastan/larastan: 3.0
• mockery/mockery: ^1.6
• orchestra/testbench: ^8.0|^9.0|^10.0
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^10.0|^11.0
• squizlabs/php_codesniffer: ^4.0

MIT

• Equidna Development Team

README

Project Overview

Alize is a Laravel package that provides the core building blocks to integrate with Mexico's number portability platform (NUMLEX/ABD). It includes:

• A SOAP HTTP endpoint to receive inbound NPC messages.
• A SOAP client for outbound messages with XSD validation and circuit breaker safeguards.
• SFTP-based daily files reconciliation.
• Orchestrators, jobs, and domain services for end-to-end portability flows.

Primary audience: internal dev teams and external integrators embedding this package into a host Laravel application.

Project Type & Tech Summary

• Type: Laravel package (library)
• PHP: ^8.1 (tested with PHP 8.4 during development)
• Laravel: 10.x | 11.x | 12.x (via illuminate/support)
• Database: Uses the host application's default database connection (migrations included)
• Cache: Uses the host application's cache store (circuit breaker state)
• Queue: Uses the host application's queue driver
• External services:
  • NUMLEX SOAP endpoint (inbound and outbound)
  • NUMLEX SFTP daily files

Quick Start (High-Level)

1. Install: composer require ometra/hela-alize
2. Publish config: php artisan vendor:publish --tag=alize-config
3. Run migrations: php artisan migrate
4. Configure environment: TLS certs, NUMLEX credentials, SOAP endpoint, SFTP settings (see Deployment Instructions)
5. Ensure scheduler and a queue worker are running
6. Verify: php artisan numlex:check-connection and hit the SOAP route to test inbound

Documentation Index

• Deployment Instructions
• API Documentation
• Routes Documentation
• Artisan Commands
• Tests Documentation
• Architecture Diagrams
• Monitoring
• Business Logic & Core Processes
• Open Questions & Assumptions

Standards

This documentation follows the project's Coding Standards and PHPDoc Style Guide.