---

name: architecture description: Resumo da arquitetura e dos princípios globais do xcution.erp.web.

Visão geral

Use esta skill quando precisar alinhar decisões de implementação com a arquitetura do projeto.

Princípios fundamentais

• Standalone-first: tudo é standalone (standalone: true); features são carregadas via rotas lazy.
• Feature-first: organização por domínio de negócio dentro de src/app/features.
• Tenant-aware: toda feature deve considerar contexto de tenant (ID, features, tema, menu).
• RBAC centralizado: autorização em três camadas (rota, menu e UI).
• PageState unificado: páginas usam PageState<T> para estado assíncrono sem flicker.
• Mock via tokens: APIs são abstraídas com InjectionToken e implementadas via mock ou HTTP por rota.

Estrutura macro

Copysrc/app/
├── core/        # infraestrutura global (auth, tenant, navigation, http)
├── features/    # módulos de negócio (customers, dashboard, auth/login)
└── shared/      # utilidades reutilizáveis (state helpers, UI primitives)

Regras de dependência

• core/ não depende de features/.
• shared/ não depende de features/.
• features/ depende apenas de core/ e shared/.

Referências

• .cursorrules
• docs/Architecture.md
• docs/Engineering Guide (Standards).md