Reunión 4 — Arquitectura del Sistema

01 Objetivos de la sesión

Puntos que se revisaron y acordaron durante la reunión con el director.

Revisar el avance de la semana: diseños y mockups elaborados en Figma (pantalla principal de registro / login).
Confirmar el estado de los objetivos específicos del anteproyecto y ubicar la reunión en el objetivo 2 (diseño de la arquitectura).
Definir la herramienta de gestión del proyecto y organizar el tablero de tareas.
Definir las herramientas para los diagramas (MER, arquitectura, casos de uso).
Acotar el alcance del módulo de configuración para no sobredimensionar el desarrollo.

02 Decisiones y acuerdos

Acuerdos tomados durante la sesión. Cada punto refleja lo que se revisó o definió con el director.

1. Avance de la semana — diseños Figma

Se revisó que los mockups en Figma quedaron terminados. La pantalla principal (index) corresponde a la vista de registrarse / loguearse. Se acordó que el prototipado navegable queda pendiente, ya que aún no se ha implementado.

2. Estado de los objetivos específicos

Se confirmó que ya se cuenta con los requerimientos funcionales y que el objetivo 1 (análisis) está hecho. La reunión se ubica en el objetivo 2: diseñar la arquitectura. Los mockups ya están; falta el modelo entidad-relación.

3. Gestión del proyecto — GitHub Projects

Se acordó usar GitHub Projects como herramienta de gestión. Se definió el flujo del tablero: Backlog → Ready → In Progress → Review → Done. Se creó la tarea de los diseños/mockups (movida a Review) y la tarea de diseño UML (movida a Ready). Backlog = pendiente pero aún no listo para trabajar; Ready = listo para empezar.

4. Alcance del módulo de configuración

Se definió acotar la configuración a lo esencial: cambiar contraseña y validar usuarios (activos / inactivos). Se aclaró que en Figma se pueden incluir más opciones (tamaño de letra, color) sin compromiso de implementarlas, porque el anteproyecto no obliga a esa cantidad de opciones de configuración.

5. Herramientas para los diagramas — Mermaid + Gemini

Se acordó generar el MER y los diagramas con Mermaid (editor mermaid.live) apoyándose en Gemini. Se definió validar manualmente lo que produce la IA y no aceptar la primera salida: revisar campos, relaciones uno-a-muchos y pasar el resultado a Review.

6. Diagrama relacional vs. entidad-relación

Se aclaró la diferencia: el diagrama generado (tablas + llaves + líneas con cardinalidad) es un diagrama relacional (modelo físico), mientras que el diagrama entidad-relación usa rombos para marcar la relación entre entidades. Se revisó que erDiagram de Mermaid está orientado al modelo físico.

7. Retoque visual final — draw.io

Se acordó que el diseño se itera en Mermaid hasta el modelo final y luego se puede pasar a draw.io para manipularlo visualmente y dejarlo presentable.

8. Diagrama de arquitectura y despliegue

Se definió que el diagrama de arquitectura cliente-servidor debe dejar claro el despliegue (por ahora local, luego un servidor). El stack previsto por el estudiante es backend en Laravel / PHP.

9. Uso de la IA — modelos y prompts

Se recomendó usar los modelos de razonamiento / Pro de Gemini en lugar del modo rápido para obtener mejores resultados, y elaborar prompts más específicos en vez de genéricos. Los casos de uso también pueden generarse con la misma técnica.

03 Evidencias en el repositorio

Archivos reales del repositorio que materializan las entidades y la arquitectura discutidas. Las migraciones y modelos Eloquent son la base del modelo entidad-relación.

Archivo	Aporte como evidencia
`database/migrations/2026_01_01_000000_create_users_table.php`	Entidad Usuarios — base del módulo de auth y validación de usuarios.
`database/migrations/2026_01_02_000000_create_materials_table.php`	Entidad Materiales — núcleo del inventario.
`database/migrations/2026_01_03_000000_create_lotes_table.php`	Entidad Lotes — soporte del control FEFO por vencimiento.
`database/migrations/2026_04_16_000001_create_bodegas_table.php`	Entidad Bodegas — relación lote ↔ bodega.
`database/migrations/2026_04_16_000003_create_movimientos_table.php`	Entidad Movimientos — entradas / salidas (Kardex).
`database/migrations/2026_05_08_151417_create_transferencias_table.php`	Entidad Transferencias entre bodegas.
`app/Models/Material.php` · `Lote.php` · `Bodega.php`	Modelos Eloquent con relaciones — reflejan las entidades del MER.
`app/Models/Movimiento.php` · `Transferencia.php`	Modelos que representan el flujo de inventario en el modelo de datos.
`docs/screenshots/pruebas/01-login.png`	Pantalla principal de login revisada en la reunión.
`docs/screenshots/pruebas/02-registro.png`	Pantalla de registro derivada del mockup de Figma.
`docs/INVENTARIO_FUNCIONALIDADES.md`	Inventario de módulos que respalda el alcance del diseño.

Tablero de gestión: GitHub Projects del repositorio (columnas Backlog · Ready · In Progress · Review · Done).

04 Tareas asignadas

Tareas acordadas para la siguiente semana y movimientos en el tablero de GitHub Projects.

#	Tarea	Tablero	Estado
1	Hacer el modelo entidad-relación (MER) con Mermaid + Gemini y validarlo manualmente.	In Progress	Asignada
2	Hacer el diagrama de arquitectura de la aplicación, dejando claro el despliegue.	Ready	Asignada
3	Crear los diseños Figma / mockups (avance de la semana).	Review	Entregada
4	Crear el ticket de diseño UML y dejarlo listo para trabajar.	Ready	Creada
5	(Opcional) Generar casos de uso con la misma técnica de Mermaid + Gemini.	Backlog	Opcional

Notas de la sesión

Se trabajó en vivo el flujo de generación de diagramas: pedir a Gemini un diagrama en lenguaje Mermaid, copiarlo al editor mermaid.live y revisar el resultado. Se observó que la herramienta produce un modelo físico (relacional) y no el entidad-relación con rombos, por lo que se acordó iterar y, de ser necesario, retocar en draw.io. Se acordó mover las tareas en el tablero a medida que avancen: los mockups de Figma a Review y, una vez aprobados, a Done; el diseño UML pasa a In Progress cuando se inicie.

← Reunión #3 Índice Reunión #5 →