michangarrito/orchestration/_archive/_definitions/validations/VALIDATION-BACKEND.md
Adrian Flores Cortes 2fb9f3f6b5
Some checks are pending
CI/CD Pipeline / Backend CI (push) Waiting to run
CI/CD Pipeline / Frontend CI (push) Waiting to run
CI/CD Pipeline / WhatsApp Service CI (push) Waiting to run
CI/CD Pipeline / Mobile CI (push) Waiting to run
CI/CD Pipeline / Docker Build (./apps/backend, ./apps/backend/Dockerfile, backend) (push) Blocked by required conditions
CI/CD Pipeline / Docker Build (./apps/frontend, ./apps/frontend/Dockerfile, frontend) (push) Blocked by required conditions
CI/CD Pipeline / Docker Build (./apps/whatsapp-service, ./apps/whatsapp-service/Dockerfile, whatsapp-service) (push) Blocked by required conditions
CI/CD Pipeline / Deploy to Production (push) Blocked by required conditions
[ESTANDAR-ORCHESTRATION] refactor: Consolidate to standard structure
- Move 7 non-standard folders to _archive/
- Archive 3 extra root files
- Update _MAP.md with standardized structure

Standard: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
Level: CONSUMER (L2)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-24 14:38:04 -06:00

1.7 KiB

Validación Backend - NestJS/TypeScript

Definición Canónica

Alias: @DEF_VAL_BE Dominio: Backend NestJS/TypeScript


COMANDOS OBLIGATORIOS

# ANTES de marcar tarea como completada:
npm run build    # DEBE pasar sin errores
npm run lint     # DEBE pasar sin errores
npm run test     # Si existen tests, DEBEN pasar

CRITERIOS DE ACEPTACIÓN

build:
  resultado: "Compila sin errores"
  archivos_generados: "dist/"
  sin_warnings_criticos: true

lint:
  resultado: "0 errores de ESLint"
  warnings_permitidos: "Solo menores"
  reglas_obligatorias:
    - "@typescript-eslint/no-explicit-any"
    - "@typescript-eslint/no-unused-vars"

test:
  resultado: "100% tests pasan"
  coverage_minimo: "70% (si configurado)"
  nuevos_tests: "Crear para código nuevo"

VALIDACIONES ADICIONALES

entities:
  - "Alineadas con DDL (nombres, tipos)"
  - "Relaciones correctamente definidas"
  - "Decoradores TypeORM correctos"

services:
  - "Inyección de dependencias correcta"
  - "Manejo de errores implementado"
  - "Transacciones donde aplique"

controllers:
  - "Decoradores Swagger completos"
  - "Validación de DTOs"
  - "Guards aplicados"

dtos:
  - "class-validator decoradores"
  - "Tipos correctos"
  - "Documentación Swagger"

ERRORES COMUNES

- error: "Cannot find module"
  causa: "Import incorrecto o dependencia faltante"
  solucion: "Verificar rutas y npm install"

- error: "Type X is not assignable to type Y"
  causa: "Tipos incompatibles"
  solucion: "Alinear tipos con DDL/interfaces"

- error: "Circular dependency"
  causa: "Módulos se importan mutuamente"
  solucion: "Extraer a módulo compartido o forwardRef"

Referencia: @PERFIL_BACKEND, @SIMCO_BACKEND