# 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 (``) 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.