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.
1.7 KiB
1.7 KiB
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 - Contexto tenant y reglas de
X-Company-Id:../../docs/architecture/tenant-context.md - Tratamiento de errores HTTP en frontend:
../../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-Iddocumentadas endocs/architecture/tenant-context.md.
Headers
- No duplicar aquí la matriz de headers.
- Consultar
docs/frontend/frontend-architecture.mdpara endpoints excluidos ytenant-context.mdpara reglas tenant-scoped.
App company switcher
Componente:
apps/web/src/layout/app-company-switcher.tsx
Propósito:
- mostrar la empresa activa real en el layout autenticado
- permitir cambiar entre
availableCompaniesde la sesión actual
Reglas:
- usar el contexto de
identity - no manejar tokens
- no llamar directamente a
GET /companies/available - no usar
companySlugpara 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.