Equipo trabajando con sistema de gestión escolar digital — Axula, desarrollado en Python Flask para institución educativa en Santo Domingo, República Dominicana
Caso de estudio Python · Flask · SQLite IA integrada Santo Domingo, RD 2025 – 2026

Axula — Sistema de gestión escolar con inteligencia artificial

Plataforma web completa para el Centro Educativo en Arte Benito Juárez en Santo Domingo. Cubre el ciclo de vida completo de la gestión escolar dominicana: expedientes, asistencia, notas, boletines PDF, acuerdos conductuales y asistente IA para padres.

20+
Módulos (Blueprints Flask)
8
Roles de usuario independientes
<3 seg
Generación de boletín PDF
90 seg
Registro de asistencia por aula
100%
Ordenanza 04-2023 MINERD
24/7
Asistente IA para padres

El problema: administración escolar sin digitalizar

El Centro Educativo en Arte Benito Juárez manejaba todos sus procesos administrativos de forma fragmentada. Como docente de multimedia en la institución, viví esa fricción de primera mano, lo que cambió completamente cómo diseñé la solución.

⚠ Antes de Axula
  • Expedientes estudiantiles en papel y carpetas físicas
  • Boletines generados manualmente — horas de trabajo por período
  • Control de asistencia en hojas de Excel no sincronizadas
  • Padres llaman al colegio fuera de horario sin respuesta
  • Informes conductuales dispersos entre docentes
  • 0 visibilidad del desempeño global de la institución
  • Evaluación por competencias (Ordenanza 04-2023) imposible de sistematizar
✓ Con Axula
  • Expediente digital unificado por estudiante con historial completo
  • Boletín PDF generado en menos de 3 segundos por estudiante
  • Asistencia registrada por aula en menos de 90 segundos
  • Asistente IA (LLaMA 3) responde consultas de padres las 24 h
  • Motor conductual: semáforo VERDE / AMARILLO / ROJO por alumno
  • Dashboard por rol — cada usuario ve solo lo que le corresponde
  • Competencias y logros según Ordenanza 04-2023 sistematizados

Capturas del sistema en producción

axula.cebj.edu.do / dashboard
📊 Dashboard — Vista del Director Captura pendiente: panel con indicadores en tiempo real,
resumen de asistencia, alertas conductuales y accesos rápidos

Dashboard principal con indicadores del plantel — acceso exclusivo del director y coordinadores

axula.cebj.edu.do / boletin / generar
📄 Módulo de Boletín PDF Captura pendiente: interfaz de generación con selección
de grado, período y preview del boletín con evaluación por competencias

Generación de boletín PDF con evaluación por competencias — Ordenanza 04-2023 del MINERD

axula.cebj.edu.do / expediente / [id]
📋 Expediente Estudiantil Captura pendiente: ficha completa con indicadores académico,
conductual, psicológico y de logros — semáforo de riesgo incluido

Expediente digital unificado — 4 indicadores: académico, conductual, psicológico y logros

Arquitectura del sistema

Axula usa una arquitectura modular de 20 Blueprints Flask organizados por dominio funcional. SQLite en modo WAL (Write-Ahead Logging) permite lecturas concurrentes sin bloqueos mientras el sistema escribe — clave en un entorno escolar con múltiples usuarios simultáneos.

Capa de presentación
Browser / Usuario final
8 Roles → 8 interfaces distintas
Capa de aplicación — Flask
app.py · Application Factory
CSRF Middleware
Session Manager
20 Blueprints por dominio
auth
expediente
boletin
asistencia
conducta
evaluacion
reportes
finanzas
asistente_ia
+11 más
Capa de datos y servicios externos
SQLite WAL · database.db
Groq API · LLaMA 3
ReportLab · PDF
openpyxl · Excel

Módulos principales

