PILOTAGEM

Como o sistema funciona por dentro

A arquitetura, o banco de dados e as duas regras que mais importam para a academia: nenhum simulador reservado para dois clientes ao mesmo tempo, e dinheiro vendido nunca confundido com dinheiro recebido.

18coleções no MongoDB
59testes automatizados
4perfis de acesso

Stack MERN

Arquitetura

A interface em React conversa com uma API em Node.js e Express. Toda requisição passa por três verificações antes de chegar às regras de negócio.

Navegador React · Vite · Tailwind CSS HTTP/JSON com token JWT API · Node.js + Express Autenticação confere o token JWT 401 recusa Permissão (RBAC) este perfil pode usar a rota? 403 recusa Validação (Zod) os dados estão no formato? 400 recusa Controlador traduz a requisição HTTP Serviço regras, bloqueios e auditoria Modelo (Mongoose) acesso às coleções lê e grava MongoDB 18 coleções · instalação local
As regras de negócio ficam todas na camada de serviço, em destaque. As permissões são conferidas no servidor em toda rota; a interface só usa a lista de permissões para esconder o que o perfil não pode usar. Na apresentação, o comando npm run demo faz a própria API servir a interface, num único endereço.

MongoDB · orientado a documentos

Banco de dados

Um atendimento atravessa dois caminhos a partir do cliente: o da operação, que ocupa sala e simulador, e o do financeiro, que registra quanto foi vendido e quanto entrou.

Cliente nome, sobrenome, telefone agenda compra Agendamento instrutor e horário Venda preço congelado N:N gera uma Reserva ocupação no horário 1 ou mais Pagamento ex.: crédito em 2x ocupa Sala e simulador status físico próprio 1 ou mais Parcela unidade de recebimento
A venda guarda uma cópia do preço de cada item no momento da compra, então mudar o catálogo não altera o histórico. Os itens da venda e os itens de um pacote ficam embutidos no próprio documento. A parcela, em destaque, é o único registro que conta como dinheiro em caixa.

Cadastros

  • Clientclientes, com opção confidencial
  • Instructorinstrutores
  • Userusuários e perfis de acesso

Catálogo

  • Serviceserviços, com preço por quantidade
  • Packagepacotes, com itens embutidos

Operação

  • Appointmentagendamentos
  • Reservationreservas de sala e equipamento
  • Roomsalas
  • Resourcesimuladores e equipamentos

Financeiro

  • Salevendas
  • Paymentpagamentos
  • Installmentparcelas
  • Expensedespesas
  • FinancialCategorycategorias financeiras

Controle

  • AuditLogregistro de ações sensíveis
  • Lockbloqueios de reserva
  • Countercódigos sequenciais
  • Settingsconfigurações gerais

Controle de concorrência

Dois pedidos, um simulador

O MongoDB instalado localmente não tem transações entre documentos. Para duas recepcionistas não reservarem o mesmo simulador no mesmo segundo, o sistema usa um bloqueio próprio.

Recepção 1 Bloqueio Recepção 2 pede Simulador 2 14h00 às 15h00 pede Simulador 2 14h00 às 15h00 cria o bloqueio consegue cria o bloqueio chave já existe R1 confere conflitos horário livre grava agendamento e reserva libera o bloqueio fim da operação tenta de novo a cada ~50 ms, por até 6 s livre cria o bloqueio agora consegue R2 confere conflitos horário ocupado recusa a reserva aviso de conflito
O bloqueio é um documento cujo identificador combina o tipo e o código do recurso, por exemplo resource:<id do simulador>. Como esse identificador é único no banco, só um pedido consegue criá-lo por vez. Cada bloqueio vale 15 segundos, então uma queda do servidor não prende o simulador. Um teste automatizado dispara dois pedidos idênticos ao mesmo tempo e confere que só um é aceito.

Regime de caixa

Vendido não é recebido

Exemplo de uma venda de R$ 2.000,00: metade no Pix na hora, metade no cartão de crédito em 2x. O cartão só conta como recebido quando o repasse é confirmado.

R$ 2.000,00 valor contratado · guardado como 200000 centavos
recebido: conta como caixaprogramado: ainda não entrou
Recebido
R$ 1.000,00 parcelas recebidas
Programado
R$ 1.000,00 parcelas pendentes
Saldo pendente
R$ 1.000,00 contratado − recebido
Situação
Parcial

Ninguém digita esses totais: o sistema recalcula tudo a partir das parcelas a cada operação. Estornos e cancelamentos não apagam nada; ficam no histórico com motivo, autor e data.

node:test + supertest

59 testes automatizados

Rodam contra um banco de testes separado, que é apagado ao final.

Mais do projeto