Alcance de desarrollo · Fase 1

App multicomercio de compra programada

12 oct 2026 · Victor Melo

Ver app del cliente Panel de comercio Panel super admin Panel de asesor

Cuota pagada Cuota de entrega, definida por cada comercio Cuota pendiente

Roles

Actores y paneles

La app tiene cuatro roles. Oficinas regionales, socio de vehículos, tiendas aliadas y el propio negocio del cliente son todos comercios, con el mismo panel.

Super admin

Dueño de la plataforma

Qué hace: Da de alta y aprueba comercios, configura el % de comisión, supervisa la operación
Qué ve: Todos los comercios, clientes, asesores, pagos y comisiones

Comercio

Oficinas, socios, tiendas aliadas, el cliente

Qué hace: Publica productos en las categorías generales, parametriza cuotas y entregas, recibe pagos y entrega
Qué ve: Solo sus productos, clientes, pagos, cuotas y entregas

Asesor de ventas

Captación en redes

Qué hace: Capta clientes en redes (Facebook, Instagram) y los lleva a WhatsApp
Qué ve: Sus clientes (por código de referido), puntaje y comisión por cliente

Cliente

Usuario de la app móvil

Qué hace: Se registra, elige producto de cualquier comercio, se suscribe y paga cuotas
Qué ve: Sus planes, cuotas pagadas y pendientes, fecha estimada de entrega, nivel

Arquitectura

Mapa de la plataforma

Todo pasa por el backend: la app y los paneles nunca se comunican directo entre sí ni con las integraciones.

Qué se construye

Alcance del desarrollo

La Fase 1 entrega una app móvil para clientes, tres paneles web (asesor, comercio y super admin) y el backend que los conecta. Lo que no esté listado en esta sección queda fuera del alcance.

Plataformas y tecnología

ComponenteTecnologíaUsuarios

App móvilFlutter · una sola base de código para Android (Google Play) e iOS (App Store)Clientes

Panel de asesorFlutter Web · responsive (computadora, tablet o teléfono)Asesores de ventas

Panel de comercioFlutter Web · responsiveDueños y empleados de cada comercio

Panel super adminFlutter Web · responsiveDueño de la plataforma y su equipo

BackendLaravel (PHP) · API central, lógica de negocio, motor de reglas y almacenamiento de archivos (cédulas, fotos, planos)Lo usan la app y los tres paneles

Base de datosPostgreSQL · una sola base para toda la plataforma, con los datos separados por comercio—

InfraestructuraServidor en la nube con copias de respaldo diarias, ambiente de pruebas y ambiente de producción—

La app se entrega en español. Los montos se manejan en USD, con su equivalente en bolívares cuando el pago es en bolívares.

App móvil — cliente

Flutter · Android e iOS

Bienvenida e inicio de sesión

Registro, inicio con correo o teléfono y contraseña, recuperación de contraseña

Registro

Datos personales, cédula (foto), referencias personales, constancia de trabajo, foto de perfil con cámara, código de referido del asesor (opcional), aceptación de términos y condiciones

Verificación de identidad

Validación KYC, activable o desactivable por el super admin

Inicio

Categorías, comercios destacados y acceso rápido a mis planes

Catálogo

Navegación por comercio, categoría y producto, con buscador y filtros por ubicación

Detalle de producto

Imágenes, prototipos o planos, descripción, precio o monto del plan y punto de retiro

Suscripción a un plan

Confirmación del plan elegido, resumen de condiciones del comercio y aceptación

Mis planes

Lista de planes activos, cuotas pagadas y pendientes, próxima fecha de pago, cuota de entrega y progreso

Pagar cuotas

Pago de la cuota del mes, adelanto de una o varias cuotas, o pago desde el primer día de todas las cuotas necesarias para llevarse el producto de una vez. En bolívares por SPIDI, internacional por Stripe, o reporte de pago hecho en oficina

Historial de pagos

Pagos con fecha, monto, método, estado y comprobante descargable

Mi nivel

