Preskočiť na obsah

"Flow" analytika

Toto je odporúčaný end-to-end postup pre analytika, ktorý pracuje od biznisového zámeru až po overený coverage obraz. Otvorte ho vtedy, keď chcete praktickú postupnosť namiesto toho, aby ste sa učili každú analytickú stránku oddelene. Je to dôležité preto, že neskoršie kroky ako sémantické vyhľadávanie, generovanie Use Cases a gap analysis fungujú oveľa lepšie, keď sú skoršie Requirements už upratané. Pred začiatkom je dobré vedieť, do ktorého projectu a specification daná práca patrí. Menší Epic sa dá spracovať za 15 až 30 minút, väčší alebo importovaný scope bude trvať dlhšie.

Prehľad "Flow"

  1. Otvoriť správny project a specification workspace.
  2. Vytvoriť alebo vygenerovať prvý Epic.
  3. Skontrolovať, vylepšiť a finalizovať Requirements.
  4. Prepojiť Requirements s Use Cases.
  5. Vygenerovať Use Cases ako nové položky.
  6. Skontrolovať, vylepšiť a finalizovať Use Cases.
  7. Pridať Test Cases, ak sú zapnuté.
  8. Spustiť gap analysis.
  9. Doplniť len odôvodnené nové Requirements.
  10. Skontrolovať pripravenosť na odovzdanie.

Stránky používané v tomto "Flow"

1. Začnite v správnom projektovom kontexte

Otvorte Projects, vyberte správny project a potom prejdite do specification, ktorá má obsahovať danú prácu. Overte, že jazyk projektu a režim prístupu zodpovedajú zamýšľanému modelu spolupráce.

Na stránke projektu použite Workspace v riadku specification. Specification workspace je najlepší prvý vstup, pretože ukazuje postup prípravy: Štart, Návrh, Kontrola, Prepojiť, Validovať a Odovzdanie. Zvýrazňuje najbližšiu užitočnú akciu, položky na kontrolu, medzery v pokrytí a blokery pripravenosti pred vstupom do detailných nástrojov.

Workspace používa rovnakú produktovú terminológiu ako detailné stránky: Epics, Requirements, Use Cases, Test Cases a Ubiquitous Language.

2. Vytvorte alebo vygenerujte prvý Epic

V Specification workspace postupujte podľa odporúčanej ďalšej akcie. Ak ešte neexistuje žiadny Epic, otvorte Detailné nástroje a vytvorte prvý Epic pomocou AI Nové.

Vyplňte:

  • key Epicu
  • name Epicu
  • text business Requirement

Čo očakávať:

  • modal sa zavrie po prijatí úlohy na generovanie
  • vytvorí sa nový Epic
  • pod Epic vzniknú štartovacie Requirements
  • priebeh viete sledovať v popup-e Background jobs po kliknutí na AIKOZO logo v hornom paneli

Manuálne vytvorenie použite iba vtedy, keď už máte štruktúru pripravenú ručne.

3. Urobte enhancement a finalizáciu Requirements

V Specification workspace otvorte Pracovať na dokumente špecifikácie a pre daný Epic vyberte Requirements. Rovnaký SmartDoc dokument môžete otvoriť aj z detailnej stránky Epicu.

Odporúčaný postup:

  1. Skontrolujte zoznam vygenerovaných alebo importovaných Requirements. Poznámka: Malý horný marker SEM6 vedľa názvu Requirement, Use Case alebo test case-u znamená, že artefakt už má svoj sémantický embedding uložený vo vector databáze. Modrý marker LINKS znamená, že artefakt má aspoň jednu potvrdenú graph väzbu; sivý znamená, že potvrdená väzba aktuálne neexistuje. Ak SEM6 chýba, bežná náprava je urobiť enhancement artefaktu a uložiť finalizovaný text.
  2. Použite Vylepšiť nové pre nové položky, ak potrebujete prvý kvalitatívny prechod.
  3. Otvorte každý dôležitý Requirement a skontrolujte:
  4. original text
  5. uložený final text; editor final textu je prázdny, kým sa final text neuloží
  6. enhancement históriu
  7. či má zostať bookmarked na neskorší follow-up
  8. Keď treba, upravte final text ručne. Použite Use as final pri final texte, keď má pôvodné znenie prepísať final text bez AI. Zmena sa uloží a položka sa vráti do stavu draft.
  9. Delegovať použite vtedy, keď Requirement ostáva platný, ale rieši ho externý vlastník.
  10. Finalizovať použite až vtedy, keď je text presný, testovateľný a implementačne neutrálny.

