Bioker — Plan de Producto (v2)

Versión v2: incorpora las resoluciones del cliente a las contradicciones y dudas de la v1. Lo resuelto se marca en verde; lo que sigue pendiente (del cliente) en rojo; lo que queda fuera de alcance en azul. Organizado por módulo/perfil, con diagrama de flujo por cada uno.

✅ Decisiones incorporadas en esta versión

Precio: nunca visible sin login. Tras iniciar sesión → precio real del producto menos el % de descuento del tipo de usuario. Precio en el público a futuro = feature flag.
Compra: el portal solo permite comprar a usuarios creados con poder de venta. Externos nunca compran directamente; el público es atendido por un Representante.
Crédito bancario: fuera de alcance — no nos compete (lo maneja el cliente/su banco).
Moneda: siempre en USD; si el pago es en Bs (único método por ahora), el checkout muestra el equivalente a tasa BCV del día (integración con BCV).
Jerarquía de usuarios: cada perfil crea usuarios que heredan de él — Gerente de Zona → Líder de Venta → Representante.
Catálogo: se construye un módulo ecommerce de gestión (productos, categorías, secciones, campañas).

0. Visión y modelo de negocio

Ecosistema de venta directa. El público ve un catálogo aspiracional sin precios y sin compra directa: toda compra ocurre dentro del portal privado, únicamente para usuarios con poder de venta (Representante, Líder, Gerente). La operación gira sobre ciclos comerciales de 21 días (17 campañas/año).

timeline title Ciclo operativo de 21 días (x17 campañas/año) Días 1-5 : Toma de pedidos (representantes consolidan clientas) Días 6-10 : Despacho y logística (flete incluido) Días 11-16 : Cobro / seguimiento Días 17-21 : Liquidación + comisiones por ciclo

Módulo A Catálogo público & acceso · Perfil: Público / Cliente Final

Público general. Navega el catálogo aspiracional sin precios y no compra directamente: se canaliza hacia un Representante.

Claro Qué hará

Catálogo digital por campaña (categorías: capilar, corporal, tratamiento).
Diseño sensorial premium, mobile-first.
Sin precios sin login. El público ve producto e imagen, no precio.
Sin compra directa del público: quien quiere comprar es atendido por un Representante.
Al iniciar sesión, el usuario ve el precio real − % de descuento de su tipo.
Exponer precio al público a futuro = feature flag (apagado por ahora).

Flujo de acceso

flowchart TD A[Entra a la web] --> B[Explora catálogo por categoría] B --> C[Producto SIN precio] C --> D{¿Tiene cuenta con poder de venta?} D -->|No| E[Contacta a un Representante] D -->|Sí| F[Login] F --> G[Ve precio real menos % de su tipo] G --> H[Arma pedido en el portal]

✅ Resuelto — ¿precio visible?
Nunca sin iniciar sesión. Tras el login se muestra el precio real del producto menos el % de descuento del tipo de usuario. Exponer precio en el catálogo público queda como feature flag (apagado por defecto).

✅ Resuelto — ¿compra abierta?
No. Por ahora el portal es solo para compra de usuarios creados (con poder de venta). Externos nunca compran ahí; el público que desea comprar se canaliza a un Representante.

✅ Resuelto en módulo A

Origen del catálogo: se construye un módulo ecommerce para gestionar productos, categorías, secciones y campañas → pasa a alcance.
Jerarquía de usuarios: cada tipo de usuario crea usuarios que heredan de él (Gerente → Líder → Representante).

Dudas del módulo A

Geolocalización: aún no definido — cómo/si se usa para asignar Representante.

Módulo B Portal de la Representante · Perfil: Representante (Vendedora Base)

Portal privado con precio con su descuento. Consolida pedidos de sus clientas y paga en el checkout.

Claro Qué hará

Precio con su % de descuento según tipo de usuario.
CRM básico: agenda de clientas (nombre, teléfono, historial, recordatorio de cobranza).
Consolidación de pedidos de la campaña antes del día 5.
Checkout en USD; si paga en Bs, ve el equivalente a tasa BCV del día.
Panel de pedidos y seguimiento de entrega.

Flujo de la Representante

flowchart TD A[Login portal] --> B[Ve catálogo con su descuento] B --> C[Agenda clientas / CRM] C --> D[Consolida pedidos antes del día 5] D --> E[Checkout en USD] E --> F[Paga en Bs a tasa BCV del día] F --> G[Seguimiento de despacho]

✅ Resuelto — Moneda
Los precios son siempre en USD. En el checkout, si el pago es en Bs (único método por ahora), se muestra el equivalente calculado a tasa BCV del día → requiere integración con una fuente BCV.

🔵 Fuera de alcance — Microcrédito / banco
El modelo de crédito bancario (línea a la Representante, liquidación a 21 días) no nos compete: lo maneja el cliente. Se elimina el bloqueante del "banco sin definir" y el módulo de crédito del alcance del MVP.

Dudas del módulo B

Método de pago en Bs: ¿pasarela, transferencia con confirmación manual, o carga de comprobante? (definir el flujo de confirmación del pago).
Fuente y hora de fijación de la tasa BCV + política de redondeo.

Módulo C Portal de Liderazgo y Redes (MLM) · Perfiles: Líder de Ventas y Gerente de Zona

Dashboards de red multinivel, metas, alta jerárquica de usuarios y liquidación de comisiones por ciclo.

