Roadmap

Esta página lista los módulos que están planificados pero aún no implementados. El estado reflejado aquí es el estado actual del desarrollo, no una promesa de fechas.

---

Completado recientemente

Cotizaciones — Generación de PDF

Estado: Completado (Abril 2026)

Generación de documentos PDF por demanda para cotizaciones existentes. El PDF se genera en tiempo real desde el estado actual de la cotización y se sirve directamente al navegador sin almacenamiento en disco.

• Endpoint GET /api/v1/quotes/:id/pdf con streaming en tiempo real vía @react-pdf/renderer.
• Plantilla con encabezado (número, título, fechas), bloque de contacto, direcciones de envío y facturación en paralelo, tabla de ítems con opciones de variante, desglose financiero completo y sección de T&C.
• Botón en QuoteDetail visible solo para cotizaciones activas (submitted, negotiating, approved, partially_approved, converted).
• Dirección de facturación seleccionable por cotización (billingAddressId en quotes).
• Términos y condiciones configurables por empresa vía CompanyConfiguration.

Cotizaciones — Timeline de eventos

Estado: Completado (Abril 2026)

Historial de auditoría orientado al usuario para cada cotización. Registra todas las transiciones de estado con actor (admin, comprador, sistema) y metadatos.

• Endpoint GET /api/v1/quotes/:id/timeline.
• Modelo QuoteEvent con actorType, actorId, actorName y metadata JSON.
• Se registra automáticamente en cada acción del flujo (submit, respond, approve, reject, cancel, etc.).
• Backfill de eventos históricos para cotizaciones existentes.

Cotizaciones — Acciones del comprador (submit)

Estado: Completado (Abril 2026)

Endpoint dedicado para que el comprador envíe su cotización desde el portal, separado del endpoint de edición.

• Endpoint POST /api/v1/buyer/quotes/:id/submit.
• Valida que la cotización esté en estado draft y tenga al menos un ítem antes de hacer la transición.

Clientes — Actualización de perfil propio

Estado: Completado (Abril 2026)

Los compradores pueden actualizar su propio perfil (nombre, teléfono, idioma) desde el portal sin intervención del administrador.

• Endpoint PUT /api/v1/customers/me.
• Protegido por auth de comprador; no permite cambiar email ni estado.

---

En desarrollo

(No hay ítems activos en este momento.)

---

Planeado — Alta prioridad

Orders / Checkout

Prioridad: Alta
Estado: No iniciado

El módulo de Orders cierra el ciclo de compra que hoy termina en cotizaciones aprobadas. Su objetivo es convertir cotizaciones aprobadas en órdenes formales con seguimiento de estado.

Capacidades esperadas:

• Conversión de cotización aprobada a orden (acción converted ya existe en el modelo de Quote).
• Modelo de datos de orden con número secuencial por empresa (ORD-0001).
• Estados de orden: pending_confirmation → confirmed → processing → shipped → delivered → cancelled.
• Ítems de orden como snapshot inmutable al momento de conversión.
• Totales finales heredados de la cotización.
• Dirección de envío vinculada desde la cotización o seleccionada al confirmar.
• API REST completa (admin + buyer portal).
• Historial de estado con timestamps por transición.

Dependencias:

• El módulo de Cotizaciones ya incluye el estado converted.
• La infraestructura de background jobs (VelociQueue) está lista para notificaciones de cambio de estado.

Límites de storefront por empresa

Prioridad: Alta
Estado: No iniciado

Configuración granular de qué funcionalidades y límites aplican por empresa en sus storefronts: número máximo de storefronts, restricciones de catálogo, etc.

PRD: docs/prd-company-storefront-limits.md

Roles y permisos de contactos

Prioridad: Alta
Estado: No iniciado

Extensión del sistema de permisos de compradores para soportar roles personalizados por empresa, más allá de los 4 roles predefinidos actuales.

PRD: docs/prd-contact-roles-permissions.md

---

Planeado — Media prioridad

Pagos (Payments)

Integración con pasarelas de pago para cobrar órdenes. Requiere el módulo de Orders como prerequisito.

Envíos (Shipping)

Integración con proveedores de logística para cotizar y rastrear envíos. Requiere el módulo de Orders como prerequisito.

---

Descartado / Sin fecha

Los siguientes ítems han sido considerados pero no tienen prioridad definida:

• Auto-registro de compradores desde storefront — Requiere flujo de aprobación para evitar spam.
• Temas personalizados de storefront — La personalización actual (color primario, logo) cubre los casos de uso inmediatos.
• Importación masiva desde archivo — El bulk upsert vía API cubre la mayoría de integraciones con ERP.

---

Para agregar un módulo a este roadmap, crea una sesión de planificación con el equipo de producto y actualiza este archivo con la descripción y prioridad acordadas.