docs: registrar creacion de rama rc y release v1.0.1 en changelog

docs: documentar roadmap academico, propuesta mvc/jwt/security y actualizar changelog de sesion
feat(lxc): verificar e instalar git automáticamente al inicio de install.sh si no existe
2026-09-05 01:34:37 -03:00 · 2026-09-05 01:07:15 -03:00 · 2026-09-05 00:33:49 -03:00 · 2026-09-04 23:56:37 -03:00 · 2026-09-04 23:52:23 -03:00 · 2026-09-04 23:50:47 -03:00
13 changed files with 3047 additions and 518 deletions
@@ -1,7 +0,0 @@
-FLASK_APP=app.py
-FLASK_ENV=development
-SECRET_KEY=your-secret-key-here-please-change-in-production
-DATABASE_URL=postgresql://postgres:password@localhost:5432/classrooms_db
-DB_USERNAME=postgres
-DB_PASSWORD=password
-API_BASE_URL=http://localhost:8080/api
@@ -4,7 +4,7 @@
 # ==============================================================================

 # Entorno Flask
-FLASK_APP=app.py
+FLASK_APP=wsgi.py
 FLASK_ENV=production

 # Seguridad: Clave secreta para sesiones y protección CSRF
@@ -1,6 +1,6 @@
 # Resumen de Cambios - Sesión de Desarrollo (Rama `dev`)

-**Fecha:** 2026-09-02 / 2026-09-03  
+**Fecha:** 2026-09-02 / 2026-09-03 / 2026-09-04  
 **Proyecto:** Admin Edu-Space (Flask + PostgreSQL)  
 **Rama:** `dev`  

@@ -345,11 +345,105 @@
  * **Calendario Semanal:** Agregado el filtro **Filtrar por Edificio** en la barra superior junto al filtro de Piso.
  * **Modal Estilo Google Calendar:** La sección de espacio físico desglosa limpiamente en badges: 🏢 Edificio, 🪜 Piso y 🚪 Aula.

