#!/usr/bin/env python3 """ Genera reporte ejecutivo para el Director del ISAP a partir de los CSVs exportados de la base de datos de producción. Uso: python3 generar_reporte.py [ruta_carpeta_export] Si no se indica la carpeta, busca automáticamente la más reciente que empiece con 'export_bd_' en el directorio del script. """ import base64 import csv import glob import os import sys from collections import Counter, defaultdict from datetime import datetime # ── Rutas ────────────────────────────────────────────────────────────────────── SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__)) LOGO_PATH = os.path.join(SCRIPT_DIR, "assets", "img", "logo.png") # ── Carga de datos ───────────────────────────────────────────────────────────── def load_csv(path): with open(path, newline="", encoding="utf-8-sig") as f: return list(csv.DictReader(f)) def find_export_dir(hint=None): if hint: return hint dirs = sorted( [p for p in glob.glob(os.path.join(SCRIPT_DIR, "export_bd_*")) if os.path.isdir(p)], reverse=True, ) if not dirs: raise FileNotFoundError("No se encontró ninguna carpeta export_bd_* en el proyecto.") return dirs[0] # ── Análisis ─────────────────────────────────────────────────────────────────── def analizar_usuarios(rows): alumnos = [u for u in rows if u["rol"] == "ALUMNO" and u["is_active"] == "1"] academicos = [u for u in rows if u["rol"] == "ACADEMICO" and u["is_active"] == "1"] por_programa = Counter(u["plan_de_estudio"] for u in alumnos if u["plan_de_estudio"]) por_gen_raw = Counter(u["generacion"] for u in alumnos if u["generacion"]) # ordenar generaciones numéricamente por_gen = dict(sorted(por_gen_raw.items(), key=lambda x: int(x[0]) if x[0].isdigit() else 0)) return { "total_alumnos": len(alumnos), "total_academicos": len(academicos), "total_usuarios": len(rows), "por_programa": dict(por_programa), "por_generacion": por_gen, "alumnos_list": alumnos, "academicos_list": academicos, } ESTADO_LABEL = { "NOMBRAMIENTO": "Nombramiento de Director", "TEMA": "Definición del Tema de Tesis", "VOTO_DIR": "Voto Aprobatorio del Director", "VOTO_LEC": "Voto Aprobatorio de los Lectores", "EXAMEN_PENDIENTE":"Definición de Fecha de Examen", "EXAMEN_PROCESO": "Examen en Proceso", "FINALIZADO": "Examen Presentado y Aprobado", } ESTADO_NEXT = { "NOMBRAMIENTO": "Asignar director de tesis", "TEMA": "Confirmar tema y nombrar lectores", "VOTO_DIR": "Esperar voto aprobatorio del director", "VOTO_LEC": "Esperar votos de los lectores", "EXAMEN_PENDIENTE":"Programar fecha de examen de grado", "EXAMEN_PROCESO": "Capturar veredicto del jurado", "FINALIZADO": "Proceso concluido", } VEREDICTO_LABEL = { "UNANIME": "Por unanimidad", "MAYORIA": "Por mayoría", "NO_APROBADO": "No aprobado", "": "—", } def analizar_tesis(tesis_rows, usuarios): id_to_user = {u["id"]: u for u in usuarios} def nombre(uid): u = id_to_user.get(uid, {}) return f"{u.get('first_name','')} {u.get('last_name','')}".strip() or uid por_estado = Counter(t["estado"] for t in tesis_rows) finalizadas = [] en_proceso = [] for t in tesis_rows: alumno_nombre = nombre(t["alumno_id"]) titulo = t["titulo"] or "Sin título" estado = t["estado"] if estado == "FINALIZADO": finalizadas.append({ "alumno": alumno_nombre, "titulo": titulo, "estado": ESTADO_LABEL.get(estado, estado), "veredicto": VEREDICTO_LABEL.get(t.get("veredicto",""), t.get("veredicto","")), "fecha": t.get("fecha_examen","")[:10] if t.get("fecha_examen") else "—", "director": nombre(t.get("director_id","")), }) else: en_proceso.append({ "alumno": alumno_nombre, "titulo": titulo, "estado": ESTADO_LABEL.get(estado, estado), "siguiente": ESTADO_NEXT.get(estado, "—"), "director": nombre(t.get("director_id","")), }) return { "total": len(tesis_rows), "por_estado": {ESTADO_LABEL.get(k,k): v for k, v in por_estado.items()}, "finalizadas": finalizadas, "en_proceso": en_proceso, } ACTION_LABEL = {"1": "Creó", "2": "Modificó", "3": "Eliminó"} def analizar_logs(rows, usuarios): id_to_user = {u["id"]: u for u in usuarios} def nombre(uid): u = id_to_user.get(uid, {}) fn, ln = u.get("first_name",""), u.get("last_name","") uname = u.get("username","") return f"{fn} {ln}".strip() or uname or uid filtered = [ r for r in rows if id_to_user.get(r.get("user_id", ""), {}).get("username", "") != "admin_tec" ] recent = sorted(filtered, key=lambda x: x["action_time"], reverse=True)[:10] result = [] for r in recent: result.append({ "fecha": r["action_time"][:16].replace("T", " "), "accion": ACTION_LABEL.get(r["action_flag"], r["action_flag"]), "objeto": r["object_repr"], "usuario": nombre(r.get("user_id","")), }) return result # ── Logo base64 ──────────────────────────────────────────────────────────────── def logo_b64(): if os.path.exists(LOGO_PATH): with open(LOGO_PATH, "rb") as f: return base64.b64encode(f.read()).decode() return "" # ── Render HTML ──────────────────────────────────────────────────────────────── def js_list(d): """Convierte dict → listas JS para Chart.js""" labels = list(d.keys()) values = list(d.values()) return labels, values COLORES_DONA = ["#003366", "#a68942", "#4a7fc1", "#d4a843", "#1a4d8f", "#c49a2c"] COLORES_BAR = ["#a68942"] * 50 # dorado para barras de programa ESTADO_BADGE_CSS = { "Nombramiento de Director": "badge-muted", "Definición del Tema de Tesis": "badge-muted", "Voto Aprobatorio del Director": "badge-purple", "Voto Aprobatorio de los Lectores": "badge-info", "Definición de Fecha de Examen": "badge-warn", "Examen en Proceso": "badge-orange", "Examen Presentado y Aprobado": "badge-ok", } VEREDICTO_BADGE_CSS = { "Por unanimidad": "badge-ok", "Por mayoría": "badge-info", "No aprobado": "badge-err", "—": "badge-muted", } def render_kpi(valor, etiqueta, icono): return f"""
{icono}
{valor}
{etiqueta}
""" def render_tabla_finalizadas(rows): if not rows: return "

No hay tesis finalizadas.

" filas = "" for r in rows: v_badge = VEREDICTO_BADGE_CSS.get(r["veredicto"], "badge-muted") e_badge = ESTADO_BADGE_CSS.get(r["estado"], "badge-muted") filas += f""" {r['alumno']} {r['titulo']} {r['director']} {r['estado']} {r['veredicto']} {r['fecha']} """ return f""" {filas}
Alumno/aTítuloDirector/a EstadoVeredictoFecha examen
""" def render_tabla_proceso(rows): if not rows: return "

No hay tesis en proceso.

" filas = "" for r in rows: badge = ESTADO_BADGE_CSS.get(r["estado"], "badge-muted") filas += f""" {r['alumno']} {r['titulo']} {r['director'] or '—'} {r['estado']} {r['siguiente']} """ return f""" {filas}
Alumno/aTítuloDirector/a EstadoSiguiente paso
""" def render_actividad(rows): if not rows: return "

Sin actividad registrada.

" items = "" for r in rows: items += f"""
{r['fecha']} {r['usuario']} {r['accion'].lower()} {r['objeto']}
""" return f'
{items}
' def render_html(stats, export_dir_name): u = stats["usuarios"] t = stats["tesis"] logs = stats["logs"] logo = stats["logo"] now = datetime.now().strftime("%d de %B de %Y, %H:%M hrs") # KPIs kpis = ( render_kpi(u["total_alumnos"], "Alumnos activos", "🎓") + render_kpi(u["total_academicos"], "Académicos activos", "👨‍🏫") + render_kpi(len(t["finalizadas"]), "Tesis finalizadas", "✅") + render_kpi(len(t["en_proceso"]), "Tesis en proceso", "📋") ) # Datos Chart.js — estados tesis est_labels, est_vals = js_list(t["por_estado"]) est_colors = COLORES_DONA[:len(est_labels)] # Datos Chart.js — alumnos por programa prog_labels, prog_vals = js_list(u["por_programa"]) # Datos Chart.js — alumnos por generación gen_labels, gen_vals = js_list(u["por_generacion"]) logo_tag = ( f'' if logo else '
ISAP
' ) html = f""" Reporte Ejecutivo — ISAP Posgrados
{logo_tag}

