# 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.