Uecko_ERP/docs

ERP Docs

Este directorio reúne la documentación operativa y arquitectónica del ERP.

Estructura actual

docs/
  README.md
  architecture/
  frontend/
  dev/

Documentos clave

• Arquitectura de identity y companies
• Contexto tenant y X-Company-Id
• API de autenticación identity
• Estado de migración a identity
• Flujo frontend de auth y selección de empresa
• Seed local de admin
• SQL manual de customer_invoice_series
• Decisión backend de InvoiceSeries
• README de modules/auth
• README de modules/identity
• README de modules/companies
• README de apps/web

Estado actual resumido

• El backend nuevo usa modules/identity para autenticación, sesión y control de acceso a companies.
• modules/companies es la fuente de verdad de la ficha operativa de empresa.
• El frontend ERP ya usa @erp/identity/client como runtime de autenticación.
• El flujo actual resuelve sesión, companies disponibles, auto-selección de empresa única y refresh automático sobre 401.

Reglas de lectura rápida

• modules/auth debe considerarse legacy/deprecated para backend nuevo.
• GET /companies/available es el endpoint vigente para cargar companies accesibles.
• GET /identity/companies no es un endpoint válido del diseño actual.
• GET /account/companies tampoco es un endpoint válido del diseño actual.
• Las rutas tenant-scoped deben usar Authorization + X-Company-Id.