feat(import): estandarizacion de formato de fecha DD/MM/AAAA en importador de google sheets (v3.8.6)
This commit is contained in:
@@ -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.
|
||||
@@ -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.
|
||||
Reference in New Issue
Block a user