FactuGES_ERP/apps/web/README.md
david e5e73a5a13 Refactor documentation for ERP architecture and customer invoices
- Updated general requirements document to clarify its historical context and remove outdated technical details.
- Revised template documentation to serve as a base for writing prompts, emphasizing its auxiliary nature.
- Enhanced architecture documentation with clear distinctions between canonical and complementary documents.
- Added a new document for backend prompt base to centralize common context for backend prompts.
- Created a dedicated README for customer invoices, organizing current contracts, operational support, and historical context.
- Improved clarity and structure in various customer invoice documents, consolidating operational semantics and referencing canonical sources.
2026-08-05 13:18:03 +02:00

1.6 KiB

apps/web

Aplicación frontend principal del ERP.

Documentación canónica

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:

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.