nmartinezr-qa/boleteria

1. Tipo de aplicación y runtime

- Es una aplicación de escritorio WinForms sobre .NET 8 (net8.0-windows) llamada Boletería.

- No hay base de datos ni servicios externos: la persistencia es en memoria durante la ejecución.

2. Arquitectura general por capas

- El sistema está dividido en cuatro capas claras:

- Presentación: formularios WinForms.

- Lógica de negocio: servicios con validaciones y reglas.

- Acceso a datos: gestores que administran colecciones en memoria.

- Entidades: modelo de dominio.

- Esta separación es el boundary principal del repositorio.

3. Punto de entrada y navegación

- Program.cs inicia la app y abre Presentacion/Principal.cs.

- Desde el formulario principal se navega a tres grupos funcionales:

- Gestiones

- Consultas

- Operaciones

- Los formularios intermedios (FrmGestiones, FrmConsultas, FrmOperaciones) actúan como menús de navegación, no como lógica de negocio.

4. Subsistema de gestión de maestros

- Los formularios de gestión registran entidades base:

- clientes, vendedores, partidos y localidades.

- Cada formulario tiene su servicio correspondiente:

- ServicioCliente, ServicioVendedor, ServicioPartido, ServicioLocalidad.

- El flujo típico es: formulario → servicio → gestor → DatosSistema.

- Aquí se crean y validan los datos maestros que luego usa el módulo de ventas.

5. Subsistema de asignación de capacidad por partido

- LocalidadPorPartido es una entidad de relación entre Partido y Localidad.

- Este módulo define qué localidades están disponibles para cada partido y en qué cantidad.

- Lo manejan ServicioLocalidadPorPartido y GestorLocalidadesPorPartido.

- Es un boundary importante porque conecta catálogo de localidades con disponibilidad real para ventas.

6. Subsistema de venta de entradas

- FrmVentaDeEntradas es el flujo operativo más importante.

- ServicioVenta valida:

- existencia de cliente, vendedor, partido y localidad,

- existencia de la relación LocalidadPorPartido,

- disponibilidad de entradas,

- cantidad solicitada,

- cálculo del total.

- Luego registra la Venta mediante GestorVentas y descuenta stock en la asignación partido-localidad.

- Este es el flujo con más dependencias cruzadas entre capas.

7. Subsistema de consultas

- Los formularios FrmConsultar* exponen lectura de clientes, vendedores, partidos, localidades, relaciones y ventas.

- No modifican estado: consumen servicios para listar y filtrar información.

- La consulta de ventas muestra una vista compuesta con cliente, vendedor, partido, localidad, cantidad, fecha y total.

8. Modelo de dominio

- Persona es la base común para Cliente y Vendedor.

- Partido, Localidad, LocalidadPorPartido y Venta modelan el negocio de boletería.

- Venta referencia a las demás entidades y representa la transacción final.

- El diagrama debe mostrar claramente estas relaciones, sobre todo la composición de Venta y la relación muchos-a-muchos resuelta por LocalidadPorPartido.

9. Acceso a datos en memoria

- DatosSistema.cs centraliza las colecciones compartidas del sistema.

- Los gestores (GestorClientes, GestorVendedores, GestorPartidos, GestorLocalidades, GestorLocalidadesPorPartido, GestorVentas) son wrappers sobre ese almacén común.

- No hay repositorios separados por base de datos; el “storage” real es una clase estática compartida.

10. Reglas y validaciones

- Las reglas de negocio viven en la capa de servicios, no en los formularios.

- Se validan campos requeridos, duplicados, identificadores, estado activo del partido, disponibilidad de localidades y stock suficiente.

- MensajesError y MensajesExito centralizan el texto de feedback para mantener consistencia entre formularios y servicios.

11. Infraestructura de UI

- La interfaz usa formularios .Designer.cs y recursos .resx de WinForms.

- Presentacion/Utilidades/EstilosUI.cs sugiere un pequeño soporte de estilo visual compartido.

- La UI está organizada por módulos funcionales, no por tipo técnico.

12. Lectura arquitectónica para diagrama

- Dibujar de arriba abajo:

- Presentación como capa de entrada.

- Servicios como frontera de validación y coordinación.

- Gestores + DatosSistema como almacenamiento operativo.

- Entidades como núcleo de dominio.

- El flujo más crítico a destacar es el de ventas, porque conecta casi todo el sistema y actualiza disponibilidad.