Arquitectura · Índice

Arquitectura del Builder

Cómo está construido el webapp de generación de reglas — para quien quiera entender, usar o extender este tipo de sistema. Un monolito modular con un núcleo de dominio hexagonal: el cálculo en el centro, aislado de HTTP y del disco; el contrato definido una vez en el backend y propagado solo al frontend.

HTTP · API routes — exponen, delegan

Schemas (Pydantic) — el contrato

Services — orquestan, leen/escriben

— frontera: adentro no se sabe de HTTP ni de disco —

Domain — cálculo puro

Las cuatro páginas

De los cimientos a la extensibilidad. Cada una abre en su propia pestaña.

A1 Forma y Stack →Monolito modular con núcleo hexagonal, el stack (FastAPI/Pydantic, Next.js/TS, storage), los 6 principios rectores y los nombres por intención. A2 Fuente de Verdad →El contrato que viaja solo: Pydantic → OpenAPI → TypeScript. Zod para UX, i18n por códigos, y el versionado de la API. A3 Dominio y Servicio →El dominio calcula, el servicio orquesta: las 6 reglas de una función pura, el ejemplo bien/mal, y cómo la forma protege la integridad del resultado. A4 Extender el Sistema →El walkthrough de 9 pasos para agregar un módulo de punta a punta, con el ejemplo del medidor de estrés de mercado, y el checklist de PR.

Complementa la guía técnica del pipeline. Esta serie describe la tecnología —cómo está armado el software—; la otra describe el método quant —qué calcula cada paso y por qué. La misma arquitectura que hace el código testeable y reusable es la que mantiene honestos los resultados.