V dokumentovom zobrazení sa Requirements a Use Cases upravujú v súvislom štruktúrovanom ProseMirror workspace. Canonical anglický text a lokalizovaný text ostávajú samostatné polia. V bilingválnych projektoch je canonical angličtina predvolene skrytá a dá sa zobraziť cez Show Canonical EN. V režime Use Cases dokument zobrazuje iba title a canonical text. Add block alebo Ctrl+Enter vytvorí nový record za aktuálnou pozíciou kurzora. Record-backed Requirement a Use Case bloky sa dajú vymazať z ovládania bloku. Split here patchne text aktuálneho Requirement a vytvorí nový draft Requirement record. Merge previous spojí text do predchádzajúceho Requirement a zlúčený zdrojový Requirement označí ako deferred. AI enhancement je preview-first: návrh najprv skontrolujte a potom ho explicitne použite alebo zahoďte.

Kontrolný zoznam Requirement

  • Je tvrdenie jasné a jednoznačné?
  • Vyhýba sa zbytočným implementačným detailom?
  • Vie ho iný človek overiť?
  • Zodpovedá stav skutočnej zrelosti položky?

4. Vytvorte väzby medzi Requirements

Otvorte Requirement a prejdite na záložku Prepojenia.

Sú tu dva režimy:

  • Navrhnúť prepojenia navrhne kandidátne vzťahy pomocou AI.
  • Nové vytvorí väzbu manuálne.

Väzby používajte len vtedy, keď majú význam. Dobré príklady:

  • jeden Requirement závisí od druhého
  • dva Requirements patria do rovnakého behaviorálneho klastru
  • dva Requirements sú v konflikte a treba to výslovne vidieť

Návrhy schvaľujte alebo zamietajte vedome. Kvalita väzieb je dôležitejšia než ich počet.

5. Vygenerujte Use Cases automaticky ako nové položky

Vráťte sa do Specification workspace, otvorte Pracovať na dokumente špecifikácie a pre Epic vyberte Use Cases. Detailnú stránku Epicu použite vtedy, keď potrebujete plné pokročilé ovládanie.

Môžete:

  • vytvoriť Use Case ručne - pomocou tlačítka Nové
  • vytvoriť Use Case pomocou AI z vybraných Requirements - pomocou tlačítka AI Nové
  • auto-generovať Use Cases ako nové položky automatickým sémantickým združovaním Requirements - pomocou tlačítka AI Auto nové

V analytickom "Flow" je bežný postup generovať Use Cases z už spresnených Requirements, nie z úplne surových draftov.

AI Nové ponúka na výber iba finálne Requirements a generovanie pred zaradením do fronty stále validuje, že vybrané Requirements sú final-ready. Requirements v stave deferred sa tu preskakujú. Zostávajú vyhľadateľné, ale nevstupujú do generovania Use Cases, analýzy Ubiquitous Language ani gap analysis.

Keď spustíte AI akciu a výsledok sa neobjaví hneď, otvorte popup Background jobs kliknutím na AIKOZO logo v hornom paneli. Slúži na kontrolu, či je úloha vo fronte, beží, je dokončená alebo zlyhala.

6. Urobte enhancement a finalizáciu Use Cases

Otvorte každý vygenerovaný Use Case a skontrolujte:

  • či je v Epic zozname prítomný marker SEM6, ak už má byť sémantické indexovanie hotové
  • či je marker LINKS modrý, keď už existujú potvrdené graph väzby medzi use case-mi
  • original text
  • final text
  • pokryté Requirements
  • enhancement výstup
  • či má položka zostať bookmarked na neskorší follow-up

Use case finalizujte až vtedy, keď je "Flow" zrozumiteľný, dostatočne úplný pre coverage prácu a zosúladený s finalizovanými Requirements.

Delegovať použite vtedy, keď Use Case ostáva platný, ale samotná delivery zodpovednosť patrí mimo aktuálny tím alebo stream.

Ak SEM6 po kontrole stále chýba, urobte enhancement Use Case a uložte finalizovaný text, aby malo sémantické indexovanie z čoho vychádzať.

Na detailoch Requirement, Use Case a Test Case sa Use as final zobrazuje v dvoch kontextoch. Tlačidlo pri original/final texte skopíruje original text do final textu a uloží položku ako draft. Tlačidlo v histórii enhancementov skopíruje do final textu daný enhancement výsledok.

7. Vytvorte väzby medzi Use Cases

Otvorte Use Case a použite záložku Prepojenia.

Väzby používajte vtedy, keď jeden Use Case závisí od druhého alebo keď sú dva Use Cases v konflikte v rovnakom scope Epics. Vzťah conflicts_with znamená, že popísané správanie nemôže byť súčasne platné pre rovnaký produktový stav, pravidlá alebo konfiguráciu. Nepridávajte väzby len preto, že ich systém vie navrhnúť.

8. Urobte analýzu medzier (gap analysis)

Zo Specification workspace použite Akcie s podporou AI -> Spustiť gap analysis alebo otvorte Detailné nástroje -> Gap analysis.

