25 de junio de 2026¶

Un día cargado: envié la v6 del anteproyecto, revisé a fondo el plan del Milestone 1 antes de escribir código, e incorporé al repositorio toda la documentación de la fase preliminar.

Envío de la v6 del anteproyecto al tutor¶

Mandé hoy al Ing. Coronel la versión 6 del anteproyecto (docs/anteproyecto/05_Qaudit_Anteproyecto_v6.md). Esta vuelta no fue por correcciones obligatorias pendientes —el anteproyecto ya había quedado apto—, sino para dejar el documento más redondo antes de cerrar la etapa preliminar y meterme de lleno en la construcción.

Lo que toqué respecto de la v4:

El título. Lo afiné a "Sistema Web para la Gestión, Trazabilidad y Ajuste de Inventario con Integración REST a Sistemas Legados — Caso de Estudio en el Rubro Retail de Indumentaria Deportiva". Me sonaba más fiel a lo que el sistema realmente hace, y el "caso de estudio" deja claro el recorte.
La hipótesis, ahora formal. Era una de las observaciones del 15 de junio. La dejé explícita en su propio apartado (2.4), atada a los objetivos: reducción de al menos 50% en el tiempo, cero errores de consolidación por la automatización del flujo en QUICK POS, y evidencia documental trazable. Recién ahí el planteamiento del problema cierra con algo medible.
Las tablas, numeradas según APA 7. Otra observación que venía arrastrando. Quedaron como Tabla 1 (módulos del sistema) y Tabla 2 (métricas de validación), cada una con su título en cursiva y su nota de elaboración propia.
Referencias. Las llevé a 19 fuentes, sumando bibliografía reciente. Todavía me queda llegar al mínimo de 30 para el documento final de la tesis, pero el anteproyecto ya está holgado.
Plan de contingencia metodológica. Dejé escrito, en la fase de Transición, qué hago si no consigo acceso al entorno de producción de QUICK POS para la prueba piloto: primero un entorno de pruebas con datos reales exportados, y si ni eso, pruebas de integración con datos sintéticos ajustando el alcance de las métricas del OE8. Prefiero tener el plan B por escrito antes que improvisar después.

Quedan todavía como deuda para la tesis final —no para el anteproyecto— el protocolo de ética con consentimiento informado, el Gantt con fechas calendario reales, la declaración de uso de IA generativa de la UAA y completar las 30 referencias. Los tengo anotados desde el feedback del 15 de junio y los voy a ir saldando en la fase de redacción.

Revisión del plan del Milestone 1 y puesta a punto del repositorio¶

El mismo día del envío de la v6 me senté a revisar en serio el plan del Milestone 1 antes de escribir una sola línea de código. Lo contrasté contra el RFC punto por punto, y la verdad es que la revisión valió la pena: salieron varias cosas para ajustar.

Lo que decidí y dejé cerrado:

La app va en la raíz del repositorio, no en una subcarpeta. Tener un app/ que adentro lleva otro app/ (el del App Router de Next) era confuso de leer y de explicar. Más simple así: src/app/, prisma/ y la configuración arriba.
Cobertura de pruebas al 95%. Había una inconsistencia: el plan decía 80% y el RFC, 95%. Unifiqué todo al 95%, que es la meta que me había puesto.
El ms_oid ya quedó opcional en el RFC. Era la corrección que venía arrastrando: el administrador habilita un correo antes de que la persona entre por primera vez, así que el identificador de Microsoft recién se vincula en ese primer login. Lo apliqué directo en el modelo de datos.
Ordené las tareas para que la base de datos de desarrollo (Postgres) se levante en la primera tarea y no en la última, porque la validación de la migración la necesita antes. Y sumé un endpoint de salud para el chequeo del contenedor.
Moví el PRD y el plan a docs/. Antes vivían en una carpeta de configuración que no se versionaba. Ahora todo el material —PRD, RFC, planes y esta bitácora— queda junto en docs/ y bajo control de versiones, que es lo que quiero para poder reconstruir el proceso después.

Además inicialicé el repositorio git del proyecto para versionar todo desde el arranque y poder seguir la evolución del trabajo commit a commit. El primer commit fue justamente la base documental: el PRD, el RFC, el plan del Milestone 1 y esta bitácora. De acá en adelante cada avance queda en el historial con su fecha.

Con esto el plan quedó pulido y el repositorio en orden. El próximo paso es arrancar la construcción del Milestone 1 por la primera tarea (scaffolding y base de datos).

Incorporo la documentación de la fase preliminar al repositorio¶

Antes de tocar el código me quedó una cosa pendiente que no quería arrastrar: toda la documentación de la etapa preliminar vivía suelta en una carpeta de trabajo (preliminar-phase/), fuera del control de versiones. Hoy la ordené y la metí al repositorio donde corresponde.

Lo que entró a docs/:

El anteproyecto y su recorrido completo. Las versiones 3, 4 y 6, más mi análisis y el informe de evaluación del tutor, quedaron juntos en docs/anteproyecto/. Me importaba que esa evolución —de la primera versión a la que finalmente quedó apta— sea reconstruible desde el historial; es parte del relato de cómo maduró la propuesta.
La documentación oficial de QUICK POS. Todo el material de la API (los PDFs de protocolos, el swagger.json, las planillas de comprobantes y procesos) lo llevé a docs/referencias/quick-pos/. Es el insumo concreto sobre el que voy a construir la integración del Milestone 4, así que tenerlo versionado me deja la base reproducible.

Lo que deliberadamente no subí: la transcripción de la reunión de relevamiento y el chat de trabajo. Son material crudo e interno, y prefiero que el repositorio cargue solo con los documentos elaborados, no con las notas de borrador. Esos crudos los dejo aparte, como respaldo personal.

De paso aproveché para corregir las referencias que en el PRD, el RFC, el plan y esta misma bitácora apuntaban a la vieja ubicación, así no quedan enlaces rotos para alguien que clone el repositorio más adelante. Recién ahí, con todo el material ordenado, me siento en condiciones de arrancar con el scaffolding.