Fintech Engineering Handbook

Artículo original ↗ Discusión en Hacker News ↗

Recepción general del handbook

  • Muchos lectores con experiencia en fintech dicen que los consejos coinciden con la práctica real y son útiles para quienes empiezan.
  • Otros lo encuentran superficial en algunos puntos o con omisiones importantes (FX, libros contables, cumplimiento).
  • Hay cierto escepticismo sobre la autoría con IA; el autor aclara que la mayor parte proviene de la experiencia, con algo de ayuda de IA en la edición.
  • Varios subrayan que ningún handbook genérico puede reemplazar la guía específica de la empresa, moldeada por abogados y cumplimiento.

Idempotencia, reintentos, trazas de auditoría y webhooks

  • Existe un fuerte acuerdo en que las claves de idempotencia, una semántica cuidadosa de reintentos y los eventos ordenados son críticos, especialmente con pagos y webhooks.
  • Las buenas trazas de auditoría se describen tanto como una herramienta de depuración como un respaldo esencial de cumplimiento; algunos ingenieros construyen “solo trazas de auditoría” como su fuente principal de datos.
  • Los webhooks se usan ampliamente en pagos (por ejemplo, para confirmar el estado de una transacción), pero no son universales en todos los sectores.

Representar dinero: enteros, decimales, floats, cadenas

  • La representación basada en int de “unidad menor” (por ejemplo, céntimos) se defiende como estándar de la industria en muchas áreas (HFT, pagos, banca de consumo).
  • Los críticos argumentan que las unidades menores como ints se vuelven frágiles con:
    • monedas con distintos números de decimales,
    • stablecoins/crypto con diferentes precisiones,
    • sistemas de socios que asumen silenciosamente exponentes distintos.
  • Se discuten alternativas:
    • Decimal de precisión arbitraria o tipos decimales nativos del lenguaje.
    • Representación JSON basada en cadenas para evitar problemas de parseo de floats.
    • Mantisa entera + exponente entero (punto flotante decimal).
    • Esquemas de punto fijo (por ejemplo, escalar por 10^n).
  • Visión minoritaria fuerte: los doubles son aceptables y comunes si:
    • se respetan los límites de precisión,
    • se redondea de forma consistente después de cada operación,
    • se usa matemáticas contables especializadas.
  • Otros insisten en que los floats nunca deben usarse para saldos de custodia/contabilidad; las aproximaciones solo son aceptables en contextos de modelado/cuánt.
  • Consenso en que unas reglas explícitas de redondeo y la reconciliación son esenciales, independientemente de la representación.

Libros contables, inmutabilidad, event sourcing y modelado de datos

  • Hay acuerdo en que el estado monetario central debe ser inmutable y derivarse de movimientos, pero:
    • Algunos prefieren el event sourcing completo;
    • Otros favorecen registros de auditoría append-only más simples para evitar una reproducción de estado compleja.
  • Debate sobre si “el saldo nunca se almacena” es práctico; algunos lo consideran al borde de ser un mal consejo.
  • Se señala que FX e instrumentos complejos necesitan mucha más sutileza de la que ofrece el handbook (tipos de cambio, políticas de redondeo, reglas legales de precisión).
  • La linaje de datos y el versionado de datos externos/de proveedores se destacan como temas ausentes pero importantes.

Cumplimiento, PII y restricciones organizativas

  • Una corriente defiende separar la PII de los registros financieros para permitir el borrado preservando al mismo tiempo el historial financiero requerido.
  • Otra advierte que esto puede chocar con KYC/AML y con requisitos de investigación; insiste en seguir políticas internas, específicas de cada jurisdicción, por encima de consejos genéricos.
  • Algunos sostienen que los ingenieros en empresas reguladas deberían, en su mayoría, seguir estándares internos establecidos en lugar de “buscar” patrones en línea; otros responden que hacen falta ideas externas para modernizar prácticas heredadas.

Alcance de “fintech” y compensaciones específicas del dominio

  • Varios comentaristas señalan que “fintech” abarca subdominios muy distintos:
    • HFT y trading de baja latencia,
    • pagos y banca de consumo,
    • monederos crypto y blockchains,
    • modelado de riesgo/cuánt.
  • Lo que es “correcto” (ints vs decimales, profundidad del event sourcing, niveles de precisión) varía mucho según el subdominio y las restricciones de rendimiento/cumplimiento.
  • Varios subrayan que aprender contabilidad y principios de libros contables, además de fundamentos de bases de datos, es más importante que cualquier elección tecnológica específica.

Notas prácticas y recursos varios

  • Las comprobaciones de saldo de ACH/Plaid no son garantías; los fondos pueden desaparecer antes de la liquidación.
  • El manejo de sobregiros y la semántica de “envíalo para saber con certeza” se reconocen como realidades.
  • Entre los recursos mencionados para profundizar hay guías de contabilidad para desarrolladores, artículos sobre escalado de libros contables, libros de sistemas intensivos en datos y lecturas estándar sobre mercados de capitales y renta fija.