Instituto Sonorense de Administración Pública

Sistema de Gestión de Posgrados — Reporte Ejecutivo

Dirección de Tecnologías {now}
{kpis}
Panorama académico

Tesis por estado

Alumnos por programa

Alumnos por generación

Tesis finalizadas ({len(t["finalizadas"])})
{render_tabla_finalizadas(t["finalizadas"])}
Tesis en proceso ({len(t["en_proceso"])})
{render_tabla_proceso(t["en_proceso"])}
Actividad reciente en el sistema
{render_actividad(logs)}
""" return html # ── Main ─────────────────────────────────────────────────────────────────────── def main(): hint = sys.argv[1] if len(sys.argv) > 1 else None export_dir = find_export_dir(hint) print(f"Leyendo datos desde: {export_dir}") tesis_rows = load_csv(os.path.join(export_dir, "tramites_tesis.csv")) usuario_rows = load_csv(os.path.join(export_dir, "tramites_usuario.csv")) log_rows = load_csv(os.path.join(export_dir, "django_admin_log.csv")) u_stats = analizar_usuarios(usuario_rows) t_stats = analizar_tesis(tesis_rows, usuario_rows) logs = analizar_logs(log_rows, usuario_rows) logo = logo_b64() stats = { "usuarios": u_stats, "tesis": t_stats, "logs": logs, "logo": logo, } html = render_html(stats, os.path.basename(export_dir)) fecha = datetime.now().strftime("%Y%m%d") outfile = os.path.join(SCRIPT_DIR, f"reporte_director_{fecha}.html") with open(outfile, "w", encoding="utf-8") as f: f.write(html) print(f"Reporte generado: {outfile}") if __name__ == "__main__": main()