MVP 1 - Dashboard - Tecnico

Backend

Endpoint principal:

• GET /transactions/dashboard

Arquivo:

• /tmp/auraxis-platform-mvp1docs-p5AMyw/repos/auraxis-api/app/controllers/transaction/report_resources.py

Payload de saida:

• mes
• totais de receita, despesa e saldo
• contagens
• categorias de topo

Web

Pagina:

• /tmp/auraxis-platform-mvp1docs-p5AMyw/repos/auraxis-web/app/pages/dashboard.vue

Composables:

• /tmp/auraxis-platform-mvp1docs-p5AMyw/repos/auraxis-web/app/composables/useDashboard.ts

Comportamento atual:

• consome GET /dashboard/overview
• se der erro, usa dashboardPlaceholder
• permite selecao de mes localmente sobre os dados carregados

App

Tela:

• /tmp/auraxis-platform-mvp1docs-p5AMyw/repos/auraxis-app/app/(private)/dashboard.tsx

Hook:

• /tmp/auraxis-platform-mvp1docs-p5AMyw/repos/auraxis-app/hooks/queries/use-dashboard-query.ts

Comportamento atual:

• tambem consome GET /dashboard/overview
• se der erro, usa placeholder
• extrai snapshot mensal em memoria

Gap tecnico principal

Ha incompatibilidade entre o endpoint consumido e o endpoint encontrado no backend:

• frontend espera /dashboard/overview
• backend exposto oferece /transactions/dashboard

Consequencia:

• dashboard visual funciona
• dado real pode nao chegar
• placeholder mascara a falta de integracao

Direcao recomendada

• adotar um contrato canonico GET /dashboard/overview
• manter GET /transactions/dashboard como base de agregacao ou compatibilidade transitória
• suportar filtros de periodo (1m, 3m, 6m, 12m, custom)
• deixar cartao de credito fora deste pacote inicial

Recomendacao tecnica

• decidir um contrato canônico
• alinhar API e frontends para o mesmo endpoint
• manter placeholder apenas como experiencia de desenvolvimento, nao como estado permanente de producao