# External sources are adapters with fakes

The repository's architectural decision, rationale and consequences.

# External sources are adapters with fakes

Every outside source — results pages (Smoothcomp, IBJJF, bracket photo via OCR), the AI model, travel prices and the event catalogue — sits behind an adapter interface with a deterministic fake used in development and tests. A real adapter is enabled per source only after its terms of use are validated, reads only a link the Athlete pasted, at most once per link per day, with a 24 h cache (RNF09). Vendors stay `[TBD]` in configuration until contracted.

