michangarrito/orchestration/_archive/_definitions/validations/VALIDATION-FRONTEND.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.8 KiB

Validación Frontend - React/TypeScript

Definición Canónica

Alias: @DEF_VAL_FE Dominio: Frontend React/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 typecheck  # DEBE pasar sin errores (tsc --noEmit)

CRITERIOS DE ACEPTACIÓN

build:
  resultado: "Build de producción exitoso"
  sin_warnings_criticos: true
  bundle_size: "Monitorear incrementos grandes"

lint:
  resultado: "0 errores de ESLint"
  reglas_react:
    - "react-hooks/rules-of-hooks"
    - "react-hooks/exhaustive-deps"

typecheck:
  resultado: "0 errores de TypeScript"
  strict_mode: true
  no_any_implicito: true

VALIDACIONES ADICIONALES

componentes:
  - "Props tipadas correctamente"
  - "Keys únicas en listas"
  - "Manejo de loading/error states"
  - "Accesibilidad básica (aria labels)"

hooks:
  - "Dependencias completas en useEffect"
  - "Cleanup en useEffect si necesario"
  - "useMemo/useCallback donde aplique"

estado:
  - "Estado mínimo necesario"
  - "Derivar datos cuando posible"
  - "Zustand/Context correctamente usado"

api:
  - "Manejo de errores de red"
  - "Estados de carga"
  - "Cancelación de requests"

ERRORES COMUNES

- error: "React Hook useEffect has missing dependency"
  causa: "Dependencia no incluida en array"
  solucion: "Agregar dependencia o usar useCallback"

- error: "Cannot read property of undefined"
  causa: "Datos async no disponibles"
  solucion: "Optional chaining o loading state"

- error: "Each child should have unique key"
  causa: "Key faltante o duplicada en map()"
  solucion: "Usar ID único como key"

Referencia: @PERFIL_FRONTEND, @SIMCO_FRONTEND