Config Auth Backend Basic

Config Auth Backend Basic

Overview

Executar setup idempotente do módulo de autenticação backend no padrão Genérico, cobrindo:

• módulo NestJS simplificado em apps/backend/src/modules/auth com arquivos centrais:
  • auth.controller.ts
  • auth.module.ts
  • jwt-auth.guard.ts
  • jwt.strategy.ts
  • require-admin.decorator.ts
  • require-admin.guard.ts
  • user.prisma.ts
  • password.prisma.ts
  • providers/bcrypt.provider.ts
• endpoints de autenticação e usuário com JwtAuthGuard e proteção administrativa por RequireAdminGuard
• integração com @namespace/auth (use cases, entidades e providers)
• implementação Prisma (repositories/queries + model .prisma com flag admin)
• compatibilidade com infraestrutura de banco atual (DbModule + PrismaService implementando runInTransaction)
• migrations de auth (criação inicial + evolução do campo admin)
• seed com usuários padrão em JSON (incluindo id UUID, admin e metadados de auditoria)

A skill aplica arquivos canônicos a partir de template versionado, convergindo arquivos existentes (app.module.ts, apps/backend/package.json e prisma/seed/main.ts) e removendo artefatos legados da implementação antiga. Antes de aplicar, o script valida pré-requisitos do banco (arquivos de db e contrato de transação) para evitar geração incompatível.

Workflow

1. Garantir infraestrutura Prisma/base pronta (ex.: skill config-prisma já aplicada).
2. Rodar simulação:
   • node .agents/skills/config-auth-backend-basic/scripts/init-config-auth-backend-basic.mjs --dry-run
3. Aplicar mudanças:
   • node .agents/skills/config-auth-backend-basic/scripts/init-config-auth-backend-basic.mjs --apply
4. Opcionalmente instalar dependências e validar build:
   • node .agents/skills/config-auth-backend-basic/scripts/init-config-auth-backend-basic.mjs --apply --install --run-build
5. Rodar migration/seed no backend:
   • npm --workspace apps/backend run prisma:migrate:dev -- --name auth-basic-init
   • npm --workspace apps/backend run prisma:seed

Commands

Aplicar módulo auth backend básico:

node .agents/skills/config-auth-backend-basic/scripts/init-config-auth-backend-basic.mjs --apply

Aplicar e instalar dependências:

node .agents/skills/config-auth-backend-basic/scripts/init-config-auth-backend-basic.mjs --apply --install

Aplicar, instalar e validar build:

node .agents/skills/config-auth-backend-basic/scripts/init-config-auth-backend-basic.mjs --apply --install --run-build

Forçar namespace fallback quando não for possível detectar pacote auth automaticamente:

node .agents/skills/config-auth-backend-basic/scripts/init-config-auth-backend-basic.mjs --apply --scope @namespace

Resources

• scripts/init-config-auth-backend-basic.mjs: orquestrador idempotente da skill com validações de pré-requisito de DB/Prisma e placeholders.
• assets/config-auth-backend-basic-template: template canônico dos arquivos gerados.
• references/config-auth-backend-basic-contract.md: contrato de saída esperado.
• Log local: .log/skills.log.

Output Contract

A skill deve convergir o backend para o contrato descrito em references/config-auth-backend-basic-contract.md, mantendo compatibilidade com o core @namespace/auth e com execução repetível sem duplicação estrutural.

Risk Logging Guardrails

• Registrar fatos de execucao em .log/skills.log com marcador no inicio da linha.
• Marcadores minimos esperados: [CMD], [FILE_CREATE], [FILE_UPDATE], [FILE_DELETE], [DIR_CREATE], [RISK], [FAIL], [AI].
• Sempre registrar [RISK] quando houver sobrescrita, exclusao, rename/move, ou fallback forcado em arquivos/pastas.
• Toda falha inesperada deve gerar [FAIL] com descricao factual curta do evento.
• Operacoes de terminal e alteracoes de arquivos devem passar pelos utilitarios compartilhados em ../utils para manter rastreabilidade consistente.

Global Standards

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