feat(benefits-reception): add institutional benefits, QR digital card & reception access control (SDD-012 v3.8.39)
This commit is contained in:
@@ -0,0 +1,111 @@
|
||||
# Plan de Arquitectura Técnica (SDD-012)
|
||||
|
||||
## Módulo: Portal de Beneficios, Convenios Comerciales y Control de Acceso por QR con IA (UdeCi) y Rol Recepción
|
||||
|
||||
---
|
||||
|
||||
### 1. Diagrama de Arquitectura del Sistema
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
subgraph "Perfiles y Clientes Web"
|
||||
ALUMNO[Estudiante / Docente: Catálogo & Credencial QR]
|
||||
BEDELIA[Bedelía / Admin: Panel ABM de Convenios]
|
||||
RECEPCION[Personal de Recepción: Escáner QR de Acceso]
|
||||
CHAT[UdeCi: Tutor Conversacional con IA]
|
||||
end
|
||||
|
||||
subgraph "Frontend BFF Node.js / Express (:3000)"
|
||||
ROUTES_BENEFITS[/benefits & /benefits/manage]
|
||||
ROUTES_RECEPTION[/reception/scanner]
|
||||
ROUTES_CREDENTIAL[/credential/my-qr]
|
||||
PROXY_API[Axios Interceptors con Bearer Token]
|
||||
end
|
||||
|
||||
subgraph "Backend Core FastAPI (:5000)"
|
||||
ROUTER_BENEFITS[routers/benefits.py]
|
||||
ROUTER_RECEPTION[routers/reception.py]
|
||||
ROUTER_AI[routers/ai_chat.py]
|
||||
SERVICE_LIVE[services/live_context_service.py]
|
||||
SERVICE_QR[services/qr_security_service.py]
|
||||
end
|
||||
|
||||
subgraph "Persistencia PostgreSQL"
|
||||
TB_BENEFITS[(institutional_benefits)]
|
||||
TB_ACCESS_LOGS[(access_logs_qr)]
|
||||
TB_USERS[(users)]
|
||||
TB_RESERVATIONS[(reservations)]
|
||||
end
|
||||
|
||||
ALUMNO -->|1. Consulta beneficios / Mi QR| ROUTES_BENEFITS
|
||||
BEDELIA -->|2. Carga / Edita convenios| ROUTES_BENEFITS
|
||||
RECEPCION -->|3. Escanea QR de alumno| ROUTES_RECEPTION
|
||||
CHAT -->|4. Pregunta por promociones| PROXY_API
|
||||
|
||||
ROUTES_BENEFITS --> PROXY_API
|
||||
ROUTES_RECEPTION --> PROXY_API
|
||||
PROXY_API --> ROUTER_BENEFITS
|
||||
PROXY_API --> ROUTER_RECEPTION
|
||||
PROXY_API --> ROUTER_AI
|
||||
|
||||
ROUTER_BENEFITS --> TB_BENEFITS
|
||||
ROUTER_RECEPTION --> SERVICE_QR
|
||||
SERVICE_QR --> TB_ACCESS_LOGS
|
||||
SERVICE_QR --> TB_USERS
|
||||
SERVICE_QR --> TB_RESERVATIONS
|
||||
ROUTER_AI --> SERVICE_LIVE
|
||||
SERVICE_LIVE --> TB_BENEFITS
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. Capas y Módulos a Desarrollar
|
||||
|
||||
#### Capa 1: Persistencia y Modelos SQLAlchemy ORM (`backend/models/`)
|
||||
1. **`models/institutional_benefit.py`**:
|
||||
- Campos: `id`, `title`, `partner_name`, `category`, `discount_label`, `description`, `terms_conditions`, `target_roles`, `building_id`, `coupon_code`, `valid_from`, `valid_until`, `is_active`, `image_url`, `created_by_user_id`, timestamps.
|
||||
- Relaciones con `Building` y `User`.
|
||||
2. **`models/access_log_qr.py`**:
|
||||
- Campos: `id`, `user_id`, `building_id`, `scanned_by_user_id`, `scanned_at`, `status`, `reason`.
|
||||
- Relaciones con `User` y `Building`.
|
||||
|
||||
#### Capa 2: DTOs y Esquemas Pydantic v2 (`backend/schemas/`)
|
||||
1. **`schemas/benefit_dto.py`**:
|
||||
- `BenefitBaseDTO`: Validaciones con `Field(..., min_length=3, max_length=150)`.
|
||||
- `BenefitCreateDTO`: `title`, `partner_name`, `category`, `discount_label`, `description`, `terms_conditions`, `target_roles`, `valid_from`, `valid_until`, etc.
|
||||
- `BenefitUpdateDTO`: Campos opcionales para edición parcial.
|
||||
- `BenefitResponseDTO`: Formato serializado con `model_config = ConfigDict(from_attributes=True)`.
|
||||
2. **`schemas/reception_dto.py`**:
|
||||
- `QRVerificationRequestDTO`: `qr_token: str`, `building_id: int`.
|
||||
- `QRVerificationResponseDTO`: `status: str`, `user_name: str`, `user_dni: str`, `user_role: str`, `matricula_status: str`, `todays_classes: List[ClassScheduleDTO]`, `scanned_at: datetime`.
|
||||
|
||||
#### Capa 3: Endpoints RESTful en FastAPI (`backend/routers/`)
|
||||
1. **`routers/benefits.py`** (`prefix="/api/v1/benefits"`, `tags=["Benefits & Convenios"]`):
|
||||
- `GET /`: Lista de beneficios vigentes con filtros por rol, categoría y sede.
|
||||
- `GET /{id}`: Detalle de un beneficio específico.
|
||||
- `POST /`: Creación de convenio (restringido a `ADMIN`, `BEDELIA`). Retorna `201 Created`.
|
||||
- `PUT /{id}`: Edición de convenio (restringido a `ADMIN`, `BEDELIA`). Retorna `200 OK`.
|
||||
- `PATCH /{id}/toggle-status`: Activa o pausa la publicación. Retorna `200 OK`.
|
||||
- `DELETE /{id}`: Eliminación lógica o física. Retorna `204 No Content`.
|
||||
2. **`routers/reception.py`** (`prefix="/api/v1/reception"`, `tags=["Reception & Access Control"]`):
|
||||
- `POST /verify-qr`: Valida el código QR, genera el `AccessLogQR` y retorna los datos y aulas del día en < 300 ms.
|
||||
- `GET /recent-logs`: Historial de los últimos ingresos escaneados por sede.
|
||||
- `GET /student-qr-token`: Genera el token firmado del alumno para su credencial virtual.
|
||||
|
||||
#### Capa 4: Integración con IA UdeCi y Contexto en Vivo
|
||||
1. **`LiveContextService` (`backend/app/services/live_context_service.py`)**:
|
||||
- Se inyecta la sección `CONVENIOS Y BENEFICIOS ACTIVOS`: lista resumida de promociones por categoría, descuentos y comercios vigentes.
|
||||
- Si un usuario pregunta sobre cafeterías o descuentos, UdeCi responde de inmediato utilizando datos reales de `InstitutionalBenefit`.
|
||||
2. **`GuideService`**:
|
||||
- Agregar guía paso a paso para que Bedelía aprenda a dar de alta convenios (`"¿Cómo publico un nuevo convenio?"`).
|
||||
|
||||
#### Capa 5: Frontend BFF (Express + Nunjucks + Bootstrap 5)
|
||||
1. **Rutas y Controladores (`frontend/src/routes/`)**:
|
||||
- `routes/benefits.js`: `/benefits` (catálogo para alumnos/docentes) y `/benefits/manage` (panel Bedelía).
|
||||
- `routes/reception.js`: `/reception/scanner` (consola de recepción con escáner de cámara).
|
||||
- `routes/credential.js`: `/credential/my-card` (credencial digital interactiva con QR).
|
||||
2. **Vistas Nunjucks**:
|
||||
- `views/benefits/catalog.html`: Grid de tarjetas con estilo marketplace, badges de descuento, buscador en vivo y modal de cupón/canje.
|
||||
- `views/benefits/manage.html`: Tabla de gestión con modales de alta/edición, switches de estado y selector de sede.
|
||||
- `views/reception/scanner.html`: Vista de alta velocidad con visor de cámara (`html5-qrcode`), campo de entrada para pistola USB, tarjeta de validación instantánea y cronograma áulico del día.
|
||||
- `views/credential/card.html`: Credencial universitaria digital con foto, datos de carrera y QR rotativo/seguro.
|
||||
@@ -0,0 +1,93 @@
|
||||
# Especificación de Requisitos de Software (SDD-012)
|
||||
|
||||
## Módulo: Portal de Beneficios, Convenios Comerciales y Control de Acceso por QR con IA (UdeCi) y Rol Recepción
|
||||
**ID de Especificación**: SDD-012
|
||||
**Estado**: Planificado / Aprobación de Arquitectura
|
||||
**Fecha**: 2026-10-27
|
||||
**Autores**: Coordinador de Arquitectura, Bedelía y Tutoría Virtual UniCABA
|
||||
|
||||
---
|
||||
|
||||
### 1. Visión General y Propósito
|
||||
|
||||
El presente requerimiento expande el ecosistema institucional de **Admin Edu-Space (UniCABA)** agregando valor tangible en la vida diaria de estudiantes, docentes y personal de Bedelía/Recepción, a través de dos ejes estratégicos interconectados con la inteligencia artificial **UdeCi**:
|
||||
|
||||
1. **Club de Beneficios y Convenios Institucionales**:
|
||||
- Una herramienta centralizada para que Bedelía y el Administrador carguen, administren y publiquen promociones, convenios y descuentos comerciales (cafeterías, librerías, tecnología, transporte, salud y cultura).
|
||||
- Un catálogo visual y responsive para estudiantes y docentes donde consultar beneficios y generar cupones o validar su pertenencia universitaria.
|
||||
- Integración nativa con **UdeCi** (IA RAG y Live Context): los alumnos y docentes pueden consultar en lenguaje natural los beneficios disponibles, promociones cercanas a su sede y condiciones de canje. UdeCi asiste a Bedelía en la redacción y auditoría de vencimientos de convenios.
|
||||
|
||||
2. **Perfil de Recepción y Control de Acceso Ágil por Código QR**:
|
||||
- Incorporación del rol institucional **`RECEPCION`** (personal de mesa de entrada, seguridad y torniquetes).
|
||||
- **Credencial Digital QR** accesible desde el portal móvil del alumno y docente, con código QR seguro y dinámico.
|
||||
- **Consola de Recepción con Escáner de Alta Velocidad**: al escanear el QR, la pantalla de recepción valida la matrícula en tiempo real, registra el ingreso (*check-in*) y muestra de forma inmediata las clases y aulas físicas asignadas para el día de hoy, permitiendo orientar al alumno en segundos.
|
||||
|
||||
---
|
||||
|
||||
### 2. Requisitos del Sistema en Sintaxis EARS (Español)
|
||||
|
||||
#### 2.1 Requisitos Ubicuos (Ubiquitous Requirements)
|
||||
- **REQ-UBI-01**: EL SISTEMA registrará en `AuditLog` toda creación, edición o cambio de estado de un convenio comercial y todo registro de ingreso institucional escaneado.
|
||||
- **REQ-UBI-02**: EL SISTEMA mantendrá el aislamiento de roles en el catálogo de beneficios: solo se mostrarán promociones vigentes dirigidas al rol específico del usuario (`ALUMNO`, `DOCENTE`, `TODOS`).
|
||||
- **REQ-UBI-03**: EL SISTEMA incorporará los convenios vigentes en la base de contexto en vivo de **UdeCi**, respondiendo consultas en tiempo real sobre promociones sin inventar datos mock.
|
||||
- **REQ-UBI-04**: EL SISTEMA garantizará que el Código QR de la Credencial Digital contenga un token verificable con firma o clave criptográfica institucional para impedir falsificaciones o clonaciones estáticas.
|
||||
|
||||
#### 2.2 Requisitos Basados en Eventos (Event-driven Requirements)
|
||||
- **REQ-EVT-01**: CUANDO un operador con rol `BEDELIA` o `ADMIN` guarde un nuevo convenio con fecha de inicio, fecha de fin, porcentaje de descuento y sede aplicable, EL SISTEMA validará los datos, persistirá el registro en `InstitutionalBenefit` y retornará código `201 Created`.
|
||||
- **REQ-EVT-02**: CUANDO un estudiante o docente consulte a UdeCi sobre descuentos (ej: *"¿Qué promociones hay en cafetería hoy?"* o *"¿Tengo descuento en librerías?"*), EL SISTEMA consultará la tabla de beneficios activos y responderá con los comercios adheridos, descuentos y pasos de canje.
|
||||
- **REQ-EVT-03**: CUANDO un operador de Bedelía solicite a UdeCi asistencia en la redacción de un convenio, EL SISTEMA generará una propuesta con cláusulas claras, términos y condiciones y etiquetas de descuento optimizadas.
|
||||
- **REQ-EVT-04**: CUANDO un alumno o docente acceda a la sección "Mi Credencial", EL SISTEMA generará su credencial virtual con foto, nombre, DNI, carrera/rol y su código QR institucional interactivo.
|
||||
- **REQ-EVT-05**: CUANDO el personal de `RECEPCION` escanee el código QR desde la cámara del dispositivo o lector óptico USB, EL SISTEMA validará la identidad en menos de 300 ms, registrará el evento en `AccessLogQR` y desplegará en verde la foto, estado del alumno y el cronograma áulico del día (aula física, sede, piso y horario).
|
||||
|
||||
#### 2.3 Requisitos de Estado (State-driven Requirements)
|
||||
- **REQ-STA-01**: MIENTRAS un convenio se encuentre fuera del rango de fechas de vigencia (`valid_until < fecha_actual`), EL SISTEMA marcará automáticamente su estado como vencido y lo ocultará del catálogo general de alumnos y docentes.
|
||||
- **REQ-STA-02**: MIENTRAS el personal opere en el perfil `RECEPCION`, EL SISTEMA presentará una interfaz minimalista optimizada para pantalla táctil o kiosco de acceso, bloqueando la navegación a paneles sensibles de notas o configuración.
|
||||
|
||||
#### 2.4 Requisitos de Situaciones No Deseadas (Unwanted Behaviour Requirements)
|
||||
- **REQ-NO-01**: SI el código QR escaneado por Recepción es inválido, manipulado o corresponde a un usuario suspendido o inactivo, ENTONCES EL SISTEMA emitirá una alerta visual roja y sonora de "Acceso Denegado / Verificar en Bedelía", registrando el intento fallido.
|
||||
- **REQ-NO-02**: SI un usuario con rol Alumno intenta acceder al panel de gestión y alta de convenios (`/benefits/manage`), ENTONCES EL SISTEMA denegará el acceso retornando error `403 Forbidden` y redirigiéndolo a su catálogo de beneficios.
|
||||
- **REQ-NO-03**: SI el comercio o sede asociada al convenio se encuentra inactiva, ENTONCES EL SISTEMA suspenderá la visualización del beneficio hasta su regularización.
|
||||
|
||||
#### 2.5 Requisitos Opcionales (Optional Features)
|
||||
- **REQ-OPC-01**: DONDE el convenio comercial cuente con un código o cupón de descuento alfanumérico (ej: `UNICABA-CAFE-20`), EL SISTEMA mostrará un botón interactivo de "Copiar Cupón" y un código de barras / QR específico para mostrar en la caja del comercio.
|
||||
- **REQ-OPC-02**: DONDE el alumno escanee su ingreso y tenga clase en los próximos 15 minutos, EL SISTEMA podrá orientar con un aviso en pantalla: *"¡Bienvenido a Sede Central! Tu clase comienza a las 18:30 en Aula 102 (1º Piso)"*.
|
||||
|
||||
---
|
||||
|
||||
### 3. Modelo de Dominio y Persistencia Propuesta
|
||||
|
||||
#### 3.1 Entidad `InstitutionalBenefit` (Tabla `institutional_benefits`)
|
||||
- `id` (Integer, PK)
|
||||
- `title` (String 150): Nombre de la promoción o convenio (ej: "20% en Cafetería La Estación").
|
||||
- `partner_name` (String 120): Empresa o comercio asociado (ej: "Café Martínez Central").
|
||||
- `category` (String 50): Categoría (`GASTRONOMIA`, `LIBRERIA`, `TECNOLOGIA`, `SALUD_DEPORTE`, `IDIOMAS`, `CULTURA`, `SERVICIOS`).
|
||||
- `discount_label` (String 80): Etiqueta destacada (ej: "20% OFF", "2x1", "$1.500 de ahorro").
|
||||
- `description` (Text): Descripción detallada del convenio.
|
||||
- `terms_conditions` (Text): Cláusulas, días de validez y restricciones.
|
||||
- `target_roles` (String 50): Perfiles habilitados (`ALL`, `ALUMNO`, `DOCENTE`, `BEDELIA`).
|
||||
- `building_id` (Integer FK nullable -> `buildings.id`): Sede aplicable o `None` para todas.
|
||||
- `coupon_code` (String 50, nullable): Código promocional alfanumérico.
|
||||
- `valid_from` (Date): Inicio de vigencia.
|
||||
- `valid_until` (Date, nullable): Fin de vigencia.
|
||||
- `is_active` (Boolean, default True): Switch de publicación inmediata.
|
||||
- `image_url` (String 255, nullable): Imagen o logotipo representativo.
|
||||
- `created_by_user_id` (Integer FK -> `users.id`): Usuario responsable del alta.
|
||||
- `created_at`, `updated_at` (DateTime): Timestamps de auditoría.
|
||||
|
||||
#### 3.2 Entidad `AccessLogQR` (Tabla `access_logs_qr`)
|
||||
- `id` (Integer, PK)
|
||||
- `user_id` (Integer FK -> `users.id`): Alumno o docente que ingresó.
|
||||
- `building_id` (Integer FK -> `buildings.id`): Sede donde se realizó el escaneo.
|
||||
- `scanned_by_user_id` (Integer FK -> `users.id`): Personal de recepción que escaneó.
|
||||
- `scanned_at` (DateTime): Momento exacto del ingreso.
|
||||
- `status` (String 20): `AUTORIZADO`, `DENEGADO`, `RESTRINGIDO`.
|
||||
- `reason` (String 150, nullable): Causa del rechazo o notas operativas.
|
||||
|
||||
---
|
||||
|
||||
### 4. Criterios de Aceptación y Validación
|
||||
1. **ABM Bedelía y Admin**: Capacidad de crear, editar, pausar y eliminar beneficios con validación de fechas y roles.
|
||||
2. **Catálogo para Alumnos y Docentes**: Navegación fluida por tarjetas con filtros por categoría y búsqueda en tiempo real.
|
||||
3. **Integración UdeCi**: Respuestas en lenguaje natural sobre convenios basadas en los datos reales cargados.
|
||||
4. **Credencial QR**: Generación dinámica en el portal del usuario.
|
||||
5. **Consola Recepción**: Escaneo con cámara y visualización en tiempo real de identidad y aulas de cursada del día.
|
||||
@@ -0,0 +1,81 @@
|
||||
# Desglose de Tareas: Portal de Beneficios, Convenios y Control de Acceso QR (SDD-012)
|
||||
|
||||
## Tareas de Implementación
|
||||
|
||||
- [x] **Tarea 1: Modelos de Persistencia SQLAlchemy (`InstitutionalBenefit` y `AccessLogQR`)**
|
||||
- **Estimación**: 25 min
|
||||
- **Acciones**:
|
||||
- Crear `backend/models/institutional_benefit.py` con campos de título, comercio, categoría, descuento, términos, roles objetivo, fechas de vigencia y switch de estado activo.
|
||||
- Crear `backend/models/access_log_qr.py` para trazabilidad de ingresos escaneados por sede y personal de recepción.
|
||||
- Importar y registrar los modelos en `backend/models/__init__.py`.
|
||||
- **Hecho cuando**: Las tablas se crean correctamente en PostgreSQL/SQLite sin errores de clave foránea ni regresiones de inicialización.
|
||||
|
||||
- [x] **Tarea 2: DTOs Pydantic v2 y Endpoints RESTful de Beneficios (`routers/benefits.py`)**
|
||||
- **Estimación**: 30 min
|
||||
- **Acciones**:
|
||||
- Crear `backend/schemas/benefit_dto.py` con validaciones de campos (`min_length`, fechas, roles).
|
||||
- Crear `backend/routers/benefits.py` con operaciones CRUD (`GET /`, `GET /{id}`, `POST /`, `PUT /{id}`, `PATCH /{id}/toggle-status`, `DELETE /{id}`).
|
||||
- Proteger rutas de escritura exigiendo roles `ADMIN` o `BEDELIA`.
|
||||
- Registrar el router en `backend/main.py`.
|
||||
- **Hecho cuando**: Peticiones a `/api/v1/benefits` responden con códigos HTTP semánticos (200, 201, 204, 403, 404, 422) y aparecen en OpenAPI Swagger UI (`/docs`).
|
||||
|
||||
- [x] **Tarea 3: Servicio de Seguridad QR y Endpoints de Recepción (`routers/reception.py`)**
|
||||
- **Estimación**: 30 min
|
||||
- **Acciones**:
|
||||
- Crear `backend/app/services/qr_security_service.py` para generar y verificar tokens de credencial firmados con HMAC-SHA256 institucional.
|
||||
- Crear `backend/schemas/reception_dto.py` para los contratos de verificación de acceso.
|
||||
- Crear `backend/routers/reception.py` con `/api/v1/reception/verify-qr` y `/api/v1/reception/recent-logs`.
|
||||
- Integrar la búsqueda de clases presenciales del día para mostrar el aula y piso asignado al momento de ingresar.
|
||||
- Registrar el router en `backend/main.py`.
|
||||
- **Hecho cuando**: Un escaneo de QR válido responde con `status: AUTORIZADO`, datos del alumno y sus aulas asignadas del día en < 300 ms.
|
||||
|
||||
- [x] **Tarea 4: Integración de Convenios en el Motor Conversacional de UdeCi**
|
||||
- **Estimación**: 20 min
|
||||
- **Acciones**:
|
||||
- Modificar `backend/app/services/live_context_service.py` para inyectar los convenios vigentes en el contexto en vivo de UdeCi.
|
||||
- Actualizar las reglas del System Prompt en `backend/routers/ai_chat.py` para responder consultas sobre descuentos en cafeterías, librerías y beneficios institucionales reales.
|
||||
- **Hecho cuando**: Al consultar a UdeCi *"¿Qué descuentos hay en cafetería?"*, responde citando comercios, porcentaje y condiciones reales de la base de datos.
|
||||
|
||||
- [x] **Tarea 5: Panel de Gestión de Convenios para Bedelía y Admin (Frontend BFF)**
|
||||
- **Estimación**: 30 min
|
||||
- **Acciones**:
|
||||
- Crear controlador `frontend/src/routes/benefits.js` y vista `frontend/views/benefits/manage.html`.
|
||||
- Implementar tabla de convenios con badges de categoría, switches de activación rápida y modal de alta/edición.
|
||||
- Incorporar el enlace en el menú lateral de Bedelía y Administración (`sidebar.html`).
|
||||
- **Hecho cuando**: Bedelía puede dar de alta un convenio con descuento, fechas y sede desde la interfaz web con feedback visual inmediato.
|
||||
|
||||
- [x] **Tarea 6: Catálogo de Beneficios y Credencial Digital QR para Alumnos y Docentes**
|
||||
- **Estimación**: 30 min
|
||||
- **Acciones**:
|
||||
- Crear vista `frontend/views/benefits/catalog.html` con tarjetas estilo marketplace, buscador interactivo y filtro por categoría (Cafetería, Librería, etc.).
|
||||
- Crear vista `frontend/views/credential/card.html` ("Mi Credencial Digital") mostrando foto, datos institucionales y código QR dinámico.
|
||||
- Añadir accesos en el menú de Estudiante y Docente.
|
||||
- **Hecho cuando**: Un estudiante puede explorar los convenios vigentes, abrir el cupón y visualizar su Credencial QR en su teléfono.
|
||||
|
||||
- [x] **Tarea 7: Consola de Escáner de Recepción y Control de Acceso en Vivo**
|
||||
- **Estimación**: 30 min
|
||||
- **Acciones**:
|
||||
- Crear vista `frontend/views/reception/scanner.html` con lector de cámara (`html5-qrcode`) y soporte para pistola de código de barras USB.
|
||||
- Integrar modal/tarjeta de validación instantánea con indicadores visuales (verde/rojo) y cronograma de clases de hoy con sede, aula y piso.
|
||||
- Configurar permisos en el BFF para el rol `RECEPCION` y administradores.
|
||||
- **Hecho cuando**: Al escanear un QR con la cámara, la pantalla muestra de inmediato la foto, el estado de matrícula y el aula donde cursa hoy.
|
||||
|
||||
- [x] **Tarea 8: Suite de Pruebas Automatizadas Backend y Cobertura E2E**
|
||||
- **Estimación**: 20 min
|
||||
- **Acciones**:
|
||||
- Crear `backend/tests/test_benefits_and_reception.py` cubriendo:
|
||||
- CRUD de beneficios y restricciones de roles.
|
||||
- Validación de vigencia de fechas.
|
||||
- Generación y verificación de tokens QR.
|
||||
- Registro de logs de acceso.
|
||||
- Respuestas de UdeCi sobre beneficios en vivo.
|
||||
- Ejecutar `pytest tests/ -v` asegurando 100% de tests pasando.
|
||||
- **Hecho cuando**: Todos los tests de la suite pasan exitosamente sin fallos ni warnings no controlados.
|
||||
|
||||
- [x] **Tarea 9: Bump de Versión, Git Push y Despliegue Continuo en Producción (LXC 10.0.0.217)**
|
||||
- **Estimación**: 20 min
|
||||
- **Acciones**:
|
||||
- Incrementar versión semántica en `package.json`, `app.js`, `__init__.py`, `setup.py`, `CHANGELOG.md` y `MEMORY.md`.
|
||||
- Ejecutar `git push origin dev`.
|
||||
- Desplegar en el contenedor de producción (`10.0.0.217`) y validar HTTP 200 en `/version`.
|
||||
- **Hecho cuando**: Producción corre la nueva versión con los módulos de beneficios y recepción operativos.
|
||||
Reference in New Issue
Block a user