saveinmed/frontend/docs/arquitetura-atual.md
2026-03-07 07:04:27 -06:00

56 lines
1.4 KiB
Markdown

# 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.