Puntaje y nivel según puntualidad en los pagos

Notificaciones

Recordatorios de pago, pagos confirmados o rechazados, avisos de entrega

Perfil

Datos personales, documentos cargados, cambio de contraseña, cierre de sesión

Panel web de asesor

Flutter Web

El asesor entra a su panel web con su usuario. Su cuenta la crea el comercio o el super admin.

Inicio

Resumen de clientes registrados, planes activos, puntaje y comisión acumulada del mes

Mi código de referido

Código y enlace para compartir por WhatsApp, Facebook e Instagram

Mis clientes

Lista de clientes registrados con su código, plan elegido y estado de pagos (al día o atrasado)

Detalle de cliente

Plan, cuotas pagadas y pendientes, contacto directo por WhatsApp

Comisiones

Comisión generada por cliente, por mes, estado (pendiente o pagada)

Puntaje

Puntaje y nivel del asesor según clientes captados y pagos al día

Panel web de comercio

Flutter Web

Cada comercio ve solo su información y sus ingresos, nunca las comisiones de la plataforma. El comercio del cliente usa este mismo panel.

Dashboard

Clientes activos, recaudación del mes, cuotas vencidas, entregas próximas

Perfil del comercio

Nombre, logo, descripción, datos de contacto, WhatsApp, cuenta bancaria para recibir pagos

Sucursales y puntos de retiro

Alta de oficinas o tiendas con estado, ciudad y dirección

Usuarios del comercio

Crear empleados con permisos: administrador, operador de pagos, solo lectura

Productos

Crear productos con fotos, planos, descripción, precio o monto y sucursal; cada producto se asigna a una categoría general creada por el super admin

Reglas de cuotas y entrega

Configuración general, por categoría o por producto (ver Parametrización)

Clientes

Lista y ficha de cada cliente con documentos, planes, pagos y asesor asignado; aprobar o rechazar registros

Planes de clientes

Estado de cada plan: activo, atrasado, listo para entrega, entregado o cancelado

Pagos

Pagos recibidos por SPIDI y Stripe; registro manual de pagos en oficina (efectivo o divisas) con comprobante; confirmar o rechazar pagos reportados

Entregas

Lista de clientes que alcanzaron la cuota de entrega; marcar entrega realizada con fecha y sucursal

Asesores

Crear asesores, ver sus clientes, comisiones y puntaje; marcar comisiones como pagadas

Ingresos

Ingresos netos del comercio por período, por producto y por método de pago

Reportes

Recaudación, morosidad, entregas y asesores; exportación a Excel

Panel web super admin

Flutter Web

El dueño de la plataforma controla todos los comercios y la comisión desde aquí.

Dashboard global

Comercios activos, clientes, recaudación total, comisiones cobradas y por cobrar

Comercios

Alta, aprobación, suspensión y edición de comercios; acceso completo para ver y editar la información de cada comercio (productos, reglas, clientes, pagos y entregas)

Comisión de la plataforma

% general configurable y % especial por comercio

Categorías

Crea y administra las categorías generales de la app; los comercios solo asignan sus productos a ellas

Clientes

Búsqueda de cualquier cliente en todos los comercios; bloqueo de usuarios

Asesores

Vista de todos los asesores, sus comercios, clientes y comisiones

Pagos y comisiones

Todas las transacciones con la comisión retenida; cuentas por cobrar a comercios por pagos manuales; marcar cobros recibidos

Configuración

Términos y condiciones vigentes, activar o desactivar la verificación KYC, parámetros de puntaje y niveles, textos de notificaciones

Usuarios administradores

Equipo del super admin con permisos

Reportes

Recaudación y comisiones por comercio y por período; exportación a Excel

Bitácora

Registro de cambios sensibles: quién cambió reglas, comisiones o pagos y cuándo

Navegables

Prototipos

Recorridos clicables de cada pantalla del alcance, con datos de demostración.

App del cliente

Desde el inicio de sesión hasta una compra exitosa, con adelanto de cuotas.

Abrir prototipo

Panel de asesor

Código de referido para compartir, clientes captados, comisiones por mes y puntaje.

Abrir prototipo

Panel de comercio

Confirmar pagos, entregar productos, reglas de cuotas en tres niveles, productos, asesores e ingresos.

Abrir prototipo

Panel super admin

Aprobar comercios, comisión general y especial, categorías, cuentas por cobrar, configuración y bitácora.

Abrir prototipo

Lo que se programa

Módulos del sistema

Las pantallas y paneles anteriores se apoyan en estos 23 módulos del backend. Cada uno es una pieza de trabajo que se diseña, programa y prueba.

Usuarios y acceso

01AutenticaciónRegistro, inicio de sesión con correo o teléfono, recuperación de contraseña y cierre de sesión por inactividad
02Roles y permisosCliente, asesor, comercio y sus empleados, super admin y su equipo; ningún comercio ve datos de otro
03Gestión documentalCarga y almacenamiento privado de cédulas, referencias, constancias, fotos y planos
04Verificación de identidad (KYC)Integración con el proveedor, activable o desactivable por el super admin
05Términos y condicionesVersión vigente y registro de la aceptación de cada usuario

Comercios y catálogo

06MulticomercioAlta, aprobación, suspensión y edición de comercios, perfil, cuenta bancaria, sucursales y puntos de retiro
07Categorías generalesLas crea el super admin; los comercios asignan sus productos a ellas
08Catálogo de productosProductos, imágenes, búsqueda y filtros por comercio, categoría y ubicación

Planes y cuotas

09Motor de reglas de cuotas y entregasParámetros en cascada (general, categoría, producto); manda la regla más específica
10Planes y suscripcionesCalendario de cuotas de cada cliente, recalculado cuando adelanta cuotas, y estado del plan: activo, atrasado, listo para entrega, entregado o cancelado
11Adjudicación y entregasDetecta la cuota de entrega alcanzada, ya sea pagando mes a mes o adelantando cuotas, maneja las modalidades de adjudicación y registra la entrega

Dinero

12Pago de cuotasPago mensual, adelanto de cuotas y pago de todas las cuotas necesarias para la entrega desde el primer día; SPIDI, Stripe, pagos reportados y registrados en oficina, confirmación o rechazo y comprobantes
13Comisiones de la plataforma% general y por comercio, retención automática y cuentas por cobrar por pagos manuales
14Conversión de monedaMontos en USD con su equivalente en bolívares; fuente de la tasa de cambio por definir
15Ingresos del comercioIngresos netos por período, producto y método de pago, sin comisiones de la plataforma

Asesores y niveles

16ReferidosCódigo y enlace por asesor y asignación automática del cliente al registrarse
17Comisiones de asesoresCálculo por cliente y por mes, con estado pendiente o pagada
18Niveles y puntajeClientes por puntualidad en los pagos; asesores por clientes captados y pagos al día; parámetros configurables

Comunicación

19Notificaciones pushRegistro, pagos confirmados o rechazados, recordatorios, atrasos y entrega disponible
20Correo electrónicoLos mismos eventos por correo, con textos editables desde el super admin

Operación y control

21Tareas programadasProcesos automáticos de vencimiento de cuotas, recordatorios y recálculo de estados, puntajes y comisiones
22Reportes y dashboardsIndicadores por panel y exportación a Excel
23Bitácora (auditoría)Quién cambió reglas, comisiones o pagos y cuándo

Motor de reglas

Parametrización de cuotas y entregas

Cada comercio define sus reglas en tres niveles, y la más específica manda: producto sobre categoría, categoría sobre general.

General del comercio

Cuando la categoría y el producto no tienen regla propia

Regla por defecto para todo el catálogo del comercio

Categoría

Sobrescribe la regla general

Todos los productos de una categoría comparten plazos y entrega

Producto

Sobrescribe categoría y general

Un producto puntual con condiciones propias

Parámetros que el comercio configura en cada nivel