🔐
Autenticación · 8 roles
Director, coordinador, docente, orientador, secretaría, digitador, padre, estudiante. Cada rol ve solo su portal.
📋
Expediente estudiantil
Ficha unificada con 4 indicadores: académico, conductual, psicológico y logros. Historial completo por estudiante.
📄
Boletín PDF automático
Generación en <3 seg con ReportLab. Header institucional, notas por competencia, firma del docente. Según Ord. 04-2023.
🚦
Motor conductual
Score = 40% notas + 35% asistencia + 25% conducta. Semáforo VERDE / AMARILLO / ROJO por alumno en tiempo real.
🤖
Asistente IA (LLaMA 3)
Responde consultas de padres sobre horarios, pagos e inscripciones las 24 h. Integrado vía Groq API con contexto del colegio.
✍️
Acuerdo-compromiso
Página dedicada por estudiante. Generación, revisión y firma digital de acuerdos conductuales entre familia y colegio.
📊
Reportes PDF / Excel
Exportación de informes institucionales con openpyxl y ReportLab. Filtros por grado, período y sección.
🏛
4 portales administrativos
Secretaría, Digitador, Finanzas y Evaluación por Competencias — dashboards independientes por función.

Stack tecnológico

Backend

Python 3 Flask · Application Factory SQLite WAL Blueprint Architecture CSRF Protection Jinja2 Templates

IA y generación de documentos

Groq API LLaMA 3 ReportLab (PDF) openpyxl (Excel)

Frontend y seguridad

JavaScript (ES6) CSS Variables · Tema claro/oscuro WAL Mode concurrencia Rate limiting Sanitización de inputs

Cómo se construyó Axula

Desarrollé Axula desde dentro de la institución — como docente que vivía los problemas que resolvía. Eso cambió completamente las decisiones de diseño.

  1. 1
    Observación directa (2 semanas) Antes de escribir código, documenté cada proceso manual: cómo se llenaban los boletines, cuánto tardaba registrar asistencia, dónde se perdía información entre docentes y secretaría.
  2. 2
    Arquitectura Blueprint por dominio Diseñé cada módulo como un Blueprint independiente. Esto permite que el sistema crezca sin tocar lo que ya funciona — un módulo nuevo no rompe los existentes.
  3. 3
    Desarrollo iterativo con usuarios reales La interfaz de asistencia fue rediseñada 3 veces hasta que cualquier docente podía completarla en menos de 90 segundos por aula. No velocidad estimada — tiempo medido con reloj en mano.
  4. 4
    Integración de IA en flujos existentes, no como función separada El asistente LLaMA 3 aparece en el momento exacto en que el padre necesita respuesta — no como chatbot flotante genérico, sino integrado en el portal de padres con contexto del colegio.
  5. 5
    Modularización completa (20 Blueprints) La refactorización de monolito a arquitectura Blueprint fue el cambio más crítico. Permite que diferentes roles del equipo trabajen en módulos sin conflictos de código.

Lo que aprendí construyendo Axula

Construir un sistema que usas tú mismo cambia la forma en que diseñas. No interpretas un brief — resuelves tu propio problema. Cada decisión de UX tiene consecuencias reales: si el formulario de asistencia es lento, tú pierdes tiempo. Eso fuerza honestidad.

La lección más importante: la IA no es una función, es una capa. Los módulos de LLaMA 3 funcionan mejor cuando están integrados en flujos que ya existen que cuando se presentan como herramientas separadas. El asistente de consultas funciona porque aparece en el momento preciso en que el padre lo necesita, con contexto real del colegio — no como un chatbot genérico.

La segunda lección: SQLite en WAL mode resuelve el 90% de los casos de concurrencia sin la complejidad de Postgres. Para sistemas internos con decenas de usuarios simultáneos, es la opción correcta. Agregar complejidad innecesaria es el error de arquitectura más común.

¿Necesitas un sistema a medida para tu organización?

Desarrollo plataformas web completas con Python, Flask e IA integrada para empresas e instituciones en República Dominicana. Cada sistema empieza con análisis de proceso real — no con código.