Cómo diseñé y construí Medisys

const expiresAtMs = Date.now() + LOCK_DURATION_MINUTES * 60_000 // 15 min
const lockExpiraEn = new Date(expiresAtMs).toISOString()

const payloadBase = {
  tenant_id: doctorRes.data.tenant_id,
  doctor_id: doctorId,
  patient_id: patientId ?? null,
  fecha_hora: combineToISO(date, horaReferencial),
  estado: "pendiente",
  lock_expira_en: lockExpiraEn,
}

La cita nace bloqueada: el estado 'pendiente' con fecha de expiración es el propio mecanismo de reserva.

// El cupo solo está ocupado si el bloqueo sigue vigente
if (cita.estado === "pendiente" && cita.lock_expira_en) {
  return new Date(cita.lock_expira_en).getTime() > ahora
}

// Liberación: 'expirada' si venció, 'cancelada' si el paciente retrocedió
const estado = expirada ? "expirada" : "cancelada"
await supabase.from("appointments")
  .update({ estado })
  .eq("id", appointmentId)
  .eq("estado", "pendiente")

Disponibilidad y liberación: la segunda operación solo aplica si la cita sigue en 'pendiente' (guarda optimista).

/** Alícuota general del IVA vigente en Venezuela (16 %). */
export const IVA_VENEZUELA = 0.16

/** RIF canónico: `V-12345678-9`. */
export const RIF_REGEX = /^([VEJG])-(\d{8})-(\d)$/

/** Cédula canónica: `V-12345678`. */
export const CEDULA_REGEX = /^([VE])-(\d{6,9})$/

/** 16 % si la línea está gravada; 0 si es un servicio médico exento. */
export function alicuotaIva(taxable: boolean): number {
  return taxable ? IVA_VENEZUELA : 0
}

Funciones puras: mismos resultados en el servidor, en el navegador y en un script de verificación.

/** Alícuota del IGTF vigente en Venezuela (3 %). */
export const ALICUOTA_IGTF = 0.03

/** IGTF de un monto en USD (3 %), redondeado a 2 decimales. */
export function calcularIgtf(montoUSD: number): number {
  if (!Number.isFinite(montoUSD) || montoUSD <= 0) return 0
  return redondear2(montoUSD * ALICUOTA_IGTF)
}

export function desglosarCobro(entrada: {
  metodo: PaymentMethod
  montoUSD?: number
  montoVES?: number
  tasa: number
}): DesgloseCobro {
  const info = infoMetodoCobro(entrada.metodo)

  // La base se expresa siempre en USD (moneda de la factura).
  const baseUSD =
    entrada.montoUSD !== undefined && Number.isFinite(entrada.montoUSD)
      ? redondear2(Math.max(0, entrada.montoUSD))
      : aUsd(entrada.montoVES ?? 0, entrada.tasa)

  const igtf = info.aplicaIgtf ? calcularIgtf(baseUSD) : 0
  const total = redondear2(baseUSD + igtf)

  // …se devuelven además los equivalentes en VES a la tasa del cobro.
  return { metodo: entrada.metodo, aplicaIgtf: info.aplicaIgtf,
    baseUSD, baseVES: aVes(baseUSD, entrada.tasa),
    igtfUSD: igtf, igtfVES: aVes(igtf, entrada.tasa),
    totalUSD: total, totalVES: aVes(total, entrada.tasa) }
}

El IGTF no se pregunta en la pantalla de cobro: se deduce del método registrado.