Documentación del Sistema

Appearance

Aprobación de Presupuesto a Procesos de Ventas ​

Módulo: crm / ventas (integración) Tipo: Entry Point Estado: Pendiente de documentación Fecha: 2026-02-02

Descripción ​

Este documento establece el punto de entrada (entry point) que conecta el módulo CRM (presupuestos) con el módulo Ventas.

Una vez que un presupuesto es aprobado, se habilitan diversos procesos del ciclo de ventas. Este documento sirve como recordatorio de procesos pendientes de documentar y como referencia de la conexión entre módulos.

Propósito

Este es un documento de referencia para tener presente qué procesos de ventas deben documentarse en el futuro. No documenta los procesos en sí, solo los identifica.

Precondición ​

Para que se activen los procesos de ventas:

  • El presupuesto debe estar aprobado (approved = true)
  • Debe tener fecha de aprobación registrada

Procesos de Ventas a Documentar ​

Los siguientes procesos se derivan de un presupuesto aprobado y requieren documentación futura:

1. Conversión a Prefactura ​

¿Qué es? Generar una prefactura (documento preliminar de venta) a partir del presupuesto aprobado.

Relación existente: La tabla budget_prefa ya está creada en migraciones (PK compuesta: prefa_id, budget_id, con RESTRICT en ambos lados).

Datos principales a trasladar:

  • Cliente del registro CRM
  • Ítems del presupuesto (si existen)
  • Total, descuento, medios de pago

TODO

Documentar en: /docs/features/ventas/prefactura-desde-presupuesto.md

  • Flujo de conversión
  • Validaciones específicas
  • Casos de uso
  • Criterios de aceptación

5. Seguimiento de Ejecución ​

¿Qué es? Tracking del cumplimiento del presupuesto aprobado.

Funcionalidades esperadas:

  • Estado de avance (pendiente → en proceso → completado)
  • Control de tercerizaciones
  • Alertas de vencimiento de validez
  • Historial de conversiones

TODO

Documentar en: /docs/features/ventas/seguimiento-presupuesto.md

  • Dashboard de seguimiento
  • Indicadores de avance
  • Alertas y notificaciones

Regla de Negocio Principal ​

RN-TRANS-001: Inmutabilidad del Presupuesto Aprobado

Un presupuesto aprobado NO puede modificarse. Los procesos de ventas copian los datos del presupuesto pero no lo modifican. Si se requieren cambios, se debe crear un nuevo presupuesto.

Relación con Prefacturas ​

La estructura de datos ya contempla la relación:

  • Tabla budget_prefa creada en migraciones
  • PK compuesta: (prefa_id, budget_id)
  • DELETE RESTRICT en ambos lados (protege integridad)
  • Un presupuesto puede tener múltiples prefacturas

Próximos Pasos ​

  1. ✅ Entry point identificado y documentado
  2. ⏳ Documentar conversión a prefactura
  3. ⏳ Documentar facturación directa
  4. ⏳ Documentar órdenes de trabajo
  5. ⏳ Documentar remitos/entregas
  6. ⏳ Documentar seguimiento de ejecución

Última actualización: 2026-02-02