# Arquitectura de Tinkuy

<!-- Va en docs/architecture.md. Es el documento de arquitectura final, con
las secciones de arc42 que aplican. Las pruebas públicas buscan estos diez
títulos (pueden agregar más) y que cada ADR de docs/adr/ esté enlazado desde
aquí. No repitan lo que ya está en otro archivo: enlácenlo y digan en dos
líneas qué va a encontrar quien lo abra. -->

## Introducción y metas

<Qué hace Tinkuy, para quién, y las tres o cuatro metas de calidad que más
pesaron en su diseño, en orden.>

## Restricciones

<Lo que no se pudo elegir: el contenedor del curso, sin frameworks, las
interfaces fijas de los enunciados.>

## Contexto y alcance

<Quién usa el sistema y de qué sistemas ajenos depende. Enlace a
docs/c4/context.md.>

## Estrategia de solución

<Las decisiones grandes, una por entrega, cada una en una frase y con el
atributo de calidad que la motivó.>

## Vista de bloques de construcción

<Los procesos, los almacenes de datos y los módulos. Enlaces a
docs/c4/containers.md, docs/c4/components.md, docs/services.md y
docs/data-ownership.md.>

## Vista de tiempo de ejecución

<Los dos o tres recorridos que explican el sistema: una compra con todo sano,
una compra con la pasarela caída, una lectura del catálogo. Paso por paso,
con quién escribe qué y qué mensaje viaja.>

## Vista de despliegue

<Qué corre dónde: procesos, puertos, bases de datos, streams. Qué puede
faltar sin que el sistema deje de responder.>

## Conceptos transversales

<Lo que atraviesa todos los módulos: idempotencia, outbox, logs y requestId,
manejo de errores, configuración.>

## Decisiones de arquitectura

<La lista de todos los ADR, cada uno con su enlace (docs/adr/NNNN-….md), su
estado y una línea que diga qué decidió. Si uno reemplaza a otro, se nota
aquí.>

## Requisitos de calidad

<Los escenarios de docs/scenarios.md, cada uno con la prueba o el script que
lo comprueba y el último resultado medido. Enlace a docs/slo.md.>

## Riesgos y deuda técnica

<Lo que saben que está mal o a medias, sacado de las consecuencias de sus
ADR: qué puede salir mal, qué tan probable es y qué harían primero.>

## Glosario

<Los términos del dominio y del diseño que alguien nuevo no entendería.>
