I0926 — Dokumentace nasazení je generovaná a dosažitelná

✕BLOKOVÁNO vlna 4 · p1 · profil implementation · bezpečné paralelně

Součást fly-deployment — Image kontejneru je projekcí modelu repozitáře a jeho smoke test je jeho důkazem.

Cíl

Vytvořit dokumentaci nasazení z kanonického objektu a implementace — architektura, kontejner, zdroje, workflow, CI, bezpečnost, náklady, řešení potíží a škálování — a zpřístupnit ji z povrchů, které se už generují.

Proč

Hodnoty nasazení přepsané do prózy jsou špatně hned poprvé, kdy se změní region nebo paměť. Repozitář už své reference generuje z dat; toto je tentýž mechanismus použitý na další subsystém.

Aktuální stav

Web se generuje z registru a indexu dokumentace. Neexistuje stránka nasazení a žádná položka navigace na ni neodkazuje.

Cílový stav

Tabulky a referenční sekce pocházejí z kanonického objektu a registru, próza vysvětluje to, co data nedokážou, a stránka je dosažitelná z úvodního povrchu i z navigace, aniž by kdokoli upravoval seznam.

Rozsah

• docs/DEPLOYMENT.md
• web

Mimo rozsah

• Hodnoty nasazení přepsané do prózy
• Ručně psaná položka navigace nebo přistávací karta
• Ceny v měnách uváděné jako trvalá fakta

Závislosti

• I0903✓HOTOVO Čtení nasazení se deklaruje jednou a promítá se všude
• I0913!ZRUŠENO Konfigurace providera se generuje a levný profil je deklarován
• I0924!ZRUŠENO Rozhodnutí je zaznamenáno tam, kde se zaznamenávají architektonická rozhodnutí

Co na tom čeká

• I0932✕BLOKOVÁNO Milník je přijat na základě svých důkazů

Kritéria přijetí

• Každá zobrazená hodnota nasazení — region, port, zdroje, počet strojů, autostop, rozpočty, základní image — je odvozena z kanonického objektu nebo zaznamenaných měření
• Stránka pokrývá architekturu a proč tento poskytovatel, kontejner a jeho runtime, zdroje, vývojářský postup se skutečnými příkazy, CI a rollback, bezpečnost, náklady, řešení potíží čerpané ze skutečně potkaných selhání a jak škálovat změnou jednoho souboru
• Jakákoli cena nebo údaj o poskytovateli, který se v čase mění, je označen datem pozorování a neuvádí se jako záruka
• Stránka je dosažitelná z vstupního povrchu a navigace stávajícím generovaným mechanismem, bez ručně psané položky
• Interní odkazy se v sestaveném webu překládají

Validace

• bash test/run.sh
• majordomus generate --check

Požadované důkazy

• docs_generated
• links_resolve
• landing_registered

Důkazy

Nic nezaznamenáno. Za každým tokenem výše musí stát příkaz nebo artefakt, než lze tento úkol dokončit; vyprávění se odmítá.

Riziko

Řešení potíží napsané dříve, než cokoli selhalo, je fikce. Plní se ze selhání, na která implementace skutečně narazí.

Časová osa

zahájeno

—

ověřeno

—

dokončeno

—

Tato tři pole, důkazy výše a stav závislostí jsou vše, z čeho se stav skládá. Neexistuje žádné pole stavu, které by s nimi mohlo být v rozporu.

Kanonický záznam: .ai/repo/project/issues/I0926.yaml. Přečtěte jej zpět pomocí majordomus plan show I0926.