saveinmed/frontend/docs/arquitetura-atual.md

Arquitetura Atual do Frontend

Este e o documento canonico para o estado atual do frontend.

Diretriz principal

• O frontend ativo nao depende de BFF.
• O frontend ativo usa API direta.
• A base padrao do App Router legado deve ser API_V1_BASE_URL.
• O app Vite usa VITE_API_URL.

URLs e ambiente

App Router e paginas legadas em src/app/...

• Helper padrao: src/lib/apiBase.ts
• Variavel esperada: NEXT_PUBLIC_API_URL
• Base final: https://api-dev.saveinmed.com.br/api/v1 quando a variavel nao existir

App Vite

• Cliente padrao: src/services/apiClient.ts
• Variavel esperada: VITE_API_URL

Autenticacao

• Endpoint de login: POST /auth/login na base apropriada do frontend em uso
• Sessao no frontend: Authorization: Bearer <token>
• Endpoint de sessao atual: GET /auth/me

Papeis validos

• admin
• owner
• employee
• delivery

Papeis legados

Os termos abaixo devem ser tratados apenas como compatibilidade ou historico:

• superadmin
• seller
• colaborador
• entregador
• dono

Leitura de legado

• Referencias a BFF em src/app/..., src/services/... e documentacao antiga nao definem a arquitetura atual.
• Referencias a Appwrite em documentacao antiga sao historicas.
• Antes de reutilizar um arquivo legado, validar se ele pertence ao fluxo realmente ativo.

Fonte de verdade

Ao atualizar documentacao futura, usar este arquivo como referencia primaria.