BRTEST - Sistema de Gestao Multi-Loja

Sistema web para operacao multi-loja com vendas, produtos, estoque, caixa, gastos, depositos, relatorios e chat.

Versao operacional do app: 2.3.1 Estado da live hoje: off Data da release publica atual: 12/04/2026 URL publica: https://vendas-brtest.web.app

Estado atual em uma frase

• O painel operacional esta aberto em producao, com backend ativo, maintenance-state em mode: off e baseline operacional consolidado em sales-only.

Fonte de verdade por assunto

• README.md
  • resumo tecnico atual, comandos e status canonico do repo
• VERSION.md
  • versao operacional publica do app e estado atual da live
• CHANGELOG.md
  • historico de releases e manutencoes relevantes
• docs/LEITURA/README.md
  • leitura operacional atual do produto
• docs/QA/README.md
  • QA canonico, governanca e runbooks tecnicos
• docs/commercial/README.md
  • material comercial atual
• docs/training/README.md
  • treinamento operacional
• docs/QA/ROADMAP.md
  • backlog futuro a partir do baseline atual

O que esta ativo agora

• painel operacional publico aberto
• backend operacional completo ativo em us-central1
• budget mensal do projeto ativo na billing account compartilhada
• export de billing para BigQuery materializado e pronto para consulta exata por script
• catalogo operacional de modelos atualizado no repo e nas colecoes vivas
• domingo por loja ativo no baseline operacional
• notebook ativo no baseline operacional
• baseline operacional em sales-only
• ranking por loja no Dashboard, com faturamento, qtd-vendas, ticket-medio e % da meta
• Inteligencia por Loja e diario-lojas em Relatorios
• Guia Diario ativo para todos os perfis
• chat operacional polido para desktop e mobile
• modal inicial de boas-vindas por release

O que continua fora do baseline

• UX operacional do modulo Testes
• relatorios guiados por Testes no ciclo atual
• Sentry como opt-in
• Data Connect remoto como preparo futuro
• App Hosting como infraestrutura aposentada

Modos publicos suportados

• off
  • painel operacional aberto
• warning
  • aviso preventivo antes de manutencao
• on
  • manutencao tecnica
• contract-hold
  • pausa comercial com superficie publica alternativa

Ambiente local canonico

• Node: 22
• sync oficial:
  • npm ci
  • npm --prefix functions ci
• manifesto de Functions: functions/functions.yaml
• checklist local barato: docs/QA/LOCAL_MAINTENANCE_CHECKLIST.md

Quando aparecer drift local:

• npm ci
• npm --prefix functions ci
• reiniciar o TypeScript Server do VS Code

Scripts principais

• npm run dev
• npm run build
• npm run lint:check
• npm run typecheck
• npm run qa:github:baseline
• npm run qa:maintenance:local
• npm run test:rules
• npm run test:e2e
• npm run test:e2e:gate
• npm run qa:gate
• npm run deploy
• npm run deploy:functions
• npm run maintenance:warn -- --reason="..." --starts-in-minutes=15 --deploy
• npm run maintenance:on -- --reason="..." --deploy --force
• npm run maintenance:off -- --reason="..." --deploy --force
• npm run contract:hold:on -- --reason="..." --deploy --force
• npm run ops:contract-hold:feedback:list -- --limit=20
• npm run ops:cloud:cost:exact -- --invoice-month=AAAAMM
• npm run ops:modelos:append:dry
• npm run ops:modelos:append:apply
• npm run release:github:dry -- --target <commit>
• npm run release:github -- --target <commit>

Operacao e acesso

• fonte de verdade de identidade e escopo: users, lojas, lojasPublicas
• perfis suportados: admin, ceo, gerente, lider, vendedor
• metadados visuais de vendedor vivem em users
• matriz de acesso operacional: docs/LEITURA/ACCESS_MATRIX.md

Artefatos e historico

• artefatos gerados por QA/ops: tmp/qa/
• historico versionado: docs/legacy/
• leitura operacional canonica: docs/LEITURA/