Arquitetura do Sistema
O Corrija+ foi construído com uma arquitetura moderna e escalável, focada em performance e experiência do usuário. A aplicação utiliza tecnologias de ponta para garantir uma correção rápida e precisa.
Stack Tecnológica
A plataforma é dividida em três camadas principais: Frontend, Backend (Serverless) e Inteligência Artificial.
Frontend
- React 19 & Vite: Core da aplicação, utilizando as funcionalidades mais recentes do React para performance e renderização otimizada.
- TypeScript: Tipagem estática em todo o projeto para maior segurança e facilidade de manutenção.
- Tailwind CSS 4: Estilização moderna e responsiva com foco em design premium.
- React Router 7: Gerenciamento de rotas e navegação fluida.
Visão Geral do Sistema
graph TD
A[Professor] -->|Upload Prova| B(Firebase Storage)
B -->|Trigger| C[App Logic / Services]
C -->|Prompt Estruturado| D{Gemini AI}
D -->|JSON Feedback/Nota| C
C -->|Salva Resultado| E[(Firestore)]
E -->|Notifica em Realtime| A
Camada de Serviços
O Corrija+ desacopla a lógica de negócio da interface através de uma camada de serviços robusta:
- Firebase Functions: Processamento pesado e tarefas de admin ocorrem em ambiente Node.js isolado, garantindo segurança (ex: validação de pagamentos Stripe).
- Integração Gemini: Utilizamos o SDK oficial da Google para enviar prompts estruturados que garantem correções precisas e feedbacks construtivos.
- Firestore Realtime: Mudanças no status de correção são refletidas instantaneamente no painel do professor através de listeners do Firebase.
Fluxo de Dados
- Upload: O professor sobe a prova (ou imagem) via Firebase Storage.
- Processamento: Um serviço extrai o texto e envia para a Gemini AI com o gabarito.
- Persistência: O resultado é salvo no Firestore e vinculado à turma/aluno.
- Notificação: O sistema emite alertas em tempo real sobre a conclusão da tarefa.
[!IMPORTANT] A segurança dos dados é garantida pelas Firestore Security Rules, que impedem que um professor acesse dados de turmas ou instituições às quais não pertence.
Backend & Persistência
- Firebase Firestore: Banco de dados NoSQL em tempo real para armazenamento de dados acadêmicos e de usuários.
- Firebase Auth: Gerenciamento seguro de autenticação e perfis.
- Firebase Functions: Lógica de negócio serverless para processamento pesado e integrações de API.
- Firebase Storage: Armazenamento de arquivos e imagens de avaliações.
Inteligência Artificial
- Google Gemini AI: Motor de IA utilizado para análise de questões dissertativas e auxílio na criação de conteúdos educacionais.
Fluxo de Processamento de IA
Abaixo está o fluxo básico de como a IA processa uma correção:
- O professor envia a avaliação para correção.
- A solicitação é enviada para uma Firebase Function.
- A função extrai o contexto necessário e o envia para a Gemini API.
- O Gemini retorna a análise, que é então processada e salva no Firestore.
- O Frontend recebe a atualização em tempo real e exibe para o professor.