Architektura rozhoduje o tom, jak dobře se agent v systému zorientuje. U tohoto projektu je to nejsilnější hodnocená oblast: splněno všech 6 kontrol.

Skóre

Stav	Počet
✅ OK	6
🟥 Není OK	0

Celkově: systém je pro agenta čitelný. Architektura má aktuální diagram, infrastruktura je celá jako kód, dokumentace žije v repozitáři ve strojově čitelné podobě a API má generovaného klienta.

Co jsme hodnotili

#	Kontrola	Stav
1	Existuje aktuální high-level diagram interních i externích komponent a jejich integrací.	✅
2	Architektura je v souladu s aktuálními požadavky i roadmapou na nejbližší kvartál.	✅
3	Infrastruktura je definována jako kód (IaC) a je verzována.	✅
4	Technická dokumentace je součástí zdrojového kódu, je strojově čitelná a průběžně udržovaná.	✅
5	API je zdokumentováno ve strojově čitelném formátu a klientský kód je z něj generován.	✅
6	Dokumentace obsahuje přehled prostředí, instancí a jejich účelu.	✅

Zjištění

Dokumentace je součástí kódu

Technická dokumentace je vedená jako markdown přímo v repozitáři, verzovaná spolu s kódem a opatřená stavem a datem poslední aktualizace. Agent ji tedy čte stejným způsobem jako zdrojový kód, bez potřeby přístupu do externího nástroje. Nezávislá kontrola úplnosti dokumentace dala této oblasti 88 % ve všech službách.

⚠️ Dílčí zjištění: kontrola zároveň odhalila, že u dvou služeb se dokumentace rozešla s realitou. Popis stavového managementu a lokalizace odpovídá starší verzi kódu. Dokumentace u nich nechybí, je zastaralá. Řešíme v prioritizovaných zjištěních.

Infrastruktura celá jako kód

Prostředí je popsané deklarativně a verzované v gitu. Nový člen týmu ani agent nemusí zjišťovat stav z konzole cloudového poskytovatele. To má přímý dopad na AI vývoj: agent může navrhnout změnu infrastruktury jako běžný merge request, který projde stejným review.

API se generovaným klientem a kontrolou driftu

Specifikace API jsou v repozitáři a generuje se z nich typovaný klient. Soulad mezi kódem a specifikací navíc hlídá CI. Frontend tedy nikdy nevolá backend „naslepo“ a agent si nemůže vymyslet endpoint, který neexistuje.

Přehled prostředí a jejich účelu

Dokumentace uvádí jednotlivá prostředí, jejich účel a rozsah. Agent tak pozná, co je produkce a co testovací instance, což je předpoklad pro bezpečné rizikové operace.

Doporučení

Priorita	Doporučení
Střední	Srovnat dokumentaci dvou služeb s aktuálním stavem kódu (stavový management, lokalizace).
Nízká	Doplnit decision log skutečným obsahem; struktura je připravená, ale zatím prázdná.
Nízká	Archivovat historickou část technologické vize, která popisuje stav několik let zpátky.