# ERP Monorepo

Monorepo con aplicaciones, servidor y paquetes modulares para el ERP.

## Estado actual

- El runtime nuevo de autenticación y sesión vive en `modules/identity`.
- `modules/companies` es la fuente de verdad de la ficha operativa de empresa.
- `modules/auth` debe considerarse legacy/deprecated para backend nuevo.
- El frontend ERP ya usa `@erp/identity/client` como runtime actual.

## Documentación clave

- [Docs index](./docs/README.md)
- [Identity and companies](./docs/architecture/identity-and-companies.md)
- [Tenant context y `X-Company-Id`](./docs/architecture/tenant-context.md)
- [Identity auth API](./docs/architecture/identity-auth-api.md)
- [Frontend auth and company selection](./docs/frontend/auth-and-company-selection.md)
- [Seed local admin](./docs/dev/seed-local-admin.sql)

## Reglas rápidas

- Backend nuevo: usar `@erp/identity/api`.
- Rutas solo autenticadas: `requireIdentityAuthenticated(params)`.
- Rutas tenant-scoped: `requireIdentityTenant(params)`.
- `GET /companies/available` es el endpoint vigente para companies accesibles.
- No documentar ni introducir `GET /identity/companies`.
- No meter `companyId` ni `companySlug` dentro del access token.