Esta terceira camada da documentação foi feita para o próximo desenvolvedor entender a arquitetura do módulo antes de abrir o código. O foco aqui é visão de sistema: telas, endpoints, banco, arquivos de imagem, cron e integrações externas que sustentam próteses, análise, simulador e manutenção.
Abra esta camada quando a dúvida não for “o que esta linha faz?”, mas sim “onde isso se encaixa na arquitetura?”. Ela serve para localizar rapidamente o ponto correto de manutenção antes de mergulhar no fluxo por fluxo ou no arquivo completo.
Em termos arquiteturais, o módulo funciona em quatro camadas. A interface do painel aciona endpoints PHP internos; esses endpoints leem e gravam tabelas próprias do módulo; e alguns deles ainda conversam com serviços externos e diretórios de imagens.
| Situação do dev | Camada mais útil | Por quê |
|---|---|---|
| “Nem sei por onde começar nesse módulo.” | Arquitetura | Entrega visão geral antes de abrir arquivos ou endpoints específicos. |
| “Se eu clicar em gerar simulação, quais arquivos entram?” | Fluxo por fluxo | Explica a cadeia real de chamada e a ordem de execução. |
| “Preciso alterar exatamente este arquivo.” | Arquivo completo linha por linha | Permite manutenção precisa, com contexto de cada bloco de código. |