Files

41 lines
4.1 KiB
Markdown

# 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.