diff --git a/CHANGELOG.md b/CHANGELOG.md index 31f2dea..a427a86 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,21 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1 - **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1. - **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción. +## [3.8.6] - 2026-10-21 +### Added +- **Estandarización de Formato de Fecha DD/MM/AAAA en Importador de Google Sheets (Spec 007)**: + - Integración de Flatpickr (`flatpickr.min.js` y `flatpickr/dist/l10n/es.js`) con formato regional `d/m/Y` (`DD/MM/AAAA`) para eliminar la dependencia de configuración de idioma del sistema operativo o navegador en inputs nativos. + - Soporte de selector interactivo de calendario con botón y edición tipográfica asistida en todos los inputs de la grilla interactiva de previsualización y filtros superiores. + - Parseo polimórfico y flexible en backend (`sheets_importer.py`) mediante `parse_flexible_date(val)` con tolerancia a `DD/MM/AAAA`, `DD-MM-AAAA` e ISO `AAAA-MM-DD`. + - Inyección de `inferred_date_display` con formato `DD/MM/AAAA` en los metadatos de inspección del Sheet. + - Cobertura de pruebas unitarias automatizadas en `backend/tests/test_sheets_import_temporal_scope.py` (`test_sync_with_ddmmaaaa_dates` y `test_sync_with_row_date_ddmmaaaa`). + +### Changed +- **Interfaz de Usuario del Importador Académico (`/admin/google_sheets_import`)**: + - Reemplazados todos los inputs `` por campos de texto monoespaciados `.table-date-input` y `.date-input-picker` con máscara y placeholder `DD/MM/AAAA`. + - Encabezado de columna de la grilla actualizado explícitamente a `Fecha Cursada (DD/MM/AAAA)`. + - Badges informativos de alcance temporal y modales de confirmación formateados de manera homogénea en `DD/MM/AAAA`. + ## [3.8.5] - 2026-10-21 ### Added - **Aislamiento de Login de Emergencia ADMIN en `/adm/login` (Spec 006)**: diff --git a/MEMORY.md b/MEMORY.md index d5bbb32..c01798c 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -9,15 +9,14 @@ Memoria del proyecto entre sesiones para la rama `dev`. - Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables. - Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación. - Reinicialización segura del sistema con contraseña de Administrador. -- **Sprint Activo: Aislamiento de Login de Emergencia Admin y Despliegue de Auth Único — v3.8.5**: - - **Aislamiento de Login Admin de Emergencia**: - - Creado enrutador y vista `/adm/login` (con redirección `/adm` -> `/adm/login`) para administradores de contingencia, protegido con `authLimiter`. - - Endpoint REST dedicado `POST /api/v1/auth/adm-login` en FastAPI que restringe estrictamente el acceso a roles `ADMIN` y emite logs de auditoría segregados (`ADMIN_EMERGENCY_LOGIN_SUCCESS`, `ADMIN_EMERGENCY_LOGIN_DENIED`, `ADMIN_EMERGENCY_LOGIN_FAILED`). - - Eliminados de la vista pública `/auth/login` el mensaje *"El acceso con contraseña local está deshabilitado para usuarios generales"* y el modal *"Acceso de Emergencia ADMIN"*. - - **Despliegue Automático por Proveedor Único**: - - Detección en BFF (`is_single_provider`). Si únicamente Moodle está habilitado, el formulario de login aparece expandido (`show`) de forma predeterminada, sin divisores redundantes ni pasos extra. - - **Suite de Pruebas y Tipado**: 66 pruebas ejecutadas con pytest pasando al 100% (66 passed, 0 failed). Cero errores en código (`@[current_problems]`). Pyright `0 errors, 0 warnings`. - - **Versión Consolidada**: `v3.8.5`. +- **Sprint Activo: Estandarización de Formato de Fecha DD/MM/AAAA en Importador Google Sheets — v3.8.6**: + - **Formato Regional Estricto DD/MM/AAAA (Spec 007)**: + - Reemplazados todos los `` nativos en `/admin/google_sheets_import` por inputs con Flatpickr (`flatpickr.min.js` y `l10n/es.js`) con formato `d/m/Y`, garantizando que en cualquier sistema operativo o navegador se visualicen y carguen fechas en `DD/MM/AAAA` (ej. `21/10/2026`). + - Selector interactivo de calendario integrado en cada fila de la grilla de previsualización ("Fecha Cursada (DD/MM/AAAA)") y en el campo "Fecha masiva". + - Helpers JS `formatToDDMMAAAA(d)` y `parseToIsoDate(d)` para conversión segura y validación cronológica. + - Parseo flexible y tolerante en backend (`sheets_importer.py`) mediante `parse_flexible_date(val)` con soporte para `%d/%m/%Y`, `%Y-%m-%d`, etc. + - **Suite de Pruebas y Tipado**: 68 pruebas pasando al 100% (68 passed, 0 failed). Cero errores en código (`@[current_problems]`). Pyright `0 errors, 0 warnings`. + - **Versión Consolidada**: `v3.8.6`. ## Decisiones (y por qué) - **Flujo Secuencial de Bedelía (9 Pasos)**: Estandarizar la carga operativa en: 1) Sede -> 2) Aula -> 3) Ciclo Lectivo -> 4) Carrera -> 5) Materia (vinculada a Carrera) -> 6) Comisión (asociada a Materia, Carrera y Ciclo) -> 7) Profesores -> 8) Alumnos -> 9) Reserva de Espacio. Esto asegura consistencia e integridad relacional. diff --git a/backend/app/__init__.py b/backend/app/__init__.py index fe2e53c..c52deaa 100644 --- a/backend/app/__init__.py +++ b/backend/app/__init__.py @@ -7,7 +7,7 @@ from typing import Any from database import db, get_db, engine, SessionLocal, session from config.config import Config -__version__ = "3.8.5" +__version__ = "3.8.6" class DummyContext: def __enter__(self): diff --git a/backend/app/services/sheets_importer.py b/backend/app/services/sheets_importer.py index 21f2aac..bb2df00 100644 --- a/backend/app/services/sheets_importer.py +++ b/backend/app/services/sheets_importer.py @@ -140,6 +140,28 @@ SHEETS_CONFIG = [ TIME_REGEX = re.compile(r'(\d{1,2})(?::(\d{2}))?\s*(?:a|-|to)\s*(\d{1,2})(?::(\d{2}))?', re.IGNORECASE) +def parse_flexible_date(val: Any) -> Optional[date]: + """ + Parsea flexiblemente fechas provistas en formato DD/MM/AAAA (%d/%m/%Y), + DD-MM-AAAA (%d-%m-%Y), ISO YYYY-MM-DD (%Y-%m-%d) o instancias de date / datetime. + """ + if not val: + return None + if isinstance(val, datetime): + return val.date() + if isinstance(val, date): + return val + if isinstance(val, str): + cleaned = val.strip() + if not cleaned: + return None + for fmt in ('%d/%m/%Y', '%Y-%m-%d', '%d-%m-%Y', '%Y/%m/%d'): + try: + return datetime.strptime(cleaned, fmt).date() + except ValueError: + continue + return None + class GoogleSheetsImporter: """ Servicio para descargar, parsear y sincronizar cursadas académicas, @@ -390,15 +412,7 @@ class GoogleSheetsImporter: allowed_days = [nd] # Normalizar fecha manual para fecha inferida base - manual_dt = None - if manual_date: - try: - if isinstance(manual_date, (datetime, date)): - manual_dt = manual_date if isinstance(manual_date, date) else manual_date.date() - elif isinstance(manual_date, str) and manual_date.strip(): - manual_dt = datetime.strptime(manual_date.strip(), '%Y-%m-%d').date() - except Exception: - pass + manual_dt = parse_flexible_date(manual_date) # Referencia de semana base: lunes 5 de octubre de 2026 (semana activa del 2° cuatrimestre) ref_monday = date(2026, 10, 5) @@ -494,6 +508,7 @@ class GoogleSheetsImporter: 'horario': r.get('horario', ''), 'turno': r.get('turno', 'Mañana'), 'inferred_date': target_date.strftime('%Y-%m-%d'), + 'inferred_date_display': target_date.strftime('%d/%m/%Y'), 'is_valid': is_valid, 'has_warning': has_warning, 'warning_msg': warning_msg @@ -557,42 +572,11 @@ class GoogleSheetsImporter: dias_esp = ['Lunes', 'Martes', 'Miércoles', 'Jueves', 'Viernes', 'Sábado', 'Domingo'] # Normalizar fecha manual si fue provista - manual_dt: Optional[date] = None - if manual_date: - try: - if isinstance(manual_date, datetime): - manual_dt = manual_date.date() - elif isinstance(manual_date, date): - manual_dt = manual_date - elif isinstance(manual_date, str) and manual_date.strip(): - manual_dt = datetime.strptime(manual_date.strip(), '%Y-%m-%d').date() - except Exception: - pass + manual_dt = parse_flexible_date(manual_date) # Normalizar rango de fechas (date_from y date_to) - date_from_dt: Optional[date] = None - if date_from: - try: - if isinstance(date_from, datetime): - date_from_dt = date_from.date() - elif isinstance(date_from, date): - date_from_dt = date_from - elif isinstance(date_from, str) and date_from.strip(): - date_from_dt = datetime.strptime(date_from.strip(), '%Y-%m-%d').date() - except Exception: - pass - - date_to_dt: Optional[date] = None - if date_to: - try: - if isinstance(date_to, datetime): - date_to_dt = date_to.date() - elif isinstance(date_to, date): - date_to_dt = date_to - elif isinstance(date_to, str) and date_to.strip(): - date_to_dt = datetime.strptime(date_to.strip(), '%Y-%m-%d').date() - except Exception: - pass + date_from_dt = parse_flexible_date(date_from) + date_to_dt = parse_flexible_date(date_to) if date_from_dt and date_to_dt and date_from_dt > date_to_dt: date_from_dt, date_to_dt = date_to_dt, date_from_dt @@ -935,18 +919,8 @@ class GoogleSheetsImporter: # Determinar fechas a generar: específica de la fila (datepicker), puntual o 16 semanas dates_to_generate = [] - row_specific_date: Optional[date] = None raw_row_date = rec.get('date') or rec.get('inferred_date') - if raw_row_date: - try: - if isinstance(raw_row_date, datetime): - row_specific_date = raw_row_date.date() - elif isinstance(raw_row_date, date): - row_specific_date = raw_row_date - elif isinstance(raw_row_date, str) and raw_row_date.strip(): - row_specific_date = datetime.strptime(raw_row_date.strip(), '%Y-%m-%d').date() - except Exception: - pass + row_specific_date: Optional[date] = parse_flexible_date(raw_row_date) if row_specific_date: dates_to_generate = [row_specific_date] diff --git a/backend/setup.py b/backend/setup.py index ee1211a..ef38216 100644 --- a/backend/setup.py +++ b/backend/setup.py @@ -2,7 +2,7 @@ from setuptools import setup, find_packages setup( name="edu-space-admin", - version="3.8.5", + version="3.8.6", description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)", author="Edu-Space Development Team", author_email="admin@edu-space.com", diff --git a/backend/tests/test_sheets_import_temporal_scope.py b/backend/tests/test_sheets_import_temporal_scope.py index 8aeeed1..fefb5a0 100644 --- a/backend/tests/test_sheets_import_temporal_scope.py +++ b/backend/tests/test_sheets_import_temporal_scope.py @@ -150,3 +150,53 @@ def test_sync_sheets_api_date_from_greater_than_date_to_returns_400(init_databas assert response.status_code == 400 assert 'La fecha de inicio (date_from) no puede ser posterior a la fecha de fin (date_to).' in response.json()['detail'] + +def test_sync_with_ddmmaaaa_dates(init_database, app_context): + """Verifica que fechas provistas en formato DD/MM/AAAA sean parseadas correctamente.""" + _ensure_seed() + importer = GoogleSheetsImporter() + row = { + 'dia': 'Miércoles', + 'codigo': 'TEST-DDMMAAAA-01', + 'asignatura': 'Materia Test DD/MM/AAAA', + 'aula': '101', + 'carrera': 'DATOS (CCC)', + 'horario': '08:30 a 11:30hs', + 'turno': 'Mañana' + } + stats = importer.sync( + selected_rows=[row], + manual_date='21/10/2026', + single_date_only=True + ) + assert len(stats['errors']) == 0 + assert stats['reservations_created'] == 1 + + res = Reservation.query.filter(Reservation.purpose.like('%TEST-DDMMAAAA-01%')).first() + assert res is not None + assert res.start_time.date() == date(2026, 10, 21) + + +def test_sync_with_row_date_ddmmaaaa(init_database, app_context): + """Verifica que fechas en filas individuales en formato DD/MM/AAAA se respeten.""" + _ensure_seed() + importer = GoogleSheetsImporter() + row = { + 'dia': 'Jueves', + 'codigo': 'TEST-DDMMAAAA-ROW', + 'asignatura': 'Materia Row DD/MM/AAAA', + 'aula': '101', + 'carrera': 'DATOS (CCC)', + 'horario': '18:30 a 21:30hs', + 'turno': 'Tarde', + 'date': '22/10/2026' + } + stats = importer.sync(selected_rows=[row]) + assert len(stats['errors']) == 0 + assert stats['reservations_created'] == 1 + + res = Reservation.query.filter(Reservation.purpose.like('%TEST-DDMMAAAA-ROW%')).first() + assert res is not None + assert res.start_time.date() == date(2026, 10, 22) + + diff --git a/frontend/package.json b/frontend/package.json index 83655c9..eb4d2bf 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "frontend", - "version": "3.8.5", + "version": "3.8.6", "description": "", "main": "index.js", "scripts": { diff --git a/frontend/src/app.js b/frontend/src/app.js index 3e5d4ff..874a66c 100644 --- a/frontend/src/app.js +++ b/frontend/src/app.js @@ -86,9 +86,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), { }); // Versiones institucionales del sistema -const APP_VERSION = '3.8.5'; -const FRONTEND_VERSION = '3.8.5'; -const BACKEND_VERSION = '3.8.5'; +const APP_VERSION = '3.8.6'; +const FRONTEND_VERSION = '3.8.6'; +const BACKEND_VERSION = '3.8.6'; env.addGlobal('app_version', APP_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION); diff --git a/frontend/views/admin/import.html b/frontend/views/admin/import.html index 1d8ab99..cb16d91 100644 --- a/frontend/views/admin/import.html +++ b/frontend/views/admin/import.html @@ -2,6 +2,25 @@ {% block title %}Sincronización Google Sheets y Purga Académica - Edu-Space Admin{% endblock %} +{% block extra_css %} + + + +{% endblock %} + {% block content %}