checklist / README.md
Abimael Torcate
Resolve merge conflicts and finalize Hugging Face Space configuration
e157b94
---
title: Checklist
emoji: 🗂️
colorFrom: blue
colorTo: green
sdk: streamlit
app_file: app.py
pinned: false
short_description: Gerenciador de Checklists com IA e Analytics
---
# 🗂️ Gerenciador de Checklists
Aplicativo completo para gerenciamento de checklists com análise de tempo e relatórios inteligentes.
## 🚀 Funcionalidades
-**Criação de Checklists Personalizados**
- 📊 **Dashboard Geral com Analytics**
- ⏱️ **Análise de Tempo e Movimentos**
- 🎯 **Controle de Prazos (6 meses)**
- 🤖 **Relatórios com IA (GPT-4)**
- 📄 **Export para PDF**
- 🔢 **Rastreamento por Número de Processo**
## 🛠️ Tecnologias
- **Frontend**: Streamlit
- **Banco de Dados**: PostgreSQL
- **IA**: OpenAI GPT-4
- **Visualização**: Plotly, Matplotlib, Seaborn
- **PDF**: ReportLab
## 📦 Dependências
```bash
pip install -r requirements.txt
```
## ⚙️ Configuração
### Variáveis de Ambiente
O aplicativo utiliza as seguintes variáveis de ambiente:
#### Banco de Dados
- `DB_HOST`: Host do PostgreSQL
- `DB_PORT`: Porta (padrão: 5432)
- `DB_NAME`: Nome do banco
- `DB_USER`: Usuário
- `DB_PASSWORD`: Senha
#### IA (OpenAI)
- `OPENAI_API_KEY`: Chave da API OpenAI para relatórios
### Para Desenvolvimento Local
Crie um arquivo `.env`:
```env
OPENAI_API_KEY=sua_chave_openai_aqui
DB_HOST=seu_host
DB_PORT=5432
DB_NAME=checklist
DB_USER=usuario
DB_PASSWORD=senha
```
## 🚀 Como Usar
1. **Criar Checklist**: Clique em "➕ Novo Checklist"
2. **Visualizar**: Acesse via "📊 Dashboard Geral"
3. **Análise**: Use "🤖 Relatórios IA" para insights
4. **Monitorar**: Acompanhe prazos e progresso
## 📊 Analytics
- Tempo médio por processo
- Taxa de conclusão
- Análise de riscos de prazo
- Identificação de gargalos
- Relatórios executivos
## 🤖 IA e Relatórios
- Análise automática de padrões
- Identificação de ineficiências
- Recomendações estratégicas
- Relatórios executivos em PDF
## 🏗️ Estrutura do Projeto
```
checklist/
├── app.py # Aplicação principal
├── pages/ # Páginas do Streamlit
│ ├── criar_checklist.py # Criação de checklists
│ ├── dashboard.py # Dashboard individual
│ ├── dashboard_geral.py # Dashboard geral
│ ├── analytics.py # Análise de tempo
│ └── relatorio_ia.py # Relatórios com IA
├── utils/
│ └── database.py # Conexão e operações DB
├── requirements.txt # Dependências Python
└── README.md # Este arquivo
```
## 📈 Métricas Importantes
- **Prazo Ideal**: 6 meses por processo
- **Status de Prazo**: NO_PRAZO, EM_RISCO, RISCO_ATRASO, ATRASADO
- **Análise de Velocidade**: Baseada em interações dos usuários