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

4.1 KiB

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

1. Visión General y Propósito

En la vista /admin/google_sheets_import (import.html), los campos de entrada de fecha nativos de HTML5 (<input type="date">) delegan el formato de presentación visual a la configuración regional (locale) del sistema operativo del cliente. En entornos con Windows o navegadores configurados en inglés, estos inputs forzaban la visualización en formato anglosajón MM/DD/YYYY (ej: 10/21/2026), generando confusión operativa en el personal de Bedelía de UniCABA acostumbrado al estándar nacional argentino DD/MM/AAAA.

El propósito de esta especificación es:

  1. Estandarizar la Visualización: Asegurar que todos los campos de fecha en /admin/google_sheets_import (Fecha masiva, Fecha cursada editable en la grilla, Fecha manual sugerida, Rango de fechas Desde-Hasta y Fecha puntual) muestren explícita e invariablemente el formato DD/MM/AAAA (ej: 21/10/2026).
  2. Interactividad y Usabilidad (Flatpickr): Incorporar el selector de fechas interactivo en español con formato d/m/Y, permitiendo tanto la selección visual por calendario como el tipeo manual validado.
  3. Resiliencia Bidireccional en Backend: Asegurar que tanto el Frontend BFF como el Backend FastAPI procesen flexiblemente fechas provistas en formato DD/MM/AAAA o ISO YYYY-MM-DD.

2. Requisitos en Sintaxis EARS (Español Estricto)

2.1. Visualización en Grilla y Formularios

  • RF-01 (Ubicuo): EL SISTEMA presentará todas las fechas de la pantalla /admin/google_sheets_import en formato DD/MM/AAAA (d/m/Y), incluyendo:
    1. El campo "Fecha masiva" de la grilla interactiva.
    2. La columna "Fecha Cursada (Editable)" para cada una de las filas en la tabla de inspección previa.
    3. Los campos de filtro y alcance temporal ("Fecha Manual Sugerida", "Fecha de Inicio (Desde)", "Fecha de Fin (Hasta)" y "Fecha Puntual Asignada").
    4. Los badges de resumen temporal y los textos informativos en los modales de confirmación.
  • RF-02 (Ubicuo): EL SISTEMA integrará Flatpickr localizado en español (es) con máscara y formato visible d/m/Y (DD/MM/AAAA) para todos los selectores de fecha en la vista.

2.2. Entrada de Datos y Edición Masiva

  • RF-03 (Basado en Eventos): CUANDO el usuario ingrese una fecha en "Fecha masiva" y presione "Aplicar", EL SISTEMA formateará el valor a DD/MM/AAAA y lo replicará en todas las filas seleccionadas de la grilla mostrando DD/MM/AAAA.
  • RF-04 (Basado en Eventos): CUANDO el usuario edite o seleccione una fecha en una fila individual de la grilla, EL SISTEMA actualizará el valor en memoria y conservará la representación visual en DD/MM/AAAA.

2.3. Resiliencia en Ingesta y Procesamiento Backend

  • RF-05 (Ubicuo): EL SISTEMA procesará de manera transparente en sheets_importer.py fechas enviadas en formato DD/MM/AAAA (%d/%m/%Y), DD-MM-AAAA (%d-%m-%Y) o ISO AAAA-MM-DD (%Y-%m-%d), normalizándolas al tipo canónico datetime.date.
  • RF-06 (No Deseado / Excepciones): SI el usuario ingresa una fecha con sintaxis inválida, ENTONCES EL SISTEMA alertará al usuario y mantendrá el último valor válido sin corromper el estado de la grilla ni interrumpir la sincronización.

3. Criterios de Aceptación y Finalización (DoD)

  1. En /admin/google_sheets_import, el campo "Fecha masiva" y todos los inputs de la columna "Fecha Cursada (Editable)" muestran fechas con formato DD/MM/AAAA (ej: 21/10/2026).
  2. Flatpickr operativo en español con apertura de calendario al hacer clic en el botón de calendario o foco del input.
  3. Rango de fechas Desde / Hasta y Fecha puntual muestran DD/MM/AAAA y actualizan sus badges en DD/MM/AAAA.
  4. El backend parsea flexiblemente formatos DD/MM/AAAA y YYYY-MM-DD.
  5. Pruebas automatizadas en backend/tests/test_sheets_import_temporal_scope.py verificando el parseo flexible de fechas.
  6. Pyright con 0 errores y suite pytest pasando al 100%.
  7. Bump semántico a v3.8.6, commit, git push origin dev y despliegue a producción verificado.