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