David
5ad446be00
- 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.
52 lines
1.7 KiB
Markdown
52 lines
1.7 KiB
Markdown
# `apps/web`
|
|
|
|
Aplicación frontend principal del ERP.
|
|
|
|
## Documentación canónica
|
|
|
|
- Arquitectura, autenticación y selección de empresa: [`../../docs/frontend/frontend-architecture.md`](../../docs/frontend/frontend-architecture.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/frontend-architecture.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/frontend-architecture.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/frontend-architecture.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/frontend-architecture.md`.
|