📊 Sistema de Estimativas e Análise de ROI Operacional - Intake de Projetos SUP

(update: 15/07/2025)

Este projeto é uma aplicação web desenvolvida em React + Vite + Tailwind CSS, utilizando Supabase como backend (Banco de Dados, Autenticação e Storage).

O sistema automatiza o intake de projetos, realizando estimativas de prazo, complexidade e agora o cálculo de ROI Operacional com base em redução de esforço humano.

---

📁 Estrutura de Pastas

.
├── .bolt/                     # Configurações internas do Bolt.new (não alterar manualmente)
├── src/                       # Todo o código-fonte do frontend
│   ├── components/            # Componentes React (UI, Admin, Formulário, Kanban, etc)
│   ├── hooks/                 # Custom React Hooks
│   ├── models/                # Tipagens e modelos de dados (TypeScript types/interfaces)
│   ├── services/              # Funções de integração com Supabase
│   ├── utils/                 # Helpers e lógicas de negócio (ex.: cálculos de ROI, complexidade, exportações)
│   └── config/                # Configurações e constantes
├── supabase/
│   └── migrations/            # Scripts de migração de banco de dados
├── .env.example               # Exemplo de variáveis de ambiente
├── index.html                 # HTML principal
├── vite.config.ts             # Configuração do Vite
├── tailwind.config.js         # Configuração do Tailwind CSS
├── package.json               # Dependências do projeto
├── tsconfig.json              # Configuração TypeScript
├── README.md                  # Este arquivo
└── ...                        # Outros arquivos de configuração (eslint, postcss, etc)

---

✅ Funcionalidades Principais

• Formulário Multi-Etapas (5 etapas):

  1. Informações Básicas
  2. Requisitos Funcionais
  3. Requisitos Técnicos
  4. Requisitos Operacionais
  5. Resultados (prazo, complexidade e ROI)

• Cálculo de Complexidade (baseado em critérios configuráveis)

• Cálculo de ROI Operacional (Redução de Esforço Humano)

• Exportação PDF

• Envio Automático de E-mail

• Kanban Board com visualização dos projetos

• Painel Administrativo com os seguintes módulos:

  • E-mails
  • Requisitos Funcionais
  • Requisitos Técnicos
  • Requisitos Operacionais (Novo)
  • Critérios de Complexidade
  • Critérios ROI (Novo)
  • Usuários
  • Configurações
  • Gerenciamento de Senha

---

🛠️ Como Rodar Localmente

1. Instalação de dependências:

npm install

2. Configurar o .env:

Copie o arquivo .env.example para .env e preencha com suas chaves do Supabase.

3. Rodar localmente:

npm run dev

4. Compilar produção:

npm run build

---

🗃️ Banco de Dados - Supabase

Estrutura de tabelas principais:

• projetos
• campos_formulario
• criterios_complexidade
• criterios_roi
• usuarios_equipe
• prioridades

Migrations estão em:

supabase/migrations/

---

🚦 Boas Práticas de Desenvolvimento

• Sempre adicionar novas funcionalidades de forma modular, dentro das pastas apropriadas (ex.: components/, utils/).
• Não modificar ou recriar o que já existe sem necessidade.
• Seguir os padrões de codificação, tipagem TypeScript e arquitetura já existentes.
• Fazer testes em ambiente de desenvolvimento antes de aplicar no Supabase de produção.

---

✅ Observações Específicas para Desenvolvedores (Bolt)

• Não alterar estrutura global sem aprovação.
• Novos módulos devem seguir os layouts, componentes e UX padrões já existentes.
• Testar CRUDs antes de liberar.
• Para campos que não vêm de campos_formulario (exemplo: Custo Hora, Tempo Pós-Projeto), deixar como inputs manuais na tela do Admin (Critérios ROI).