feat(import): estandarizacion de formato de fecha DD/MM/AAAA en importador de google sheets (v3.8.6)

This commit is contained in:
2026-10-21 15:21:24 -03:00
parent 836e605697
commit 0d93e2c5b7
13 changed files with 440 additions and 110 deletions
+31
View File
@@ -0,0 +1,31 @@
# 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.
+40
View File
@@ -0,0 +1,40 @@
# 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.
@@ -0,0 +1,38 @@
# Tareas: 007-formato-fechas-ddmmaaaa - Estandarización de Formato de Fecha DD/MM/AAAA en Importador de Google Sheets
## Tareas
- [x] **T01: Parseo Flexible de Fechas en Backend (`sheets_importer.py`)**
- **Descripción**: Implementar `parse_flexible_date(val)` en `backend/app/services/sheets_importer.py` para parsear fechas tanto en `DD/MM/AAAA` (`%d/%m/%Y`), `DD-MM-AAAA` (`%d-%m-%Y`) como en ISO `AAAA-MM-DD` (`%Y-%m-%d`). Aplicarlo en `manual_date`, `date_from`, `date_to` y filas de `selected_rows`.
- **Hecho cuando**: Las llamadas a sincronización procesen correctamente fechas provistas en `DD/MM/AAAA`.
- **Estimación**: 15 min.
- [x] **T02: Pruebas Automatizadas de Fechas DD/MM/AAAA en Backend**
- **Descripción**: Agregar tests en `backend/tests/test_sheets_import_temporal_scope.py` verificando sincronizaciones con fechas enviadas en formato `DD/MM/AAAA` tanto puntual como en rangos.
- **Hecho cuando**: `pytest backend/tests/test_sheets_import_temporal_scope.py` pase al 100%.
- **Estimación**: 15 min.
- [x] **T03: Integración de Flatpickr y Helpers de Fecha en `import.html`**
- **Descripción**: Cargar Flatpickr (CSS + JS + `l10n/es.js`) en `frontend/views/admin/import.html`. Definir las funciones `formatToDDMMAAAA(d)` y `parseToIsoDate(d)` en la sección de scripts.
- **Hecho cuando**: Flatpickr esté disponible en la página y las funciones de conversión operen correctamente.
- **Estimación**: 15 min.
- [x] **T04: Actualización de la Grilla Interactiva y "Fecha Masiva" a DD/MM/AAAA**
- **Descripción**: Reemplazar `<input type="date">` en `#bulkDateInput` y en cada fila de `renderPreview()` por inputs de texto monoespaciados formateados en `DD/MM/AAAA` (`d/m/Y`) con Flatpickr y selector de calendario. Actualizar `applyBulkDate()` y `updateRowDate()` para manejar `DD/MM/AAAA`.
- **Hecho cuando**: La grilla previsualice e inserte siempre fechas en `DD/MM/AAAA` (ej. `21/10/2026`).
- **Estimación**: 20 min.
- [x] **T05: Actualización de Filtros Superiores y Badges a DD/MM/AAAA**
- **Descripción**: Configurar Flatpickr en `#manual_date`, `#date_from`, `#date_to` y `#single_punctual_date`. Asegurar que los badges informativos y modales de confirmación muestren las fechas en `DD/MM/AAAA`.
- **Hecho cuando**: Ningún input en la pantalla muestre `MM/DD/YYYY` y todos usen `DD/MM/AAAA`.
- **Estimación**: 15 min.
- [x] **T06: Verificación de Código, Pyright y Suite de Pruebas**
- **Descripción**: Ejecutar `npx pyright` (0 errores) y la suite completa de pruebas `pytest tests -v`.
- **Hecho cuando**: Cero diagnósticos y todos los tests aprobados.
- **Estimación**: 10 min.
- [x] **T07: Bump Semántico a v3.8.6, Git Push y Despliegue en Producción**
- **Descripción**: Incrementar versión a `3.8.6`, actualizar `CHANGELOG.md` y `MEMORY.md`, hacer commit, `git push origin dev` y desplegar en `10.0.0.217` verificando HTTP 200 en vivo.
- **Hecho cuando**: `https://eduspace.oemspot.com.ar/version` responda `3.8.6` y `/admin/google_sheets_import` esté operativo en vivo.
- **Estimación**: 15 min.