Calculadora de Orçamento Estratégico v1.0.0

Sistema avançado de Business Intelligence (BI) e suporte à decisão para precificação técnica de locação de espaços . A plataforma transforma dados operacionais em inteligência competitiva, garantindo margens sustentáveis e previsibilidade financeira.

Visão Estratégica e BI

Diferente de ferramentas de cálculo convencionais, este ecossistema integra:

• Dashboard Executivo: Visualização em tempo real de KPIs como Receita Total (Pipeline), Taxa de Conversão e Margem Média Geral.
• Infraestrutura para ML: Coleta estruturada de dados para modelos de Regressão Logística, permitindo identificar preditores de venda como Lead Time e elasticidade de desconto.
• Análise de Viabilidade: Classificação dinâmica de risco operacional (Verde/Amarelo/Vermelho) baseada no ponto de equilíbrio e margem de contribuição.

Funcionalidades de Alto Impacto

• Engenharia de Custos Granular: Detalhamento de mão de obra (HE 50%, HE 100%), vale-transporte, transporte por app e refeição.
• Multiplicadores Dinâmicos: Ajuste automático por turnos (Manhã: 1.00x, Tarde: 1.15x, Noite: 1.40x).
• Gestão de CRM: Captura de dados do cliente e monitorização do status de conversão para evitar o Viés de Sobrevivência nas análises.
• Governança: Geração de PDFs distintos para propostas comerciais (Cliente) e análises gerenciais detalhadas (Superintendência).

Natureza dos Dados e Variáveis

Para garantir o rigor técnico, o sistema opera com as seguintes variáveis:

• Quantitativas (Razão): Custos base, horas totais, margem líquida e valor final.
• Qualitativas/Categóricas: Unidade, espaços e turnos predominantes.
• Modelagem Preditiva: Foco em identificar a probabilidade de conversão com base em variáveis de confusão e preditores históricos.

Autenticação e Segurança

O sistema conta com autenticação via Firebase Authentication para proteger o acesso ao dashboard administrativo:

• Login Seguro: Email e senha com validação de usuário ativo
• Gestão de Usuários: Interface administrativa para criar e gerenciar usuários
• Roles e Permissões: Suporte para usuários, administradores e superintendentes

🔒 Documentação de Segurança

Para informações completas sobre segurança e gerenciamento de credenciais:

• SECURITY_README.md - 🔐 Hub central de segurança e melhores práticas
• SECURITY_REMEDIATION_GUIDE.md - Resposta a incidentes e limpeza de credenciais
• ENVIRONMENT_VARIABLES_GUIDE.md - Migração para arquitetura Zero Trust
• FIREBASE_CREDENTIALS_EXPLAINED.md - Diferenças entre credenciais públicas e privadas

⚠️ IMPORTANTE: Nunca commite arquivos de credenciais (.json, .env) no Git! Use variáveis de ambiente.

🚀 Setup Inicial de Credenciais

Para configurar sua credencial de acesso, consulte:

• RECOMENDACOES_ACIONAVEIS.md - ⭐ Guia completo passo-a-passo (RECOMENDADO)
• GUIA_RAPIDO_LOGIN.md - Guia rápido de configuração (5 minutos)
• RESOLUCAO_LOGIN.md - Documentação completa e troubleshooting
• RESOLVING_AUTH_INVALID_CREDENTIAL.md - 🔧 Resolvendo erro auth/invalid-credential
• AUTHENTICATION_GUIDE.md - Guia técnico do sistema de autenticação
• SETUP_USERS_CDL.md - 👥 Registo em massa de utilizadores da equipa CDL

✅ Recomendações Acionáveis - Validação SGQ-SECURITY

Após configurar as credenciais, valide seu ambiente com o protocolo SGQ-SECURITY:

• QUICK_REFERENCE_RECOMENDACOES.md - ⚡ Quick Reference (1 minuto)
• RECOMENDACOES_ACIONAVEIS.md - 📋 Guia completo de validação

Validação Rápida (Recomendado):

npm run validate:all    # Valida todo o ambiente (acesso + role + SGQ)

Ferramentas Individuais:

npm run setup:user      # Criar/sincronizar usuário desenvolvedor
npm run setup:users     # Registo em massa de utilizadores CDL
npm run seed:database   # Popular Firestore com dados operacionais padrão
npm run verify:auth     # Verificar configuração de autenticação
npm run verify:security # Auditoria SGQ (RBAC + Resiliência)

Qualidade e Validação (QA)

A precisão financeira é garantida por uma suite de mais de 235 testes automatizados (Jest e Playwright), cobrindo falhas de arredondamento e integridade de dados. Adicionalmente, testes E2E verificam o fluxo completo de autenticação e acesso ao sistema.

Implicações Estratégicas e Recomendações

• Vantagem Competitiva: A utilização de modelos de gestão (como a análise de margem de contribuição) permite uma estratégia de Liderança em Custo.
• Recomendação Acionável: Monitorizar o desvio do Ticket Médio via Dashboard para identificar anomalias na política de descontos.

---

Desenvolvido por Maycon A. Bentes - Inteligência de Mercado, Planejamento e Estudos Estatísticos.

Última Atualização: 26/12/2025