Backend Data (Kotlin / JPA)
Overview
Aplicar o padrão de persistência do backend Kotlin cobrindo modelagem JPA, migrations, e implementação dos adapters com mapeamento consistente para domínio.
Guidelines
- Entidades JPA (
@Entity) ficam na camada de infraestrutura, não no domínio. - Separar entidade JPA da entidade de domínio (mapeamento explícito
toDomain/fromDomain). - Usar Spring Data JPA repositories para operações básicas.
- Migrations via Flyway ou Liquibase (SQL versionado).
- Adapters implementam interfaces de domínio (Repository/Query) e retornam
Result. - Tratar erros com
runCatchingeResult.
Workflow
- Identificar alteração: modelo JPA, migration, seed ou adapter.
- Ajustar entidade JPA e/ou migration SQL.
- Atualizar implementação do adapter (repository/query).
- Revisar mapeamentos
toDomain/fromDomain. - Validar seed e dados iniciais.
- Rodar migrations e testes de integração.
References
Consultar references/data-pattern-kt.md para paths, checklist e armadilhas.
Consultar ../skills-standards.md para convenção global de nomenclatura (seção Kotlin).
Global Standards
- Consultar
../skills-standards.mdpara padrões globais de nomenclatura e convenções gerais entre skills.