Uecko_ERP/docs/README.md
2026-07-06 14:04:47 +02:00

37 lines
1.4 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)
## 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.
- Las rutas tenant-scoped deben usar `Authorization` + `X-Company-Id`.