Core Repository

Repository

Overview

Aplicar o padrão de repositório para escrita e leitura de entidades de domínio com contratos no core e implementação desacoplada em infraestrutura.

Guidelines

• Definir contrato em packages/*/core/src/**/provider/*.repository.ts.
• Reutilizar bases de shared quando aplicável (CrudRepository, CreateRepository, etc.).
• Implementar em adapter de infraestrutura (ex.: apps/backend/src/**/*.prisma.ts) retornando Result.
• Mapear domínio explicitamente:
  • toDomain: payload do banco -> entidade.
  • fromDomain: entidade -> payload de persistência.
• Tratar falhas com Result.fail(...) e não vazar exceção no fluxo normal.
• Manter separação CQRS:
  • Repository para comando/escrita e leitura orientada a entidade.
  • Query para leitura/projeção DTO.

Workflow

1. Confirmar agregados/entidades cobertos pelo repositório.
2. Definir/ajustar contrato no core com métodos mínimos necessários.
3. Implementar adapter de infraestrutura respeitando o contrato.
4. Implementar mapeamento toDomain/fromDomain.
5. Garantir consistência transacional para operações compostas.
6. Criar/ajustar mocks in-memory para testes de use case.

References

Consultar references/repository-pattern.md para contratos, exemplos de implementação e checklist. Consultar ../skills-standards.md para convenção global de nomenclatura.

Global Standards

• Consultar ../skills-standards.md para padroes globais de nomenclatura e convencoes gerais entre skills.