school-management-system
Plataforma de gestión escolar auto-alojada con Laravel 13, PHP 8.3 y Docker. Incluye 26 módulos para gestión académica, financiera, recursos humanos y comunicaciones. Soporta despliegue en VPS o cPanel con RBAC granular, autenticación Sanctum/Spatie y soporte multi-idioma.
Ficha actualizada 25 sept 2026, 23:34 · upstream 25 sept 2026, 23:32 · release sin release detectada
Qué es school-management-system
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
School Management System es una plataforma de gestión escolar auto-alojada construida con Laravel 13, PHP 8.3, MySQL 8 y Redis 7. Diseñada para gestionar académica, estudiantes, personal, finanzas y comunicaciones en un entorno single-school sin capa multi-tenant. La interfaz administrativa utiliza Blade + Bootstrap 5 y ofrece portales separados para docentes, estudiantes y padres.
La arquitectura sigue un patrón modular de 26 módulos con estructura estandarizada: Modelos Eloquent con scopes, Repositorios con caché tag-based (compatible con Redis o base de datos), Servicios de lógica de negocio, Observers para limpieza de caché, FormRequests para validación y JsonResources para respuestas API. Incluye 206+ tests de funcionalidad, análisis estático con PHPStan nivel 5 y documentación detallada en docs/modules/.
El proyecto destaca por su enfoque R&D: construido casi enteramente con un agente de IA (Claude), lo que lo convierte en un prototipo de viabilidad técnica más que un producto comercial. Incluye guías específicas para agentes de IA (CLAUDE.md, AGENTS.md) y soporta despliegue flexible: Docker completo o fallback a cPanel/VPS sin contenedores. La licencia es AGPL v3.
- Gestión integral del ciclo vital del estudiante: admisión online, matrícula, promoción, transferencia y emisión de certificados (TC, admit cards).
- Control académico con gestión de clases, exámenes, calificaciones, GPA, tabulaciones automáticas y asistencia con RFID o auto-clock-out.
- Administración financiera completa: configuración de items de pago, generación de facturas, integración con gateways (bKash, SSLCommerz, Stripe, PayPal), cheques, devoluciones y nóminas con préstamos.
- Comunicación institucional: anuncios, mensajería interna (hilos 1:1 y grupos con roles restringidos), SMS por lotes con soporte GSM-7/Unicode y alertas de transporte.
- Gestión operativa: departamentos de personal, gestión de vacaciones con aprobación, biblioteca con préstamos/devoluciones y control de vencimientos, flota de transporte con rutas y alertas, generación de tarjetas de identificación PDF.
- Portal web CMS para la institución: homepage basada en bloques, menús arrastrar-soltar y soporte multi-idioma con edición visual y RTL.
- Arquitectura modular escalable con patrón de 10 pasos por módulo (migración → modelo → repositorio → servicio → observador → requests → resources → controlador → tests → linting/docblocks).
- Soporte RBAC granular con Spatie Laravel Permission y roles predefinidos: super_admin, admin, teacher, accountant, librarian, receptionist, student, parent.
- Despliegue flexible: Docker completo (app, nginx, MySQL, Redis, MinIO, Horizon, scheduler) o fallback a cPanel/VPS sin contenedores usando caché y cola en base de datos.
- Documentación exhaustiva para agentes de IA (CLAUDE.md, AGENTS.md) con reglas de arquitectura, convenciones de nombres, orden de construcción de módulos y gotchas documentados.
- Patrones de código robustos: repositorios con caché tag-based compatible con Redis o base de datos, transacciones DB::transaction() para escrituras financieras y middleware SetCurrentSchoolFromSession para aislamiento school_id.
- Análisis de calidad integrado: tests de funcionalidad (206+ casos), análisis estático PHPStan nivel 5, linting Pint y badges en GitHub Actions.
- Proyecto de investigación/prototipo sin garantía comercial ni soporte oficial; no apto para entornos críticos sin hardening adicional.
- Funcionalidad LMS con detección de IA opcional depende de Anthropic (pago) o alternativa auto-alojada que requiere configuración manual y no inicia por defecto.
- Credenciales por defecto (admin, MySQL, MinIO) están expuestas en documentación; deben cambiarse obligatoriamente antes de producción.
- Dependencia de PHP 8.3 y Laravel 13; actualizaciones mayores requieren migración controlada de versiones.
- Algunas funcionalidades avanzadas (LMS AI detector) están gateadas por perfil y no se activan automáticamente en despliegues estándar.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requisitos mínimos: Docker Desktop o Engine + Compose, 2 núcleos CPU, 2 GB RAM, 30 GB disco. Pasos obligatorios: generar APP_KEY, ejecutar migraciones con --seed para roles/permisos/grados/gateways/menus/lenguajes, enlazar storage. Cambiar TODAS las credenciales por defecto (admin, teacher, student, parent, minioadmin, school_user/school_pass) antes de exponer a internet. Habilitar HTTPS con Let's Encrypt. Configurar cron para Horizon y scheduler. Seguir docs/cpanel-deployment.md para VPS sin Docker o docs/vps-deployment.md para despliegue completo con Redis/Horizon bajo Supervisor.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.