Architecture

Архитектура

Пространство имён

Пакет использует PSR-4 namespace CloudCastle\PhoneFormat\ (каталог src/) с подслоями:

• CloudCastle\PhoneFormat\Contract\ — интерфейсы (публичные контракты);
• CloudCastle\PhoneFormat\Exception\ — исключения пакета;
• CloudCastle\PhoneFormat\… — реализация.

Архитектурные границы между слоями проверяются Deptrac: Core зависит от Contract/Exception/External, Contract не зависит от Core.

Тесты

CloudCastle\PhoneFormat\Tests\ (каталог tests/) разделён на наборы: Unit, Integration, Security, Load, Performance.

Принципы

• Строгая типизация, declare(strict_types=1) в каждом файле.
• Минимум runtime-зависимостей.
• Публичный API документирован PHPDoc.