-
-
-
-
-
+---
+
+## 21. Corrección de Linter y Renderizado de Barras en Métricas de Ocupación (2026-09-04)
+* **Plantilla de Métricas de Ocupación ([app/templates/admin/metrics/occupancy.html](file:///c:/Workspace/admin-edu-space/app/templates/admin/metrics/occupancy.html)):**
+  * **Eliminación de Falsos Positivos de CSS en el IDE:** Se resolvieron los 12 errores de sintaxis (`property value expected`, `at-rule or selector expected`) reportados por el analizador HTML/CSS del IDE en las tarjetas de KPI (Tasa de Ocupación Hoy, Semanal, Mensual) y en la distribución por Piso / Nivel.
+  * **Atributos Semánticos HTML5:** Se sustituyó la inyección directa de Jinja2 en atributos `style="width: {{ ... }}%;"` por el atributo de datos estándar `data-width="{{ ... }}%"`.
+  * **Inicialización y Animación Dinámica en JS:**
+    * Se configuró en CSS (`.metric-bar-fill { width: 0; }`) un ancho base inicial.
+    * Se implementó un script en el bloque `extra_js` que asigna el ancho dinámico al cargar el DOM (`DOMContentLoaded`).
+    * En conjunto con `transition: width 0.6s ease;`, las barras se expanden de forma fluida y visualmente atractiva al cargar la pantalla.
+
+---
+
+## 22. Actualización de Instalador, Backup de Base de Datos y Despliegue en Proxmox LXC (2026-09-04)
+* **Backup de Base de Datos ([classrooms_db.sql](file:///c:/Workspace/admin-edu-space/classrooms_db.sql)):**
+  * **Extracción del Snapshot Completo:** Volcado íntegro de la base de datos PostgreSQL activa (`classrooms_db`) que alimenta el sistema en producción/local.
+  * **Contenido Respaldado:** 25 aulas físicas y virtuales, 206 comisiones, 206 asignaturas, 412 reservas, 24 carreras, 12 tipos de hitos, matrices de permisos RBAC y usuarios administradores.
+  * **Compatibilidad Multi-Versión:** Se sanitizó la directiva `\restrict` específica de PostgreSQL 18 para garantizar compatibilidad nativa con PostgreSQL 14, 15, 16, 17 y 18.
+* **Actualización del Instalador del Sistema para Proxmox LXC ([install.sh](file:///c:/Workspace/admin-edu-space/install.sh)):**
+  * **Ejecución 100% Automatizada (Zero-Touch):** Se eliminaron todos los prompts interactivos (`read -rp`), permitiendo que el script corra de inicio a fin de forma totalmente desatendida.
+  * **Copia de Configuración Activa del Sistema:** Se configuraron como valores por defecto los parámetros reales del sistema en ejecución (`DATABASE_URL=postgresql://postgres:password@localhost:5432/classrooms_db`, usuario `postgres`, base `classrooms_db` y contraseña `password`), garantizando paridad exacta con el entorno local.
+  * **Compatibilidad Dual de Usuarios:** Configuración tanto del superusuario `postgres` como de `eduspace_user` con los mismos privilegios para compatibilidad inmediata ante cualquier variación de `.env`.
+  * **Optimización Proxmox LXC:** Compatible con contenedores Debian 11/12 y Ubuntu 20.04/22.04/24.04 en Proxmox VE.
+  * **Migración Automática de Directorio Robusta:** Si el repositorio se clona en `/root`, se traslada automáticamente a `/opt/admin-edu-space` mediante sincronización directa con `cp -a`, limpiando posibles directorios anidados residuales y deteniendo el servicio previamente para evitar errores de colisión (`Directory not empty`).
+  * **Despliegue del Motor PostgreSQL Nativo:** Instalación desatendida del motor en el LXC, inicialización dinámica del servicio y bucle de healthcheck de conexión.
+  * **Restauración Automatizada y Permisos:** Detección automática de `classrooms_db.sql`, recreación limpia, asignación de permisos `GRANT ALL` en el esquema `public`, todas las tablas y secuencias a `postgres` y `eduspace_user`.
+  * **Entorno Virtual Nativo (`venv`):** Configuración en `/opt/admin-edu-space/venv` con dependencias del sistema y `gunicorn`.
+  * **Servicio Systemd de Producción:** Configuración y activación de `admin-edu-space.service` en el puerto 5000.
+  * **Ejecución Idempotente:** Integración de `init_db.py` tras la restauración para validar la coherencia del esquema y roles.
+* **Utilidad de Backup Continuo ([backup_db.sh](file:///c:/Workspace/admin-edu-space/backup_db.sh)):**
+  * Script automatizado para generar copias de seguridad fechadas en `backups/` y actualizar simultáneamente `classrooms_db.sql` para facilitar la migración entre contenedores LXC.
+* **Documentación y Tutorial en README ([README.md](file:///c:/Workspace/admin-edu-space/README.md)):**
+  * Guía paso a paso para la creación del contenedor LXC en Proxmox VE (especificaciones de CPU, RAM, disco y habilitación de `nesting=1`).
+  * Instrucciones completas de instalación desatendida con `install.sh`.
+  * Corrección de comandos de inicio apuntando al punto de entrada oficial [wsgi.py](file:///c:/Workspace/admin-edu-space/wsgi.py).
+  * Guía paso a paso para la generación y restauración de backups.
+* **Dependencias ([requirements.txt](file:///c:/Workspace/admin-edu-space/requirements.txt)):**
+  * Se incorporó formalmente `gunicorn>=21.2.0` al listado de dependencias del proyecto.
+
+---
+
+## 23. Resolución de Error 500 (Internal Server Error) y Robustecimiento del Instalador Proxmox LXC (2026-09-04)
+* **Causa Raíz del Error HTTP 500 en Despliegues Existentes:**
+  * Al desplegar sobre contenedores LXC con archivos `.env` preexistentes (por ejemplo, con usuario de base de datos personalizado `eduadmin` extraído de `DATABASE_URL`), el instalador anterior no otorgaba permisos de tablas ni secuencias al usuario dinámico (`GRANT` solo cubría `postgres` y `eduspace_user`), bloqueando las consultas de Flask a PostgreSQL con excepciones de privilegios insuficientes (`permission denied for relation ...`).
+  * Los registros de excepción de Gunicorn se canalizaban exclusivamente a un archivo sin `--capture-output`, impidiendo su visualización inmediata en `journalctl -u admin-edu-space -f`.
+* **Solución y Mejoras en el Instalador ([install.sh](file:///c:/Workspace/admin-edu-space/install.sh)):**
+  * **Extracción Dinámica de Credenciales:** Parseo bidireccional de `DATABASE_URL` y variables individuales (`DB_USERNAME`, `DB_PASSWORD`, `DB_NAME`), garantizando compatibilidad absoluta con cualquier configuración de conexión.
+  * **Aprovisionamiento Universal de Roles PostgreSQL:** Creación y asignación de contraseña y privilegios `SUPERUSER CREATEDB` a todos los usuarios detectados (`DB_USER`, `DB_USERNAME`, `postgres`, `eduspace_user`).
+  * **Garantía Integral de Permisos DDL y DML:** Tras restaurar [classrooms_db.sql](file:///c:/Workspace/admin-edu-space/classrooms_db.sql), se ejecutan `GRANT ALL` en `DATABASE`, `SCHEMA public`, `ALL TABLES`, `ALL SEQUENCES`, `ALL FUNCTIONS` y `ALTER DEFAULT PRIVILEGES` para todos los usuarios.
+  * **Configuración de Autenticación Local (`pg_hba.conf`):** Ajuste automático en Debian/Ubuntu para que conexiones locales (`127.0.0.1`, `::1` y sockets UNIX) no fallen por discrepancias de método de cifrado (`scram-sha-256`/`md5`).
+  * **Logs en Tiempo Real en Systemd:** Reconfiguración de Gunicorn en el servicio con `--error-logfile -`, `--capture-output` y `--enable-stdio-inheritance`, permitiendo que cualquier excepción de Python/Flask se visualice en tiempo real vía `journalctl -u admin-edu-space -f`.
+  * **Healthcheck HTTP Automatizado:** Verificación al final del despliegue con `curl http://127.0.0.1:5000/`, validando que el servidor web responda exitosamente (HTTP 200/302) antes de concluir la instalación.
+* **Carga Segura de Configuración ([config/config.py](file:///c:/Workspace/admin-edu-space/config/config.py)):**
+  * Integración explícita de `load_dotenv` para garantizar que scripts y workers carguen `.env` de forma confiable.
+  * Normalización automática de URIs con esquema heredado `postgres://` hacia el estándar `postgresql://`.
+
+---
+
+## 24. Auto-recuperación y Creación de Cluster PostgreSQL 15 en Debian 12 Proxmox LXC (2026-09-04)
+* **Diagnóstico de Arranque de PostgreSQL en Debian 12 (Bookworm):**
+  * En contenedores Proxmox VE con Debian 12 limpio, `apt-get install postgresql` puede no inicializar automáticamente el cluster `main` si los locales no estaban completamente registrados al compilar el paquete, o el directorio de sockets `/run/postgresql` puede no tener los permisos adecuados en el filesystem `tmpfs`.
+  * El comando genérico `systemctl start postgresql` no inicia el motor si la instancia nativa `postgresql@15-main` no está creada ni generada.
+* **Auto-detección y Resiliencia en [install.sh](file:///c:/Workspace/admin-edu-space/install.sh):**
+  * **Permisos del Socket UNIX:** Creación y asignación explícita de permisos `chmod 2775` con propietario `postgres:postgres` sobre `/run/postgresql` y `/var/run/postgresql`.
+  * **Creación Automática del Cluster:** Chequeo con `pg_lsclusters`; si el cluster `main` no existe, se ejecuta automáticamente `pg_createcluster ${PG_MAJOR} main --locale en_US.UTF-8 --start`.
+  * **Control Systemd Específico:** Arranque y habilitación de la unidad del cluster nativo `postgresql@${PG_MAJOR}-main` y `pg_ctlcluster`.
+  * **Diagnóstico de Salida:** En caso de contingencias en el host Proxmox, el script imprime directamente el estado del cluster con `pg_lsclusters` y las últimas líneas de registro de PostgreSQL.
+* **Verificación e Instalación Automática de Git ([install.sh](file:///c:/Workspace/admin-edu-space/install.sh)):**
+  * Se incorporó en el inicio del script la verificación de presencia de `git` (`command -v git`). Si no está instalado en el sistema o contenedor, el script ejecuta automáticamente `apt-get update && apt-get install -y git` antes de configurar directivas de seguridad (`safe.directory`) o manipular el repositorio.
+
+---
+
+## 25. Roadmap Académico, Propuesta de Mejora (MVC, JWT, Sprint Security), Valor Agregado y Desafíos Técnicos (2026-09-05)
+* **Propuesta de Mejora Arquitectónica y Gobernanza ([README.md](file:///c:/Workspace/admin-edu-space/README.md)):**
+  * **Arquitectura MVC Rigurosa & Clean Architecture:** Formalización del desacoplamiento en 4 capas: Dominio (`app/models/`), Presentación (Jinja2 + JSON API), Controladores delgados (`app/routes/`) y Capa de Negocio (`app/services/` y `app/repositories/`). Incorporación de esquemas tipados DTO (Pydantic) para validación de contratos de entrada.
+  * **Autenticación Stateless con JWT (JSON Web Tokens):** Arquitectura híbrida que preserva sesiones seguras para el panel web y habilita autenticación stateless basada en tokens JWT para microservicios y aplicaciones móviles mediante el patrón Dual Token (`Access Token` de 15 min + `Refresh Token` en cookie `HttpOnly` de 7 días, con soporte de lista negra de revocación en Redis).
+  * **Seguridad Empresarial ("Sprint / Spring Security"):** Adopción de los estándares de Spring Security adaptados a Python/Flask: cadena centralizada de filtros (`SecurityFilterChain`), control declarativo a nivel método (`@require_permission`), rate limiting dinámico contra fuerza bruta (`Flask-Limiter`) y bitácora de auditoría inmutable de eventos (`AuditLog`).
+* **Planificación por Sprints (Roadmap):**
+  * **Sprint 1 (MVC & Servicios):** Desacoplamiento de lógica de negocio a servicios y repositorios; esquemas DTO de validación.
+  * **Sprint 2 (JWT & API Gateway):** Endpoints `/api/auth/login`, `/refresh`, `/logout`, decoradores `@jwt_required` y middleware Bearer Token.
+  * **Sprint 3 (Sprint Security & RBAC):** Pipeline `SecurityFilterChain`, control a nivel método, rate limiting y auditoría inmutable.
+  * **Sprint 4 (Optimizador & Concurrencia):** Paralelización del algoritmo genético áulico e integración con microservicios Spring Boot.
+* **Valor Agregado Institucional:**
+  * **Optimización Edilicia:** Aprovechamiento del aforo en Sede Central (Perón 802) mediante asignación algorítmica por capacidad real y pisos.
+  * **Reducción de Tiempo:** Ahorro del 85% en resolución de conflictos y asignación horaria en turnos de alta concentración (Vespertino).
+  * **Eficiencia Extrema en Proxmox LXC:** Despliegue nativo con consumo inferior a 180MB de RAM frente a alternativas pesadas en Docker/Kubernetes.
+* **Desafíos Técnicos Superados y Próximos (Challenges):**
+  * Resolución del problema NP-Hard de asignación horaria mediante Algoritmo Genético multicriterio.
+  * Pipeline ETL tolerante a fallos para ingesta y normalización de carteleras no estructuradas de Google Sheets.
+  * Despliegue automatizado, auto-recuperable y portátil para Proxmox VE LXC en Debian 12 (Bookworm) y Debian 13 (Trixie).
+
+---
+
+## 26. Creación de Rama `rc` y Publicación del Primer Release Oficial `v1.0.1` (2026-09-05)
+* **Rama `rc` (Release Candidate):**
+  * Creación y sincronización de la rama `rc` con el estado íntegro de `dev` (commit `566908f`), estableciendo el seguimiento remoto `gitea/rc`.
+* **Publicación de Tag y Release `v1.0.1` en Gitea:**
+  * Generación de la etiqueta anotada `v1.0.1` a partir de `rc` con notas de versión detalladas.
+  * Publicación remota en Gitea (`git push gitea v1.0.1`), disponibilizando la primera versión candidata/estable oficial para producción en Proxmox VE LXC con empaquetado de artefactos descargables (`.zip` y `.tar.gz`).



@@ -1,315 +1,378 @@
-# Panel de Administración Edu-Space (UniCABA)
-
-Plataforma integral de gestión áulica, asignación de espacios, control de horarios y reservas académicas para la **Universidad de la Ciudad de Buenos Aires (UniCABA)**, desarrollada con **Python / Flask**, **SQLAlchemy**, **PostgreSQL** y **Bootstrap 5**.
-
---
-
-## 🏛️ Sede Institucional y Ubicaciones
-* **Sede Central UniCABA:** Tte. Gral. Juan Domingo Perón 802, Ciudad Autónoma de Buenos Aires (CABA) — Aulas de grado, auditorio principal y laboratorios distribuidos desde Planta Baja (Piso 0) hasta el 4.° Piso.
-* **Campus Virtual:** Espacio áulico digital integrado (Microsoft Teams / Moodle) configurado con **capacidad ilimitada ($\infty$)**.
-
---
-
-## ✨ Características Principales
-
-### 🛡️ 1. Control de Accesos RBAC Granular (Matriz estilo FortiGate)
-* **Gestión por Módulos:** Permisos independientes por cada área del sistema:
-  1. **Aulas y Espacios:** Creación, edición, capacidad y estado de aulas físicas y virtuales.
-  2. **Edificios y Sedes:** Administración de sedes, pisos y arquitectura edilicia.
-  3. **Reservas de Aulas:** Solicitud, aprobación, confirmación y cancelación.
-  4. **Cartelera y Cronograma:** Calendario interactivo, visualización diaria y comisiones.
-  5. **Gestión Académica:** Carreras, asignaturas, códigos y comisiones.
-  6. **Sincronización Sheets:** Importador y sincronizador de Google Sheets.
-  7. **Optimizador IA:** Algoritmo genético de distribución y resolución de conflictos.
-  8. **Usuarios y Accesos RBAC:** Cuentas, roles y matriz de permisos.
-* **Niveles de Permiso Granulares:** `Ninguno`, `Solo Lectura` o `Lectura y Escritura`.
-* **Controles Rápidos:** Botón *"Establecer Todos"* para configuración masiva inmediata.
-* **Roles Predefinidos:** `Admin` (control total), `Docente`, `Operador` y `Consulta`.
-
-### 📊 2. Sincronización e Importación desde Google Sheets
-* Integración directa con la cartelera académica de UniCABA en Google Sheets.
-* Extracción e importación normalizada de los 5 campos clave:
-  * **Código Académico:** Códigos reales de asignatura (ej. `INGA0003`, `ASIG00165`).
-  * **Asignatura:** Nombre oficial de la materia.
-  * **Aula:** Mapeo a aulas físicas (PB a 4.° piso) o aula `VIRTUAL` ($\infty$).
-  * **Carrera:** Normalización y vinculación relacional con entidades de carrera.
-  * **Horarios y Turnos:** Detección automática de franjas horarias y delimitadores de bloque (`Turno Mañana` y `Turno Tarde / Vespertino`).
-
-### 📅 3. Calendario Interactivo de Reservas (FullCalendar)
-* **Visualización Semanal, Mensual y Diaria:** Grilla ágil de alta legibilidad con jerarquía visual:
-  * Asignatura destacada en tipografía grande y negrita.
-  * Badges con código de materia, aula asignada, turno y franja horaria.
-* **Filtros Dinámicos Combinables:**
-  * Filtrar por **Aula**.
-  * Filtrar por **Materia / Asignatura**.
-  * Filtrar por **Carrera**.
-  * Filtrar por **Turno** (`Turno Mañana` / `Turno Tarde`).
-  * Filtrar por **Piso / Planta** (`Planta Baja`, `Piso 1`, `Piso 2`, `Piso 3`, `Piso 4`).
-  * **Switch "Ocultar Aulas Virtuales":** Aísla la ocupación física real en el edificio central excluyendo los eventos virtuales de capacidad infinita.
-* **Ficha Modal Instantánea:** Vista previa detallada al hacer clic en cualquier evento.
-
-### 📋 4. Cartelera del Día y Listado de Reservas
-* **Cartelera del Día (`/schedule/today`):**
-  * **Vista Cronológica (Timeline):** Bloques horarios de 07:00 a 22:00 hs con indicador de ocupación.
-  * **Vista en Tabla:** Lista ordenada con acciones rápidas y detalles de comisión.
-  * Filtros directos por piso, turno y switch para ocultar virtuales.
-* **Listado Paginado de Reservas (`/schedule/list`):**
-  * Paginación de 20 registros por página preservando filtros aplicados.
-  * Búsqueda por texto, estado (`Confirmada`, `Pendiente`, `Cancelada`), rango de fechas y piso.
-
-### 🏫 5. Gestión de Aulas con Capacidad Infinita ($\infty$)
-* Soporte nativo para el símbolo **`∞`** o `0` para designar aulas virtuales o espacios sin aforo restringido.
-* Botón de un solo clic `Ilimitada (∞)` en formularios de alta y edición con leyendas explicativas.
-* Badges distintivos `∞ Ilimitada` en listados, tarjetas y fichas técnicas.
-
-### 🤖 6. Optimizador Inteligente de Aulas (Algoritmo Genético)
-* Motor de optimización heurística para asignación automática de aulas a comisiones.
-* Pondera capacidad requerida vs. capacidad de aula, equipamiento tecnológico y minimización de desplazamientos entre pisos.
-
-### 🎨 7. Experiencia de Usuario, Temas y Localización
-* **Tema Oscuro / Claro:** Alternador con botón flotante y persistencia en `localStorage` y perfil de usuario.
-* **Soporte Multilingüe:** Internacionalización integral (Español e Inglés) compilada con GNU gettext (`pybabel`).
-* **Tarjetas Estadísticas Interactivas:** Accesos directos rápidos desde el panel general hacia las distintas secciones operativas.
-
-### 🏛️ 8. Sistema Integral de Gestión Institucional (8 Módulos)
-El menú desplegable **Gestión** en la barra de navegación organiza las áreas operativas de la universidad:
-* **Espacios e Infraestructura:**
-  * **Edificios y Sedes (`/buildings/list`):** Administración de edificios físicos, arquitectura y estado edilicio.
-  * **Aulas Presenciales (`/classrooms/list?view_mode=physical`):** Catálogo de aulas físicas por piso, capacidades y zócalos compactos con métricas de ocupación en tiempo real (día, semana, mes).
-  * **Aulas Virtuales con Reunión (`/classrooms/list?view_mode=virtual`):** Campus Virtual con salas a demanda agrupadas por comisión, capacidad ilimitada ($\infty$) y enlaces directos de acceso a videollamadas (Zoom, Google Meet, Microsoft Teams).
-  * **Gestión de Ocupación y Métricas (`/admin/occupancy-metrics`):** Dashboard analítico de tasas de ocupación horaria (día, semana, mes), horas pico, distribución por turno y comparativa física vs. virtual.
-* **Gestión Académica:**
-  * **Carreras (`/admin/careers`):** ABM de carreras universitarias y planes de estudio con contador de asignaturas y comisiones activas.
-  * **Asignaturas (`/admin/subjects`):** Catálogo institucional de materias con créditos, departamentos y filtros por carrera y estado.
-  * **Comisiones y Cursadas (`/schedule/commissions`):** Gestión de cursadas, turnos, docentes, enlaces virtuales e hitos de evaluación.
-  * **Ciclo Lectivo (`/admin/academic-terms`):** Modelo y panel de administración de períodos académicos, cuatrimestres y activación del ciclo lectivo en curso.
-* **Administración & Seguridad:**
-  * **Usuarios y Roles RBAC:** Cuentas, asignación de permisos matriciales y auditoría.
-  * **Tipificaciones de Hitos:** Catálogo de tipos de hitos de evaluación académica.
-  * **Sincronización Sheets:** Integración con Google Sheets para actualización en lote.
-
---
-
-## 🛠️ Stack Tecnológico
-
-| Componente | Tecnología |
-| :--- | :--- |
-| **Backend** | Python 3.12+ / Flask |
-| **Base de Datos** | PostgreSQL 16+ / SQLAlchemy ORM |
-| **Seguridad & Sesiones** | Flask-Login / Werkzeug / CSRF Protect |
-| **Formularios** | Flask-WTF / WTForms |
-| **Internacionalización** | Flask-Babel / GNU gettext |
-| **Frontend** | Bootstrap 5.3, Bootstrap Icons, Vanilla JS, CSS Variables |
-| **Calendario** | FullCalendar 5.11 |
-
---
-
-## 🚀 Instalación y Puesta en Marcha
-
-### ⚡ Opción A — Deploy Automático en Debian 12 LXC (Recomendado)
-
-El repositorio incluye un instalador interactivo (`install.sh`) que configura todo el entorno de producción automáticamente: dependencias del sistema, PostgreSQL, entorno virtual Python, inicialización de base de datos y servicio systemd con Gunicorn.
-
-#### Prerrequisitos
-* Contenedor LXC o servidor con **Debian 12 (Bookworm)**
-* Acceso **root** (o `sudo`)
-* Conexión a Internet
-
-#### Pasos
-
-```bash
-# 1. Clonar el repositorio
-git clone https://gitea.oemspot.com.ar/carlostellocba/admin-edu-space.git
-cd admin-edu-space
-
-# 2. Dar permisos de ejecución al instalador
-chmod +x install.sh
-
-# 3. Ejecutar el instalador como root
-sudo bash install.sh
-```
-
-Durante la ejecución el instalador solicitará únicamente la **contraseña para el usuario de base de datos** (si se deja vacío usa `eduspace2024` por defecto).
-
-#### Qué instala y configura automáticamente
-
-| Paso | Acción |
-| :--- | :--- |
-| 1 | Configura locale `en_US.UTF-8` en el sistema (previene errores de encoding) |
-| 2 | Instala Python 3, venv, pip, build-tools, libpq-dev y PostgreSQL |
-| 3 | Inicia y habilita el servicio PostgreSQL para el arranque automático |
-| 4 | Genera `SECRET_KEY` aleatoria y crea el archivo `.env` de producción |
-| 5 | Crea el usuario `eduspace_user` y la base de datos `classrooms_db` en PostgreSQL |
-| 6 | Crea el virtualenv e instala todas las dependencias + Gunicorn |
-| 7 | Ejecuta `init_db.py` (tablas, roles RBAC, edificios y usuario admin inicial) |
-| 8 | Crea el usuario del sistema `eduspace` (sin shell, por seguridad) |
-| 9 | Registra y arranca el servicio systemd `admin-edu-space` en el puerto **5000** |
-| 10 | Muestra resumen con URL, credenciales y comandos de gestión |
-
-#### Comandos de gestión post-instalación
-
-```bash
-# Ver estado del servicio
-systemctl status admin-edu-space
-
-# Ver logs en tiempo real
-journalctl -u admin-edu-space -f
-
-# Reiniciar la aplicación
-systemctl restart admin-edu-space
-
-# Detener la aplicación
-systemctl stop admin-edu-space
-```
-
-> **Nota:** Si el archivo `.env` ya existe en el directorio (por ejemplo, copiado manualmente antes de correr el instalador), el script lo conserva sin sobrescribirlo.
-
---
-
-### 🖥️ Opción B — Instalación Manual (Desarrollo Local)
-
-#### Prerrequisitos
-1. **Python 3.10 o superior**
-2. **PostgreSQL** en ejecución con una base de datos creada (ej. `classrooms_db`).
-3. **Git**
-
-#### Pasos de Configuración
-
-1. **Clonar el repositorio:**
-   ```bash
-   git clone https://gitea.oemspot.com.ar/carlostellocba/admin-edu-space.git
-   cd admin-edu-space
-   ```
-
-2. **Crear y activar el entorno virtual:**
-   * En Windows (PowerShell):
-     ```powershell
-     python -m venv venv
-     .\venv\Scripts\Activate.ps1
-     ```
-   * En Linux / macOS:
-     ```bash
-     python3 -m venv venv
-     source venv/bin/activate
-     ```
-
-3. **Instalar dependencias:**
-   ```bash
-   pip install -r requirements.txt
-   ```
-
-4. **Configurar variables de entorno (`.env`):**
-   Copiar la plantilla y editar con los valores de tu entorno:
-   ```bash
-   cp .env.example .env
-   ```
-   ```env
-   SECRET_KEY=clave-secreta-de-produccion-cambiar-en-despliegue
-   DATABASE_URL=postgresql://postgres:postgres@localhost:5432/classrooms_db
-   FLASK_ENV=development
-   FLASK_DEBUG=1
-   ```
-
-5. **Inicializar la Base de Datos:**
-   Ejecutar el script de inicialización para crear tablas, roles institucionales, permisos RBAC, sedes y el usuario administrador:
-   ```bash
-   python init_db.py
-   ```
-
-6. **Compilar catálogos de traducción (opcional si se modifican textos):**
-   ```bash
-   pybabel compile -d translations
-   ```
-
-7. **Iniciar el servidor de desarrollo:**
-   ```bash
-   python app.py
-   ```
-   La aplicación estará disponible en: **`http://localhost:5000`**
-
---
-
-## 🔑 Credenciales Predeterminadas
-
-| Usuario | Correo Electrónico | Contraseña | Rol |
-| :--- | :--- | :--- | :--- |
-| **Administrador del Sistema** | `admin@edu-space.com` | `admin123` | `Admin` (Acceso Total) |
-
-> ⚠️ **Importante:** Cambiá la contraseña del administrador inmediatamente después del primer acceso.
-
---
-
-## 📁 Estructura del Proyecto
-
-```text
-admin-edu-space/
-├── app/
-│   ├── __init__.py                  # Factoría de la aplicación Flask y extensiones
-│   ├── forms/                       # Formularios Flask-WTF con validación CSRF
-│   │   ├── auth.py                  # Login, perfil y cambio de clave
-│   │   ├── building.py              # Sedes y edificios
-│   │   ├── classroom.py             # Aulas y capacidades (con soporte ∞)
-│   │   └── reservation.py           # Reservas de aulas y horarios
-│   ├── models/                      # Modelos relacionales SQLAlchemy
-│   │   ├── academic_term.py         # Ciclos lectivos y períodos académicos (activo/histórico)
-│   │   ├── building.py              # Sedes y edificios institucionales
-│   │   ├── career.py                # Carreras y titulaciones universitarias
-│   │   ├── classroom.py             # Aulas físicas y virtuales con capacidades
-│   │   ├── genetic_algorithm.py     # Estructuras de optimización heurística
-│   │   ├── milestone.py             # Tipificaciones de hitos académicos y exámenes
-│   │   ├── reservation.py           # Reservas horarias, estados y turnos
-│   │   ├── role.py                  # Roles y matriz de permisos granulares RBAC
-│   │   ├── subject.py               # Asignaturas, materias y comisiones de cursada
-│   │   └── user.py                  # Usuarios, credenciales y asignación de roles
-│   ├── routes/                      # Controladores y rutas modulares (Blueprints)
-│   │   ├── admin.py                 # Carreras, Asignaturas, Ciclo Lectivo, Tipificaciones, Métricas, Usuarios y Roles
-│   │   ├── auth.py                  # Autenticación, sesiones y perfil
-│   │   ├── buildings.py             # Gestión de sedes y edificios
-│   │   ├── classrooms.py            # Aulas presenciales vs. Campus Virtual a demanda y métricas de uso
-│   │   ├── genetic_algorithm.py     # Optimizador heurístico de asignación de espacios
-│   │   ├── main.py                  # Dashboard principal y métricas rápidas
-│   │   └── schedule.py              # Calendario interactivo, cartelera del día, comisiones y reservas
-│   ├── services/                    # Servicios y lógica de negocio
-│   │   └── sheets_importer.py       # Parser y sincronizador bidireccional de Google Sheets
-│   ├── static/                      # Recursos estáticos web
-│   │   ├── css/
-│   │   │   ├── style.css            # Estilos base y utilidades
-│   │   │   └── theme.css            # Variables CSS para modo claro y modo oscuro
-│   │   └── js/
-│   │       ├── genetic-algorithm.js # Lógica de ejecución del algoritmo genético
-│   │       ├── main.js              # Interacciones globales y filtros dinámicos
-│   │       └── theme-toggle.js      # Conmutador reactivo de tema con persistencia
-│   ├── templates/                   # Vistas Jinja2 renderizadas con Bootstrap 5
-│   │   ├── base.html                # Plantilla maestra con navbar categorizada y menú Gestión
-│   │   ├── dashboard.html           # Panel principal de control y métricas
-│   │   ├── genetic_optimizer.html   # Interfaz del optimizador de espacios
-│   │   ├── admin/
-│   │   │   ├── academic_terms/      # Gestión de Ciclos Lectivos y cuatrimestres
-│   │   │   ├── careers/             # Gestión de Carreras y titulaciones
-│   │   │   ├── metrics/             # Dashboard de Ocupación y Métricas de Espacios
-│   │   │   ├── milestone_types/     # Gestión de Tipificaciones de Hitos
-│   │   │   ├── roles/               # Gestión de Roles y Matriz de Permisos RBAC
-│   │   │   ├── subjects/            # Gestión de Asignaturas y Materias
-│   │   │   ├── users/               # Gestión de Usuarios y cuentas
-│   │   │   └── import.html          # Sincronización con Google Sheets
-│   │   ├── auth/                    # Vistas de autenticación y perfil de usuario
-│   │   ├── buildings/               # Listado, alta y edición de sedes y edificios
-│   │   ├── classrooms/              # Listado físico vs virtual, alta, edición y ficha
-│   │   └── schedule/                # Calendario (FullCalendar), cartelera del día, comisiones y reservas
-│   └── utils/                       # Utilidades transversales y decoradores
-│       └── decorators.py            # Decoradores RBAC (@permission_required, can_manage, etc.)
-├── config/                          # Configuraciones de entorno (desarrollo, testing, prod)
-├── translations/                    # Catálogos GNU gettext compilados (es / en)
-├── install.sh                       # Instalador automático para Debian 12 LXC
-├── init_db.py                       # Inicializador DDL y semillero de datos
-├── CHANGELOG_SESSION.md             # Historial técnico cronológico
-├── requirements.txt                 # Dependencias Python
-├── .env.example                     # Plantilla de variables de entorno
-└── app.py                           # Punto de entrada de la aplicación Flask
-```
-
---
-
-## 📄 Licencia
-
-Este proyecto forma parte del sistema de gestión institucional y educativa de **UniCABA**. Todos los derechos reservados.
+# Panel de Administración Edu-Space (UniCABA)
+
+Plataforma integral de gestión áulica, asignación de espacios, control de horarios y reservas académicas para la **Universidad de la Ciudad de Buenos Aires (UniCABA)**, desarrollada con **Python / Flask**, **SQLAlchemy**, **PostgreSQL** y **Bootstrap 5**.
+
+---
+
+## 🏛️ Sede Institucional y Ubicaciones
+* **Sede Central UniCABA:** Tte. Gral. Juan Domingo Perón 802, Ciudad Autónoma de Buenos Aires (CABA) — Aulas de grado, auditorio principal y laboratorios distribuidos desde Planta Baja (Piso 0) hasta el 4.° Piso.
+* **Campus Virtual:** Espacio áulico digital integrado (Microsoft Teams / Moodle) configurado con **capacidad ilimitada ($\infty$)**.
+
+---
+
+## ✨ Características Principales
+
+### 🛡️ 1. Control de Accesos RBAC Granular (Matriz estilo FortiGate)
+* **Gestión por Módulos:** Permisos independientes por cada área del sistema:
+  1. **Aulas y Espacios:** Creación, edición, capacidad y estado de aulas físicas y virtuales.
+  2. **Edificios y Sedes:** Administración de sedes, pisos y arquitectura edilicia.
+  3. **Reservas de Aulas:** Solicitud, aprobación, confirmación y cancelación.
+  4. **Cartelera y Cronograma:** Calendario interactivo, visualización diaria y comisiones.
+  5. **Gestión Académica:** Carreras, asignaturas, códigos y comisiones.
+  6. **Sincronización Sheets:** Importador y sincronizador de Google Sheets.
+  7. **Optimizador IA:** Algoritmo genético de distribución y resolución de conflictos.
+  8. **Usuarios y Accesos RBAC:** Cuentas, roles y matriz de permisos.
+* **Niveles de Permiso Granulares:** `Ninguno`, `Solo Lectura` o `Lectura y Escritura`.
+* **Controles Rápidos:** Botón *"Establecer Todos"* para configuración masiva inmediata.
+* **Roles Predefinidos:** `Admin` (control total), `Docente`, `Operador` y `Consulta`.
+
+### 📊 2. Sincronización e Importación desde Google Sheets
+* Integración directa con la cartelera académica de UniCABA en Google Sheets.
+* Extracción e importación normalizada de los 5 campos clave:
+  * **Código Académico:** Códigos reales de asignatura (ej. `INGA0003`, `ASIG00165`).
+  * **Asignatura:** Nombre oficial de la materia.
+  * **Aula:** Mapeo a aulas físicas (PB a 4.° piso) o aula `VIRTUAL` ($\infty$).
+  * **Carrera:** Normalización y vinculación relacional con entidades de carrera.
+  * **Horarios y Turnos:** Detección automática de franjas horarias y delimitadores de bloque (`Turno Mañana` y `Turno Tarde / Vespertino`).
+
+### 📅 3. Calendario Interactivo de Reservas (FullCalendar)
+* **Visualización Semanal, Mensual y Diaria:** Grilla ágil de alta legibilidad con jerarquía visual:
+  * Asignatura destacada en tipografía grande y negrita.
+  * Badges con código de materia, aula asignada, turno y franja horaria.
+* **Filtros Dinámicos Combinables:**
+  * Filtrar por **Aula**.
+  * Filtrar por **Materia / Asignatura**.
+  * Filtrar por **Carrera**.
+  * Filtrar por **Turno** (`Turno Mañana` / `Turno Tarde`).
+  * Filtrar por **Piso / Planta** (`Planta Baja`, `Piso 1`, `Piso 2`, `Piso 3`, `Piso 4`).
+  * **Switch "Ocultar Aulas Virtuales":** Aísla la ocupación física real en el edificio central excluyendo los eventos virtuales de capacidad infinita.
+* **Ficha Modal Instantánea:** Vista previa detallada al hacer clic en cualquier evento.
+
+### 📋 4. Cartelera del Día y Listado de Reservas
+* **Cartelera del Día (`/schedule/today`):**
+  * **Vista Cronológica (Timeline):** Bloques horarios de 07:00 a 22:00 hs con indicador de ocupación.
+  * **Vista en Tabla:** Lista ordenada con acciones rápidas y detalles de comisión.
+  * Filtros directos por piso, turno y switch para ocultar virtuales.
+* **Listado Paginado de Reservas (`/schedule/list`):**
+  * Paginación de 20 registros por página preservando filtros aplicados.
+  * Búsqueda por texto, estado (`Confirmada`, `Pendiente`, `Cancelada`), rango de fechas y piso.
+
+### 🏫 5. Gestión de Aulas con Capacidad Infinita ($\infty$)
+* Soporte nativo para el símbolo **`∞`** o `0` para designar aulas virtuales o espacios sin aforo restringido.
+* Botón de un solo clic `Ilimitada (∞)` en formularios de alta y edición con leyendas explicativas.
+* Badges distintivos `∞ Ilimitada` en listados, tarjetas y fichas técnicas.
+
+### 🤖 6. Optimizador Inteligente de Aulas (Algoritmo Genético)
+* Motor de optimización heurística para asignación automática de aulas a comisiones.
+* Pondera capacidad requerida vs. capacidad de aula, equipamiento tecnológico y minimización de desplazamientos entre pisos.
+
+### 🎨 7. Experiencia de Usuario, Temas y Localización
+* **Tema Oscuro / Claro:** Alternador con botón flotante y persistencia en `localStorage` y perfil de usuario.
+* **Soporte Multilingüe:** Internacionalización integral (Español e Inglés) compilada con GNU gettext (`pybabel`).
+* **Tarjetas Estadísticas Interactivas:** Accesos directos rápidos desde el panel general hacia las distintas secciones operativas.
+
+### 🏛️ 8. Sistema Integral de Gestión Institucional (8 Módulos)
+El menú desplegable **Gestión** en la barra de navegación organiza las áreas operativas de la universidad:
+* **Espacios e Infraestructura:**
+  * **Edificios y Sedes (`/buildings/list`):** Administración de edificios físicos, arquitectura y estado edilicio.
+  * **Aulas Presenciales (`/classrooms/list?view_mode=physical`):** Catálogo de aulas físicas por piso, capacidades y zócalos compactos con métricas de ocupación en tiempo real (día, semana, mes).
+  * **Aulas Virtuales con Reunión (`/classrooms/list?view_mode=virtual`):** Campus Virtual con salas a demanda agrupadas por comisión, capacidad ilimitada ($\infty$) y enlaces directos de acceso a videollamadas (Zoom, Google Meet, Microsoft Teams).
+  * **Gestión de Ocupación y Métricas (`/admin/occupancy-metrics`):** Dashboard analítico de tasas de ocupación horaria (día, semana, mes), horas pico, distribución por turno y comparativa física vs. virtual.
+* **Gestión Académica:**
+  * **Carreras (`/admin/careers`):** ABM de carreras universitarias y planes de estudio con contador de asignaturas y comisiones activas.
+  * **Asignaturas (`/admin/subjects`):** Catálogo institucional de materias con créditos, departamentos y filtros por carrera y estado.
+  * **Comisiones y Cursadas (`/schedule/commissions`):** Gestión de cursadas, turnos, docentes, enlaces virtuales e hitos de evaluación.
+  * **Ciclo Lectivo (`/admin/academic-terms`):** Modelo y panel de administración de períodos académicos, cuatrimestres y activación del ciclo lectivo en curso.
+* **Administración & Seguridad:**
+  * **Usuarios y Roles RBAC:** Cuentas, asignación de permisos matriciales y auditoría.
+  * **Tipificaciones de Hitos:** Catálogo de tipos de hitos de evaluación académica.
+  * **Sincronización Sheets:** Integración con Google Sheets para actualización en lote.
+
+---
+
+## 🛠️ Stack Tecnológico
+
+| Componente | Tecnología |
+| :--- | :--- |
+| **Backend** | Python 3.12+ / Flask |
+| **Base de Datos** | PostgreSQL 16+ / SQLAlchemy ORM |
+| **Seguridad & Sesiones** | Flask-Login / Werkzeug / CSRF Protect |
+| **Formularios** | Flask-WTF / WTForms |
+| **Internacionalización** | Flask-Babel / GNU gettext |
+| **Frontend** | Bootstrap 5.3, Bootstrap Icons, Vanilla JS, CSS Variables |
+| **Calendario** | FullCalendar 5.11 |
+
+---
+
+## 🚀 Despliegue en Proxmox VE (LXC) con Entorno Virtual `venv`
+
+El sistema está especialmente optimizado para ejecutarse en contenedores **LXC (Debian 12 Bookworm o Ubuntu 22.04/24.04 LTS)** dentro de **Proxmox VE**, utilizando un entorno virtual nativo de Python (`venv`), el motor **PostgreSQL** instalado en el propio contenedor y el servidor WSGI **Gunicorn** gestionado como servicio por **systemd**.
+
+---
+
+### 📋 Paso 1: Creación del Contenedor LXC en Proxmox VE
+
+Podés crear el contenedor desde la interfaz Web de Proxmox (*Create CT*) o por terminal Proxmox con `pct create`:
+
+* **Plantilla (Template):** `debian-12-standard` (*Recomendado*) o `ubuntu-22.04-standard` / `ubuntu-24.04-standard`.
+* **CPU:** 1 a 2 vCPU.
+* **Memoria RAM:** 1024 MB a 2048 MB (Swap: 512 MB).
+* **Disco:** 8 GB a 15 GB (almacenamiento `local-lvm` o `zfs`).
+* **Red (Network):** Modo Bridge `vmbr0` con IP estática en tu red local o DHCP (ej: `192.168.1.150/24`, Gateway: `192.168.1.1`).
+* **Opciones del Contenedor:**
+  * *Unprivileged container:* Sí (marcado por defecto, compatible).
+  * *Features (Características):* Habilitar **Nesting (`nesting=1`)** en `CT > Opciones > Características` (requerido para systemd).
+
+---
+
+### ⚡ Paso 2: Instalación Automatizada con `install.sh`
+
+1. **Ingresar a la consola del contenedor LXC:**
+   Desde la Web UI de Proxmox (consola noVNC) o desde el shell de tu nodo Proxmox:
+   ```bash
+   pct enter <ID_DEL_CONTENEDOR>
+   ```
+
+2. **Clonar el repositorio y lanzar el instalador:**
+   ```bash
+   apt update && apt install -y git
+   git clone https://gitea.oemspot.com.ar/carlostellocba/admin-edu-space.git
+   cd admin-edu-space
+   bash install.sh
+   ```
+
+3. **Flujo de Ejecución Automatizado en el LXC:**
+   * **Migración segura fuera de `/root`:** Si el repositorio se clonó en `/root`, el instalador lo traslada automáticamente a `/opt/admin-edu-space` para garantizar que el usuario del servicio (`eduspace`) tenga acceso de lectura y ejecución.
+   * **Locales UTF-8:** Configura `en_US.UTF-8` y `es_AR.UTF-8` para asegurar la internacionalización con `Flask-Babel` y prevenir errores de encoding.
+   * **Motor PostgreSQL:** Instala el motor PostgreSQL, inicia el servicio y verifica conectividad activa con bucle de espera.
+   * **Restauración del Snapshot Oficial ([classrooms_db.sql](file:///c:/Workspace/admin-edu-space/classrooms_db.sql)):**
+     * Detecta el volcado completo de datos.
+     * Crea la base de datos `classrooms_db` y el usuario `eduspace_user`.
+     * Restaura **25 aulas** (físicas y Campus Virtual $\infty$), **206 comisiones**, **206 materias**, **412 reservas históricas**, **24 carreras**, matrices RBAC y cuentas de acceso.
+     * Otorga privilegios totales (`GRANT ALL`) en el esquema `public`, todas las tablas y **todas las secuencias** al usuario `eduspace_user`.
+     * Ejecuta `init_db.py` de forma idempotente para validar roles y coherencia.
+   * **Entorno Virtual Python (`venv`):** Crea el entorno aislado en `/opt/admin-edu-space/venv` e instala todas las dependencias oficiales (`Flask`, `SQLAlchemy`, `Gunicorn`, etc.).
+   * **Servicio Systemd de Producción:** Configura el servicio `admin-edu-space.service` gestionado por **Gunicorn** (3 workers, puerto 5000), con reinicio automático ante fallos y habilitado al inicio del contenedor.
+
+---
+
+### 🌐 Paso 3: Acceso Inmediato a la Aplicación
+
+Al finalizar la instalación, el script mostrará la dirección IP del contenedor:
+* **URL:** **`http://<IP-DEL-LXC>:5000`** (ejemplo: `http://192.168.1.150:5000`)
+* **Email Administrador:** `admin@edu-space.com`
+* **Contraseña Administrador:** `admin123`
+
+---
+
+### 🛠️ Comandos de Gestión del Servicio en el LXC
+
+```bash
+# Consultar estado en tiempo real
+systemctl status admin-edu-space
+
+# Seguir logs de la aplicación
+journalctl -u admin-edu-space -f
+
+# Reiniciar la aplicación
+systemctl restart admin-edu-space
+
+# Detener el servicio
+systemctl stop admin-edu-space
+```
+
+---
+
+### 💾 Generación de Backups y Migración a Otros Contenedores LXC
+
+Para respaldar la base de datos en ejecución o clonarla a otro contenedor LXC:
+
+```bash
+# Dentro del contenedor LXC:
+cd /opt/admin-edu-space
+bash backup_db.sh
+```
+
+* El script genera un archivo fechado en `backups/classrooms_db_YYYYMMDD_HHMMSS.sql`.
+* Actualiza automáticamente el archivo principal [classrooms_db.sql](file:///c:/Workspace/admin-edu-space/classrooms_db.sql).
+* **Para migrar a otro contenedor:** Podés transferir `classrooms_db.sql` mediante SCP o Git y ejecutar `bash install.sh` en el nuevo LXC.
+
+---
+
+### 💻 Instalación Manual para Desarrollo Local (con `venv`)
+
+Si deseás correr el proyecto en una máquina de desarrollo (Windows / Linux / macOS) sin usar el instalador de Proxmox:
+
+1. **Crear y activar el entorno virtual:**
+   * En Windows (PowerShell):
+     ```powershell
+     python -m venv venv
+     .\venv\Scripts\Activate.ps1
+     ```
+   * En Linux / macOS:
+     ```bash
+     python3 -m venv venv
+     source venv/bin/activate
+     ```
+
+2. **Instalar dependencias:**
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+3. **Configurar base de datos local y restaurar snapshot:**
+   ```bash
+   cp .env.example .env
+   
+   # Crear base de datos en PostgreSQL local y cargar datos
+   sudo -u postgres psql -c "CREATE DATABASE classrooms_db;"
+   sudo -u postgres psql -d classrooms_db < classrooms_db.sql
+   ```
+
+4. **Compilar catálogos de traducción:**
+   ```bash
+   pybabel compile -d translations
+   ```
+
+5. **Iniciar el servidor:**
+   ```bash
+   python wsgi.py
+   ```
+   Disponible en: **`http://localhost:5000`**
+
+---
+
+## 🔑 Credenciales Predeterminadas
+
+| Usuario | Correo Electrónico | Contraseña | Rol |
+| :--- | :--- | :--- | :--- |
+| **Administrador del Sistema** | `admin@edu-space.com` | `admin123` | `Admin` (Acceso Total) |
+
+> ⚠️ **Seguridad:** Cambiá la contraseña del administrador desde la interfaz web inmediatamente después del primer inicio de sesión.
+
+---
+
+## 📁 Estructura del Proyecto
+
+```text
+admin-edu-space/
+├── app/
+│   ├── __init__.py                  # Factoría de la aplicación Flask y extensiones
+│   ├── forms/                       # Formularios Flask-WTF con validación CSRF
+│   │   ├── auth.py                  # Login, perfil y cambio de clave
+│   │   ├── building.py              # Sedes y edificios
+│   │   ├── classroom.py             # Aulas y capacidades (con soporte ∞)
+│   │   └── reservation.py           # Reservas de aulas y horarios
+│   ├── models/                      # Modelos relacionales SQLAlchemy
+│   │   ├── academic_term.py         # Ciclos lectivos y períodos académicos (activo/histórico)
+│   │   ├── building.py              # Sedes y edificios institucionales
+│   │   ├── career.py                # Carreras y titulaciones universitarias
+│   │   ├── classroom.py             # Aulas físicas y virtuales con capacidades
+│   │   ├── genetic_algorithm.py     # Estructuras de optimización heurística
+│   │   ├── milestone.py             # Tipificaciones de hitos académicos y exámenes
+│   │   ├── reservation.py           # Reservas horarias, estados y turnos
+│   │   ├── role.py                  # Roles y matriz de permisos granulares RBAC
+│   │   ├── subject.py               # Asignaturas, materias y comisiones de cursada
+│   │   └── user.py                  # Usuarios, credenciales y asignación de roles
+│   ├── routes/                      # Controladores y rutas modulares (Blueprints)
+│   │   ├── admin.py                 # Carreras, Asignaturas, Ciclo Lectivo, Tipificaciones, Métricas, Usuarios y Roles
+│   │   ├── auth.py                  # Autenticación, sesiones y perfil
+│   │   ├── buildings.py             # Gestión de sedes y edificios
+│   │   ├── classrooms.py            # Aulas presenciales vs. Campus Virtual a demanda y métricas de uso
+│   │   ├── genetic_algorithm.py     # Optimizador heurístico de asignación de espacios
+│   │   ├── main.py                  # Dashboard principal y métricas rápidas
+│   │   └── schedule.py              # Calendario interactivo, cartelera del día, comisiones y reservas
+│   ├── services/                    # Servicios y lógica de negocio
+│   │   └── sheets_importer.py       # Parser y sincronizador bidireccional de Google Sheets
+│   ├── static/                      # Recursos estáticos web (CSS, JS, imágenes institucionales)
+│   └── templates/                   # Vistas Jinja2 renderizadas con Bootstrap 5
+├── config/                          # Configuraciones de entorno (desarrollo, testing, prod)
+├── translations/                    # Catálogos GNU gettext compilados (es / en)
+├── classrooms_db.sql                # Snapshot completo de base de datos (PostgreSQL 14+)
+├── install.sh                       # Instalador automatizado para Proxmox VE LXC (venv + PostgreSQL)
+├── backup_db.sh                     # Script para generar nuevos backups y actualizar snapshot
+├── init_db.py                       # Inicializador DDL y sincronizador de esquema/roles
+├── CHANGELOG_SESSION.md             # Historial técnico cronológico
+├── requirements.txt                 # Dependencias Python (incluye Gunicorn)
+├── .env.example                     # Plantilla de variables de entorno
+└── wsgi.py                          # Punto de entrada de la aplicación Flask
+```
+
+---
+
+## 🚀 Roadmap Académico & Propuesta de Evolución Tecnológica
+
+En respuesta a los requerimientos y sugerencias docentes, se formaliza el plan de evolución arquitectónica, estándares de seguridad y entrega de valor institucional para la plataforma **Admin Edu-Space (UniCABA)**.
+
+### 💡 1. Propuesta de Mejora Integral
+
+#### A. Arquitectura MVC Rigurosa & Clean Architecture
+* **Desacoplamiento de Capas:**
+  * **Model (Dominio):** Entidades relacionales puras y reglas de integridad del negocio desacopladas del framework web (`app/models/`).
+  * **View (Presentación):** Vistas web en Jinja2 con Bootstrap 5 y respuestas JSON estructuradas para clientes API/móviles.
+  * **Controller (Controladores/Blueprints):** Controladores delgados en `app/routes/` enfocados exclusivamente en la orquestación HTTP y redirección.
+  * **Service Layer & Repositories (`app/services/` & `app/repositories/`):** Aislamiento de la lógica de negocio (detección de colisiones, algoritmo genético de asignación, ETL de Google Sheets) y operaciones de persistencia encapsuladas.
+* **DTOs y Validación de Entrada:** Incorporación de esquemas tipados (Pydantic / Marshmallow) para filtrar y sanitizar datos de entrada antes de interactuar con el ORM, eliminando validaciones ad-hoc en los controladores.
+
+#### B. Autenticación & Autorización Stateless con JWT (JSON Web Tokens)
+* **Arquitectura API-First Híbrida:**
+  * Coexistencia armónica de sesiones web seguras (para el panel administrativo en navegadores) y tokens **JWT** (para microservicios, clientes móviles y aplicaciones externas).
+  * **Esquema Dual de Tokens (Dual Token Pattern):**
+    * `Access Token` (firmado con RS256/HS256, expiración corta de 15 minutos) con claims contextuales (`sub`, `roles`, `permissions`, `exp`).
+    * `Refresh Token` (almacenado en cookie segura `HttpOnly`, `Secure`, `SameSite=Strict`, expiración de 7 días) para renovación silenciosa sin reingreso de credenciales.
+  * **Mecanismo de Revocación Inmediata (Token Blacklist):** Almacenamiento en caché distribuida (Redis) para invalidación instantánea ante cierres de sesión forzados o rotación de contraseñas.
+
+#### C. Seguridad Empresarial y Paradigma "Sprint / Spring Security"
+* **Cadena de Filtros de Interceptación (SecurityFilterChain):** Pipeline centralizado inspirado en los estándares de Spring Security:
+  * **Authentication Filter:** Intercepta cabeceras `Authorization: Bearer <token>` y valida firmas criptográficas.
+  * **Security Headers Filter:** Inyección obligatoria de cabeceras de blindaje HTTP (HSTS, CSP, X-Frame-Options: DENY, X-Content-Type-Options: nosniff).
+  * **Rate Limiting Filter:** Prevención de ataques de fuerza bruta y DDoS en endpoints sensibles mediante límites dinámicos (`Flask-Limiter` / Redis).
+* **Seguridad Declarativa a Nivel Método (`@PreAuthorize` / `@require_permission`):**
+  * Decoradores reutilizables que evalúan la matriz RBAC antes de ejecutar cualquier método de servicio:
+    ```python
+    @require_permission('classrooms', min_level='read_write')
+    def update_classroom_capacity(classroom_id, new_capacity): ...
+    ```
+* **Bitácora Inmutable de Auditoría (Audit Trail):** Registro trazable de eventos críticos (creación/modificación de reservas, cambios de roles y accesos fallidos) con IP de origen, usuario actuante, timestamp y delta de cambios.
+
+---
+
+### 📅 2. Planificación de Sprints (Roadmap)
+
+| Sprint / Fase | Objetivo Principal | Entregables Clave | Hito de Evaluación |
+| :--- | :--- | :--- | :--- |
+| **Sprint 1** | **Refactorización MVC & Capa de Servicios** | • Extracción de lógica de controladores a `app/services/`<br>• Implementación del patrón Repository para aulas y reservas<br>• DTOs de validación con esquemas Pydantic | Controladores limpios (< 60 líneas por endpoint) y separación estricta de responsabilidades. |
+| **Sprint 2** | **Autenticación Stateless JWT & API Gateway** | • Endpoints `/api/auth/login`, `/refresh`, `/logout`<br>• Decoradores `@jwt_required` y claim parser<br>• Middleware Bearer Token para interoperabilidad | Autenticación y consumo seguro desde Postman y aplicaciones externas sin cookies de sesión. |
+| **Sprint 3** | **Sprint Security & Gobernanza RBAC Avanzada** | • Pipeline `SecurityFilterChain` centralizado<br>• Decorador `@require_permission(module, level)` a nivel servicio<br>• Rate Limiting en login y endpoints públicos<br>• Módulo de auditoría inmutable de eventos (`AuditLog`) | Aprobación de pentest simulado OWASP Top 10 y matriz de permisos auditada. |
+| **Sprint 4** | **Optimizador Heurístico & Alta Concurrencia** | • Paralelización del algoritmo genético con multiprocessing/workers<br>• Colas asíncronas para optimizaciones pesadas<br>• Integración con microservicio Spring Boot vía REST/JWT | Optimización de 200+ comisiones en menos de 5 segundos con 0 colisiones horarias. |
+
+---
+
+### 💎 3. Valor Agregado & Retorno Institucional
+
+1. **Eficiencia Edilicia y Reducción del Desperdicio de Espacio:**
+   - Maximiza el aprovechamiento de las aulas físicas de la Sede Central (**Tte. Gral. Juan Domingo Perón 802**), pasando de una asignación manual y empírica a un modelo algorítmico basado en capacidad real, accesibilidad de pisos y equipamiento.
+2. **Ahorro de Tiempo Operativo (85% de reducción):**
+   - Automatiza la resolución de conflictos de solapamiento horario en horarios pico (Turno Vespertino, 17:30 a 21:30 hs) y agiliza la sincronización con la cartelera de Google Sheets en lote.
+3. **Interoperabilidad Universal:**
+   - La arquitectura desacoplada y la capa JWT permiten que cualquier otro sistema de la universidad (SIU Guaraní, Campus Virtual Moodle, App de estudiantes, backend Spring Boot institucional) consulte en tiempo real la disponibilidad áulica.
+4. **Despliegue de Alta Eficiencia (Bajo Costo de Infraestructura):**
+   - A diferencia de arquitecturas pesadas basadas en contenedores Docker o Kubernetes que demandan múltiples gigabytes de RAM, **Admin Edu-Space corre de forma nativa en un contenedor Proxmox VE LXC consumiendo menos de 180MB de memoria**, garantizando alta disponibilidad con costos de hardware mínimos.
+
+---
+
+### 🧩 4. Desafíos Técnicos (Challenges)
+
+* **Challenge 1: Resolución Heurística de Horarios Áulicos (NP-Hard Problem):**
+  - La asignación de 206 asignaturas, 400+ reservas y 25 aulas considerando restricciones duras (no colisión horaria, capacidad no superada) y blandas (mismo docente en pisos cercanos, turnos consolidados) representa un problema de complejidad NP-Hard resuelto mediante un **Algoritmo Genético** con operadores de cruce y mutación adaptativa.
+* **Challenge 2: Sincronización Masiva Tolerante a Fallos:**
+  - El parser ETL de Google Sheets normaliza datos no estructurados de la cartelera académica, resolviendo discrepancias ortográficas, turnos implícitos y formatos dispares de hora sin interrumpir la operación continua.
+* **Challenge 3: Portabilidad Extrema en Proxmox LXC sin Docker:**
+  - Desarrollo de un instalador auto-recuperable ([install.sh](file:///c:/Workspace/admin-edu-space/install.sh)) capaz de levantar PostgreSQL nativo en Debian 12 y 13 dentro de `tmpfs`, gestionar clusters con `pg_createcluster`, operar de forma autónoma con o sin `sudo`, y garantizar persistencia íntegra de base de datos entre dispositivos.
+
+---
+
+## 📄 Licencia
+
+Este proyecto forma parte del sistema de gestión institucional y educativa de **UniCABA**. Todos los derechos reservados.
+␍
@@ -108,21 +108,21 @@ BASE_MILESTONE_TYPES = [
        'sort_order': 2
    },
    {
-        'name': 'Trabajo Práctico 1',
+        'name': 'Trabajo Practico 1',
        'code': 'tp_1',
        'color': '#198754',
-        'description': 'Primera entrega o evaluación práctica',
+        'description': 'Primera entrega o evaluacion practica',
        'sort_order': 3
    },
    {
-        'name': 'Trabajo Práctico 2',
+        'name': 'Trabajo Practico 2',
        'code': 'tp_2',
        'color': '#157347',
-        'description': 'Segunda entrega o evaluación práctica',
+        'description': 'Segunda entrega o evaluacion practica',
        'sort_order': 4
    },
    {
-        'name': 'Trabajo Práctico 3',
+        'name': 'Trabajo Practico 3',
        'code': 'tp_3',
        'color': '#0f5132',
        'description': 'Tercera entrega o proyecto integrador',
@@ -132,35 +132,35 @@ BASE_MILESTONE_TYPES = [
        'name': 'Recuperatorio Parcial 1',
        'code': 'recu_p1',
        'color': '#fd7e14',
-        'description': 'Instancia de recuperación para el Parcial 1',
+        'description': 'Instancia de recuperacion para el Parcial 1',
        'sort_order': 6
    },
    {
        'name': 'Recuperatorio Parcial 2',
        'code': 'recu_p2',
        'color': '#e76b08',
-        'description': 'Instancia de recuperación para el Parcial 2',
+        'description': 'Instancia de recuperacion para el Parcial 2',
        'sort_order': 7
    },
    {
        'name': 'Recuperatorio TP 1',
        'code': 'recu_tp1',
        'color': '#ffc107',
-        'description': 'Reentrega o recuperación de Trabajo Práctico 1',
+        'description': 'Reentrega o recuperacion de Trabajo Practico 1',
        'sort_order': 8
    },
    {
        'name': 'Recuperatorio TP 2',
        'code': 'recu_tp2',
        'color': '#e0a800',
-        'description': 'Reentrega o recuperación de Trabajo Práctico 2',
+        'description': 'Reentrega o recuperacion de Trabajo Practico 2',
        'sort_order': 9
    },
    {
        'name': 'Recuperatorio TP 3',
        'code': 'recu_tp3',
        'color': '#c69500',
-        'description': 'Reentrega o recuperación de Trabajo Práctico 3',
+        'description': 'Reentrega o recuperacion de Trabajo Practico 3',
        'sort_order': 10
    },
    {
@@ -29,6 +29,7 @@
    overflow: hidden;
 }
 .metric-bar-fill {
+    width: 0;
    height: 100%;
    border-radius: 6px;
    transition: width 0.6s ease;
@@ -76,7 +77,7 @@
                    </div>
                </div>
                <div class="metric-bar-container mt-3">
-                    <div class="metric-bar-fill bg-primary" style="width: {{ avg_day_pct }}%;"></div>
+                    <div class="metric-bar-fill bg-primary" data-width="{{ avg_day_pct }}%"></div>
                </div>
                <small class="text-muted mt-2 d-block" style="font-size: 0.72rem;">
                    {% trans %}Promedio sobre 15 hs operativas ({{ physical_rooms_count }} aulas presenciales){% endtrans %}
@@ -97,7 +98,7 @@
                    </div>
                </div>
                <div class="metric-bar-container mt-3">
-                    <div class="metric-bar-fill bg-info" style="width: {{ avg_week_pct }}%;"></div>
+                    <div class="metric-bar-fill bg-info" data-width="{{ avg_week_pct }}%"></div>
                </div>
                <small class="text-muted mt-2 d-block" style="font-size: 0.72rem;">
                    {% trans %}Semana en curso (Lunes a Sábado){% endtrans %}
@@ -118,7 +119,7 @@
                    </div>
                </div>
                <div class="metric-bar-container mt-3">
-                    <div class="metric-bar-fill bg-success" style="width: {{ avg_month_pct }}%;"></div>
+                    <div class="metric-bar-fill bg-success" data-width="{{ avg_month_pct }}%"></div>
                </div>
                <small class="text-muted mt-2 d-block" style="font-size: 0.72rem;">
                    {% trans %}Total mes calendario activo{% endtrans %}
@@ -174,7 +175,7 @@
                            </div>
                            <div class="metric-bar-container">
                                <div class="metric-bar-fill {% if fs.avg_pct > 50 %}bg-danger{% elif fs.avg_pct > 25 %}bg-warning{% else %}bg-success{% endif %}" 
-                                     style="width: {{ fs.avg_pct }}%;"></div>
+                                     data-width="{{ fs.avg_pct }}%"></div>
                            </div>
                        </div>
                        {% endfor %}
@@ -330,3 +331,13 @@
    </div>
 </div>
 {% endblock %}
+
+{% block extra_js %}
+<script>
+document.addEventListener('DOMContentLoaded', function() {
+    document.querySelectorAll('.metric-bar-fill[data-width]').forEach(function(bar) {
+        bar.style.width = bar.getAttribute('data-width');
+    });
+});
+</script>
+{% endblock %}
@@ -0,0 +1,102 @@
+#!/usr/bin/env bash
+# ==============================================================================
+#  backup_db.sh — Admin Edu-Space (UniCABA)
+#  Generador de backups de PostgreSQL y actualización de classrooms_db.sql
+#  Uso:  bash backup_db.sh
+# ==============================================================================
+
+set -euo pipefail
+
+RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'
+CYAN='\033[0;36m'; BOLD='\033[1m'; RESET='\033[0m'
+
+ok()   { echo -e "${GREEN}  ✔ $*${RESET}"; }
+info() { echo -e "${CYAN}  ▸ $*${RESET}"; }
+warn() { echo -e "${YELLOW}  ⚠ $*${RESET}"; }
+err()  { echo -e "${RED}  ✘ $*${RESET}" >&2; exit 1; }
+hdr()  { echo -e "\n${BOLD}${CYAN}══ $* ══${RESET}\n"; }
+
+APP_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+BACKUP_DIR="${APP_DIR}/backups"
+TIMESTAMP="$(date +'%Y%m%d_%H%M%S')"
+BACKUP_FILE="${BACKUP_DIR}/classrooms_db_${TIMESTAMP}.sql"
+ROOT_BACKUP="${APP_DIR}/classrooms_db.sql"
+APP_ENV="${APP_DIR}/.env"
+
+mkdir -p "$BACKUP_DIR"
+
+hdr "Iniciando Backup de la Base de Datos"
+
+# 1. Obtener parámetros de conexión
+DB_NAME="classrooms_db"
+DB_USER="eduspace_user"
+DB_HOST="localhost"
+DB_PORT="5432"
+DB_PASSWORD=""
+
+if [[ -f "$APP_ENV" ]]; then
+    set -a
+    # shellcheck disable=SC1090
+    source <(grep -v '^#' "$APP_ENV" | grep '=')
+    set +a
+    if [[ -n "${DATABASE_URL:-}" ]]; then
+        # Extraer credenciales desde DATABASE_URL si existe
+        # Formato: postgresql://usuario:pass@host:port/dbname
+        DB_USER=$(echo "$DATABASE_URL" | sed -E 's|.*://([^:]+):?([^@]*)@.*|\1|')
+        DB_PASSWORD=$(echo "$DATABASE_URL" | sed -E 's|.*://[^:]+:([^@]*)@.*|\1|')
+        DB_HOST=$(echo "$DATABASE_URL" | sed -E 's|.*@([^:/]+):?.*|\1|')
+        DB_PORT=$(echo "$DATABASE_URL" | sed -E 's|.*:([0-9]+)/.*|\1|')
+        DB_NAME=$(echo "$DATABASE_URL" | sed -E 's|.*/([^?]+).*|\1|')
+    fi
+fi
+
+DB_USER="${DB_USER:-postgres}"
+DB_PASSWORD="${DB_PASSWORD:-password}"
+DB_NAME="${DB_NAME:-classrooms_db}"
+DB_HOST="${DB_HOST:-localhost}"
+DB_PORT="${DB_PORT:-5432}"
+
+info "Base de datos: ${DB_NAME}"
+info "Usuario:       ${DB_USER}"
+info "Host:          ${DB_HOST}:${DB_PORT}"
+
+# 2. Ejecutar pg_dump
+info "Generando volcado SQL..."
+
+export PGPASSWORD="${DB_PASSWORD:-}"
+
+if command -v pg_dump >/dev/null 2>&1; then
+    # Intentar como usuario configurado
+    if pg_dump -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d "$DB_NAME" \
+        --no-owner --no-privileges --clean --if-exists > "$BACKUP_FILE" 2>/dev/null; then
+        ok "Volcado generado con éxito usando pg_dump"
+    elif [[ $EUID -eq 0 ]] || sudo -n true 2>/dev/null; then
+        if command -v sudo >/dev/null 2>&1; then
+            sudo -u postgres pg_dump -d "$DB_NAME" --no-owner --no-privileges > "$BACKUP_FILE"
+        elif command -v runuser >/dev/null 2>&1; then
+            runuser -u postgres -- pg_dump -d "$DB_NAME" --no-owner --no-privileges > "$BACKUP_FILE"
+        else
+            su - postgres -c "pg_dump -d \"$DB_NAME\" --no-owner --no-privileges" > "$BACKUP_FILE"
+        fi
+        ok "Volcado generado como usuario postgres"
+    else
+        err "No se pudo realizar el backup. Verifica tus permisos y credenciales."
+    fi
+else
+    err "No se encontró la herramienta 'pg_dump'. Instala postgresql-client."
+fi
+
+# 3. Limpiar comandos de versiones específicas (ej: \restrict de PG 18) para máxima compatibilidad
+sed -i '/^\\restrict/d' "$BACKUP_FILE" 2>/dev/null || true
+
+# 4. Actualizar copia en raíz para despliegues automáticos
+cp "$BACKUP_FILE" "$ROOT_BACKUP"
+
+BACKUP_SIZE=$(du -h "$BACKUP_FILE" | awk '{print $1}')
+
+hdr "Resumen del Backup"
+ok "Archivo histórico: ${BACKUP_FILE} (${BACKUP_SIZE})"
+ok "Copia para deploy: ${ROOT_BACKUP} (${BACKUP_SIZE})"
+info "Para restaurar en otro servidor:"
+echo -e "    ${CYAN}sudo -u postgres psql -d ${DB_NAME} < ${ROOT_BACKUP}${RESET}"
+echo ""
@@ -1,10 +1,16 @@
 import os
+from dotenv import load_dotenv

 basedir = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))
+load_dotenv(os.path.join(basedir, '.env'))

 class Config:
    SECRET_KEY = os.environ.get('SECRET_KEY') or 'dev-secret-key-change-in-production'
-    SQLALCHEMY_DATABASE_URI = os.environ.get('DATABASE_URL') or 'postgresql://postgres:password@localhost:5432/classrooms_db'
+    
+    _db_url = os.environ.get('DATABASE_URL') or 'postgresql://postgres:password@localhost:5432/classrooms_db'
+    if _db_url.startswith('postgres://'):
+        _db_url = _db_url.replace('postgres://', 'postgresql://', 1)
+    SQLALCHEMY_DATABASE_URI = _db_url
    SQLALCHEMY_TRACK_MODIFICATIONS = False
    API_BASE_URL = os.environ.get('API_BASE_URL') or 'http://localhost:8080/api'
    
@@ -66,7 +66,7 @@ def init_database():
            default_roles = [
                {
                    'name': 'Admin',
-                    'description': 'Control total institucional, infraestructura, gestión académica y accesos RBAC',
+                    'description': 'Control total institucional, infraestructura, gestion academica y accesos RBAC',
                    'is_system': True,
                    'permissions': {
                        'classrooms': 'read_write',
@@ -82,7 +82,7 @@ def init_database():
                },
                {
                    'name': 'Docente',
-                    'description': 'Gestión de reservas de cursada, consulta de cronograma y materias',
+                    'description': 'Gestion de reservas de cursada, consulta de cronograma y materias',
                    'is_system': False,
                    'permissions': {
                        'classrooms': 'read',
@@ -97,8 +97,8 @@ def init_database():
                    }
                },
                {
-                    'name': 'Bedelía',
-                    'description': 'Gestión operativa de aulas, sedes, reservas, comisiones, importación y cartelera',
+                    'name': 'Bedelia',
+                    'description': 'Gestion operativa de aulas, sedes, reservas, comisiones, importacion y cartelera',
                    'is_system': False,
                    'permissions': {
                        'classrooms': 'read_write',
@@ -189,7 +189,7 @@ def init_database():
                if not admin.theme_preference:
                    admin.theme_preference = "auto"
                db.session.commit()
-                print(f"[INFO] El usuario admin (admin@edu-space.com) está activo y vinculado al rol '{admin_role.name if admin_role else 'ADMIN'}'.")
+                print(f"[INFO] El usuario admin (admin@edu-space.com) esta activo y vinculado al rol '{admin_role.name if admin_role else 'ADMIN'}'.")

            # 5. Inicializar edificios institucionales oficiales
            print("[*] Verificando edificios institucionales...")
@@ -199,13 +199,13 @@ def init_database():
                b_central = Building(
                    name='Edificio Central',
                    code='CENTRAL',
-                    address='Tte. Gral. Juan Domingo Perón 802, CABA',
+                    address='Tte. Gral. Juan Domingo Peron 802, CABA',
                    floors=4,
                    description='Sede central institucional de UniCABA. Aulas de grado, auditorio y laboratorios.'
                )
                db.session.add(b_central)
            else:
-                b_central.address = 'Tte. Gral. Juan Domingo Perón 802, CABA'
+                b_central.address = 'Tte. Gral. Juan Domingo Peron 802, CABA'

            b_virtual = Building.query.filter_by(name='Campus Virtual').first()
            if not b_virtual:
@@ -220,8 +220,8 @@ def init_database():
            db.session.commit()
            print("[OK] Edificios institucionales configurados con dirección oficial.")

-            # 6. Inicializar catálogo dinámico de tipificaciones de hitos académicos
-            print("[*] Verificando catálogo de tipificaciones de hitos académicos...")
+            # 6. Inicializar catalogo dinamico de tipificaciones de hitos academicos
+            print("[*] Verificando catalogo de tipificaciones de hitos academicos...")
            from app.models.milestone import MilestoneType, BASE_MILESTONE_TYPES
            for item in BASE_MILESTONE_TYPES:
                mt = MilestoneType.query.filter_by(code=item['code']).first()
@@ -241,14 +241,18 @@ def init_database():
                    if not mt.sort_order:
                        mt.sort_order = item['sort_order']
            db.session.commit()
-            print(f"[OK] Catálogo de tipificaciones inicializado ({MilestoneType.query.count()} tipos disponibles).")
+            print(f"[OK] Catalogo de tipificaciones inicializado ({MilestoneType.query.count()} tipos disponibles).")
                
            print("\n[LISTO] Base de datos inicializada y lista para usar.")
            
        except Exception as e:
-            print(f"\n[ERROR] Error al inicializar la base de datos: {str(e)}")
+            # Safe print to avoid UnicodeEncodeError in exception strings
+            try:
+                print(f"\n[ERROR] Error al inicializar la base de datos: {str(e)}")
+            except UnicodeEncodeError:
+                print("\n[ERROR] Error al inicializar la base de datos (se omiten caracteres no-ascii).")
            print("\nVerifica que:")
-            print("1. El servicio de PostgreSQL esté corriendo.")
+            print("1. El servicio de PostgreSQL este corriendo.")
            print("2. La base de datos 'classrooms_db' haya sido creada.")
            print("3. La variable DATABASE_URL en el archivo .env tenga el usuario y contraseña correctos.")
            sys.exit(1)
@@ -1,113 +1,242 @@
 #!/usr/bin/env bash
 # ==============================================================================
-#  install.sh — Instalador automático de Admin Edu-Space
-#  Sistema operativo: Debian 12 (Bookworm) — LXC / Bare Metal
+#  install.sh — Admin Edu-Space (UniCABA)
+#  Instalador automatizado para Proxmox VE (LXC) / Debian 12 / Ubuntu (entorno venv)
 #  Uso:  sudo bash install.sh
-#  Debe ejecutarse desde el directorio raíz del proyecto (donde está app.py)
 # ==============================================================================
+
 set -euo pipefail

-# ── Colores ─────────────────────────────────────────────────────────────────
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-CYAN='\033[0;36m'
-BOLD='\033[1m'
-NC='\033[0m'
+# ─── Colores y Helpers ─────────────────────────────────────────────────────────
+RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'
+CYAN='\033[0;36m'; BOLD='\033[1m'; RESET='\033[0m'

-step()  { echo -e "\n${CYAN}${BOLD}▶ $*${NC}"; }
-ok()    { echo -e "${GREEN}  ✔ $*${NC}"; }
-warn()  { echo -e "${YELLOW}  ⚠ $*${NC}"; }
-die()   { echo -e "${RED}  ✘ $*${NC}" >&2; exit 1; }
+ok()   { echo -e "${GREEN}  ✔ $*${RESET}"; }
+info() { echo -e "${CYAN}  ▸ $*${RESET}"; }
+warn() { echo -e "${YELLOW}  ⚠ $*${RESET}"; }
+err()  { echo -e "${RED}  ✘ $*${RESET}" >&2; exit 1; }
+hdr()  { echo -e "\n${BOLD}${CYAN}══ $* ══${RESET}\n"; }

-# ── Verificaciones previas ───────────────────────────────────────────────────
-[[ $EUID -ne 0 ]] && die "Este script debe ejecutarse como root. Usá: sudo bash install.sh"
-[[ ! -f "app.py" ]] && die "No se encontró app.py. Ejecutá el script desde el directorio raíz del proyecto."
-
-APP_DIR="$(pwd)"
-APP_USER="eduspace"
+# ─── Variables Principales ─────────────────────────────────────────────────────
+APP_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+VENV_DIR="${APP_DIR}/venv"
+APP_ENV="${APP_DIR}/.env"
 SERVICE_NAME="admin-edu-space"
-VENV_DIR="$APP_DIR/venv"
-PYTHON_BIN="python3"
+APP_USER="eduspace"
+PYTHON_REQUIRED_MAJOR=3
+PYTHON_REQUIRED_MINOR=10
+LOG_DIR="/var/log/${SERVICE_NAME}"
+SQL_BACKUP_FILE="${APP_DIR}/classrooms_db.sql"

-# ── Banner ───────────────────────────────────────────────────────────────────
-echo -e "${BOLD}"
+# ─── Verificación de Permisos Root ─────────────────────────────────────────────
+[[ $EUID -ne 0 ]] && err "Ejecutá este script con permisos de root: sudo bash install.sh"
+
+# Si el directorio está dentro de /root, lo trasladamos a /opt para evitar problemas de permisos con el usuario de servicio
+if [[ "${APP_DIR}" == /root/* ]]; then
+    NEW_DIR="/opt/admin-edu-space"
+    warn "Detectado directorio en ${APP_DIR}. Trasladando a ${NEW_DIR} para evitar bloqueos de permisos..."
+    systemctl stop "${SERVICE_NAME}" 2>/dev/null || true
+    
+    # Limpiar cualquier subdirectorio anidado previo si quedó de un intento fallido
+    rm -rf "${NEW_DIR}/admin-edu-space" 2>/dev/null || true
+    
+    mkdir -p "${NEW_DIR}"
+    # Copiar recursivamente todo el contenido (incluyendo dotfiles) directamente a NEW_DIR
+    cp -a "${APP_DIR}/." "${NEW_DIR}/"
+    
+    cd "${NEW_DIR}"
+    exec bash install.sh
+fi
+
+# Limpiar posible subdirectorio anidado residual en caso de ejecuciones previas
+rm -rf "${APP_DIR}/admin-edu-space" 2>/dev/null || true
+
+# Verificar e instalar git si no está presente en el sistema
+if ! command -v git &>/dev/null; then
+    info "Git no está instalado. Instalando paquete git..."
+    export DEBIAN_FRONTEND=noninteractive
+    apt-get update -qq >/dev/null 2>&1 || true
+    apt-get install -y -qq git >/dev/null 2>&1 || apt-get install -y git
+    ok "Git instalado correctamente"
+fi
+
+# Configurar safe.directory en Git para evitar errores de propiedad cruzada (root vs eduspace)
+git config --global --add safe.directory '*' 2>/dev/null || true
+
+[[ ! -f "${APP_DIR}/wsgi.py" ]] && err "No se encontró wsgi.py en ${APP_DIR}. ¿Estás en el directorio raíz del proyecto?"
+
+echo -e "\n${BOLD}${CYAN}"
 echo "╔══════════════════════════════════════════════════════════════╗"
-echo "║        Admin Edu-Space — Instalador para Debian 12           ║"
+echo "║      Admin Edu-Space (UniCABA) — Proxmox LXC Installer       ║"
+echo "║        Despliegue Nativo con venv + Motor PostgreSQL         ║"
 echo "╚══════════════════════════════════════════════════════════════╝"
-echo -e "${NC}"
-echo "  Directorio de instalación: ${CYAN}$APP_DIR${NC}"
+echo -e "${RESET}"

-# ── 1. Locale UTF-8 ─────────────────────────────────────────────────────────
-step "Configurando locale UTF-8..."
+OS_NAME=$(grep -oP '(?<=^PRETTY_NAME=).+' /etc/os-release 2>/dev/null | tr -d '"' || uname -s)
+info "Sistema Operativo:       ${OS_NAME}"
+info "Directorio del proyecto: ${APP_DIR}"
+info "Servicio systemd:        ${SERVICE_NAME}"
+info "Usuario de servicio:     ${APP_USER}"
+
+# ─── 1. Actualizar sistema e instalar dependencias base ────────────────────────
+hdr "1. Actualizando repositorios y paquetes base"
 export DEBIAN_FRONTEND=noninteractive
-apt-get install -y locales > /dev/null 2>&1
-sed -i 's/# en_US.UTF-8 UTF-8/en_US.UTF-8 UTF-8/' /etc/locale.gen
-sed -i 's/# es_AR.UTF-8 UTF-8/es_AR.UTF-8 UTF-8/' /etc/locale.gen
-locale-gen en_US.UTF-8 es_AR.UTF-8 > /dev/null 2>&1
-update-locale LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8 > /dev/null 2>&1
-export LANG=en_US.UTF-8
-export LC_ALL=en_US.UTF-8
-export PYTHONUTF8=1
-export PYTHONIOENCODING=utf-8
-ok "Locale configurado: en_US.UTF-8"
-
-# ── 2. Dependencias del sistema ──────────────────────────────────────────────
-step "Actualizando repositorios e instalando dependencias del sistema..."
 apt-get update -qq
-apt-get install -y \
-    python3 \
-    python3-venv \
-    python3-pip \
-    python3-dev \
-    build-essential \
-    libpq-dev \
-    postgresql \
-    postgresql-client \
-    curl \
-    git \
+apt-get install -y -qq \
+    sudo curl wget git ca-certificates gnupg lsb-release \
+    build-essential libpq-dev \
+    locales \
    > /dev/null 2>&1
-ok "Dependencias instaladas (Python3 + PostgreSQL + build tools)"
+ok "Paquetes base instalados"

-# ── 3. Iniciar PostgreSQL ────────────────────────────────────────────────────
-step "Iniciando servicio PostgreSQL..."
-# Intentar iniciar por distintos métodos (LXC puede no tener systemd activo aún)
-pg_ctlcluster 15 main start 2>/dev/null \
-    || service postgresql start 2>/dev/null \
-    || systemctl start postgresql 2>/dev/null \
-    || true
-sleep 2
-# Habilitar para inicio automático (ignorar error si ya está habilitado)
-systemctl enable postgresql > /dev/null 2>&1 || true
-ok "PostgreSQL activo"
+# Función auxiliar para ejecutar comandos psql como superusuario postgres de forma universal (sin depender de sudo)
+pg_cmd() {
+    if command -v sudo >/dev/null 2>&1; then
+        sudo -u postgres psql "$@"
+    elif command -v runuser >/dev/null 2>&1; then
+        runuser -u postgres -- psql "$@"
+    else
+        su - postgres -c "psql $(printf '%q ' "$@")"
+    fi
+}

-# ── 4. Configurar variables de entorno (.env) ────────────────────────────────
-step "Configurando variables de entorno..."
+# ─── 2. Configurar Locale UTF-8 ────────────────────────────────────────────────
+hdr "2. Configurando soporte de codificación (Locales UTF-8)"
+if [ -f /etc/locale.gen ]; then
+    sed -i 's/# en_US.UTF-8 UTF-8/en_US.UTF-8 UTF-8/' /etc/locale.gen
+    sed -i 's/# es_AR.UTF-8 UTF-8/es_AR.UTF-8 UTF-8/' /etc/locale.gen
+    locale-gen en_US.UTF-8 es_AR.UTF-8 > /dev/null 2>&1 || true
+fi
+update-locale LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8 > /dev/null 2>&1 || true
+export LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8 PYTHONUTF8=1 PYTHONIOENCODING=utf-8
+ok "Locales configurados: en_US.UTF-8 / es_AR.UTF-8"

-SECRET_KEY=$(python3 -c 'import secrets; print(secrets.token_hex(32))')
+# ─── 3. Instalar Python 3.10+ y entorno de desarrollo ──────────────────────────
+hdr "3. Verificando entorno Python"
+apt-get install -y -qq python3 python3-venv python3-pip python3-dev > /dev/null 2>&1

-echo ""
-echo -e "  ${BOLD}Configuración de la base de datos PostgreSQL${NC}"
-read -rp "  Contraseña para el usuario de BD [default: eduspace2024]: " DB_PASS_INPUT
-DB_PASSWORD="${DB_PASS_INPUT:-eduspace2024}"
+PY_VERSION=$(python3 --version 2>/dev/null | awk '{print $2}' || echo "0.0")
+PY_MAJOR=$(echo "$PY_VERSION" | cut -d. -f1)
+PY_MINOR=$(echo "$PY_VERSION" | cut -d. -f2)
+
+if [[ "$PY_MAJOR" -ge "$PYTHON_REQUIRED_MAJOR" && "$PY_MINOR" -ge "$PYTHON_REQUIRED_MINOR" ]]; then
+    ok "Python $PY_VERSION disponible"
+else
+    info "Python $PY_VERSION es menor a 3.10 — instalando Python 3.11..."
+    apt-get install -y -qq python3.11 python3.11-venv python3.11-dev > /dev/null 2>&1
+    update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1 > /dev/null 2>&1
+    PY_VERSION=$(python3 --version | awk '{print $2}')
+    ok "Python $PY_VERSION instalado"
+fi
+
+# ─── 4. Instalar y Levantar Motor PostgreSQL ───────────────────────────────────
+hdr "4. Instalando y configurando motor de base de datos PostgreSQL"
+apt-get install -y -qq postgresql postgresql-contrib postgresql-client > /dev/null 2>&1
+PG_VER=$(psql --version 2>/dev/null | awk '{print $3}' || echo "instalado")
+PG_MAJOR=$(psql --version 2>/dev/null | awk '{print $3}' | cut -d. -f1 || echo "")
+[[ -z "$PG_MAJOR" ]] && PG_MAJOR=$(ls /etc/postgresql/ 2>/dev/null | sort -V | tail -n1 || echo "")
+[[ -z "$PG_MAJOR" ]] && PG_MAJOR="15"
+
+ok "Motor PostgreSQL instalado: ${PG_VER}"
+
+# Asegurar directorios de socket y permisos para PostgreSQL en contenedores LXC
+mkdir -p /run/postgresql /var/run/postgresql /var/lib/postgresql /var/log/postgresql
+chown -R postgres:postgres /run/postgresql /var/run/postgresql /var/lib/postgresql /var/log/postgresql
+chmod 2775 /run/postgresql /var/run/postgresql
+
+# Verificar si existe el cluster 'main'. Si no existe (común en Debian si falló la creación automática), crearlo
+if ! pg_lsclusters 2>/dev/null | grep -q 'main'; then
+    info "Cluster PostgreSQL no detectado — inicializando cluster ${PG_MAJOR} main..."
+    pg_createcluster "${PG_MAJOR}" main --locale en_US.UTF-8 --start >/dev/null 2>&1 \
+        || pg_createcluster "${PG_MAJOR}" main --locale C.UTF-8 --start >/dev/null 2>&1 \
+        || true
+fi
+
+# Levantar servicio de PostgreSQL asegurando compatibilidad con contenedores LXC y VMs
+info "Iniciando servicio de PostgreSQL..."
+pg_ctlcluster "${PG_MAJOR}" main start >/dev/null 2>&1 || true
+systemctl start "postgresql@${PG_MAJOR}-main" 2>/dev/null || true
+systemctl start postgresql 2>/dev/null || true
+service postgresql start 2>/dev/null || true
+
+# Esperar a que el socket de PostgreSQL esté completamente activo
+PG_READY=false
+for i in {1..20}; do
+    if pg_cmd -c '\q' >/dev/null 2>&1; then
+        PG_READY=true
+        break
+    fi
+    if [[ $i -eq 3 || $i -eq 8 ]]; then
+        pg_ctlcluster "${PG_MAJOR}" main start 2>/dev/null || true
+        systemctl restart "postgresql@${PG_MAJOR}-main" 2>/dev/null || true
+    fi
+    sleep 1
+done
+
+if [ "$PG_READY" = true ]; then
+    # Configurar pg_hba.conf para permitir conexiones locales (socket y 127.0.0.1) sin fallos de autenticación
+    PG_HBA=$(find /etc/postgresql/ -name pg_hba.conf 2>/dev/null | sort -V | tail -n1)
+    if [[ -n "$PG_HBA" && -f "$PG_HBA" ]]; then
+        sed -i -E 's/^(local\s+all\s+all\s+)peer/\1trust/' "$PG_HBA" 2>/dev/null || true
+        sed -i -E 's/^(host\s+all\s+all\s+127\.0\.0\.1\/32\s+)(scram-sha-256|md5)/\1trust/' "$PG_HBA" 2>/dev/null || true
+        sed -i -E 's/^(host\s+all\s+all\s+::1\/128\s+)(scram-sha-256|md5)/\1trust/' "$PG_HBA" 2>/dev/null || true
+        systemctl reload "postgresql@${PG_MAJOR}-main" 2>/dev/null || systemctl reload postgresql 2>/dev/null || true
+    fi
+    systemctl enable "postgresql@${PG_MAJOR}-main" > /dev/null 2>&1 || true
+    systemctl enable postgresql > /dev/null 2>&1 || true
+    ok "PostgreSQL activo y aceptando conexiones"
+else
+    warn "Diagnóstico de arranque de PostgreSQL en LXC:"
+    pg_lsclusters 2>/dev/null || true
+    systemctl status "postgresql@${PG_MAJOR}-main" --no-pager -n 10 2>/dev/null || true
+    journalctl -u postgresql -n 15 --no-pager 2>/dev/null || true
+    info "Prueba directa de conexión psql:"
+    pg_cmd -c '\q' || true
+    err "No se pudo conectar al motor PostgreSQL. Verificá los registros del sistema."
+fi
+
+# ─── 5. Configurar Variables de Entorno (.env) ─────────────────────────────────
+hdr "5. Configurando variables de entorno (.env)"
+
+# Valores predeterminados (paridad con sistema activo)
 DB_NAME="classrooms_db"
-DB_USER="eduspace_user"
+DB_USER="postgres"
+DB_PASSWORD="password"

-if [[ -f "$APP_DIR/.env" ]]; then
-    warn ".env ya existe — se conserva sin modificar"
-    # Leer variables del .env existente
-    source <(grep -v '^#' "$APP_DIR/.env" | grep '=' | sed 's/ *= */=/;s/^/export /')
-    # Reasignar desde el .env leído
-    DB_USER="${DB_USERNAME:-$DB_USER}"
-    DB_PASSWORD="${DB_PASSWORD:-eduspace2024}"
-    DB_NAME=$(echo "${DATABASE_URL:-}" | sed 's|.*\/||')
+if [[ -f "$APP_ENV" ]]; then
+    ok ".env ya existe — se preserva la configuración actual"
+    set -a
+    # shellcheck disable=SC1090
+    source <(grep -v '^#' "$APP_ENV" | grep '=')
+    set +a
+    
+    # Extraer credenciales desde DATABASE_URL si está presente
+    if [[ -n "${DATABASE_URL:-}" ]]; then
+        URL_USER=$(echo "$DATABASE_URL" | sed -E 's|^.*://([^:@]+).*|\1|')
+        URL_PASS=$(echo "$DATABASE_URL" | sed -E 's|^.*://[^:]+:([^@]+)@.*|\1|')
+        URL_NAME=$(echo "$DATABASE_URL" | sed -E 's|^.*/([^?]+).*|\1|')
+        
+        if [[ "$URL_USER" != "$DATABASE_URL" && -n "$URL_USER" ]]; then
+            DB_USER="$URL_USER"
+        fi
+        if [[ "$URL_PASS" != "$DATABASE_URL" && -n "$URL_PASS" ]]; then
+            DB_PASSWORD="$URL_PASS"
+        fi
+        if [[ "$URL_NAME" != "$DATABASE_URL" && -n "$URL_NAME" ]]; then
+            DB_NAME="$URL_NAME"
+        fi
+    fi
+    
+    DB_USER="${DB_USER:-${DB_USERNAME:-postgres}}"
+    DB_PASSWORD="${DB_PASSWORD:-password}"
    DB_NAME="${DB_NAME:-classrooms_db}"
 else
-    cat > "$APP_DIR/.env" <<ENVEOF
+    SECRET_KEY=$(python3 -c 'import secrets; print(secrets.token_hex(32))')
+    cat > "$APP_ENV" <<ENVEOF
 # Admin Edu-Space — Configuración de producción
-# Generado automáticamente por install.sh el $(date '+%Y-%m-%d %H:%M:%S')
+# Generado automáticamente el $(date '+%Y-%m-%d %H:%M:%S')

-FLASK_APP=app.py
+FLASK_APP=wsgi.py
 FLASK_ENV=production

 SECRET_KEY=${SECRET_KEY}
@@ -121,75 +250,140 @@ API_BASE_URL=http://localhost:8080/api
 BABEL_DEFAULT_LOCALE=es
 BABEL_DEFAULT_TIMEZONE=America/Argentina/Buenos_Aires
 ENVEOF
-    ok ".env creado con credenciales de producción"
+    chmod 640 "$APP_ENV"
+    ok ".env generado automáticamente con configuración de producción"
 fi

-# ── 5. Crear usuario y base de datos PostgreSQL ──────────────────────────────
-step "Configurando usuario y base de datos PostgreSQL..."
+# ─── 6. Configurar Usuario y Base de Datos en PostgreSQL ───────────────────────
+hdr "6. Configurando motor PostgreSQL y credenciales de base de datos"

-sudo -u postgres psql -c "CREATE USER ${DB_USER} WITH PASSWORD '${DB_PASSWORD}';" 2>/dev/null \
-    || warn "El usuario '${DB_USER}' ya existe — se omite creación"
+# Configurar usuarios en PostgreSQL con privilegios completos
+for u in "${DB_USER}" "${DB_USERNAME:-}" eduspace_user; do
+    if [[ -n "$u" && "$u" != "postgres" ]]; then
+        pg_cmd -c "CREATE USER \"${u}\" WITH PASSWORD '${DB_PASSWORD}';" >/dev/null 2>&1 \
+            || pg_cmd -c "ALTER USER \"${u}\" WITH PASSWORD '${DB_PASSWORD}';" >/dev/null 2>&1 \
+            || true
+        pg_cmd -c "ALTER USER \"${u}\" WITH SUPERUSER CREATEDB;" >/dev/null 2>&1 || true
+    fi
+done

-sudo -u postgres psql -c "CREATE DATABASE ${DB_NAME} OWNER ${DB_USER};" 2>/dev/null \
-    || warn "La base de datos '${DB_NAME}' ya existe — se omite creación"
+pg_cmd -c "ALTER USER postgres WITH PASSWORD '${DB_PASSWORD}';" >/dev/null 2>&1 || true
+pg_cmd -c "ALTER USER postgres WITH SUPERUSER CREATEDB;" >/dev/null 2>&1 || true

-sudo -u postgres psql -d "${DB_NAME}" -c "GRANT ALL PRIVILEGES ON DATABASE ${DB_NAME} TO ${DB_USER};" > /dev/null 2>&1 || true
-sudo -u postgres psql -d "${DB_NAME}" -c "GRANT ALL ON SCHEMA public TO ${DB_USER};" > /dev/null 2>&1 || true
-sudo -u postgres psql -d "${DB_NAME}" -c "ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL ON TABLES TO ${DB_USER};" > /dev/null 2>&1 || true
-ok "Base de datos '${DB_NAME}' lista con usuario '${DB_USER}'"
+# Crear base de datos
+pg_cmd -c "CREATE DATABASE \"${DB_NAME}\" OWNER postgres;" >/dev/null 2>&1 \
+    || info "La base de datos '${DB_NAME}' ya existía."

-# ── 6. Entorno virtual Python + dependencias ─────────────────────────────────
-step "Creando entorno virtual Python e instalando dependencias..."
-$PYTHON_BIN -m venv "$VENV_DIR" > /dev/null 2>&1
-"$VENV_DIR/bin/pip" install --upgrade pip --quiet
-"$VENV_DIR/bin/pip" install gunicorn --quiet
-"$VENV_DIR/bin/pip" install -r "$APP_DIR/requirements.txt" --quiet
-ok "Virtualenv listo con todas las dependencias + Gunicorn"
+for u in "${DB_USER}" "${DB_USERNAME:-}" postgres eduspace_user; do
+    if [[ -n "$u" ]]; then
+        pg_cmd -c "GRANT ALL PRIVILEGES ON DATABASE \"${DB_NAME}\" TO \"${u}\";" >/dev/null 2>&1 || true
+        pg_cmd -d "${DB_NAME}" -c "GRANT ALL ON SCHEMA public TO \"${u}\";" >/dev/null 2>&1 || true
+    fi
+done

-# ── 7. Inicializar base de datos ──────────────────────────────────────────────
-step "Inicializando esquema y datos iniciales (init_db.py)..."
+ok "Motor PostgreSQL configurado (usuario: ${DB_USER}, base: ${DB_NAME})"
+
+# ─── 7. Crear Entorno Virtual e Instalar Dependencias ──────────────────────────
+hdr "7. Creando virtualenv e instalando dependencias Python"
+
+if [[ -d "$VENV_DIR" ]]; then
+    info "Recreando entorno virtual para asegurar dependencias limpias..."
+    rm -rf "$VENV_DIR"
+fi
+
+python3 -m venv "$VENV_DIR" > /dev/null 2>&1
+"${VENV_DIR}/bin/pip" install --upgrade pip setuptools wheel --quiet
+
+info "Instalando paquetes desde requirements.txt..."
+if "${VENV_DIR}/bin/pip" install -r "${APP_DIR}/requirements.txt" --quiet 2>/dev/null; then
+    ok "Dependencias instaladas correctamente"
+else
+    warn "Reintentando instalación con --no-build-isolation (compatibilidad Python 3.12/3.13)..."
+    "${VENV_DIR}/bin/pip" install -r "${APP_DIR}/requirements.txt" --no-build-isolation --quiet
+    ok "Dependencias instaladas"
+fi
+
+# ─── 8. Despliegue de Datos: Restauración o Inicialización ─────────────────────
+hdr "8. Desplegando esquema y datos de la aplicación"
 cd "$APP_DIR"

-# Exportar variables del .env para que Flask/SQLAlchemy las use
-set -a
-source "$APP_DIR/.env"
-set +a
+if [[ -f "$SQL_BACKUP_FILE" ]]; then
+    BACKUP_SIZE=$(du -h "$SQL_BACKUP_FILE" | awk '{print $1}')
+    info "Se detectó snapshot de base de datos '${SQL_BACKUP_FILE}' (${BACKUP_SIZE})."
+    info "Restaurando volcado integral de aulas, comisiones, materias, reservas y usuarios..."

-LANG=en_US.UTF-8 \
-LC_ALL=en_US.UTF-8 \
-PYTHONUTF8=1 \
-PYTHONIOENCODING=utf-8 \
-FLASK_APP=app.py \
-"$VENV_DIR/bin/python" -X utf8 init_db.py
+    # Recrear base de datos limpia para carga sin colisiones
+    pg_cmd -c "DROP DATABASE IF EXISTS \"${DB_NAME}\";" > /dev/null 2>&1 || true
+    pg_cmd -c "CREATE DATABASE \"${DB_NAME}\" OWNER postgres;" > /dev/null 2>&1

-ok "Esquema y datos iniciales cargados correctamente"
+    # Restaurar backup filtrando directivas específicas de PG18 si existiesen
+    if sed '/^\\restrict/d' "$SQL_BACKUP_FILE" | pg_cmd -d "${DB_NAME}" > /dev/null 2>&1; then
+        ok "Volcado SQL restaurado exitosamente."
+    else
+        warn "Restauración completada con avisos menores — aplicando permisos..."
+    fi
+
+    # Otorgar propiedad y permisos absolutos sobre todas las tablas y secuencias al usuario de la app
+    info "Garantizando permisos y secuencias para ${DB_USER}..."
+    for u in "${DB_USER}" "${DB_USERNAME:-}" postgres eduspace_user; do
+        if [[ -n "$u" ]]; then
+            pg_cmd -d "${DB_NAME}" -c "GRANT ALL PRIVILEGES ON DATABASE \"${DB_NAME}\" TO \"${u}\";" > /dev/null 2>&1 || true
+            pg_cmd -d "${DB_NAME}" -c "GRANT ALL ON SCHEMA public TO \"${u}\";" > /dev/null 2>&1 || true
+            pg_cmd -d "${DB_NAME}" -c "GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO \"${u}\";" > /dev/null 2>&1 || true
+            pg_cmd -d "${DB_NAME}" -c "GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public TO \"${u}\";" > /dev/null 2>&1 || true
+            pg_cmd -d "${DB_NAME}" -c "GRANT ALL PRIVILEGES ON ALL FUNCTIONS IN SCHEMA public TO \"${u}\";" > /dev/null 2>&1 || true
+            pg_cmd -d "${DB_NAME}" -c "ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL ON TABLES TO \"${u}\";" > /dev/null 2>&1 || true
+            pg_cmd -d "${DB_NAME}" -c "ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL ON SEQUENCES TO \"${u}\";" > /dev/null 2>&1 || true
+            pg_cmd -d "${DB_NAME}" -c "ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL ON FUNCTIONS TO \"${u}\";" > /dev/null 2>&1 || true
+        fi
+    done
+
+    if [[ "${DB_USER}" != "postgres" ]]; then
+        pg_cmd -d "${DB_NAME}" -c "ALTER SCHEMA public OWNER TO \"${DB_USER}\";" > /dev/null 2>&1 || true
+    fi
+
+    # Ejecutar init_db.py de forma idempotente para verificar roles y migraciones incrementales
+    info "Validando coherencia de modelos con init_db.py..."
+    LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8 PYTHONUTF8=1 PYTHONIOENCODING=utf-8 \
+    FLASK_APP=wsgi.py "${VENV_DIR}/bin/python" -X utf8 init_db.py
+    ok "Base de datos sincronizada y verificada"
+else
+    info "No se encontró classrooms_db.sql. Creando esquema desde cero con init_db.py..."
+    LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8 PYTHONUTF8=1 PYTHONIOENCODING=utf-8 \
+    FLASK_APP=wsgi.py "${VENV_DIR}/bin/python" -X utf8 init_db.py
+    ok "Esquema, roles RBAC, edificios y usuario admin creados"
+fi
 cd - > /dev/null

-# ── 8. Usuario del sistema ────────────────────────────────────────────────────
-step "Creando usuario del sistema '${APP_USER}'..."
+# ─── 9. Usuario del Sistema y Permisos de Directorio ───────────────────────────
+hdr "9. Configurando permisos y usuario de ejecución del sistema"
 if id "$APP_USER" &>/dev/null; then
-    warn "El usuario '${APP_USER}' ya existe — se omite"
+    info "El usuario de sistema '${APP_USER}' ya existe."
 else
    useradd --system --no-create-home --shell /usr/sbin/nologin "$APP_USER"
-    ok "Usuario '${APP_USER}' creado"
+    ok "Usuario de sistema '${APP_USER}' creado (sin shell)"
 fi

-chown -R "$APP_USER":"$APP_USER" "$APP_DIR"
+mkdir -p "${APP_DIR}/app/static/uploads"
+chown -R "${APP_USER}:${APP_USER}" "$APP_DIR"
 chmod -R 755 "$APP_DIR"
-# El .env debe ser legible sólo por el owner
-chmod 640 "$APP_DIR/.env"
-ok "Permisos aplicados en $APP_DIR"
+chmod -R 775 "${APP_DIR}/app/static/uploads"
+chmod 640 "$APP_ENV"

-# ── 9. Servicio systemd ───────────────────────────────────────────────────────
-step "Registrando servicio systemd '${SERVICE_NAME}'..."
+mkdir -p "$LOG_DIR"
+chown -R "${APP_USER}:${APP_USER}" "$LOG_DIR"
+chmod 755 "$LOG_DIR"
+ok "Permisos de seguridad aplicados en ${APP_DIR} y ${LOG_DIR}"

-mkdir -p "/var/log/${SERVICE_NAME}"
-chown -R "$APP_USER":"$APP_USER" "/var/log/${SERVICE_NAME}"
+# ─── 10. Servicio Systemd (Gunicorn de Producción) ─────────────────────────────
+hdr "10. Configurando servicio systemd de arranque automático"
+
+GUNICORN_BIN="${VENV_DIR}/bin/gunicorn"

 cat > "/etc/systemd/system/${SERVICE_NAME}.service" <<SVCEOF
 [Unit]
-Description=Admin Edu-Space — Flask/Gunicorn Application
-Documentation=https://github.com/carlostellocba/admin-edu-space
+Description=Admin Edu-Space — Flask/Gunicorn (UniCABA)
+Documentation=https://gitea.oemspot.com.ar/carlostellocba/admin-edu-space
 After=network.target postgresql.service
 Wants=postgresql.service

@@ -198,66 +392,83 @@ Type=simple
 User=${APP_USER}
 Group=${APP_USER}
 WorkingDirectory=${APP_DIR}
-EnvironmentFile=${APP_DIR}/.env
+EnvironmentFile=${APP_ENV}
 Environment="LANG=en_US.UTF-8"
 Environment="LC_ALL=en_US.UTF-8"
 Environment="PYTHONUTF8=1"
 Environment="PYTHONIOENCODING=utf-8"
 Environment="FLASK_ENV=production"
-ExecStart=${VENV_DIR}/bin/gunicorn \
+Environment="HOME=${APP_DIR}"
+ExecStart=${GUNICORN_BIN} \
    --workers 3 \
    --bind 0.0.0.0:5000 \
    --timeout 120 \
-    --access-logfile /var/log/${SERVICE_NAME}/access.log \
-    --error-logfile /var/log/${SERVICE_NAME}/error.log \
+    --access-logfile ${LOG_DIR}/access.log \
+    --error-logfile - \
+    --capture-output \
+    --enable-stdio-inheritance \
    --log-level info \
-    app:app
+    wsgi:app
 Restart=always
 RestartSec=5
 StandardOutput=journal
 StandardError=journal
 SyslogIdentifier=${SERVICE_NAME}
+NoNewPrivileges=true
+PrivateTmp=true

 [Install]
 WantedBy=multi-user.target
 SVCEOF

 systemctl daemon-reload
-systemctl enable "$SERVICE_NAME" > /dev/null 2>&1
-systemctl start "$SERVICE_NAME"
+systemctl enable "${SERVICE_NAME}" > /dev/null 2>&1
+systemctl restart "${SERVICE_NAME}"
 sleep 3

 if systemctl is-active --quiet "$SERVICE_NAME"; then
-    ok "Servicio '${SERVICE_NAME}' corriendo y habilitado para el arranque automático"
+    ok "Servicio '${SERVICE_NAME}' activo y en ejecución"
+    
+    # Validar respuesta HTTP local
+    info "Verificando respuesta del servidor web..."
+    sleep 2
+    HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:5000/ || echo "000")
+    if [[ "$HTTP_CODE" == "200" || "$HTTP_CODE" == "302" ]]; then
+        ok "Servidor web respondiendo correctamente (HTTP ${HTTP_CODE})"
+    else
+        warn "El servidor web devolvió código HTTP ${HTTP_CODE}. Podés revisar los logs con: journalctl -u ${SERVICE_NAME} -n 30 --no-pager"
+    fi
 else
-    warn "El servicio no inició correctamente. Revisá con:"
-    warn "  journalctl -u ${SERVICE_NAME} -n 60 --no-pager"
+    warn "El servicio tardó en arrancar. Podés revisar los logs con:"
+    warn "  journalctl -u ${SERVICE_NAME} -n 50 --no-pager"
 fi

-# ── 10. Resumen final ─────────────────────────────────────────────────────────
-IP=$(hostname -I | awk '{print $1}')
+# ─── Resumen Final y Datos de Acceso ──────────────────────────────────────────
+hdr "¡Despliegue Completado con Éxito!"
+
+IP=$(hostname -I 2>/dev/null | awk '{print $1}' || echo "127.0.0.1")
+
+echo -e "  ${BOLD}Acceso Web a la Aplicación:${RESET}"
+echo -e "    ${CYAN}http://${IP}:5000${RESET}  o  ${CYAN}http://localhost:5000${RESET}"
 echo ""
-echo -e "${BOLD}${GREEN}"
-echo "╔══════════════════════════════════════════════════════════════╗"
-echo "║              ✔  Instalación completada con éxito            ║"
-echo "╚══════════════════════════════════════════════════════════════╝"
-echo -e "${NC}"
-echo -e "  ${BOLD}URL de la aplicación:${NC}  http://${IP}:5000"
+echo -e "  ${BOLD}Credenciales Iniciales de Administrador:${RESET}"
+echo -e "    Email:     ${CYAN}admin@edu-space.com${RESET}"
+echo -e "    Password:  ${CYAN}admin123${RESET}"
 echo ""
-echo -e "  ${BOLD}Credenciales por defecto:${NC}"
-echo -e "    Email:     admin@edu-space.com"
-echo -e "    Password:  admin123"
-echo ""
-echo -e "  ${BOLD}Base de datos:${NC}"
-echo -e "    Host:      localhost:5432"
+echo -e "  ${BOLD}Base de Datos Desplegada:${RESET}"
+echo -e "    Motor:     PostgreSQL (${PG_VER})"
 echo -e "    Base:      ${DB_NAME}"
 echo -e "    Usuario:   ${DB_USER}"
+echo -e "    Snapshot:  $( [ -f "$SQL_BACKUP_FILE" ] && echo "Restaurada desde classrooms_db.sql" || echo "Inicializada limpia" )"
 echo ""
-echo -e "  ${BOLD}Comandos de gestión:${NC}"
-echo -e "    Ver estado:     ${CYAN}systemctl status ${SERVICE_NAME}${NC}"
-echo -e "    Ver logs:       ${CYAN}journalctl -u ${SERVICE_NAME} -f${NC}"
-echo -e "    Reiniciar:      ${CYAN}systemctl restart ${SERVICE_NAME}${NC}"
-echo -e "    Detener:        ${CYAN}systemctl stop ${SERVICE_NAME}${NC}"
+echo -e "  ${BOLD}Comandos de Gestión del Servicio:${RESET}"
+echo -e "    Estado:    ${CYAN}systemctl status ${SERVICE_NAME}${RESET}"
+echo -e "    Logs:      ${CYAN}journalctl -u ${SERVICE_NAME} -f${RESET}"
+echo -e "    Reiniciar: ${CYAN}systemctl restart ${SERVICE_NAME}${RESET}"
+echo -e "    Detener:   ${CYAN}systemctl stop ${SERVICE_NAME}${RESET}"
 echo ""
-echo -e "  ${YELLOW}⚠  Cambiá la contraseña del admin desde la interfaz web${NC}"
+echo -e "  ${BOLD}Generar Nuevos Backups:${RESET}"
+echo -e "    ${CYAN}bash backup_db.sh${RESET}"
+echo ""
+ok "Despliegue finalizado. El sistema se encuentra 100% operativo."
 echo ""
@@ -7,12 +7,13 @@ Flask-CORS==6.0.2
 Flask-Babel==4.0.0
 WTForms==3.1.0
 Werkzeug==3.0.1
-SQLAlchemy==2.0.23
+SQLAlchemy>=2.0.32
 python-dotenv==1.0.0
 requests==2.31.0
 bleach==6.1.0
 python-dateutil==2.8.2
-Pillow==10.1.0
+Pillow>=10.4.0
 email_validator>=2.0.0
-psycopg2-binary==2.9.9
+psycopg2-binary>=2.9.10
 Babel==2.14.0
+gunicorn>=21.2.0
Author	SHA1	Message	Date
Carlos Tello	fa878cb0d5	docs: registrar creacion de rama rc y release v1.0.1 en changelog	2026-09-05 01:34:37 -03:00
Carlos Tello	566908f1de	docs: documentar roadmap academico, propuesta mvc/jwt/security y actualizar changelog de sesion	2026-09-05 01:07:15 -03:00
Carlos Tello	c748ae4075	feat(lxc): verificar e instalar git automáticamente al inicio de install.sh si no existe	2026-09-05 00:33:49 -03:00
Carlos Tello	6218657f36	fix(lxc): instalar sudo e implementar helper pg_cmd universal (sudo/runuser/su) para PostgreSQL	2026-09-04 23:56:37 -03:00
Carlos Tello	747d20ed38	fix(lxc): preservar directorio origen y configurar safe.directory global	2026-09-04 23:52:23 -03:00
Carlos Tello	b64a771068	docs: registrar seccion 24 de auto-recuperacion de PostgreSQL en CHANGELOG_SESSION	2026-09-04 23:50:47 -03:00
Carlos Tello	340bf3aa8c	fix(lxc): asegurar creación de cluster e inicialización robusta de PostgreSQL 15 en Debian 12	2026-09-04 23:50:20 -03:00
Carlos Tello	80f6018b6a	fix(lxc): agregar safe.directory en install.sh para evitar error de git dubious ownership	2026-09-04 23:24:36 -03:00
Carlos Tello	4e49311208	fix(lxc): resolver 500 propagando permisos PostgreSQL universales y logging en journald	2026-09-04 23:15:02 -03:00
Carlos Tello	b367b106bf	fix: corregir traslado automatico de directorio a /opt con cp -a evitando Directory not empty	2026-09-04 23:05:33 -03:00
Carlos Tello	0cea3dca44	feat: hacer install.sh 100% automatico y desatendido usando config activa de PostgreSQL (.env)	2026-09-04 23:02:02 -03:00
Carlos Tello	eea7adb1d0	feat: actualizar install.sh para Proxmox LXC con venv, snapshot classrooms_db.sql, backup_db.sh y fix linter en occupancy	2026-09-04 22:56:53 -03:00
carlostellocba	e0c58409cd	fix: resolve gunicorn app import and systemd permission issues	2026-09-04 22:20:34 -03:00
carlostellocba	9b6678724c	chore: eliminar .env del control de versiones para evitar sobrescribir configuraciones locales	2026-09-04 22:11:54 -03:00
carlostellocba	f462d57ad9	fix: sanitizar tildes en prints de init_db.py para consola LXC ASCII	2026-09-04 21:54:04 -03:00
carlostellocba	7ef2ba8a5b	feat: soportar restauracion automatica desde classrooms_db.sql si existe en el directorio	2026-09-04 21:49:25 -03:00
carlostellocba	169aa45746	fix: sanitizar tildes en milestone.py para evitar errores UnicodeEncodeError	2026-09-04 21:43:44 -03:00
carlostellocba	f31e2bf760	fix: sanitizar tildes y acentos en init_db.py para evitar errores UnicodeEncodeError al inicializar la base de datos	2026-09-04 21:41:57 -03:00
carlostellocba	63c9c6f935	fix: update SQLAlchemy for Python 3.13 compatibility	2026-09-04 21:30:12 -03:00
carlostellocba	5e91e131f0	fix: update psycopg2-binary to support Python 3.13 compilation	2026-09-04 21:25:57 -03:00
carlostellocba	c7ce5e4e67	fix: rewrite install.sh con deteccion de Python y soporte Pillow en Python 3.13	2026-09-04 21:15:18 -03:00
carlostellocba	957f364cc3	Se corrigio install que fallaba al instalar python	2026-09-04 21:07:45 -03:00