Flujo de Negocio

Documentación del flujo completo de negocio del sistema de administración, incluyendo el happy path, modelo de datos, estados y enumeraciones.

Flujo principal

El siguiente diagrama muestra el camino feliz (happy path) desde el registro de un cliente hasta la liquidación completa de una venta.

Modelo de datos

Relaciones principales entre las entidades del sistema.

Ciclo de vida de estados

Estados de Venta

Estados de Pago

Enums de referencia

Venta.tipo

Valor	Descripción
`lentes`	Lentes graduados
`armazon`	Armazón sin lentes
`lentes_contacto`	Lentes de contacto
`accesorio`	Accesorios ópticos

Venta.estado

Valor	Descripción
`activa`	Venta en curso, con pagos pendientes
`completada`	Todos los pagos liquidados
`cancelada`	Venta cancelada manualmente
`vencida`	Tiene pagos vencidos sin liquidar

Pago.tipo

Valor	Descripción
`enganche`	Pago inicial al crear la venta
`quincenal`	Pago recurrente cada 15 días

Pago.estado

Valor	Descripción
`pendiente`	Pago aún no realizado
`pagado`	Pago registrado exitosamente
`fallido`	Intento de pago fallido
`cancelado`	Pago cancelado (cascada de cancelación de venta)

Pago.metodo_pago

Valor	Descripción
`efectivo`	Pago en efectivo en sucursal
`transferencia`	Transferencia bancaria
`tarjeta`	Pago con tarjeta de crédito/débito

Reglas de transición

Al cancelar una venta, todos los pagos con estado pendiente cambian automáticamente a cancelado. Los pagos ya registrados como pagado no se modifican.

Una venta pasa a completada automáticamente cuando todos sus pagos tienen estado pagado.
Un pago fallido puede reintentarse — el sistema permite registrarlo nuevamente.
Una venta vencida puede regresar a activa si se regularizan los pagos pendientes.
Al crear una venta, el sistema auto-genera 1 pago tipo enganche + N pagos tipo quincenal (uno cada 15 días según num_quincenas).