Skip to content
Projeto-de-Software-DeliveryPublic

Repository files navigation

Frontend — Delivery

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

Telas

Á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

Estrutura

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.

Testes

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 (hooks useCarregar/useAcao), src/api/http.ts (parsing de resposta, erros do Spring/FastAPI, 204, header de Authorization), src/auth/tokenProvider.ts, e dois módulos de src/api/*.ts representativos do padrão usado em todos eles (lojas.ts e carrinho.ts): tanto a lógica de negócio do modo mock (estoque, soma de quantidade, cálculo de total) quanto a chamada de http() com o método/caminho/corpo certos fora do modo mock.
  • Testes de integração: src/auth/AuthGate.test.tsx renderiza o AuthGate de verdade (mockando só o hook useAuth0) dentro de um MemoryRouter e confere que ele mostra a tela de carregando, a tela de login (com as rotas /entrar/:tipo) ou a aplicação protegida (AppRoutes → Home de verdade), de acordo com o estado de autenticação — e que o getter de token usado por http.ts é registrado/limpo corretamente. Como não há backend real neste repositório, essa é a forma de integração equivalente no frontend.

Cobertura e o que fica fora do gate

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 de lojas.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/** e src/components/** são majoritariamente JSX de apresentação — cobri-los bem pede um teste de integração por tela (reaproveitando o padrão do AuthGate.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.

Como integrar com o backend

  1. Crie um .env com VITE_USE_MOCK=false.
  2. Suba o API Gateway em http://localhost:8080. Em dev, o Vite repassa /api/* para ele (ver vite.config.ts).
  3. Pontos que ainda faltam resolver para a integração:
    • hoje o gateway só roteia /clientes/** e /lojas/**; ainda faltam /produtos, /pedidos e /entregadores;
    • o gateway exige JWT. Quando o login existir, o token entra em src/api/http.ts (tem um TODO lá);
    • o endereço de entrega/retirada usa uma lat/lng fixa (tem um TODO em Carrinho.tsx e PedidosPendentes.tsx).

Releases

Packages

Used by

Contributors

Languages