How staroscky/controle-cancha works
Controle de Bocha é um aplicativo client-side para acompanhar clientes, partidas, consumo e acerto de contas, com persistência local e uso offline via PWA conforme o README. O fluxo principal vai do operador às telas de gestão, que registram eventos e consultam saldos e históricos. Os hooks amostrados coordenam regras e repositórios; o código não amostrado é representado apenas pelos módulos e capacidades identificáveis na árvore, sem presumir chamadas específicas entre eles.
Main entry points: App.tsx Navegação · useComandas.ts Comandas · usePartidaAtiva.ts Partida ativa · useClientes.ts Gestão clientes
Components 23
Interface
- Navegação
app/src/App.tsx - Clientes
app/src/ui/pages/ClientesPage.tsx - Partidas
app/src/ui/pages/PartidaPage.tsx - Catálogo
app/src/ui/pages/ConsumoPage.tsx - Comandas
app/src/ui/pages/ComandasPage.tsx - Estatísticas
app/src/ui/pages/EstatisticasPage.tsx - Dados e backup
app/src/ui/pages/BackupPage.tsx
Operações
- Gestão clientes
app/src/ui/hooks/useClientes.ts - Partida ativa
app/src/ui/hooks/usePartidaAtiva.ts - Comandas
app/src/ui/hooks/useComandas.ts - Estatísticas
app/src/ui/hooks/useEstatisticas.ts - Consumo
app/src/ui/hooks/useConsumo.ts
Regras e dados
- Saldo e clientes
app/src/domain/rules/calcularSaldo.ts - Regras de partida
app/src/domain/rules/prepararLancamentosFechamentoPartida.ts - Regras de consumo
app/src/domain/rules/prepararLancamentosConsumo.ts - Clientes e grupos
app/src/data/clientesRepo.ts - Partidas e participantes
app/src/data/partidasRepo.ts - Lançamentos
app/src/data/lancamentosRepo.ts - Catálogo de consumo
app/src/data/itensConsumoRepo.ts - Backup
app/src/data/backupRepo.ts
Persistência
- Armazenamento local
app/src/data/storage.ts
Other components
- Operador
- LocalStorage
Connections 29
- Operador → Navegação: usa
- Navegação → Clientes: abre
- Navegação → Partidas: abre
- Navegação → Catálogo: abre
- Navegação → Comandas: abre
- Navegação → Estatísticas: abre
- Navegação → Dados e backup: abre
- Clientes → Gestão clientes: consulta
- Partidas → Partida ativa: consulta
- Comandas → Comandas: consulta
- Estatísticas → Estatísticas: consulta
- Catálogo → Consumo: consulta
- Gestão clientes → Clientes e grupos: lê e altera
- Gestão clientes → Lançamentos: consulta e remove
- Gestão clientes → Saldo e clientes: calcula saldo
- Partida ativa → Partidas e participantes: gerencia partida
- Partida ativa → Clientes e grupos: consulta clientes
- Partida ativa → Lançamentos: registra eventos
- Partida ativa → Regras de partida: prepara fechamento
- Partida ativa → Regras de consumo: prepara consumo
- Comandas → Clientes e grupos: consulta clientes
- Comandas → Partidas e participantes: consulta participação
- Comandas → Catálogo de consumo: consulta catálogo
- Comandas → Lançamentos: registra lançamentos
- Comandas → Regras de consumo: prepara consumo
- Comandas → Saldo e clientes: calcula saldo
- Dados e backup → Backup: opera backup
- Clientes e grupos → Armazenamento local: lê e grava
- Armazenamento local → LocalStorage: lê e grava