cokie_college

CokieCollege é uma solução integrada multiplataforma voltada à gestão acadêmica, disciplinar e administrativa de instituições de ensino. Seu objetivo é facilitar a interação em tempo real entre administradores, coordenadores de nível, docentes, estudantes e pessoal da cantina por meio de aplicações web e móveis. Arquitetura O sistema é organizado em módulos desacoplados. O backend é uma API REST em Node.js com Express 5.x que gerencia a lógica de negócio, segurança com Helmet, limitação de requisições, compressão GZIP, autenticação administrativa com Supabase e notificações push mediante Expo Server SDK. O app móvel é desenvolvido com Expo 54, Expo Router e i18next (espanhol e inglês), com design adaptável em modo claro e escuro. O portal web usa React com Vite para monitoramento e administração institucional. Também inclui uma pasta de protótipos visuais e recursos de design. O banco de dados é Supabase PostgreSQL, com políticas de Row Level Security, autenticação, armazenamento e gatilhos. Funcionalidades por perfil O módulo de estudantes oferece diário pedagógico com monitoramento de presenças e um semáforo de conduta de quatro cores, console de notas com detalhamento percentual por atividades, solicitação de justificativas com anexos no Supabase Storage e pré-pedido de almoços com geração de código QR para retirada e pagamento. O módulo de docentes permite o lançamento e histórico de notas com validação de 0,00 a 10,00 e contagem regressiva por período, tickets de prorrogação de prazo ao coordenador e registro de presença ao vivo por turma e matéria. O módulo de coordenadores e administradores inclui gestão de usuários com filtragem por perfil e paginação, aprovação de justificativas com revisão de evidências, divulgação de avisos e eventos institucionais por nível educacional, e atribuição de horários, turmas, salas de aula e carga acadêmica. O módulo da cantina permite publicar o menu diário, gerenciar pedidos com estados (solicitado, preparado, entregue) e escanear códigos QR para confirmar a entrega dos almoços. Implantação Requer Node.js 18 ou superior, Expo CLI e uma conta do Supabase. Executa-se um script SQL no editor do Supabase para inicializar tabelas, tipos enumerados, funções, views e políticas RLS. Depois, instala-se e inicia-se o backend configurando um arquivo .env, e inicia-se o app móvel com Expo. A compilação móvel e as atualizações OTA são realizadas com EAS. Segurança e desempenho O projeto habilita Row Level Security nas tabelas do Supabase, aplica proteção HTTP com helmet, express-rate-limit e compressão GZIP, e inclui índices de banco de dados para otimizar consultas pesadas. Conta com suporte de internacionalização para espanhol e inglês.