Skip to content

Viniciustda/OiTenta / .agents/skills/module-repository

module-repository

Verified

Cria contratos de repositório padronizados para agregados dos módulos de negócio, reaproveitando interfaces compartilhadas de persistência e gerando também uma implementação em memória para apoiar testes dos casos de uso.

references/repository-pattern.md

View on GitHub
# Repository Pattern

Padrao observado no projeto:

- O contrato do repositorio fica em `modules/<modulo>/src/<aggregate>/provider/<aggregate>.repository.ts`
- O arquivo `provider/index.ts` reexporta o contrato
- O agregado expoe `model`, `provider` e `usecase` por meio de `src/<aggregate>/index.ts`
- O repositorio de dominio usa import de `@poupig/shared`
- A entidade do agregado vem de `../model`
- O teste usa fake em `modules/<modulo>/test/mock/fake-<aggregate>.repository.ts`
- A fake importa tipos do modulo via `../../src` quando isso simplifica o consumo

Padrao CRUD minimo observado em `auth`:

```ts
import { CrudRepository } from "@poupig/shared";
import { User } from "../model";

export interface UserPageParams {
  page: number;
  perPage: number;
}

export interface UserRepository extends CrudRepository<
  User,
  User,
  User,
  UserPageParams
> {}
```

Padrao da fake observado em `auth`:

- usa `Map<string, Entity>` para storage
- aceita dados iniciais no construtor
- expoe leitura da colecao em memoria
- implementa `findPage` retornando `PageResult<TEntity>`
- falha no `update` quando o registro nao existe

Heuristicas seguras:

- Se a entidade ja representa o payload de criacao e atualizacao, reutilize a propria entidade como generic de `CrudRepository`.
- Se nao for seguro reutilizar a entidade, crie tipos auxiliares locais pequenos e explicitos.
- Se o pedido mencionar somente parte das operacoes CRUD, prefira composicao com contratos granulares em vez de `CrudRepository`.
- Em repositorios customizados, evite declarar manualmente um metodo que ja encaixa em contrato compartilhado.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 197kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall