Gabriel AlmirENErros explícitos
Result e Option tornam falha e ausência parte do contrato.
dossier / implemented
Maybe
Erros e ausência viram estados explícitos, adotados gradualmente nas bordas de sistemas PHP 7.4.
01 / Contexto
Sistemas legados misturam null, false, exceções e validações. Maybe explora uma transição incremental sem exigir reescrita.
- Compatibilidade com PHP 7.4.
- Adoção gradual em código existente.
- Concorrência por processos com fronteiras de segurança claras.
02 / Mapa arquitetural
Mapa arquitetural
- 01null / false / throw
Semânticas concorrentes no legado.
- 02Schema + DTO
Dados ganham forma na borda.
- 03Result + Option
Erro e ausência entram no contrato.
- 04Async isolado
Processos com timeout e serialização explícitos.
03 / Decisões
Decisões
Adoção nas bordas
Schema e DTO entram primeiro onde dados externos atravessam o sistema.
Async como processo
O núcleo continua síncrono; concorrência, timeout e serialização pertencem a uma fronteira própria.
04 / quality
Atributos de qualidade
CompatibilidadeAPI compatível com PHP 7.4.Restrição declarada pelo projeto.
SegurançaValidação antes de cruzar processos.Schema, DTO e contratos explícitos.
EvoluçãoSchema → DTO → Result → Option → Async.Camadas podem ser adotadas incrementalmente.
Evidências
- API públicaTipos e exemplos versionados no repositório.
- Fronteira AsyncSerialização, timeout e isolamento são responsabilidades observáveis.
Limites conhecidos
- Async não substitui filas duráveis nem supervisão operacional.
- A aplicação continua responsável por idempotência, recursos e recuperação.
- Licença e commit-fonte aguardam fixação após auditoria.