Desarrollo de un Mvp de plataforma de fidelización con saldo regalo...

Resumen del proyecto

Necesitamos desarrollar una plataforma de fidelización donde el cliente recibe un saldo regalo (Bono OXS) y lo puede gastar en comercios asociados. Los comercios pueden emitir bonos, cobrar bonos mediante QR y recargar saldo con tarjeta. El sistema incluye desbloqueos temporales, bloqueos para comercios, match promocional, caps y antifraude básico.

1. Alcance funcional (MVP)

3.1 App móvil (una sola app con 2 modos)

Modo Cliente

•    Registro/por teléfono + OTP (preferible) o email (aceptable).

•    Pantalla de saldo: total, disponible hoy y próximos desbloqueos (30/60 días).

•    QR dinámico para pago (expira 60-120 segundos).

•    Listado y mapa de comercios asociados + filtros por categoría.

•    Historial: bonos recibidos, gastos y desbloqueos.

•    Notificaciones push: bono recibido, desbloqueos y caducidad.

Modo Comercio (POS)

•    + roles (operador / admin del comercio).

•    Cobrar bono: escanear QR del cliente, introducir ticket y confirmar operación.

•    Emitir bono: buscar cliente (teléfono o QR) y emitir importe.

•    Panel comercio: saldo líquido y bloqueado (con fechas), ventas por periodos, nivel y progreso.

•    Recarga de saldo con tarjeta (Stripe) con packs predefinidos.

3.2 Backoffice web (Admin plataforma + Admin comercio)

•    Gestión de comercios: alta, categoría, nivel, condiciones y usuarios.

•    Gestión del pool promocional: match por categoría/nivel, caps globales y por comercio, crédito de alta.

•    Antifraude básico: límites por cliente/comercio, flags y congelación manual de match pendiente.

•    Reporting mínimo: recargas, bonos emitidos/canjeados, consumo del pool promo, reutilización estimada.

1. Reglas del negocio (implementar tal cual)

Cliente (desbloqueo)

•    50% disponible inmediato.

•    25% desbloqueo a 30 días.

•    25% desbloqueo a 60 días.

•    Caducidad del bono: 12 meses.

Comercio (cobro al recibir bono)

•    Cobro 100% en OXS.

•    Split: 50% líquido + 50% bloqueado 60 días.

Match promocional (pool promo) — híbrido

•    20% del match inmediato.

•    50% por activación de uso (se libera al canjearse bonos).

•    30% diferido: 15% a 30 días + 15% a 60 días.

Crédito de alta (nuevo comercio)

•    Importes configurables por categoría: consumo 75€, técnicos 120€, ancla 200€, viajes 120€.

•    Liberación: 30% día 1 y 70% tras 10 canjes reales de clientes distintos.

•    Caducidad: 30% (15 días) y 70% (45 días para desbloquear).

Límites antifraude (configurable)

•    Cliente: 150€/día y 600€/mes (equivalente).

•    Recepción: 2 bonos/semana y 6/mes.

•    QR con expiración 60-120 segundos y protección anti-replay.

Requisitos técnicos

•    App: Flutter o React Native (proponer).

•    Backend: Node/NestJS o Python/FastAPI (proponer).

•    Base de datos: PostgreSQL.

•    API documentada (Swagger/OpenAPI).

•    Ledger interno auditable (transacciones inmutables).

•    Notificaciones push (Firebase).

•    Stripe para pagos con tarjeta (recargas).

•    Despliegue en cloud con Docker (aws/gcp/digitalocean).

•    Roles y permisos + logs.

•    Seguridad básica: JWT, rate limiting, protección de endpoints sensibles.

Nota: no se requiere integración on-chain en el MVP. Se plantea para fase futura.

Category: IT & Programming Subcategory: Web development What is the scope of the project?: Create a new custom site