Claro Líder de Ventas (sectorial)

Dashboard en tiempo real de su célula de Representantes.
Metas por campaña con semaforización.
Comisión por sobrepaso / overriding.
Crea Representantes (usuarios que heredan de él).

Claro Gerente de Zona (estatal)

Dashboard macro: Líderes y Representantes de su zona.
Reportes territoriales por zona.
Comisión de zona.
Crea Líderes de Venta (que a su vez crean Representantes).

✅ Resuelto — Alta jerárquica de usuarios
Cada perfil crea usuarios que heredan de él: Gerente de Zona → Líder de Venta → Representante. La red se construye por creación descendente.

flowchart LR G[Gerente de Zona
crea Líderes] --> L1[Líder de Venta
crea Representantes] G --> L2[Líder 2] L1 --> R1[Representante] L1 --> R2[Representante] R1 --> C1[Clientas]

Dudas del módulo C

Pendiente (cliente) Reglas del árbol MLM (estructura fija vs variable, tamaños de célula) → lo define el cliente.
Menor Motor de comisiones: distinguir comisiones directas vs pagadas por la compañía (ej. líderes al cierre + 1 día).
Menor Alta de usuario: ¿requiere aprobación del superior o es directa?

Módulo D Panel de Administración & Backend · Perfil: Administrador / Equipo Diartipel

Gestión de catálogo (ecommerce), campañas, inventario, despacho y reportes.

Claro Qué hará

Módulo ecommerce: alta de productos, categorías, secciones y marcas (Brizna, Forelle, Solano, Gelly, Kapelli, Visiclass).
% de descuento por tipo de usuario (motor de precios).
Motor de ciclos: calendario de 17 campañas de 21 días.
Inventario, facturación y despacho por zonas.
Reportes exportables (Excel/PDF): volumen, rendimiento por municipio, margen.

Flujo de campaña (Admin)

flowchart TD A[Configura campaña 21 días] --> B[Carga catálogo ecommerce] B --> C[Define % descuento por tipo] C --> D[Recibe pedidos consolidados] D --> E[Genera lotes de despacho por zona] E --> F[Factura y controla inventario] F --> G[Reportes + comisiones] G --> A

🔵 Fuera de alcance — Logística / despacho
Lo maneja el cliente (flete incluido, despacho por zonas). Si elige una empresa de envío, la integración de tracking se cotiza como add-on aparte.

Dudas del módulo D

Inventario: ¿tiempo real y multi-almacén por zona, o stock central?
Facturación: requisitos fiscales (Venezuela) / integración contable.

5. Stack técnico e integraciones

Área	Definido	Estado
Frontend	WebApp React/Next.js · PWA mobile-first (sin tienda de apps)	Confirmar framework; app nativa a futuro
Backend	Node.js / Python / Laravel · escalable a 10.000 vendedoras	Elegir uno; definir infra/hosting
Gestión de catálogo	Módulo ecommerce (productos, categorías, secciones, campañas)	En alcance ✅
Precios / descuentos	Motor de % por tipo de usuario · precio visible solo con login	En alcance ✅ (feature flag para público)
Moneda / BCV	Precios en USD · checkout en Bs a tasa BCV del día	Integrar fuente BCV ✅
Crédito / banco	Microcrédito, liquidación bancaria	Fuera de alcance 🔵 (lo maneja el cliente)
Logística	Flete incluido · despacho por zonas	Fuera de alcance 🔵 (lo maneja el cliente; si elige courier → integrar tracking como add-on)
WhatsApp Business API	Confirmación de pedido y despacho	Proveedor + número verificado

6. Decisiones del cliente — estado

Precio visible en el catálogo público. ✅ Por ahora NO; se maneja con feature flag. Con login: precio real − % del tipo de usuario.

Compra directa del público. ✅ No. Siempre vía Representante; el portal solo permite comprar a usuarios creados con poder de venta.

Banco partner y modelo de crédito. 🔵 Fuera de alcance — no nos compete (lo maneja el cliente).

Moneda y tasa. ✅ Siempre USD; si el pago es en Bs, a tasa BCV del día (conectar con el BCV).

Reglas del árbol MLM. ⏳ Lo define el cliente.

Logística de despacho. 🔵 Fuera de alcance — lo maneja el cliente. Si elige una empresa de envío, la integración de tracking se cotiza como add-on.

Alcance del MVP vs. visión completa. ⏳ Se define de último.

7. Próximos pasos

Cerrar las 2 pendientes del cliente: reglas del árbol MLM (#5) y alcance del MVP (#7).
Definir en detalle el ciclo de 21 días. No haremos un control estricto del flujo, pero es clave mapear todas las etapas de la operación (pedidos → despacho → cobro → liquidación/comisiones) para no dejar cabos sueltos.
Definir el flujo de confirmación del pago en Bs y la fuente/hora de la tasa BCV.
Con crédito fuera de alcance → re-estimar presupuesto (baja el módulo de pago/banco; sube el módulo ecommerce de catálogo).
Arquitectura + wireframes mobile-first del portal privado.

v2 — decisiones del cliente incorporadas (28-jul-2026). Base: PRD "Plataforma Web Bioker" + 2 audios (Intro y Explicación de producto). Documento de trabajo interno; el presupuesto se re-estima al cerrar alcance (#5 y #7).