44 lines
1.8 KiB
Markdown
44 lines
1.8 KiB
Markdown
# ERP Docs
|
|
|
|
Este directorio reúne la documentación operativa y arquitectónica del ERP.
|
|
|
|
## Estructura actual
|
|
|
|
```txt
|
|
docs/
|
|
README.md
|
|
architecture/
|
|
frontend/
|
|
dev/
|
|
```
|
|
|
|
## Documentos clave
|
|
|
|
- [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)
|
|
- [Seed local de admin](./dev/seed-local-admin.sql)
|
|
- [SQL manual de `customer_invoice_series`](./dev/customer-invoice-series.sql)
|
|
- [Decisión backend de `InvoiceSeries`](./customer-invoices/invoice-series.md)
|
|
- [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)
|
|
|
|
## 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`.
|