Note

Gap analýzu možno spustiť až keď existuje dostatočná báza sémantického obsahu a teda ste aktívne a dôsledne prešli predchádzajúce kroky tohto analytického "Flow". Delegované Requirements sú z tejto analýzy zámerne vylúčené.

Typický postup:

  1. Vyberte scope Epic alebo nechajte všetky Epics v specification.
  2. Najprv ponechajte default thresholdy, ak nemáte dôvod ich meniť.
  3. Spustite analýzu.
  4. Prezrite riadky Use Cases a ich coverage mapy.

Tabuľka výsledkov sa otvorí na najnovšom reporte analýzy. Ovládacími prvkami pre predchádzajúci a nasledujúci report v hlavičke tabuľky si pozriete staršie alebo novšie uložené reporty.

Ak run trvá dlhšie, skontrolujte aktuálny stav a prípadné failure detaily v popup-e Background jobs.

Interpretácia:

  • Covered znamená, že súčasné Requirements pravdepodobne pokrývajú kroky Use Case.
  • Weak znamená, že coverage existuje, ale nie je dostatočne presvedčivý.
  • Gap znamená, že Use Case obsahuje správanie, ktoré súčasné Requirements dostatočne nepokrývajú.

Coverage map sa otvorí pre vybraný dokončený report. Rozhodnutia zostanú viditeľné, keď bol krok prijatý bez ďalšej akcie alebo zmenený na Requirement.

V Coverage map značka v stĺpci Step ukazuje extrahovaného aktéra a poradie kroku:

  • U znamená krok používateľa, zákazníka alebo iného externého aktéra.
  • S znamená krok systému, služby alebo platformy.
  • X znamená, že aktér nebol v zdrojovom Use Case jasný.

Číslo je poradie kroku v extrahovanom flow Use Case, takže U1 je prvý extrahovaný používateľský krok a S2 je druhý extrahovaný systémový krok.

Hodnotu Score používajte ako sémantický pomer zhody od 0.00 do 1.00. Aktuálne thresholdy určujú počiatočný status:

  • skóre pod Gap < sa zobrazí ako Gap
  • skóre od Gap < po, ale bez, Covered >= sa zobrazí ako Weak
  • skóre na úrovni Covered >= alebo vyššie sa zobrazí ako Covered

Pri weak findings použite pomer voči covered thresholdu ako pomôcku pri review: score / covered threshold. Pri defaultnom Covered >= 0.55 je weak skóre 0.50 približne 91% covered thresholdu, zatiaľ čo 0.36 je približne 65%. Tento pomer pomáha pri triage, ale nenahrádza prečítanie matchnutého Requirement.

Weak finding prijmite iba vtedy, keď najlepší matchnutý Requirement už spĺňa zámer kroku Use Case a zostávajúca nejednoznačnosť je akceptovateľné delivery riziko. Po výbere Accept sa krok označí ako Accepted a hlavný report ho už nepočíta ako nevyriešený weak alebo gap finding.

Ak neskorší run analýzy extrahuje rovnaký krok aktéra s rovnakým najlepším Requirement dôkazom alebo podobným znením, accepted rozhodnutie sa prenesie aj do tohto runu.

Ak match len slovne prekrýva text, vynecháva pravidlo, mení aktéra alebo necháva správanie nejednoznačné, neprijímajte ho len preto, aby sa vyčistil report. Vytvorte Requirement z gapu alebo upravte existujúci Requirement v bežnom Requirement workflow.

9. Pridajte len odôvodnené a zmysluplné Requirements

Gap analysis je rozhodovacia pomôcka, nie príkaz na vytváranie ďalších Requirements.

Nový Requirement z gapu vytvárajte len vtedy, keď:

  • chýbajúce správanie naozaj patrí do scope
  • krok Use Case je dostatočne významný na vlastný Requirement
  • nový Requirement zlepší jasnosť alebo istotu delivery

Nevytvárajte Requirements pre drobné slovné rozdiely alebo zjavné duplicity.

10. Záverečné analytické kontroly

Pred odovzdaním práce ďalej si overte:

  • dôležité Requirements sú final
  • Use Cases pokrývajú zamýšľané biznisové správanie
  • Test Cases pokrývajú dôležité Use Cases, keď je zapnutá podpora Test Cases
  • väzby popisujú skutočné vzťahy
  • gapy boli skontrolované, nie slepo premenené na ďalšie položky
  • stav Epic zodpovedá skutočnej zrelosti analýzy

Voliteľne, ale užitočne:

  • skontrolujte a prijmite Ubiquitous Language v detailných nástrojoch
  • exportujte finalizované Requirements, finalizované Use Cases a dostupné Test Cases pri potrebe formálneho handoff-u