67 lines
3.4 KiB
Markdown
67 lines
3.4 KiB
Markdown
# ERP Docs
|
|
|
|
Este directorio reúne la documentación operativa y arquitectónica del ERP.
|
|
|
|
## Documentación vigente
|
|
|
|
### Arquitectura general
|
|
|
|
- [Arquitectura de identity y companies](./architecture/identity-and-companies.md)
|
|
- [Contexto tenant y `X-Company-Id`](./architecture/tenant-context.md)
|
|
- [API de autenticación identity](./architecture/identity-auth-api.md)
|
|
- [Estado de migración a identity](./architecture/identity-migration-status.md)
|
|
- [Flujo frontend de auth y selección de empresa](./frontend/auth-and-company-selection.md)
|
|
|
|
### Document series
|
|
|
|
- [README de `document-series`](./document-series/README.md)
|
|
- [Diseño de `document-series`](./document-series/document-series-design.md)
|
|
- [Validación manual de `document-series`](./document-series/manual-validation.md)
|
|
|
|
### Customer-invoices / proformas
|
|
|
|
- [Contrato de series de proformas](./customer-invoices/proforma-series-contract.md)
|
|
- [Contrato de create de proformas](./customer-invoices/proforma-create-contract.md)
|
|
- [Tax config persistido en proformas](./customer-invoices/proforma-tax-config.md)
|
|
|
|
### SQL operativos / runbooks vigentes
|
|
|
|
- [DDL de series documentales en proformas](./customer-invoices/sql/add-proforma-document-series-columns.sql)
|
|
- [DDL de `tax_config` en proformas](./customer-invoices/sql/add-proforma-tax-config-columns.sql)
|
|
- [Validación de migración a `document_series`](./document-series/sql/validate-document-series-migration.sql)
|
|
- [Validación de `tax_config` en proformas](./customer-invoices/sql/validate-proforma-tax-config.sql)
|
|
|
|
### Referencias de módulos
|
|
|
|
- [README de `modules/auth`](../modules/auth/README.md)
|
|
- [README de `modules/identity`](../modules/identity/README.md)
|
|
- [README de `modules/companies`](../modules/companies/README.md)
|
|
- [README de `apps/web`](../apps/web/README.md)
|
|
|
|
## Histórico / migraciones transicionales
|
|
|
|
- [Migración desde `customer_invoice_series` a `document_series`](./document-series/migration-from-customer-invoice-series.md)
|
|
- [Split histórico Proforma / IssuedInvoice](./customer-invoices/split-proformas-issued-invoices-migration.md)
|
|
- [InvoiceSeries legacy](./customer-invoices/invoice-series.md)
|
|
- [Drop manual de `customer_invoice_series`](./document-series/sql/drop-customer-invoice-series-legacy.sql)
|
|
- [SQL histórico de `customer_invoice_series`](./dev/customer-invoice-series.sql)
|
|
- [Runbooks SQL históricos de `customer-invoices`](./customer-invoices/sql/README.md)
|
|
- [Seed local de admin](./dev/seed-local-admin.sql)
|
|
|
|
## 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.
|