4.1 KiB
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:
- 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). - 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. - Resiliencia Bidireccional en Backend: Asegurar que tanto el Frontend BFF como el Backend FastAPI procesen flexiblemente fechas provistas en formato
DD/MM/AAAAo ISOYYYY-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_importen formatoDD/MM/AAAA(d/m/Y), incluyendo:- El campo "Fecha masiva" de la grilla interactiva.
- La columna "Fecha Cursada (Editable)" para cada una de las filas en la tabla de inspección previa.
- Los campos de filtro y alcance temporal ("Fecha Manual Sugerida", "Fecha de Inicio (Desde)", "Fecha de Fin (Hasta)" y "Fecha Puntual Asignada").
- 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 visibled/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/AAAAy lo replicará en todas las filas seleccionadas de la grilla mostrandoDD/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.pyfechas enviadas en formatoDD/MM/AAAA(%d/%m/%Y),DD-MM-AAAA(%d-%m-%Y) o ISOAAAA-MM-DD(%Y-%m-%d), normalizándolas al tipo canónicodatetime.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)
- En
/admin/google_sheets_import, el campo "Fecha masiva" y todos los inputs de la columna "Fecha Cursada (Editable)" muestran fechas con formatoDD/MM/AAAA(ej:21/10/2026). - Flatpickr operativo en español con apertura de calendario al hacer clic en el botón de calendario o foco del input.
- Rango de fechas Desde / Hasta y Fecha puntual muestran
DD/MM/AAAAy actualizan sus badges enDD/MM/AAAA. - El backend parsea flexiblemente formatos
DD/MM/AAAAyYYYY-MM-DD. - Pruebas automatizadas en
backend/tests/test_sheets_import_temporal_scope.pyverificando el parseo flexible de fechas. - Pyright con 0 errores y suite
pytestpasando al 100%. - Bump semántico a
v3.8.6, commit,git push origin devy despliegue a producción verificado.