Desarrollo de un Mvp de plataforma de fidelización con saldo regalo para comercios asociados

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.

3. Alcance funcional (MVP)
3.1 App móvil (una sola app con 2 modos)

Modo Cliente
•    Registro/login 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)
•    Login + 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.

4. 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.