DevSprinters

Plataforma web completa de apuestas online desarrollada a medida, lista para operar como negocio digital. Combina tres líneas de producto, un sistema financiero propio, un panel administrativo de gestión y una experiencia de usuario fluida tipo aplicación moderna (SPA), todo dentro de un único producto integrado.

Líneas de apuestas disponibles:

1. Apuestas Deportivas: catálogo dinámico de deportes, eventos y mercados (1X2, hándicap, totales, etc.), cuotas y opciones configurables por evento, historial de apuestas del usuario, tickets activos y resultados, liquidación automática al cerrar eventos.

2. Apuestas Hípicas (Carreras de Caballos): gestión de carreras, caballos participantes y resultados; sistema de retos hípicos entre usuarios; apuestas individuales con seguimiento del estado de cada carrera.

3. Apuestas Personalizadas (Custom Bets): los usuarios autorizados pueden crear sus propias apuestas privadas e invitar a otros participantes, con sistema de permisos granular.

Sistema financiero y monedero virtual:

- Depósitos mediante MercadoPago y transferencia bancaria con verificación.

- Retiros vinculados a cuentas bancarias del usuario, con número de transacción único y validación administrativa.

- Registro contable de transacciones (movimientos, saldos, historial completo).

- Webhooks de pagos para integraciones externas.

- Sistema de comisiones configurable por tipo de operación o producto.

- Gestión de cuentas bancarias asociadas a cada usuario.

Panel de Administración Profesional:

- Dashboard ejecutivo con métricas clave en tiempo real (usuarios totales, verificados, depósitos aprobados/pendientes, retiros pendientes, apuestas activas).

- Gestión de usuarios (alta, edición, permisos, bloqueos, 2FA).

- Aprobación y control de depósitos y retiros.

- Administración de deportes, eventos y mercados deportivos.

- Administración de carreras hípicas con caballos, cuotas y resultados.

- Configuración del sistema de comisiones.

- Módulo de reportes financieros y operativos con exportación a Excel (Resumen General, Usuarios, Transacciones, Apuestas Deportivas, Carreras, Comisiones).

- Configuración global de la plataforma.

- Auditoría completa mediante registro de actividades.

Seguridad y cumplimiento:

- Autenticación multi-factor (2FA con TOTP).

- Verificación de email obligatoria.

- Recuperación segura de contraseñas.

- Registro de actividad y auditoría de operaciones críticas.

- Validación estricta en cada formulario y endpoint.

- Páginas legales integradas (Privacidad y Términos).

- Recordatorios de juego responsable.

Experiencia del usuario final:

- Interfaz moderna, responsive y accesible, optimizada para escritorio y móvil.

- Modo oscuro nativo con paleta verde corporativa.

- Navegación instantánea sin recargas (SPA real).

- Panel de configuración personal: perfil, contraseña, apariencia y seguridad.

Stack técnico:

- Backend: Laravel 12 (PHP 8.3)

- Frontend: React 19 + TypeScript + Inertia.js v2

- Estilos: Tailwind CSS v4 con sistema de diseño propio basado en Radix UI

- Base de datos relacional con 20+ tablas y migraciones versionadas.

- Suite de pruebas automatizadas (PHPUnit).

- Cola de trabajos en segundo plano para tareas pesadas (notificaciones, procesos financieros, webhooks).

- Tipado estricto extremo a extremo.

- Código revisado automáticamente con Laravel Pint, ESLint y Prettier.

Magnitud del proyecto:

- 3 verticales de negocio (Deportes, Hípica, Custom Bets)

- 9 módulos administrativos independientes

- 20+ tablas de base de datos

- 20+ controladores backend

- 25+ páginas frontend

- Sistemas integrados: Pagos, Comisiones, Wallet, 2FA, Auditoría, Reportes

Implementación de dos módulos críticos en la plataforma DJ Ponla: (1) un sistema de suscripciones recurrentes integrado con Culqi (procesador de pagos peruano) y (2) un sistema de facturación electrónica conforme a SUNAT. Adicionalmente, se ejecutó una migración completa del stack original (Vercel + Supabase + React) a una arquitectura Laravel + React desplegada en VPS propio.

PARTE 1: MÓDULO DE SUSCRIPCIONES (Culqi)

Soporte multimoneda (PEN/USD), trials gratuitos, códigos de descuento, suscripciones vitalicias y grandfathered.

Modelos: CulqiPlan (catálogo de planes mensual/semestral/anual sincronizado con Culqi API), CulqiSubscription (estados pending_payment/active/trialing/cancelled, integrity_hash antimanipulación), CulqiCustomer, CulqiCard (con detección de reutilización para fraude de trial), DiscountCode + DiscountCodeUsage + CulqiDiscountPlan (códigos porcentuales con validez y límites), UserTrialHistory.

Servicios: CulqiService (~577 LOC, cliente HTTP a Culqi v2 API), CulqiSyncService (reconciliación BD <-> Culqi), PlanSyncService (cache 1h), DiscountCodeService.

Flujos clave: Suscripción de pago con polling síncrono (7 intentos x 2s) + webhook charge.creation.succeeded, trials con recordatorio 2 días antes de vencer y antifraude por BIN+last4, cancelación diferida hasta current_period_end.

Endpoints REST: /api/v1/plans, /me/subscription (GET/POST/PUT/DELETE), /trial-eligibility, /change-plan, /change-card, /reactivate, /me/cards, /me/subscription/lifetime, /api/v1/webhooks/culqi.

