Cash Backend · Plan de trabajo y seguimiento
Plan de trabajo y estado del proyecto
Documento de seguimiento para los proyectos de optimización de almacenamiento en base de datos y el upgrade del runtime AWS Lambda a Node.js 24. Este documento resume avance, estado de tareas, pruebas y próximos hitos.
1 · Cronograma clic para expandir
Optimización DB · Fases 1-4
-
Semana 1 22-26 jun Fase 1 · Diseño técnico
Validado local Diseño del esquema de
save_utility, reglas de escritura desdePOST /save, lectura desdeGET /savey criterio de estado vigente por usuario. -
Semana 2 29 jun-3 jul Fase 2 · Implementación backend QA
En curso La implementación base y el backfill ya fueron probados en una base local. Falta cerrar pruebas de borde y preparar el paso controlado a QA.
-
Semana 3 6-10 jul Fase 3 · QA y validación
Pendiente Pruebas funcionales de
POST /save, pruebas deGET /save, validación de compatibilidad con frontend y Zoho CRM, verificación de integridad del backfill y revisión de muestras. -
Semana 4 13-17 jul Fase 4 · Producción y entrega
Pendiente Rollout por etapas
DB -> Lambda, monitoreo post-despliegue, verificación funcional y documentación técnica de cierre.
Runtime AWS Lambda · Node.js 24
-
Semana 5 20-24 jul Bloque A · Preparación y upgrade técnico
Pendiente Inventario de funciones, revisión de stacks, configuración inicial del repositorio, actualización de runtime a
nodejs24.x, ajuste de workflows, tooling y Serverless Framework. -
Semana 5 20-24 jul Bloque B · Validación local / CI
Pendiente Instalación de dependencias, build TypeScript, empaquetado Serverless, validación CloudFormation y ajustes puntuales de compatibilidad.
-
Semana 6 27-31 jul Bloque C · QA
Pendiente Despliegue QA, pruebas de humo sobre endpoints, autenticación, base de datos, jobs críticos y revisión inicial de CloudWatch.
-
Semana 6 27-31 jul Bloque D · Producción y cierre
Pendiente Despliegue producción, monitoreo, verificación posterior y acompañamiento en el cierre del camino anterior de despliegue.
2 · Estado actual clic para expandir
Resumen
| Frente | Estado | Inicio | Entrega esperada | Notas |
|---|---|---|---|---|
| Optimización DB | En curso | 22 jun 2026 | Por definir | Diseño técnico implementado y validado localmente con muestra representativa. QA no ha sido modificado. |
| Upgrade Runtime Node.js 24 | Pendiente | Por definir | Por definir | Requiere disponibilidad de admin AWS del cliente. |
Tareas DB
| Fase | Tarea | Estado | Validación esperada | Notas de avance |
|---|---|---|---|---|
| Fase 1 | Definir esquema de save_utility. |
Validado local | Esquema revisado y probado localmente. | El modelo conserva el estado vigente por usuario y reduce la dependencia operativa del histórico completo. |
| Fase 1 | Especificar lógica de escritura doble y lectura desde save_utility. |
Validado local | Reglas de precedencia documentadas y verificadas en entorno local. | La lectura mantiene compatibilidad con el contrato actual de GET /save. |
| Fase 2 | Crear tabla save_utility e índice único por usuario activo. |
Validado local | Tabla disponible y validada en Postgres local. | La muestra local mantiene una sola fila operativa por usuario. |
| Fase 2 | Ejecutar backfill del último game_save vigente por usuario. |
Validado local | Conteo de usuarios activos vs. filas resultantes validado. | Prueba local: 37 usuarios activos generaron 37 filas en save_utility, sin duplicados. |
| Fase 2 | Modificar POST /save para doble escritura. |
En revisión | Evento en save y upsert en save_utility. |
Implementación base disponible localmente; falta cerrar el comportamiento final del payload histórico liviano. |
| Fase 2 | Modificar GET /save para leer desde save_utility. |
Validado local | Respuesta compatible con contrato actual. | La muestra local confirma que la fuente vigente coincide con el resultado esperado del modelo anterior. |
| Fase 3 | Probar POST /save y GET /save. |
En curso | Pruebas funcionales aprobadas localmente antes de QA. | Las pruebas actuales se ejecutan solo en entorno local; QA permanece sin cambios. |
| Fase 3 | Validar compatibilidad con Zoho CRM y frontend. | Pendiente | Sin breaking changes detectados. | Por actualizar. |
| Fase 4 | Rollout productivo por etapas DB -> Lambda. |
Pendiente | Producción operando con el nuevo flujo. | Por actualizar. |
| Fase 4 | Monitoreo post-despliegue y documentación técnica de cierre. | Pendiente | Logs y verificación funcional sin errores nuevos. | Por actualizar. |
Tareas Runtime Node.js 24
| Bloque | Tarea | Estado | Validación esperada | Notas de avance |
|---|---|---|---|---|
| Preparación | Confirmar funciones Lambda en alcance y stacks fury-qa / fury-prod. |
Pendiente | Inventario confirmado. | Por actualizar. |
| Preparación | Configurar repositorio, variables, secretos y credenciales u OIDC. | Pendiente | Nuevo camino de despliegue autorizado. | Requiere admin AWS del cliente. |
| Upgrade técnico | Actualizar runtime a nodejs24.x, workflows, tooling y Serverless. |
Pendiente | Branch/PR listo para validación. | Por actualizar. |
| Validación | Ejecutar instalación, build, lint, empaquetado Serverless y validación CloudFormation. | Pendiente | Checks completados bajo Node.js 24. | Por actualizar. |
| QA | Desplegar Lambdas de QA con nodejs24.x. |
Pendiente | QA actualizado mediante Serverless/CloudFormation. | Por actualizar. |
| QA | Ejecutar pruebas de humo y revisar CloudWatch. | Pendiente | Aprobación para despliegue productivo. | Por actualizar. |
| Producción | Desplegar producción en ventana acordada. | Pendiente | Producción actualizada a nodejs24.x. |
Por actualizar. |
| Cierre | Verificar logs, estado del runtime y cierre del camino anterior de despliegue. | Pendiente | Un solo camino autorizado para producción. | Por actualizar. |
3 · Pruebas y Validaciones clic para expandir
Registro de pruebas y validaciones por ambiente. La evidencia local permite avanzar el diseño sin modificar QA; las pruebas de QA y producción se completarán en sus respectivas fases.
Local · Optimización DB
| Paso | Objetivo | Estado | Evidencia |
|---|---|---|---|
| Base local aislada | Probar sin riesgo sobre QA. | Completado | Postgres local en Docker. No se escribieron cambios en la base QA. |
| Muestra representativa | Validar el modelo con varios usuarios y payloads reales exportados. | Completado | 37 usuarios y 72 saves importados localmente desde los archivos de prueba. |
| Migraciones desde cero | Confirmar que el esquema se puede crear de forma reproducible. | Completado | Las migraciones corrieron correctamente y la validación del esquema quedó al día. |
| Backfill local | Crear el estado vigente por usuario sin duplicar filas operativas. | Completado | 37 usuarios activos resultaron en 37 filas de save_utility; segunda ejecución idempotente. |
| Pruebas de borde | Revisar casos antes de tocar QA. | En curso | Se están revisando casos de payload, compatibilidad y comportamiento de escritura futura. |
Resultados locales
| Prueba | Aplica a | Estado | Resultado / evidencia |
|---|---|---|---|
Conteo de usuarios activos vs. filas en save_utility. |
DB Fase 2 / Fase 3 | Validado local | 37 usuarios activos -> 37 filas en save_utility; 0 duplicados por usuario. |
| Revisión de muestras de payload migrado. | DB Fase 3 | Validado local | Muestra local de 72 saves; la fila vigente migrada coincide con el último estado esperado por usuario. |
POST /save registra telemetría y actualiza estado vigente. |
DB Fase 3 | En revisión | Ruta implementada localmente. Falta cerrar la política final de payload liviano en el histórico. |
GET /save lee desde save_utility sin romper contrato frontend. |
DB Fase 3 | Validado local | La comparación local confirma la misma fuente vigente que el modelo anterior para la muestra importada. |
QA
| Validación | Aplica a | Estado | Resultado / evidencia |
|---|---|---|---|
| Backfill controlado en QA. | DB QA | Pendiente | Se ejecutará después de cerrar las pruebas locales y aprobar el plan de seguridad. |
Pruebas funcionales de POST /save y GET /save. |
DB QA | Pendiente | Por actualizar. |
| Compatibilidad con frontend y Zoho CRM. | DB QA | Pendiente | Por actualizar. |
Producción
| Validación | Aplica a | Estado | Resultado / evidencia |
|---|---|---|---|
| Rollout productivo por etapas. | DB Producción | Pendiente | Por actualizar. |
| Monitoreo post-despliegue. | DB Producción | Pendiente | Por actualizar. |