Technical Docs

Esta area concentra material tecnico de engenharia do praxis-metadata-starter. Ela mistura referencias atuais, registros historicos de fechamento e planos arquivados. Nao deve ser lida como onboarding principal.

Para onboarding e narrativa publica atual, use primeiro:

Como ler esta area

Referencias tecnicas atuais

Estes documentos ainda descrevem comportamento vivo do starter, mas podem citar compatibilidade com o core legado quando isso fizer parte da implementacao atual.

Legado e migracao do core antigo

Estes documentos continuam uteis para quem ainda toca o core legado, mas nao descrevem o baseline recomendado para recursos novos.

Fechamentos historicos do baseline atual

Registros do que foi implementado e endurecido nas fases que consolidaram o baseline resource + surfaces + actions + capabilities.

Planos e backlog arquivados ou em evolucao

Documentos de planejamento tecnico. Sao uteis para contexto e continuidade de engenharia, mas nao substituem a fonte canonica do contrato publico atual.

Regras de leitura

O baseline canonico do starter e resource + surfaces + actions + capabilities + HATEOAS.
AbstractCrudController, BaseCrudService e afins sao superficie legada.
Planos e fechamentos historicos ajudam a entender como o baseline atual surgiu, mas nao devem rebaixar a fonte canonica atual para a semantica antiga.
Quando houver duvida de contrato publico, a prioridade e:
1. README.md
2. docs/architecture-overview.md
3. docs/guides/**
4. docs/spec/**
5. esta area tecnica