25 lines
1.7 KiB
Markdown
25 lines
1.7 KiB
Markdown
# EduManager - Regras Globais e Escopo
|
|
|
|
## 🚀 Escopo do Projeto
|
|
**EduManager** é um Sistema de Gestão Escolar completo, focado em alta performance, usabilidade premium e automação de processos administrativos e acadêmicos.
|
|
|
|
## 🛠️ Stack Tecnológica
|
|
- **Frontend/Backend:** Remix (React)
|
|
- **Banco de Dados:** PostgreSQL (100% Local/Self-Hosted)
|
|
- **Arquitetura de Storage:** Self-Hosted (MinIO) - 100% Desacoplado do Supabase Cloud.
|
|
- **Sincronização:** API Local de alta performance para conciliação bancária (Asaas).
|
|
- **Orquestração:** Portainer (Docker)
|
|
|
|
## ⚠️ Regras de Negócio Críticas (MANDATÓRIO)
|
|
|
|
> [!IMPORTANT]
|
|
> **Migração de Dados (Legado 'schoodat'):**
|
|
> Ao realizar a migração completa dos dados do sistema legado 'schoodat' para o nosso banco de dados local Postgres, **é terminantemente proibido alterar, resetar ou re-hashear as senhas existentes.**
|
|
> As credenciais devem ser mantidas exatamente como estão para garantir que o acesso dos usuários não seja interrompido.
|
|
|
|
## 📜 Padrões de Desenvolvimento
|
|
1. **Design System:** Estética Premium, Dark Mode por padrão (ou glassmorphism), micro-animações e ausência de placeholders.
|
|
2. **Segurança:** Todas as rotas sensíveis devem validar o token JWT local (via secrets do ambiente). Proibido usar Supabase SDK para lógica de autenticação ou sincronização no frontend.
|
|
3. **Resiliência:** Tratamento rigoroso de erros em chamadas de API de terceiros (Asaas, Evolution API).
|
|
4. **Upload de Arquivos:** Proibido o uso de Base64 para envio de novos arquivos ao servidor. Use obrigatoriamente `FormData` e envie o objeto `File/Blob` para as rotas de API que integram com o MinIO.
|