Files
admin-edu-space/specs/007-formato-fechas-ddmmaaaa/plan.md
T

2.1 KiB

Plan: 007-formato-fechas-ddmmaaaa - Estandarización de Formato de Fecha DD/MM/AAAA en Importador de Google Sheets

1. Arquitectura y Enfoque de Solución

La pantalla /admin/google_sheets_import requiere que todas las fechas visibles se formateen estrictamente como DD/MM/AAAA. Los <input type="date"> nativos serán sustituidos por inputs formateados vinculados a Flatpickr (dateFormat: 'd/m/Y'), asegurando consistencia visual independiente del locale del sistema operativo. A su vez, el backend FastAPI incorporará un parseador de fechas tolerante para procesar DD/MM/AAAA y YYYY-MM-DD.


2. Fases de Implementación

Fase 1: Backend Resiliente (backend/app/services/sheets_importer.py)

  • Crear la función utilitaria parse_flexible_date(val) que soporte %d/%m/%Y, %d-%m-%Y y %Y-%m-%d.
  • Aplicar parse_flexible_date a manual_date, date_from, date_to y a las filas individuales date / inferred_date en sync_google_sheets.
  • Agregar pruebas unitarias en backend/tests/test_sheets_import_temporal_scope.py.

Fase 2: Vista Frontend Nunjucks & Flatpickr (frontend/views/admin/import.html)

  • Cargar recursos CSS y JS de Flatpickr (flatpickr.min.css, flatpickr.js, l10n/es.js).
  • Implementar helpers JS formatToDDMMAAAA(d) y parseToIsoDate(d).
  • Reemplazar <input type="date"> en:
    • "Fecha masiva": input de texto con Flatpickr (#bulkDateInput).
    • Columna "Fecha Cursada (Editable)": input de texto con Flatpickr por fila e ícono de calendario.
    • "Fecha Manual Sugerida": input con Flatpickr (#manual_date).
    • "Fecha de Inicio (Desde)" y "Fecha de Fin (Hasta)": inputs con Flatpickr (#date_from, #date_to).
    • "Fecha Puntual Asignada": input con Flatpickr (#single_punctual_date).
  • Formatear badges y textos en modal de confirmación a DD/MM/AAAA.

Fase 3: Pruebas, Verificación y Despliegue

  • Validar npx pyright -> 0 errores.
  • Ejecutar pytest tests -v -> 100% pasando.
  • Bump de versión a v3.8.6 en todos los archivos pertinentes.
  • git commit y git push origin dev.
  • Desplegar en producción 10.0.0.217 y verificar en vivo.