Praxis Metadata Starter Docs

Documentacao publica do praxis-metadata-starter.

Esta home deve orientar pessoas, LLMs e indexadores para a semantica atual da plataforma, sem misturar onboarding novo com baseline legado.

O que este site publica

• a trilha principal do backend canonico resource-oriented
• o contrato estrutural e documental publicado pelo starter
• a semantica de surfaces, actions e capabilities
• referencia tecnica complementar em Javadoc

Comece por objetivo

Quero adotar o baseline atual

• Guides hub
• Architecture overview
• Conformance

Quero gerar uma aplicacao nova

1. Guia 01 - Backend - Aplicacao Nova
2. Guia 02 - Backend - Recurso Metadata-Driven
3. Guia 04 - Quando usar Resource, Surface, Action e Capability

Quero integrar um runtime Angular

• Guia 03 - Frontend - Angular CRUD Completo
• Checklist de Validacao

Quero referencia tecnica Java

• Javadoc publico
• Indice humano do Javadoc
• Documentacao tecnica

Baseline Atual

O baseline canonico atual do starter e:

• resource
• surface
• action
• capability
• HATEOAS

Isso significa:

• /schemas/filtered segue como contrato estrutural
• /schemas/catalog segue como catalogo documental
• /schemas/surfaces e /schemas/actions publicam discovery semantico
• /{resource}/capabilities agrega as capacidades do recurso sem redefinir o contrato estrutural

Regra De Leitura

Se houver divergencia entre material antigo de CRUD generico e a trilha atual:

• priorize os guias desta home
• priorize architecture-overview
• trate material legado como referencia de migracao, nao como baseline para app nova