FactuGES_ERP/docs/architecture/identity-migration-status.md
David 5ad446be00 feat: restructure frontend documentation and introduce new architectural guidelines
- Removed outdated documents on screen design and editor layout audit.
- Added comprehensive documentation on frontend architecture, UI patterns, and UI system.
- Established clear guidelines for component usage, routing, and layout structures.
- Enhanced accessibility and responsiveness standards across UI components.
- Defined testing protocols and anti-patterns to maintain code quality and consistency.
2026-09-04 18:52:45 +02:00

94 lines
2.5 KiB
Markdown

# Identity Migration Status
## Referencias canónicas
- Reglas de contexto tenant y middlewares públicos: [tenant-context.md](./tenant-context.md)
- Flujo frontend de autenticación y selección de empresa: [../frontend/frontend-architecture.md](../frontend/frontend-architecture.md)
- Runtime y responsabilidades del módulo `identity`: [../../modules/identity/README.md](../../modules/identity/README.md)
## Migrado a `identity`
### Backend tenant-scoped
Módulos migrados:
- `modules/catalogs`
- `modules/customers`
- `modules/customer-invoices`
- `modules/factuges`
Estado:
- sin `@erp/auth/api`
- sin `mockUser`
- sin helpers locales de auth
- usan el middleware tenant canónico documentado en `tenant-context.md`
### Backend autenticado sin tenant
`modules/companies` usa el middleware autenticado sin tenant documentado en `tenant-context.md`.
Esto aplica a:
```http
POST /companies
GET /companies/available
GET /companies/:company_id
PATCH /companies/:company_id
POST /companies/:company_id/enable
POST /companies/:company_id/disable
```
### Backend tenant-scoped en `modules/companies`
`modules/companies` también expone endpoints tenant-scoped para operar sobre la company activa o endurecer endpoints legacy.
Esto aplica a:
```http
GET /companies/current
PATCH /companies/current
GET /companies/:company_id
PATCH /companies/:company_id
POST /companies/:company_id/enable
POST /companies/:company_id/disable
```
Política V1 actual para `PATCH /companies/current`:
```txt
usuario autenticado
+ X-Company-Id válido
+ membership activa
+ company activa
```
No existe todavía enforcement real de `identity:companies:update`.
## Frontend actual
El runtime nuevo ya usa `@erp/identity/client`.
Los detalles del flujo implementado, headers y refresh automático se mantienen en `frontend/frontend-architecture.md`.
## Legacy pendiente
`modules/auth` queda legacy/deprecated y no debe usarse en backend nuevo.
Sigue pendiente revisar o retirar consumidores legacy residuales antes de eliminarlo por completo.
### `modules/supplier`
Queda fuera de esta migración por ahora.
## Búsquedas útiles de control
```powershell
rg -n -F "@erp/auth/api" modules apps packages
rg -n -F "mockUser" modules apps packages
rg -n -F "IdentityInternalDeps" modules apps packages
rg -n -F 'getInternal(\"identity\")' modules apps packages
rg -n -F "requireIdentityTenant(params)" modules apps packages
rg -n -F "requireIdentityAuthenticated(params)" modules apps packages
```