Sistema educacional completo para gestão de disciplinas, aulas, avaliações, notas e comunicação entre alunos, responsáveis, professores, coordenação e direção.
┌─────────────────────────────────────────────────────────────┐
│ FRONTEND (React Native + Expo) │
│ - App Mobile Multiplataforma │
└────────────────────────┬────────────────────────────────────┘
│
│ HTTPS/REST API
│
┌────────────────────────▼────────────────────────────────────┐
│ API GATEWAY / NGINX │
└────────────┬───────────────────────────┬────────────────────┘
│ │
│ │
┌────────────▼──────────────┐ ┌───────▼─────────────────────┐
│ LARAVEL API (PHP 8.2+) │ │ PYTHON ML SERVICE │
│ - Autenticação JWT │ │ - Análise de Desempenho │
│ - CRUD Completo │ │ - Predição de Notas │
│ - Validações │ │ - Geração de Relatórios │
│ - Políticas de Acesso │ │ - Dashboards Analytics │
└────────────┬──────────────┘ └───────┬─────────────────────┘
│ │
│ │
┌────────────▼───────────────────────────▼─────────────────────┐
│ POSTGRESQL DATABASE │
│ - Dados Relacionais │
│ - Migrations Versionadas │
└───────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────┐
│ REDIS CACHE │
│ - Cache de Sessões │
│ - Cache de Queries │
└───────────────────────────────────────────────────────────────┘- ✅ Visualizar disciplinas matriculadas
- ✅ Acessar conteúdos das aulas
- ✅ Consultar calendário de eventos e provas
- ✅ Visualizar observações gerais
- ✅ Todas as funcionalidades do aluno
- ✅ Visualizar notas detalhadas
- ✅ Acompanhar advertências
- ✅ Consultar suspensões
- ✅ Verificar convocações para reuniões
- ✅ Cadastrar e gerenciar aulas
- ✅ Criar e editar ementas de disciplinas
- ✅ Lançar notas dos alunos
- ✅ Registrar observações para coordenação
- ✅ Participar do fórum de práticas pedagógicas
- ✅ Avaliar e aprovar ementas
- ✅ Revisar planejamento de aulas
- ✅ Analisar observações de professores
- ✅ Encaminhar questões para direção
- ✅ Gerar relatórios de turmas
- ✅ Acesso completo ao sistema
- ✅ Dashboard executivo
- ✅ Auditoria de movimentações
- ✅ Relatórios gerenciais
- ✅ Análises preditivas (ML)
- PHP 8.2+ com Laravel 11
- PostgreSQL 16 (Banco de dados)
- Redis (Cache e filas)
- Python 3.12+
- FastAPI (Framework web)
- Pandas (Análise de dados)
- Scikit-learn (Machine Learning)
- ReportLab / WeasyPrint (Geração de PDFs)
- Celery (Tarefas assíncronas)
- React Native com Expo
- TypeScript
- React Navigation
- Axios (HTTP client)
- AsyncStorage (Armazenamento local)
- Docker & Docker Compose
- Nginx (Reverse proxy)
- GitHub Actions (CI/CD)
rapida/
├── backend-api/ # Laravel API
│ ├── app/
│ │ ├── Models/
│ │ ├── Http/
│ │ │ ├── Controllers/Api/V1/
│ │ │ ├── Middleware/
│ │ │ └── Requests/
│ │ ├── Policies/
│ │ └── Services/
│ ├── database/
│ │ ├── migrations/
│ │ └── seeders/
│ ├── routes/
│ │ └── api.php
│ └── tests/
│
├── ml-service/ # Python ML & Reports
│ ├── app/
│ │ ├── api/
│ │ ├── ml/
│ │ │ ├── models/
│ │ │ └── predictions.py
│ │ ├── reports/
│ │ │ ├── generators/
│ │ │ └── templates/
│ │ └── services/
│ ├── tests/
│ └── requirements.txt
│
├── mobile-app/ # React Native Expo
│ ├── src/
│ │ ├── screens/
│ │ ├── components/
│ │ ├── navigation/
│ │ ├── services/
│ │ ├── hooks/
│ │ └── types/
│ ├── assets/
│ └── app.json
│
├── docker/
│ ├── nginx/
│ ├── php/
│ └── python/
│
└── docker-compose.yml- JWT (JSON Web Tokens) para autenticação stateless
- Role-Based Access Control (RBAC) com 5 níveis:
studentresponsibleteachercoordinatordirector
- Laravel Policies para autorização granular
- Refresh Tokens para segurança
- Users - Usuários base do sistema
- Students - Alunos
- Responsibles - Responsáveis
- Teachers - Professores
- Disciplines - Disciplinas
- ClassGroups - Turmas
- Enrollments - Matrículas
- Lessons - Aulas
- Assessments - Avaliações
- Grades - Notas
- Observations - Observações
- Warnings - Advertências
- Suspensions - Suspensões
- SchoolEvents - Eventos escolares
- Syllabuses - Ementas
- Docker & Docker Compose
- Node.js 18+ (para o app mobile)
- Git
# 1. Clone o repositório
git clone https://github.com/clcmo/rapida.git
cd rapida
# 2. Configure as variáveis de ambiente
cp backend-api/.env.example backend-api/.env
cp ml-service/.env.example ml-service/.env
# 3. Suba os containers
docker-compose up -d
# 4. Execute as migrations
docker-compose exec api php artisan migrate --seed
# 5. Acesse a API
# API: http://localhost:8000
# ML Service: http://localhost:8001
# Documentação API: http://localhost:8000/api/documentation
# 6. Para o app mobile
cd mobile-app
npm install
npx expo start- Predição de Desempenho - Prevê notas futuras baseado em histórico
- Detecção de Risco de Evasão - Identifica alunos em risco
- Recomendação de Intervenções - Sugere ações pedagógicas
- Análise de Padrões de Notas - Identifica tendências por turma/disciplina
- Clustering de Alunos - Agrupa por perfil de aprendizagem
- Boletins individuais (PDF)
- Relatórios de turma
- Dashboards executivos
- Análises comparativas
- Relatórios de frequência
# Backend (Laravel)
docker-compose exec api php artisan test
# ML Service (Python)
docker-compose exec ml-service pytest
# Frontend (React Native)
cd mobile-app && npm test- V1.0 - MVP com funcionalidades básicas
- V1.1 - Fórum de professores
- V1.2 - Sistema de notificações push
- V1.3 - Integração com sistemas externos
- V2.0 - Dashboard ML avançado
- V2.1 - App para tablets/web
Contribuições são bem-vindas! Por favor, leia o CONTRIBUTING.md antes de enviar PRs.
Este projeto está sob a licença MIT. Veja LICENSE para mais detalhes.
- Desenvolvedor Principal - [@clcmo]
Para suporte, entre em contato: [ola@camilaloliveira.com]
2019 - 2026. Camila L. Oliveira. Todos os direitos reservados.