Sobre o projeto

Este é um sistema de horários e substituições concebido em torno do fluxo de trabalho diário do coordenador pedagógico de escolas K–12 de Taiwan, licenciado sob MIT, auto-hospedado por escola, em formato puramente web, com interface em chinês tradicional e terminologia educacional taiwanesa. A cobertura funcional é bastante completa. A parte de dados base inclui semestres e tabelas de períodos (modelos para vários sistemas de ensino), professores/turmas/disciplinas/espaços, importação Excel, assistente de configuração, cópia para novo semestre e atribuição de turmas e tabelas de períodos em sistemas mistos. A distribuição de aulas e a marcação manual de horários suportam grupos de turmas rotativas, ensino colaborativo, aulas consecutivas, estatísticas de horas em tempo real, horário semanal por arrastar e largar, verificação de conflitos célula a célula, gestão de múltiplos rascunhos e publicação. A marcação automática de horários usa o motor Google OR-Tools CP-SAT, resolvendo com restrições rígidas H1–H10 e restrições flexíveis S1–S8 ponderadas, executa em segundo plano e fornece progresso em tempo real; quando não há solução, localiza o conflito em linguagem administrativa e suporta marcação parcial. O fluxo de substituições inclui registo de licenças e expansão dos períodos afetados, recomendação de substitutos, validação de trocas, atribuição com efeito imediato, notificações internas e por Email com confirmação, painel do dia e impressão de avisos A4, bem como exportação mensal de estatísticas de horas para Excel. Os relatórios podem exportar horários de turmas, professores e espaços em Excel, PDF (com tipos de letra chineses incorporados) ou PNG, e fornecer o quadro geral da escola e pacote zip em lote. Na operação e manutenção há backup automático diário, backup manual/download/restauro por upload, registos de auditoria e permissões de funções RBAC. A stack técnica é Vue 3 + TypeScript + Vite + Pinia + Naive UI no frontend, Python 3.12 + FastAPI + SQLAlchemy 2 + Pydantic v2 no backend, base de dados PostgreSQL 16, Redis e RQ para executar tarefas em segundo plano de marcação de horários e exportação/backup, Caddy como proxy reverso, e implementação global com Docker Compose em seis contentores. As imagens oficiais estão disponíveis para amd64 e arm64; requisitos mínimos de 2 núcleos / 4GB RAM / 10GB de disco, recomendando-se 4 núcleos e 8GB para marcação automática. A instalação oferece scripts de um clique (Windows PowerShell e bash para Linux/macOS/NAS), podendo também obter-se a imagem oficial ou compilar a partir do código-fonte. O projeto foi deliberadamente concebido para ser descarregado e depois executado, em vez de executado diretamente por pipeline, para que o utilizador possa inspecionar primeiro o conteúdo. O sistema inclui uma funcionalidade de dados de demonstração que gera rapidamente os dados completos de uma escola secundária fictícia quando ainda não existe um semestre, facilitando a experiência de marcação de horários, substituições, exportação e backup. A documentação inclui o manual de operação do coordenador pedagógico (11 capítulos em páginas web ilustradas), manual de implementação, desenho de arquitetura, cartões de tarefas de desenvolvimento, registo de alterações e guia de contribuição, além de uma versão HTML para leitura offline. O estado do projeto é v1.2.4, com os seis marcos M0–M5 concluídos e testes unitários, de integração e ponta a ponta.