bora-escrever-plataforma

🎓 Bora Escrever - Plataforma Educacional

Plataforma educacional completa para preparação de redações do ENEM, desenvolvida com tecnologias modernas e foco na experiência do usuário.

✨ Características Principais

🎨 Interface Moderna: Design em dark mode com experiência fluida
📚 Banco de Repertórios: +100 repertórios socioculturais categorizados
🤖 Correção por IA: Sistema de correção automática baseado nas 5 competências do ENEM
💬 Chat Educacional: Assistente virtual MariA especializada em redação
📊 Analytics Avançado: Acompanhamento detalhado do progresso
🎥 Videoaulas: Conteúdo educacional estruturado
👨‍🏫 Tutoria Humanizada: Sessões individuais com especialistas
📱 100% Responsivo: Funciona perfeitamente em desktop, tablet e mobile

🚀 Tecnologias Utilizadas

Frontend

HTML5, CSS3, JavaScript ES6+
Design System moderno com variáveis CSS
Sistema de navegação SPA (Single Page Application)
Responsividade com CSS Grid e Flexbox

Backend

Node.js + Express.js
MongoDB + Mongoose
JWT para autenticação
OpenAI GPT-4 para correção automática
Sistema de upload de arquivos
Rate limiting e segurança avançada

📋 Pré-requisitos

Node.js 16+
MongoDB (local ou Atlas)
Conta OpenAI (para IA)
Git
VS Code (recomendado)

⚡ Instalação Rápida

1. Clone o repositório

git clone https://github.com/seu-usuario/bora-escrever-plataforma.git
cd bora-escrever-plataforma

2. Instale o backend

cd backend
npm install

3. Configure variáveis de ambiente

# Copie o arquivo de exemplo
copy .env.example .env

# Edite o .env com suas configurações

4. Popule o banco de dados

npm run seed

5. Inicie o servidor

npm run dev

6. Abra o frontend

Abra frontend/index.html no navegador ou configure um servidor local.

🔧 Configuração Detalhada

MongoDB

Local: Instale MongoDB Community Edition
Atlas: Crie cluster gratuito em mongodb.com/cloud/atlas
URI: Configure MONGODB_URI no .env

OpenAI

Acesse platform.openai.com
Crie uma conta e gere API key
Configure OPENAI_API_KEY no .env

JWT

Configure JWT_SECRET com string aleatória segura
Defina JWT_EXPIRE (padrão: 30d)

📚 Estrutura do Projeto

bora-escrever-plataforma/
├── frontend/                 # Aplicação frontend
│   ├── index.html           # Página principal
│   ├── css/style.css        # Estilos principais
│   └── js/app.js            # JavaScript principal
├── backend/                 # API Backend
│   ├── server.js            # Servidor principal
│   ├── models/              # Modelos MongoDB
│   ├── routes/              # Rotas da API
│   ├── middleware/          # Middlewares
│   ├── seeds/               # Dados iniciais
│   └── uploads/             # Arquivos enviados
├── scripts/                 # Scripts de automação
└── docs/                    # Documentação

🎯 Funcionalidades

📊 Dashboard

Estatísticas de progresso em tempo real
Redações escritas, correções recebidas, nota média
Acesso rápido a todas as funcionalidades

✍️ Editor de Redações

Editor de texto rico com contador de palavras
Seleção de temas do banco integrado
Sistema de salvamento automático

📚 Banco de Repertórios

5 repertórios iniciais (Black Mirror, Adolescência, RAM TCHUM, etc.)
Sistema de busca e filtros avançados
Categorização por área temática
Sistema de favoritos

🤖 Correção por IA

Análise baseada nas 5 competências do ENEM
Feedback detalhado e construtivo
Pontuação de 0-1000 pontos
Sugestões de melhoria

💬 Chat com MariA

Assistente virtual especializada em redação
Respostas contextualizadas
Sugestões de repertórios
Limites diferenciados por plano

👥 Níveis de Acesso

🆓 Plano Gratuito

3 correções mensais
20 mensagens diárias com IA
Acesso a conteúdo básico

💎 Plano Premium

Correções ilimitadas
Chat ilimitado com IA
Tutoria humanizada
Repertórios exclusivos

🔐 Autenticação

Usuários de Exemplo (após seed)

Admin: admin@boraescrever.com / 123456
Usuário: joao@email.com / 123456

🚀 Deploy

Heroku (Recomendado)

# Instalar Heroku CLI
# heroku create bora-escrever-app
# heroku config:set MONGODB_URI=sua_uri
# heroku config:set JWT_SECRET=seu_secret
# heroku config:set OPENAI_API_KEY=sua_chave
# git push heroku main

Railway

# Conectar repositório no railway.app
# Configurar variáveis de ambiente
# Deploy automático via Git

🤝 Contribuição

Fork o projeto
Crie uma branch para sua feature (git checkout -b feature/nova-feature)
Commit suas mudanças (git commit -m 'Adiciona nova feature')
Push para a branch (git push origin feature/nova-feature)
Abra um Pull Request

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

🆘 Suporte

📧 Email: contato@boraescrever.com
🐛 Issues: GitHub Issues
📖 Docs: Documentação

📈 Roadmap

Desenvolvido com ❤️ para democratizar a educação de qualidade no Brasil