Comandos artisan: app:expire-subscriptions, app:sync-culqi-plans, app:cancel-user-subscription, app:send-trial-reminders, app:cancel-failed-culqi-subscriptions.

PARTE 2: FACTURACIÓN ELECTRÓNICA SUNAT

Implementación completa de comprobantes electrónicos (Boleta 03, Factura 01) conforme a UBL 2.1 y catálogos SUNAT, con firma digital X.509 y envío SOAP.

Modelos: Invoice (serie + correlativo, tipo_doc 01/03, tipo_operacion 0101/0201/0401, valor_venta/igv/total, moneda + exchange_rate, xml_signed + hash, sunat_status, sunat_response, sunat_ticket, retry_count) e InvoiceSeries (next_correlativo atómico con lockForUpdate).

SunatService (~1092 LOC) con Greenter\See + DomPDF + NumeroALetras.

Determinación automática del comprobante:

- Perú con RUC -> Factura 01 (F001), 18% IGV

- Perú sin RUC -> Boleta 03 (B001), 18% IGV

- Extranjero exportador de servicios -> Factura 01 op 0201, 0% IGV

- Extranjero no domiciliado -> Factura 01 op 0401, 18% IGV

Validaciones SUNAT: HAL-09 (DNI 8 / RUC 11), HAL-10 (Boleta > S/700 obliga doc del adquirente), HAL-23 (razón social mínimo 3 caracteres).

Flujos: generación automática tras pago (webhook -> determina tipo -> calcula totales -> obtiene tipo de cambio SUNAT para USD -> firma XML -> genera PDF -> envío directo en factura o Resumen Diario en boleta), Resumen Diario asíncrono con tickets, reintentos hasta 3 intentos.

Endpoints: /me/invoices (lista, detalle, /pdf, /xml, /cdr).

Configuración: kill switch SUNAT_EMISSION_ENABLED, RUC + razón social + ubigeo, credenciales SOL, certificado X.509, modo producción vs BETA.

PARTE 3: MIGRACIÓN DE STACK

Migración del stack original Vercel + Supabase + React a Laravel + React + VPS propio, ganando control total sobre infraestructura, capacidad de webhooks robustos para pagos, integraciones SOAP con SUNAT y reducción de costos operativos.

Plataforma web monolítica para la gestión integral de un colegio (niveles Inicial, Primaria y Secundaria, en turnos Mañana, Tarde y Noche). Centraliza todo el ciclo académico: matriculación, asignación de cursos y materias, registro de calificaciones, generación de boletines y reportes oficiales para el Ministerio de Educación (MINEDU), y administración de usuarios. Sustituye procesos manuales en planillas Excel y Word por un único sistema con roles, trazabilidad y emisión automática de PDFs.

Contexto y problema que resuelve:

Antes existía un flujo disperso: la secretaría llevaba inscripciones en Excel, los profesores entregaban notas en planillas físicas, y los boletines bimestrales/trimestrales se armaban a mano sobre plantillas preimpresas. La plataforma unifica ese ciclo en una única fuente de verdad para alumnos, cursos y notas. Los boletines se generan superponiendo los datos sobre las mismas plantillas oficiales del colegio, de modo que el formato de salida es indistinguible del que se venía usando manualmente.

Stack técnico:

- Backend: PHP 8.x sobre Laravel 9

- Frontend: Blade + Livewire 2, Alpine.js, Tailwind CSS, SweetAlert2

- Base de datos: MySQL (22 modelos Eloquent)

- PDFs: FPDF + FPDI para superposición sobre plantillas preimpresas

- Excel: PhpSpreadsheet para imports masivos y exports

- Build: Vite

- Auth: custom (columnas usuario/clave)

Módulos por rol (5 tipos de usuario):

- Administrador: control total, CRUD de usuarios, gestión de cursos y materias, importación masiva desde Excel, promoción anual, backup de la BD, emisión de boletines.

- Secretaría: listas oficiales por curso, sexo, edad y nivel; reportes MINEDU; asesores; índices; exportaciones a PDF/Excel.

- Profesor: registro y edición de notas, vista consolidada de su carga, exportación de actas.

- Estudiante: consulta de notas y descarga de boletín.

- Coordinador: supervisión académica.

Características técnicas destacadas:

- Encriptación reversible de contraseñas con Crypt (AES vía APP_KEY) para soporte administrativo, con fallback para registros legacy.

- Generación de boletines superponiendo datos sobre PDFs preimpresos del colegio, con variantes por turno (mañana vs. tarde/noche) y modalidad (bimestral vs. trimestral) elegidas dinámicamente.

- 18 componentes Livewire para flujos interactivos sin recarga.

- Importación de Excel con validación y trazabilidad fila por fila.

- Backup integrado de la base de datos.

- Reportes ministeriales (MINEDU) con el formato exacto que exige la afiliación oficial.

Decisiones de diseño:

- Esquema y dominio en español (alumno, curso, matricula, notas, dicta, responsable).

- Modelos con primaryKey 'codigo' para preservar los códigos institucionales.

- Rutas agrupadas por prefijo según rol.

- Middleware AuthsUsers parametrizado que acepta lista de tipos permitidos.

Métricas del proyecto:

- 22 modelos Eloquent

- 9 controllers (AdminController ~7,000 LOC)

- 18 componentes Livewire

- 42 migraciones

- 91 vistas Blade

- 116 rutas registradas

- 5 plantillas PDF de boletín (turno x modalidad)

- 5 roles diferenciados