Uecko_ERP/docs/README.md

ERP Docs

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

Contexto técnico

Monorepo con:

• Node.js >= 22
• TypeScript
• PNPM
• Turborepo
• ExpressJS
• MariaDB
• Sequelize v6
• Vitest

Arquitectura:

• DDD pragmático
• Clean Architecture
• Separación Domain / Application / Infrastructure
• SOLID, DRY, KISS, YAGNI, SSOT
• Fail Fast
• Defensive Programming
• Cambios incrementales
• Evitar sobreingeniería

Documentación vigente

Arquitectura general

• 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

Document series

• README de document-series
• Diseño de document-series
• Validación manual de document-series

Customer-invoices / proformas

• Contrato de series de proformas
• Contrato de create de proformas
• Tax config persistido en proformas

SQL operativos / runbooks vigentes

• DDL de series documentales en proformas
• DDL de tax_config en proformas
• Validación de migración a document_series
• Validación de tax_config en proformas

Referencias de módulos

• README de modules/auth
• README de modules/identity
• README de modules/companies
• README de apps/web

Histórico / migraciones transicionales

• Migración desde customer_invoice_series a document_series
• Split histórico Proforma / IssuedInvoice
• InvoiceSeries legacy
• Drop manual de customer_invoice_series
• SQL histórico de customer_invoice_series
• Runbooks SQL históricos de customer-invoices
• Seed local de admin

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.
• /document-series es la API canónica de series documentales.
• /catalogs/invoice-series no es un endpoint activo.