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.
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.
Cadastros
Clientclientes, com opção confidencialInstructorinstrutoresUserusuários e perfis de acesso
Catálogo
Serviceserviços, com preço por quantidadePackagepacotes, com itens embutidos
Operação
AppointmentagendamentosReservationreservas de sala e equipamentoRoomsalasResourcesimuladores e equipamentos
Financeiro
SalevendasPaymentpagamentosInstallmentparcelasExpensedespesasFinancialCategorycategorias financeiras
Controle
AuditLogregistro de ações sensíveisLockbloqueios de reservaCountercódigos sequenciaisSettingsconfiguraçõ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.
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.
200000 centavos
- 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.
- Permissões de cada perfil em cada rota20
permissions.test.js - Cálculos em centavos, parcelas, descontos e fuso horário11
finance.calc.test.js - Conflitos de sala, simulador e instrutor, inclusive pedidos simultâneos9
availability.test.js - Vendas, pagamentos parciais, estornos e preço histórico7
finance.test.js - Roteiro completo da apresentação, da venda ao relatório7
demo-flow.test.js - Clientes confidenciais e revelação auditada5
privacy.test.js