Montos o precio del plan Plazos disponibles para el cliente % asignado a cada cuota Cuota inicial (si aplica) Cuota a partir de la cual se entrega el producto Modalidad de adjudicación: antigüedad, sorteo, licitación o pago total anticipado Puntos de retiro

La app no fija montos, plazos ni cuotas: todo valor lo carga cada comercio desde su panel.

Dinero

Pagos y comisiones

La plataforma retiene en cada transacción un % que el super admin configura; el resto va a la cuenta del comercio.

Adelanto de cuotasEl cliente puede adelantar una o varias cuotas, o pagar desde el primer día todas las cuotas necesarias para alcanzar la cuota de entrega y llevarse el producto de una vez.
BolívaresSPIDI (aliado de pagos en bolívares), que retiene automáticamente el % de la plataforma.
ExteriorStripe opcional, para familiares que pagan desde fuera de Venezuela.
Pagos en oficinaEl comercio los registra manualmente (efectivo o divisas); el % de la plataforma queda como cuenta por cobrar a ese comercio, visible solo en el panel super admin.
AsesoresComisión por cliente registrado, visible en su panel (monto o % por definir).

Aplica a todo

Requisitos transversales

Estos requisitos aplican a la app y a los tres paneles.

Roles y permisosCliente, asesor, usuario de comercio (con sus permisos) y super admin; nadie ve datos de otro comercio.
NotificacionesPush en la app y correo electrónico para registro, pagos, recordatorios de cuota (anticipación configurable), pagos atrasados y entrega disponible.
Cálculo automáticoEstado de cada plan, cuotas vencidas, cuota de entrega alcanzada, puntaje del cliente y del asesor, comisión de la plataforma y del asesor.
SeguridadContraseñas cifradas, conexión segura (HTTPS), documentos privados accesibles solo por el comercio y el super admin, sesión con cierre por inactividad en los paneles.
RespaldosCopia diaria de la base de datos y de los archivos.
DiseñoIdentidad visual nueva (nombre y logo a definir), interfaz adaptada a teléfono en la app y a computadora en los paneles.

Límites

Fuera del alcance

No se incluye en la Fase 1; cualquiera de estos puntos se cotiza aparte.

Contabilidad, facturación fiscal o integración con sistemas contables del comercio.
Pago automático de comisiones a asesores (el panel solo las calcula y las marca como pagadas).
Sorteos y licitaciones automáticos dentro de la app (se pueden configurar como modalidad, pero la ejecución es manual).
Chat interno en la app y contacto directo con el comercio (la compra se hace dentro de la app).
Firma electrónica de contratos.
Redacción de términos y condiciones y asesoría legal.
Campañas de marketing, manejo de redes y contenido.
Fotos, planos y textos de productos (los carga cada comercio).
Idiomas distintos al español.
Integraciones no listadas en Pagos y comisiones.

Cierre

Entregables y criterios de aceptación

La Fase 1 se da por entregada cuando el comercio del cliente completa el flujo de punta a punta en producción.

EntregableSe acepta cuando

✓Propuesta de marca (nombres y logo)El cliente aprueba nombre y logo

✓Diseño de pantallas (app y paneles)El cliente aprueba las pantallas antes de programar

✓App publicada en Google Play y App StoreLa app está disponible para descarga en ambas tiendas

✓Panel de comercio en líneaUn comercio puede cargar productos, configurar reglas, registrar pagos y marcar entregas

✓Panel super admin en líneaSe puede crear un comercio, configurar la comisión y ver la recaudación global

✓Flujo completo probadoUn cliente se registra con código de asesor, se suscribe, paga por SPIDI y en oficina, y llega a la cuota de entrega; la comisión de plataforma y asesor se calcula bien

✓Carga inicialComercio del cliente configurado con sus planes de vivienda y vehículos

✓CapacitaciónUna sesión para el super admin y una para el comercio del cliente

✓Manual de usoGuía breve de cada panel

Las correcciones de errores sobre lo listado en este documento están incluidas durante el período de garantía (duración por definir en la propuesta).