React + TypeScript + Vite. Por enquanto roda mockado: os dados são de mentira e ficam salvos no navegador, sem precisar de backend.
npm install
npm run dev # http://localhost:5173| Área | O que dá pra fazer |
|---|---|
| Cliente | ver lojas → cardápio → adicionar ao carrinho → fazer pedido → acompanhar pedidos (com PIN) |
| Loja | aceitar/recusar pedidos pendentes, cadastrar produtos e mexer no estoque |
| Entregadores | cadastrar, mudar status (disponível / indisponível / em entrega) e excluir |
src/
├── api/ ← tudo que fala com o backend
│ ├── http.ts fetch de verdade + chave USE_MOCK
│ ├── mock.ts "banco" de mentira (localStorage) + dados iniciais
│ ├── clientes.ts /clientes, /clientes/{id}/enderecos
│ ├── lojas.ts /lojas
│ ├── produtos.ts /produtos
│ ├── carrinho.ts /clientes/{id}/carrinho
│ ├── pedidos.ts /clientes/{id}/pedidos, /pedidos/{id}, /lojas/{id}/pedidos/...
│ └── entregadores.ts /entregadores
├── pages/ ← uma tela por arquivo
│ ├── Home.tsx, Cadastro.tsx
│ ├── cliente/ Lojas, Loja, Carrinho, Pedidos
│ ├── loja/ PedidosPendentes, Produtos
│ └── entregador/ Entregadores
├── components/ Layout (cabeçalho), Foto
├── types.ts tipos iguais aos DTOs do backend
└── util.ts formatação + hooks useCarregar (buscar dados) e useAcao (salvar/excluir com erro)
Cada função em src/api/ corresponde a uma rota que já existe no backend (pedidos-lojas e entregador) e tem as duas versões lado a lado:
// GET /lojas/{id}
export function buscarLoja(id: number): Promise<Loja> {
if (USE_MOCK) return simular((banco) => acharOu404(banco.lojas, id, 'Loja'));
return http('GET', `/lojas/${id}`);
}O que ainda falta está em TODO.md.
npm run test # roda a suíte uma vez
npm run test:watch # modo watch, para desenvolvimento
npm run test:coverage # roda com relatório de cobertura (é o que o CI usa)Stack: Vitest + @testing-library/react + jsdom (é o padrão natural para um projeto Vite + React; configuração em vitest.config.ts, separado do vite.config.ts usado para dev/build).
- Testes de unidade:
src/util.ts(hooksuseCarregar/useAcao),src/api/http.ts(parsing de resposta, erros do Spring/FastAPI, 204, header de Authorization),src/auth/tokenProvider.ts, e dois módulos desrc/api/*.tsrepresentativos do padrão usado em todos eles (lojas.tsecarrinho.ts): tanto a lógica de negócio do modo mock (estoque, soma de quantidade, cálculo de total) quanto a chamada dehttp()com o método/caminho/corpo certos fora do modo mock. - Testes de integração:
src/auth/AuthGate.test.tsxrenderiza oAuthGatede verdade (mockando só o hookuseAuth0) dentro de umMemoryRoutere confere que ele mostra a tela de carregando, a tela de login (com as rotas/entrar/:tipo) ou a aplicação protegida (AppRoutes→Homede verdade), de acordo com o estado de autenticação — e que o getter de token usado porhttp.tsé registrado/limpo corretamente. Como não há backend real neste repositório, essa é a forma de integração equivalente no frontend.
O CI (.github/workflows/ci.yml) roda npm run test:coverage, que falha se a cobertura cair abaixo de 80% de linhas/statements/functions e 75% de branches — mesmo padrão usado no servico-notificacoes (threshold sobre um conjunto explícito de arquivos, não sobre 100% da base).
O gate de cobertura (vitest.config.ts → test.coverage.include) olha só para o que já tem teste de propósito nesta primeira rodada:
src/util.ts,src/api/http.ts,src/api/lojas.ts,src/api/carrinho.ts,src/auth/tokenProvider.ts,src/auth/AuthGate.tsx.
Ficam fora do gate por ora (não incluídos em include, não é "excluído por estar quebrado"):
- os demais módulos de
src/api/*.ts(clientes.ts,entregadores.ts,pedidos.ts,produtos.ts) seguem exatamente o mesmo padrão delojas.ts/carrinho.ts(USE_MOCK ? simular(...) : http(...)) — testá-los é replicar o mesmo molde, próximo passo natural; src/api/mock.tsé o "banco de dados" de mentira usado só em modo demo, não lógica de produto;src/pages/**esrc/components/**são majoritariamente JSX de apresentação — cobri-los bem pede um teste de integração por tela (reaproveitando o padrão doAuthGate.test.tsx), que não coube nesta rodada.
Rodando npm run test:coverage hoje, os arquivos incluídos no gate ficam em ~91% de linhas/statements, ~94% de branches e ~92% de functions — bem acima do threshold, o que dá margem para crescer a suíte sem quebrar o CI.
- Crie um
.envcomVITE_USE_MOCK=false. - Suba o API Gateway em
http://localhost:8080. Em dev, o Vite repassa/api/*para ele (vervite.config.ts). - Pontos que ainda faltam resolver para a integração:
- hoje o gateway só roteia
/clientes/**e/lojas/**; ainda faltam/produtos,/pedidose/entregadores; - o gateway exige JWT. Quando o login existir, o token entra em
src/api/http.ts(tem umTODOlá); - o endereço de entrega/retirada usa uma lat/lng fixa (tem um
TODOemCarrinho.tsxePedidosPendentes.tsx).
- hoje o gateway só roteia