Initial commit DBMaker - Oficiais e Funcionando

This commit is contained in:
Marcos
2026-03-22 17:12:45 -03:00
commit 9cee4943f8
144 changed files with 31465 additions and 0 deletions

291
README.md Normal file
View File

@@ -0,0 +1,291 @@
# 📚 SteelBook - Gerenciador de Databooks Técnicos
![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)
![License](https://img.shields.io/badge/license-MIT-green.svg)
![Status](https://img.shields.io/badge/status-Production-brightgreen.svg)
SteelBook é uma plataforma web moderna para criar, organizar e gerar Databooks técnicos profissionais. Desenvolvida com React, TypeScript e Supabase, oferece uma experiência intuitiva e poderosa para gerenciamento de documentação técnica.
## ✨ Características Principais
- 📊 **Dashboard Inteligente** - Visualize todos os seus projetos com progresso em tempo real
- 📚 **Gestão de Databooks** - Crie e organize databooks com múltiplos tópicos
- 📄 **Upload de Documentos** - Suporte para PDF, JPG e PNG com preview
- 🏷️ **Categorização** - Organize tópicos com categorias customizáveis
- 🎨 **Personalização** - Customize cores, logos e marca d'água
- 📑 **Geração de PDF** - Gere PDFs profissionais com um clique
- 👥 **Gerenciamento de Usuários** - Controle de acesso e permissões
- ⚙️ **Configurações Avançadas** - Mapeamento de pastas, integração com IA
- 📊 **Progresso em Tempo Real** - Acompanhe o progresso de cada projeto
- 🔐 **Segurança** - Autenticação JWT e Row Level Security
## 🚀 Quick Start
### Pré-requisitos
- Node.js 16+
- npm ou yarn
- Conta Supabase
### Instalação
```bash
# Clone o repositório
git clone https://github.com/seu-usuario/steelbook.git
cd steelbook
# Instale as dependências
npm install
# Configure as variáveis de ambiente
cp .env.example .env
# Inicie o servidor de desenvolvimento
npm run dev
```
### Configuração do Supabase
1. Crie um projeto em [supabase.com](https://supabase.com)
2. Copie a URL e chave anônima
3. Adicione ao arquivo `.env`:
```env
VITE_SUPABASE_URL=https://seu-projeto.supabase.co
VITE_SUPABASE_ANON_KEY=sua-chave-anonima
```
4. Execute as migrations:
```bash
supabase db push
```
## 📖 Documentação
### Para Usuários
- **[Manual do Usuário](docs/MANUAL_USUARIO.md)** - Guia completo e didático
- Primeiros passos
- Criando databooks
- Gerenciando documentos
- Gerando PDFs
- Dicas e truques
### Para Desenvolvedores
- **[Arquitetura Técnica](docs/ARQUITETURA_TECNICA.md)** - Documentação técnica detalhada
- Visão geral do sistema
- Estrutura do banco de dados
- Fluxo de dados
- Componentes principais
- Autenticação e segurança
## 🏗️ Estrutura do Projeto
```
steelbook/
├── src/
│ ├── pages/ # Páginas principais
│ ├── components/ # Componentes reutilizáveis
│ ├── lib/ # Funções utilitárias
│ ├── types/ # Tipos TypeScript
│ └── App.tsx # Componente raiz
├── supabase/
│ ├── migrations/ # Migrations do banco
│ └── setup_*.sql # Scripts de setup
├── docs/ # Documentação
├── public/ # Arquivos estáticos
└── package.json # Dependências
```
## 🛠️ Stack Tecnológico
### Frontend
- **React 18** - UI library
- **TypeScript** - Type safety
- **Vite** - Build tool
- **Tailwind CSS** - Styling
- **TanStack Query** - State management
- **Lucide Icons** - Icons
### Backend
- **Supabase** - Backend as a Service
- **PostgreSQL** - Database
- **JWT** - Authentication
- **Row Level Security** - Authorization
## 📊 Banco de Dados
O SteelBook utiliza 13 tabelas principais:
1. **usuarios** - Usuários do sistema
2. **clientes** - Informações de clientes
3. **templates_topicos** - Tópicos padrão
4. **templates_customizados** - Templates personalizados
5. **projetos** - Databooks em desenvolvimento
6. **databooks_mestres** - Configurações do databook
7. **secoes_databook** - Seções do databook
8. **documentos_auto_indexados** - Documentos carregados
9. **categorias** - Categorias de tópicos
10. **configuracoes_pastas** - Mapeamento de pastas
11. **integracao_ia** - Configurações de IA
12. **log_processamento_ia** - Histórico de processamentos
13. **permissoes_usuario_detalhadas** - Controle de permissões
Veja [Arquitetura Técnica](docs/ARQUITETURA_TECNICA.md) para detalhes completos.
## 🔐 Segurança
- ✅ Autenticação JWT
- ✅ Row Level Security (RLS)
- ✅ Validação de entrada
- ✅ HTTPS obrigatório
- ✅ CORS configurado
- ✅ Encriptação de dados sensíveis
## 📈 Progresso do Projeto
O progresso é calculado automaticamente:
```
Progresso = (Seções com documentos / Total de tópicos) × 100
```
Exemplo:
- Total de tópicos: 28
- Seções com documentos: 7
- Progresso: 25%
## 🎯 Funcionalidades Principais
### Dashboard
- Visualização de projetos recentes
- Estatísticas rápidas
- Barra de progresso em tempo real
- Ações rápidas (ver, editar, clonar, deletar)
### Gerenciamento de Databooks
- Criar novo databook
- Configurar informações do projeto
- Personalizar aparência
- Definir formato do PDF
### Gerenciamento de Documentos
- Upload de arquivos
- Preview de documentos
- Reordenação por drag-and-drop
- Filtro por categoria
- Busca por título/número
### Gestão de Tópicos
- Criar tópicos hierárquicos
- Reordenar com drag-and-drop
- Associar categorias
- Marcar como obrigatório
### Configurações
- Mapeamento de pastas
- Gerenciamento de categorias
- Gerenciamento de usuários
- Visualização de logs
- Integração com IA
### Geração de PDF
- Preview do databook
- Personalização de cores
- Marca d'água
- Numeração de páginas
- Download automático
## 🚀 Deployment
### Vercel (Recomendado)
```bash
npm run build
vercel deploy
```
### Netlify
```bash
npm run build
netlify deploy --prod --dir=dist
```
### Docker
```bash
docker build -t steelbook .
docker run -p 3000:3000 steelbook
```
## 📝 Variáveis de Ambiente
```env
# Supabase
VITE_SUPABASE_URL=https://seu-projeto.supabase.co
VITE_SUPABASE_ANON_KEY=sua-chave-anonima
# API
VITE_API_URL=http://localhost:5173
# Ambiente
VITE_ENV=development
```
## 🤝 Contribuindo
Contribuições são bem-vindas! Por favor:
1. Fork o projeto
2. Crie uma branch para sua feature (`git checkout -b feature/AmazingFeature`)
3. Commit suas mudanças (`git commit -m 'Add some AmazingFeature'`)
4. Push para a branch (`git push origin feature/AmazingFeature`)
5. Abra um Pull Request
## 📄 Licença
Este projeto está licenciado sob a Licença MIT - veja o arquivo [LICENSE](LICENSE) para detalhes.
## 👥 Autores
- **Desenvolvido com ❤️** para profissionais de engenharia
## 🙏 Agradecimentos
- [React](https://react.dev)
- [Supabase](https://supabase.com)
- [Tailwind CSS](https://tailwindcss.com)
- [TanStack Query](https://tanstack.com/query)
- [Lucide Icons](https://lucide.dev)
## 📞 Suporte
Para suporte, abra uma issue no GitHub ou entre em contato com o time de desenvolvimento.
## 🗺️ Roadmap
- [ ] Integração com IA para análise automática
- [ ] Sincronização com Google Drive/OneDrive
- [ ] Versionamento de databooks
- [ ] Comentários e anotações
- [ ] Exportação em múltiplos formatos
- [ ] API REST pública
- [ ] Aplicativo mobile
- [ ] Integração com sistemas ERP
## 📊 Status
- ✅ v1.0 - Lançamento inicial
- 🔄 v1.1 - Em desenvolvimento
- 📅 v2.0 - Planejado para Q2 2025
---
**Última atualização:** Novembro 2024
**Versão:** 1.0.0
Desenvolvido com ❤️ para profissionais de engenharia.