Pokračování v projektech bez dokumentace

Popis činnosti

Častý dotaz z praxe: „Z historických důvodů jsme analýzu nedělali — jak teď pokračovat?" Jde o brownfield bez AAF artefaktů: běžící, nezdokumentovaný systém (drtivá většina reálných případů). Cílem této činnosti je dostat rozjetý projekt na AAF model tak, aby na něm šlo dál konzistentně stavět nové požadavky.

Postup má tři dílčí činnosti a jedno klíčové pořadí:

• Reverze Zlatého klíčového procesu aspoň nahrubo. Zpětně se rekonstruuje obchodně nosný Chod procesu a postaví se jako kostra rozkladu — rám a obrázek z krabice položený jako první. Plný výklad reverze a skládání puzzle viz Zlatý klíčový proces.
• Skládání puzzle kolem kostry. Ostatní procesy se k položené kostře doskládávají po dílech — u každého se rozhoduje vůči kostře: založit novou větev, nebo navázat na existující.
• Nové požadavky → analýza blízkého okolí. Daný požadavek se zpracuje analýzou svého blízkého okolí — prvků, kterých se přímo dotýká. Kam až okolí sahá, určuje Objektové paradigma: prvky na hranici okolí se berou vnějším pohledem (co nabízejí ven), do jejich vnitřku se nepokračuje. Hranice popsaného okolí se tak stává hranicí vnějšího pohledu — dál se nejde do detailu. Plný výklad viz Objektové paradigma.

Pořadí: nejdřív reverze, pak očista

Nejdřív se zreverzuje „jak to je, i když nečistě" — skutečný, byť neideální stav. Teprve potom přichází „očista" (narovnání nekonzistencí, refaktor modelu). Snaha dělat očistu rovnou míchá dva kroky do jednoho: analytik nemá „čeho se chytit", protože narovnává něco, co ještě nemá zachyceno. Bez zachyceného výchozího stavu chybí opora pro rozhodování.

Vstupy

• Běžící nezdokumentovaný systém (žádné nebo neúplné AAF artefakty).
• Přístup ke znalosti provozu — lidé znalí chování systému, existující kód a databáze.
• Nové požadavky, které se mají do systému zapracovat.

Výstupy

• Zpětně zreverzovaný Zlatý klíčový proces aspoň nahrubo jako kostra rozkladu.
• Postupně skládaný model procesů „jak to je" (puzzle kolem kostry).
• Analýza blízkého okolí nových požadavků v OP (hranice okolí jako hranice vnějšího pohledu).

Indikátory dokončení

• Zlatý klíčový proces je zpětně rekonstruován aspoň nahrubo a slouží jako kostra.
• Nové procesy a požadavky jsou zařazené vůči kostře (založit větev × navázat).
• U nových požadavků je provedena analýza blízkého okolí s OP.
• Reverze „jak to je" je hotová dřív, než se začne s očistou.

Nejčastější chyby

• Očista rovnou — analytik narovnává model dřív, než zreverzuje skutečný stav; dva kroky v jednom, míchanina, není „čeho se chytit".
• Skládání „od dílů" bez kostry — reverze bez položeného Zlatého procesu jako kostry vede k haldě procesů a nahodilému stromu (viz Zlatý klíčový proces).
• Pokračování za hranicí okolí — analytik při novém požadavku otevírá vnitřek protějšku na hranici místo aby jej vzal vnějším pohledem; rozklad se rozteče do celého systému a požadavek se nedořeší.

Vazby

Reverze Zlatého procesu a skládání puzzle staví na Zlatý klíčový proces (tam plný výklad kostry, brownfield-reverze a puzzle). Analýza blízkého okolí nových požadavků stojí na Objektové paradigma (vnější pohled, hranice prvku jako konec viditelnosti interakce). Priority procesů ve stromu drží Prvky HLA. Opačnou situaci — greenfield a rychlou nabídku — řeší Greenfield a Strategické modelování.

Příklady

Rezervace zboží v běžícím e-shopu

Do nezdokumentovaného e-shopu přibyl požadavek: při příjmu objednávky od zákazníka rezervovat objednané zboží ve skladu.

Blízké okolí požadavku: zákazník odešle objednávku, systém ji přijme a v rámci jednoho UC zarezervuje objednané položky ve skladu a odpoví. Tohle řešíme — okolí (zákazník), bod použití (příjem objednávky), interakce se skladem.

Hranice okolí je na skladovém modulu — za předpokladu, že sklad službu rezervace už nabízí. Pak je sklad jen vnějším pohledem: nabízí službu „rezervuj položku X v množství N" a vrací výsledek (rezervováno / nedostatek). Jak ji vnitřně realizuje (evidence zásob, dostupnost, lokace) — neřešíme, do detailu skladu se nejde.

Kdyby sklad rezervaci neuměl, je služba „rezervuj" sama novým požadavkem uvnitř skladu: hranice okolí se posune dovnitř skladu a na nové blízké okolí (sklad ↔ jeho evidence zásob) se postup zopakuje. Hranici tedy určuje to, co protějšek reálně nabízí ven — ne přání analytika.

Verze a změny

• 1.0 — Zavedení kapitoly. Brownfield bez dokumentace: reverze Zlatého procesu nahrubo + skládání puzzle + analýza blízkého okolí nových požadavků v OP; klíčové pořadí reverze → očista.