david
26e2ee59bd
- Implemented feedback state resolution for proforma list and update pages. - Created error view models for proforma and customer updates, including handling for various error types. - Added tests for error handling in proforma and customer list updates. - Introduced utility functions for building error view models and resolving feedback states. - Ensured translation support for error messages in Spanish. - Removed duplicate error alert components in customer module.
52 lines
1.8 KiB
Markdown
52 lines
1.8 KiB
Markdown
# `apps/web`
|
|
|
|
Aplicación frontend principal del ERP.
|
|
|
|
## Documentación canónica
|
|
|
|
- Flujo de autenticación y selección de empresa: [`../../docs/frontend/auth-and-company-selection.md`](../../docs/frontend/auth-and-company-selection.md)
|
|
- Contexto tenant y reglas de `X-Company-Id`: [`../../docs/architecture/tenant-context.md`](../../docs/architecture/tenant-context.md)
|
|
- Tratamiento de errores HTTP en frontend: [`../../docs/architecture/http-error-handling-frontend.md`](../../docs/architecture/http-error-handling-frontend.md)
|
|
|
|
## Runtime actual de autenticación
|
|
|
|
La app usa `@erp/identity/client` como runtime actual.
|
|
|
|
## Flujo actual
|
|
|
|
- La sesión y la empresa activa se resuelven según el flujo documentado en `docs/frontend/auth-and-company-selection.md`.
|
|
- Las rutas tenant-scoped deben respetar las reglas de `X-Company-Id` documentadas en `docs/architecture/tenant-context.md`.
|
|
|
|
## Headers
|
|
|
|
- No duplicar aquí la matriz de headers.
|
|
- Consultar `docs/frontend/auth-and-company-selection.md` para endpoints excluidos y `tenant-context.md` para reglas tenant-scoped.
|
|
|
|
## App company switcher
|
|
|
|
Componente:
|
|
|
|
```txt
|
|
apps/web/src/layout/app-company-switcher.tsx
|
|
```
|
|
|
|
Propósito:
|
|
|
|
- mostrar la empresa activa real en el layout autenticado
|
|
- permitir cambiar entre `availableCompanies` de la sesión actual
|
|
|
|
Reglas:
|
|
|
|
- usar el contexto de `identity`
|
|
- no manejar tokens
|
|
- no llamar directamente a `GET /companies/available`
|
|
- no usar `companySlug` para auth
|
|
- no modificar el access token
|
|
- respetar el flujo canónico documentado en `docs/frontend/auth-and-company-selection.md`
|
|
|
|
## Refresh automático
|
|
|
|
La app implementa refresh automático global sobre `401`.
|
|
|
|
La semántica completa de retry, exclusiones y limpieza de sesión se documenta en `docs/frontend/auth-and-company-selection.md`.
|