Points and rewards: gamification engine in SIMAP Digital

// src/services/puntosService.js

/**
 * Convert a points balance to its Balboa value.
 * 100 points = B/.1.00  →  1 point = B/.0.01
 */
export function calcularDescuentoBalboas(puntos) {
  return puntos / 100;
}

/**
 * Convert a Balboa amount back into points (for display or validation).
 */
export function balboasAPuntos(balboas) {
  return Math.floor(balboas * 100);
}

// src/services/puntosService.js

/**
 * Award points to a resident for a positive action.
 * Writes a 'ganancia' record to puntos_historial.
 */
export async function otorgarPuntos(usuarioId, cantidad, motivo) {
  if (cantidad <= 0) return;

  await db.puntos_historial.add({
    usuarioId: String(usuarioId),
    cantidad: cantidad,
    tipo_transaccion: 'ganancia',
    motivo: motivo,        // e.g. 'Pago puntual antes del día 15'
    fecha: new Date().toISOString()
  });
}

/**
 * Redeem points as a bill discount.
 * Writes a 'canje' record and throws if the balance is insufficient.
 */
export async function canjearPuntos(usuarioId, cantidad, motivo = 'Descuento en cobro') {
  const saldoActual = await obtenerSaldoPuntos(usuarioId);
  if (cantidad > saldoActual) {
    throw new Error('No hay suficientes puntos para canjear');
  }

  await db.puntos_historial.add({
    usuarioId: String(usuarioId),
    cantidad: cantidad,
    tipo_transaccion: 'canje',
    motivo: motivo,
    fecha: new Date().toISOString()
  });
}

export async function obtenerSaldoPuntos(usuarioId) {
  const historial = await db.puntos_historial
    .where('usuarioId').equals(String(usuarioId))
    .toArray();

  let saldo = 0;
  for (const h of historial) {
    if (h.tipo_transaccion === 'ganancia') {
      saldo += h.cantidad;
    } else if (h.tipo_transaccion === 'canje') {
      saldo -= h.cantidad;
    }
  }
  return saldo;
}