Pular para conteúdo

Frontend Architecture — fonte canônica

Landing page de descobrabilidade para #392.

Esta página existe apenas para apontar para o documento canônico que vive no repositório de orquestração — ele é a fonte de verdade única para padrões, stack, convenções e gates de qualidade dos frontends Auraxis (auraxis-web Nuxt 4 + auraxis-app React Native).

📍 Fonte canônica

.context/26_frontend_architecture.md

(arquivo na raiz do repo auraxis-platform, 769 linhas em 2026-05-19)

Cobre:

  • Princípios imutáveis (SOLID, separação de domínio, no business logic in views, etc.)
  • Stack canônica (Vue 3, Nuxt 4, TypeScript strict, Pinia, Vitest, Playwright, Tailwind v4, NativeWind v5 mobile)
  • Convenções de componentes (composables, props tipadas, slot patterns)
  • Padrão de testes (unit + e2e, coverage gate ≥ 85%)
  • Comandos canônicos (pnpm quality-check etc)
  • Override de design vigente (apontando para MVP-1-Web-Design-System-v3-Market-Pulse.md)
  • Histórico de decisões e ADRs frontend referenciados

Documentos relacionados (não canônicos)

Doc Função
Web-CI-Pipeline.md Pipeline CI/CD específico do auraxis-web
MVP-1-Web-Design-System-v3-Market-Pulse.md Design tokens + sistema visual vigente (override do paleta legada)
MVP-1-Web-Foundation-Layer.md Foundation da web app — composables, stores, http-client
MVP-1-App-Foundation-Layer.md Foundation do mobile
MVP-1-Web-Rebrand-Total-2026-04.md Histórico do rebrand 2026-04
Convention-Branches-Issues-Commits.md Branching, issues, commits — multi-repo
.context/61_design_source_of_truth.md Fonte canônica de design (paleta, tipografia, spacing)

Esses documentos especializam ou complementam o canônico. Em caso de conflito, o canônico prevalece.

Para devs / agentes

  • Antes de qualquer trabalho FE: ler o canônico (26_frontend_architecture.md).
  • Antes de qualquer trabalho visual: ler o design source-of-truth + design system v3.
  • Antes de bater PR: rodar pnpm quality-check no auraxis-web ou npm run quality-check no auraxis-app.

Histórico

Data Mudança
2026-04-17 Última revisão major do canônico (princípios + stack + testes)
2026-04-29 Override de design (paleta legada → MPv3)
2026-05-19 Esta landing page criada (#392 closeout)