Preskočiť na obsah

Navigačné a administratívne stránky

Táto referencia pokrýva hlavné navigačné, koordinačné a administratívne stránky. Väčšina detailov globálnych Settings je zámerne vynechaná, okrem správania šablón promptov zdieľaného s tenant settings. Použite ju vtedy, keď chcete rýchlo pochopiť stránky, ktoré vás vedú do správneho pracovného priestoru alebo ukazujú prevádzkový kontext, nie priamo tvorbu artefaktov. Je to dôležité preto, že práve tieto stránky určujú, kam sa v produkte presuniete, kto má prístup a kde skontrolujete AI usage alebo tenant stav. Potrebujete len bežný prístup do aplikácie a ide o krátke referenčné čítanie.

Prihlásenie a relácie

Keď vaša relácia vyprší, AIKOZO vás pošle späť cez prihlásenie a potom vás vráti na stránku, ktorú ste používali. Relácie vypršia po 30 minútach nečinnosti a majú aj dlhší absolútny limit nastavený v nasadení. Rovnaký návrat platí aj po nastavení hesla pri prvom prihlásení alebo po resete hesla v identity providerovi.

Ak AIKOZO dočasne nemôže overiť inak aktívnu reláciu pre nedostupnú autentifikačnú službu alebo sieť, ponechá aktuálnu stránku otvorenú, zobrazí upozornenie a overenie automaticky zopakuje. Presmerovanie na prihlásenie nastane až vtedy, keď relácia preukázateľne chýba, je neplatná, vypršala pre nečinnosť alebo prekročila absolútny limit.

Na ukončenie lokálnej relácie použite Odhlásiť sa v hlavičke. AIKOZO túto akciu odošle ako chránenú požiadavku a potom pokračuje na odhlasovaciu stránku identity providera; priame otvorenie adresy logout API reláciu neukončí.

Kontextový AI asistent

Keď je zapnuté CAP_CONTEXTUAL_ASSISTANT, v akciách hero sekcie pri ovládaní pomoci na stránke sa zobrazí launcher AI na podporovaných stránkach projektov, špecifikácií, plánovania, implementácií a artefaktov. Nezobrazuje sa na stránkach nastavení, profilu, správy tenantov, AI Usage, About, Action Pack ani Build execution. Otvorí kontextového asistenta pre aktuálnu stránku alebo artefakt. Asistent odpovedá z ohraničeného AIKOZO MCP kontextu a pre podporované artefakty môže zobraziť štruktúrované návrhy zmien. Odpovede asistenta sa renderujú ako štruktúrovaný Markdown pre čitateľné sekcie, odrážky a rozpisy počtov.

Po každom dokončenom ťahu sa pod správou používateľa zobrazí tlmený jednoriadkový štítok Zámer s najviac piatimi slovami. Začína hlavnou operáciou, napríklad Načítať všetko, Vyhľadať, Hľadať, Zhrnúť, Vypočítať, Porovnať, Upraviť alebo Posúdiť, a potom spresní rozsah použitý existujúcou odpoveďou a načítaním asistenta bez opakovania promptu. Jednoznačná samostatná operácia v angličtine alebo slovenčine sa normalizuje deterministicky; zložené alebo negované vyjadrenie zostáva na existujúcej inferencii asistenta. Mení sa iba štítok, nie smerovanie, a nejde o krok potvrdenia. Ak chcete interpretáciu opraviť, odošlite opravu ako bežný nasledujúci prompt. Ikona sa vznáša v pravom dolnom rohu každej správy bez vytvorenia ďalšieho riadka akcií. V správe používateľa skopíruje pôvodný prompt a v správe asistenta danú odpoveď. Po podržaní kurzora nad dokončenou bublinou správy sa zobrazí kompaktný dátum a čas jej vytvorenia v lokálnom časovom pásme prehliadača.

Keď je zapnutý Prompt Guru, panel asistenta obsahuje výber šablóny promptu. Predvolený prompt a model asistenta sa spravujú cez použitie assistant.contextual.chat v Settings alebo Tenant settings.

Keď asistent načíta artefakty, pravý panel ich filtruje podľa posledného zámeru používateľa a artefaktov pomenovaných v poslednej odpovedi, potom zobrazí ich používateľské key alebo názvy ako odkazy späť na príslušné stránky artefaktov.

Pri jasných požiadavkách na presnú náhradu textu vie asistent vytvoriť návrhy zo scoped artefaktov aj vtedy, keď načítaný zoznam zobrazuje iba preview. Náhrada rozlišuje veľkosť písmen a platí iba pre podporované skalárne textové polia, napríklad finálny text požiadavky, názov alebo finálny text prípadu použitia a title, description, expected result alebo final text testovacieho prípadu.

Pri požiadavkách na reorganizáciu špecifikácie vie asistent navrhnúť nedeštruktívnu reštrukturalizáciu špecifikácie. Po aplikovaní sa vytvoria nové epiky a do novej štruktúry sa skopírujú existujúce požiadavky, prípady použitia a testovacie prípady. Pôvodné artefakty sa nepresúvajú, nemažú, nepremenúvajú ani neupravujú. Kópie začínajú ako draft a chýbajúce skopírované väzby na požiadavky sa zobrazia ako upozornenia.

Karty návrhov sú súhrny. Použite Skontrolovať na otvorenie read-only náhľadu návrhu pred tým, ako sa čokoľvek aplikuje. Skalárne zmeny zobrazujú hodnoty pred a po zmene alebo kompaktné riadky pre zmenu stavu. Návrhy reštrukturalizácie špecifikácie zobrazujú navrhované cieľové epiky so zoskupenými kópiami požiadaviek, prípadov použitia a testovacích prípadov. Aplikovanie návrhu sa vykonáva z päty náhľadu. Náhľad používa kľúče, názvy a title artefaktov namiesto databázových ID.

Príklady otázok a príkazov:

  • Ktoré prípady použitia v tomto kontexte sú v stave final?
  • Ktoré draft testovacie prípady už majú vyplnený finálny text?
  • Mohli by ste navrhnúť lepšiu štruktúru aktuálneho epiku?
  • Nastavte stav final pre všetky požiadavky v tomto kontexte, ktoré už majú vyplnený finálny text.
  • V požiadavkách, ktorých final text obsahuje Administrator, nahraďte tento text hodnotou administrator.

Kliknutím na príklad sa text skopíruje do poľa správy asistenta, aby ste ho mohli pred odoslaním skontrolovať alebo upraviť.

Odpovede asistenta vykresľujú podporovaný Markdown vrátane tabuliek. Tabuľky najprv použijú kompaktné stĺpce vážené podľa obsahu, aby sa zmestili do šírky správy. Po podržaní myši alebo zameraní tabuľky možno pomocou ikony rozbalenia otvoriť väčší náhľad so zvislým posúvaním; ak to obsah stále vyžaduje, zostáva dostupné aj vodorovné posúvanie.

Návrhy zmien sú rozdelené na položky s hodnotami pred a po zmene. Nič sa nezapíše, kým konkrétnu položku neschválite. Nepodporované stránky a vylúčené typy artefaktov zostávajú iba v režime chatu.

Šablóny promptov v Settings

Globálne Settings umožňujú administrátorom vytvárať, upravovať a vymazávať šablóny promptov uložené v singleton dokumente nastavení. Tenant settings zobrazujú šablóny promptov z tenantového dokumentu nastavení aj z globálneho singleton nastavenia. Každý riadok promptu má pill Tenant alebo Globálne. Vymazanie tenantového promptu odstráni iba tenantovú šablónu alebo prepis; zdedené globálne prompty zostanú viditeľné a vymazávajú sa v globálnych Settings.

AI model mapping v Settings a Tenant settings používa rovnaké označenia použití ako AI Usage vrátane Build execution pre apply-patch volania počas buildu.

Tenant Settings obsahuje aj sekciu Spracovanie zdroja AI Workspace. Jej samostatná akcia Uložiť uloží pre vybraný tenant limit prehľadávania webu, cieľovú veľkosť a prekrytie častí zdroja a veľkosť jednotky extrakcie znalostí. Tieto hodnoty ovplyvnia nové alebo opätovne spracované zdroje, nie zdroje, ktoré sú už pripravené.

Stránka Projects

Účel

Stránku Projects používajte na vstup do správneho projektu, vytvorenie nového projektu a potvrdenie, ku ktorým projektom máte prístup.

Keď je zapnuté CAP_PROJECT_WORKSPACE, manažéri môžu zvoliť AI Workspace vedľa AI Nový pre dočasný pracovný priestor pred vytvorením projektu alebo akciu Pracovný priestor na existujúcom projekte. Pozrite si Projektový pracovný priestor.

Súvisiaci "Flow"

Hlavné akcie

  • filtrovať zoznam projektov podľa key alebo name
  • označiť alebo zrušiť označenie projektov hviezdičkou a potom použiť filter Starred na zobrazenie iba vašich dostupných projektov označených hviezdičkou
  • otvoriť projekt a pokračovať do špecifikácií alebo implementácií
  • vidieť restricted projekty len vtedy, keď ste manager alebo ste priradený ako allowed user
  • vytvoriť NewPersonal projekt po prihlásení
  • vytvoriť project cez New, ak to vaša rola povoľuje
  • spustiť AI New, keď je zapnutý CAP_AI_PROJECT_BOOTSTRAP; používatelia bez role Manager vytvárajú osobný draft, Manageri si pred chatom vyberajú osobný alebo kolaboratívny rozsah
  • pre managerov výslovne zahrnúť osobné projekty, keď potrebujú skontrolovať súkromnú projektovú prácu
  • obnoviť zoznam
  • New personal project: zadanie key, name, description a jazyka projektu
  • New project: zadanie key, name, description, jazyka projektu a režimu prístupu
  • AI sprievodca nastavením projektu: Manageri najprv vyberú cieľový rozsah. Používatelia bez role Manager pokračujú priamo s osobným projektovým draftom. Potom nasleduje chat nad metadátami projektu, BIZ/TECH kontextom a biznis požiadavkami a použitie Vytvoriť projekt v súhrne Project po splnení kontroly pripravenosti. Draft je dočasný, po neaktivite expiruje a po zaradení creation jobu sa odstráni. Pod každým dokončeným ťahom používateľa sa zobrazí aj pasívny jednoriadkový štítok Zámer s najviac piatimi slovami. Začína hlavnou operáciou a potom spresní jej rozsah bez opakovania promptu. Jednoznačné samostatné operácie v angličtine alebo slovenčine sa normalizujú deterministicky; zložené alebo negované vyjadrenie zostáva na existujúcej inferencii asistenta. Mení sa iba štítok, nie správanie draftu. Opravu odošlite ako bežný nasledujúci prompt; štítok nemení pravidlá draftu ani vytvorenia projektu. Ikona sa vznáša v pravom dolnom rohu každej správy bez ďalšieho riadka akcií a skopíruje pôvodný prompt alebo odpoveď asistenta. Po podržaní kurzora nad dokončenou bublinou správy sa zobrazí kompaktný dátum a čas jej vytvorenia v lokálnom časovom pásme prehliadača.

Stránka Project

Účel

Stránku Project používajte ako systémovú mapu jedného projektu. Prepája špecifikačnú prácu naľavo s implementačnou prácou napravo a dáva rýchly vstup do ďalších pracovných priestorov.

Projekty vytvorené cez projektový pracovný priestor zobrazujú odkaz späť na pôvod objavovania, kým je CAP_PROJECT_WORKSPACE zapnuté.

Súvisiaci "Flow"

Hlavné akcie

  • skontrolovať description, key, badge Restricted a agregované počty
  • otvoriť project settings
  • povýšiť vlastný osobný projekt cez Promote to managed
  • pre managerov vidieť čitateľné meno vlastníka pri otvorení cudzieho osobného projektu
  • prehliadať projektové zoznamy špecifikácií a implementácií
  • keď je Planning zapnutý pre vašu rolu a projekt, prehliadať projektový zoznam Plans a skontrolovať súhrnné počty Planning (Ready) pre Plans, Scopes, Estimates, Risks a Effort drivers; každý riadok Plan obsahuje aj kontext Scope a aktuálny Minimum Baseline ako Baseline
  • otvoriť zjednodušený Workspace pre specification alebo implementation z akcií v riadku
  • použiť Open workspace na kartách systémovej mapy; pri viacerých položkách sa stránka posunie na príslušný zoznam a nevyberá položku za vás
  • vytvoriť novú specification
  • vytvoriť novú implementation
  • vytvoriť nový Plan kontajner zo zoznamu Plans v projekte výberom Specification a Epicov, ktoré sa majú stať Scopes
  • New specification
  • New implementation
  • New Plan: vybrať Specification, zvoliť jeden alebo viac Epicov ako Scopes, potom zadať Plan key, name a voliteľný description

Stránka Project settings

Účel

Stránku Project settings používajte na kontrolu lokalizácie projektu, správu restricted prístupu a údržbu projektového kontextu.

Súvisiaci "Flow"

Hlavné akcie

  • skontrolovať jazyk projektu
  • skontrolovať vlastníka osobného projektu alebo pôvodného vlastníka, keď sa tieto údaje zobrazujú
  • vybrať predvoľbu formátu projektu používanú pre budúce AI generovania
  • nastaviť Format Enforcement na Enforce, keď má validácia formátu blokovať finalizáciu, alebo Warning Only, keď sa problémy formátu majú zobraziť ako upozornenia a finalizácia má pokračovať; nové osobné projekty a existujúce projekty spred tohto nastavenia majú predvolené Warning Only, nové kolaboratívne projekty majú predvolené Enforce; stavové gate-y zdrojov zostávajú vynútené
  • prepnúť project access medzi unrestricted a restricted
  • priraďovať a odoberať povolených používateľov pri restricted projekte
  • prehliadať typy projektového kontextu
  • upravovať, ukladať alebo mazať projektový kontext

Stránka Specifications

Účel

Stránku Specifications používajte na prehliadanie specification kontajnerov naprieč projektmi, ku ktorým máte prístup, a na rýchle otvorenie správnej špecifikácie. Cross-project pohľad zoskupuje riadky podľa projektu a každý riadok zobrazuje kľúč špecifikácie a krátky popis, ak je dostupný.

Súvisiaci "Flow"

Hlavné akcie

  • filtrovať špecifikácie podľa key, name alebo project
  • použiť Load more, keď existujú ďalšie zodpovedajúce špecifikácie; filtrovanie prehľadáva dostupný výsledkový set, nielen riadky už načítané na obrazovke
  • použiť Workspace v riadku specification na otvorenie Specification workspace
  • otvoriť samotný riadok na pokračovanie do pokročilej stránky Epics
  • obnoviť zoznam podľa potreby

Stránka Implementations

Účel

Stránku Implementations používajte na prehliadanie implementačných kontajnerov naprieč projektmi a na otvorenie správneho implementation workspace-u. Cross-project pohľad zoskupuje riadky podľa projektu a každý riadok zobrazuje kľúč implementation, prepojenú specification a krátky popis, ak je dostupný.

Súvisiaci "Flow"

Hlavné akcie

  • filtrovať implementations podľa key, name, project alebo specification
  • použiť Load more, keď existujú ďalšie zodpovedajúce implementations; filtrovanie prehľadáva dostupný výsledkový set, nielen riadky už načítané na obrazovke
  • použiť Workspace v riadku implementation na otvorenie Implementation workspace
  • otvoriť samotný riadok na pokračovanie do pokročilej stránky Implementation

Pozrite tiež

Hlavné akcie

New implementation sa na tejto stránke zobrazí vtedy, keď je vytváranie sprístupnené priamo tu.

Stránka Plans

Účel

Stránku Plans používajte na prehliadanie first-class plánovacích kontajnerov. Nové Plans sú viazané na Specification a obsahujú jeden Planning Scope pre každý vybraný Epic. Scope vlastní AI-backed hodnotenia pre daný plánovaný Epic. Hodnotenia extrahujú plánovacie faktory v background jobe, ukladajú použitý prompt/model a aktualizujú baseline vybraného Scope hrubým odhadom úsilia až po prijatí Plannerom alebo Adminom. Delivery slicing a integrácia s delivery systémami sú stále mimo scope.

Plans vyžadujú CAP_PLANNING a sú viditeľné pre roly Admin a Planner.

Súvisiaci "Flow"

Hlavné akcie

  • filtrovať Plans podľa key, name, project, Specification, Epic Scope alebo lifecycle statusu
  • otvoriť prehľad Plan
  • na detaile Plan upraviť name a description; uloženie accepted alebo superseded Plan ho znovu otvorí ako draft
  • pridať chýbajúci Epic ako Scope, keď Epic patrí do Specification daného Plan
  • otvoriť stránku Planning Scope a vygenerovať alebo pregenerovať AI-backed hodnotenie preň
  • otvoriť Estimation Profiles na stránke Tenant a zobraziť deterministické verzie profilov používané plánovacími hodnoteniami
  • otvoriť Delivery Role Profiles na stránke Tenant a zobraziť deterministické váhy rolí používané pre Role Allocation
  • skontrolovať najnovšie vygenerované hodnotenie, pridať review notes, voliteľne prepísať odhad so zdôvodnením a prijať jedno hodnotenie ako aktuálny plánovací baseline Scope
  • po potvrdení vymazať Plan zo zoznamu Plans alebo zoznamu Plans v Project
  • pozrieť stav prijatého baseline, upozornenia na zastaraný baseline, históriu hodnotení, timeline, verziu profilu odhadu a append-only históriu verzií
  • Edit Plan: upraviť name a description; Plans mimo stavu draft sa pri uložení znovu otvoria ako draft
  • Add Scope: pridať do Plan ďalší Scope z epicu
  • Delete pri Scope: natrvalo vymazať daný Scope spolu s jeho hodnoteniami, alokáciami, prepojeniami pôvodu a odvodenými plánovacími výstupmi. Potvrdenie zobrazí ovplyvnené zdroje. Vymazanie je zablokované, kým prebieha súvisiaca úloha na pozadí alebo kým od Scope závisia aplikované Implementation Features; najprv vymažte tieto Features. Zdrojový Epic ani jeho Requirements, Use Cases a Test Cases sa nevymažú.

Detail Plan

Detail Plan zobrazuje identitu Planu a context path: Project, Plan a Scopes v Plane. Context tree prepája riadky Project, Plan a Scope na ich príslušné stránky.

  • Scopes zobrazuje Scopes odvodené z Epicov s Full/Active rozsahmi, počtami active/deferred, verziou prijatého assessmentu, stavom allocation a freshness. Filter podľa názvu zúži viditeľný zoznam Scopes. Kompaktný ovládač tabu radí Scopes podľa najstarších, najnovších alebo key a zachová výber v URL. Scope otvoríte výberom jeho riadka; jedinou explicitnou akciou riadka je Delete pre plannerov a administrátorov, ktorá najprv zobrazí dopad vymazania.
  • Minimum Baseline generuje nemenné deterministické revízie z aktuálnych prijatých dvojitých Scope assessments a kanonických Scope Item splitov; Specification Allocation je voliteľná. Tab zobrazuje Full Scope, Active Scope, Minimum Baseline, plánované zníženie, reconciliation buckets a residual, freshness, kompaktné počty klasifikácií a AI-asistované Savings Opportunities. Použite Generate, keď chcete orientačné AI kandidáty úspor pre aktuálny Minimum Baseline zaradiť ako background job. Job sledujte v Background jobs. Backend validuje každý návrh a orientačnú úsporu počíta iba z existujúcich allocation údajov. Príležitosti so stavom decision needed môžu stále zobrazovať orientačnú hodnotu, keď má affected artifact allocation estimate. Návrhy nevymazávajú ani nemenia Specification artefakty. Keď sa návrh bezpečne mapuje na položky Planning Scope, Defer all uloží plánovacie rozhodnutia a označí príležitosť applied bez prepísania nemenného zdrojového Minimum Baseline.
  • Design verification kontroluje aktuálny Minimum Baseline voči final Implementation Designu a vybraným Patternom. Tab generuje, kontroluje, prijíma, nahrádza a obnovuje Design-informed Confidence reviews ako background jobs.
  • Feature Candidates premieta prijatý Minimum Baseline do kontrolovateľných kandidátov na Implementation Features pomocou prepojených špecifikačných artefaktov, prijatých plánovacích allocations, Design fragments a vybraných alebo povolených Patterns. Generovanie sa zaraďuje ako background job a dá sa sledovať v Background jobs. Karty kandidátov zostávajú stručné; otvorením kandidáta skontrolujete risks, decisions, included scope, required dependencies, traceability, Design fragments a Patterns na detaile Feature Candidate. Prijaté proposals sa dajú aplikovať iba do novej Implementation alebo do existujúcej Implementation bez Features; naplnené Implementations sú chránené pred náhodným zlúčením.
  • Remaining Scope zobrazuje projection coverage po aplikovaní Feature Projection. Porovnáva lineage Plan Scope s traceability vytvorených Features pre Requirements, Use Cases, Test Cases a effort, keď existujú allocation estimates. Planner/Admin používatelia môžu vytvárať Extensions z vybrateľných remaining alebo deferred artefaktov, generovať Extension Feature Candidates a aplikovať prijaté Extension proposals do novej, prázdnej alebo same-Plan traceable Implementation.
  • Versions zobrazuje append-only históriu verzií Plan

Vybraný tab detailu Plan sa premieta do URL stránky, takže reload alebo zdieľaný odkaz otvorí rovnaký tab.

Časť Plan foundation sa na detaile Plan zámerne nezobrazuje. Plan upravte alebo vymažte po potvrdení zo zoznamu Plans alebo zo zoznamu Plans v Project. Staršie Plans viazané priamo na Epic sú na detaile iba na zobrazenie. Supersede pre Minimum Baseline nie je vymazanie; staré baseline-y zostávajú auditnými záznamami.

Stránka Planning Scope

Stránka Planning Scope vlastní hodnotiacu prácu pre jeden Epic v spec-scoped Plane. Kontextový strom je nad tabmi a je tam rezervované miesto pre budúce semantic search v Planningu. Taby sú Overview pre Scope Coverage so základnými detailmi Scope, súhrn prijatého baseline, zdrojový Epic a počty plánovacieho pokrytia; Assessment pre najnovšie vygenerované hodnotenie, review rozhodnutia, drivery, chýbajúce informácie a históriu hodnotení; Scope Items pre rozdelenie na UC/fallback RQ; Allocation pre Specification Allocation; Roles pre Role Allocation; a Timeline pre filtrovateľnú auditovateľnú aktivitu s rozbaliteľnými detailmi udalostí.

Vybraný tab Planning Scope sa premieta do URL stránky, takže reload alebo zdieľaný odkaz otvorí rovnaký tab.

Scope Coverage spája popis Scope a súhrn prijatého Scope Estimate so zdrojovým Epicom, počtom primárnych plánovacích položiek, pokrytím Requirements/Use Cases, fallback Requirements a dôkazmi z Test Cases pre daný Scope. Refresh Coverage znovu odvodí súhrn pokrytých artefaktov zo zdrojového Epicu Scope. Admini a Planneri ho môžu obnoviť, čitatelia Planningu môžu kontrolovať súhrn.

Tab Scope Items sa napĺňa z najnovšieho vygenerovaného hodnotenia. Zobrazuje každý primárny Use Case a fallback Requirements, ktoré nie sú prepojené na Use Case. Súhrn vysvetľuje toto správanie výberu riadkov, zatiaľ čo tabuľka sa sústredí na stav Active/Deferred, pôvod a dôvod rozhodnutia, kanonické Full a Active úsilie, úrovne faktorov pre UI, backend, dáta, integráciu, bezpečnosť a testovanie a dôkazy. Každá položka používa dvojriadkovú skupinu: jej názov a Action prechádzajú cez oba riadky a všetkých šesť faktorov zdieľa širokú zlúčenú bunku v druhom riadku. Tabuľka sa tak zmestí na stránku bez horizontálneho posúvania. Hodnoty Scope item odkazujú späť na detail zdrojového Use Case alebo fallback Requirement. Kompaktný ovládač tabu prepína poradie assessmentu, obrátené poradie assessmentu a poradie podľa key a zachová výber v URL. Admini a Planneri môžu prejsť myšou na faktorový pill a kliknúť na jeho ľavú alebo pravú polovicu, aby faktor znížili alebo zvýšili medzi úrovňami none, low, medium a high. Každá zmena prepočíta iba kanonický príspevok danej položky a premietne rozdiel do Full a Active odhadov Scope; pôvodný celkový odhad sa neprerozdelí medzi ostatné položky. Existujúce allocations sa pre audit označia ako stale, ale zostávajú použiteľné. Admini a Planneri môžu položky Scope z tejto tabuľky Defer alebo Restore cez modal s povinným dôvodom; tieto akcie aktualizujú iba overlay Planning Scope a zdrojové Specification artefakty nemenia.

Generate Assessment zaradí AI generovanie do background jobu. Kým je job vo fronte alebo beží, stránka priebežne kontroluje latest status a zdieľaný popover Background jobs zobrazuje zaradenú úlohu hodnotenia Planning Scope. Dokončené hodnotenie je reviewable, ale neaktualizuje baseline Scope, kým ho Planner alebo Admin neprijme. Prijatie hodnotenia z neho spraví aktuálny plánovací baseline pre daný Scope a prepočíta rollup rodičovského Plan. Rodičovský Plan sa stane accepted až vtedy, keď má každý aktívny Scope prijatý baseline. Predtým prijaté hodnotenia pre rovnaký Scope sa označia ako superseded. Prepísanie odhadu zachová pôvodný vygenerovaný odhad a vyžaduje zdôvodnenie. Zobrazený key a verzia profilu odhadu určujú deterministický profil použitý pre hodnotenie. Ak je dostupná snímka profilu, stránka zobrazuje aj jej názov a to, či išlo o systémový alebo vlastný profil. Prijaté odhady sú plánovacie baseline, nie záväzky doručenia. Zlyhané hodnotenie zostáva v histórii pre audit, ale nemôže sa stať baseline.

Role Allocation rozdelí každý kanonický príspevok aktívnej položky Scope medzi faktory odlišné od none a každý faktorový bucket alokuje iba oprávneným delivery rolám podľa Delivery Role Profile Planu. Nulový test-factor bucket preto nevytvorí žiadnu alokáciu pre Tester. Algoritmus je deterministický a pri chýbajúcich alebo všetkých none faktoroch nepoužíva equal fallback. Vygenerované role allocations ukladajú snapshot profilu a dôkazy faktorového rozdelenia a zosúlaďujú min, most likely a max súčty späť na prijatý odhad Scope. Admini a Planneri môžu role allocations generovať, prijať, nahradiť a pregenerovať. Planneri môžu kontrolovať váhy profilov; Admini spravujú vlastné verzie profilov a tenant default na stránke Tenant. Role Allocation je na tabe Roles a dá sa exportovať ako CSV. Matica úsilia faktorov a rolí zobrazuje každý kôš faktora ako riadok, každú alokovanú rolu ako stĺpec a príslušný príspevok v bunke. Tlačidlá možností Min, Most likely a Max nad tabuľkami prepínajú hodnoty v matici aj jediný stĺpec Estimate v tabuľke Delivery Role. CSV obsahuje rovnaké súčty košov, oprávnenosť a príspevky rolí.

Specification Allocation zvolí Full alebo Active základ (predvolene Active) a rozdelí ho medzi prepojené špecifikačné artefakty. Nejde o nezávislý odhad pre každú Requirement, Use Case alebo Test Case. Predvolený cieľ sú Use Cases, ak existujú, potom Requirements; Test Cases sú dostupné, keď sú prepojené. Vygenerované rozdelenia zosúlaďujú min, most likely a max súčty späť na prijatý odhad Scope. Drobné zaokrúhlenie sa rieši pridaním zvyškového rozdielu poslednej položke. Admini a Planneri môžu rozdelenia generovať, prijať, nahradiť a pregenerovať. Hodnoty allocation artefaktov odkazujú na zdrojové detail stránky, zobrazujú skrátený final text vedľa effort splitu a obsahujú koše úsilia faktorov UI, backend, dáta, integrácia, bezpečnosť a test. Koše používajú rovnaký kanonický rozklad low/medium/high klasifikácií Scope Items ako Role Allocation a po zaokrúhlení zachováva súčet položky. Specification Allocation je na tabe Allocation. CSV export obsahuje aj tieto riadky faktorov. Prázdne stavy rozlišujú, či treba najprv prijať hodnotenie, alebo ešte nebolo vygenerované žiadne rozdelenie. Berte ich ako plánovaciu pomôcku pre audit a kontrolu, nie ako záväzok doručenia.

Tab Estimation Profiles na stránke Tenant

Estimation Profiles určujú, ako Planning premieňa extrahované faktory na hrubé odhady úsilia v človekodňoch alebo človekohodinách. Tab je dostupný zo stránky Tenant. Ide o deterministickú konfiguráciu, nie o prompty pre AI extrakciu faktorov. Admini aj Planneri môžu vidieť dostupné verzie profilov a vybrať profil pri vytváraní alebo úprave Planu. Profil označený ako Default sa predvyberie pre nové Plany, ale každý Plan si stále ukladá konkrétny odkaz na profil. Admin môže duplikovať existujúci profil, nastaviť predvolený profil, upraviť Key, Name a Description zo zoznamu profilov, upraviť jednotku a pravidlá vybraného vlastného profilu priamo v tabe, uložiť zmeny ako novú verziu alebo vymazať profily, ktoré nie sú priradené k Planom. Rozsahy Scope sa interpretujú vo vybranej jednotke; zmena jednotky neprepočíta uložené číselné rozsahy. Vstavaný systémový profil je interný fallback a v tabe sa nespravuje; musí zostať aspoň jeden tenant profil. Ak sa vymaže aktuálny Default profil, Default sa presunie na iný zostávajúci profil.

Budúce hodnotenia používajú profil priradený k Planu. Existujúce hodnotenia si ponechajú key, verziu a snímku profilu zachytenú pri generovaní, takže ich význam sa po úpravách profilu nemení.

Tab Delivery Role Profiles na stránke Tenant

Delivery Role Profiles určujú, ako Planning rozdelí prijatý odhad assessmentu medzi delivery roly. Tab je dostupný zo stránky Tenant vedľa Estimation Profiles. Vstavané delivery roly a systémový profil sú vo V1 iba na čítanie. Admini aj Planneri môžu vidieť roly, váhy rolí, označenie tenant default, úpravy faktorov, ako aj efektívne normalizované percento pre každý faktor, úroveň a oprávnenú rolu. Tieto odvodené percentá zobrazujú výsledok uloženej verzie profilu po skombinovaní globálnych váh rolí a prídavných úprav; nejde o samostatne uloženú konfiguráciu. Admin môže profil duplikovať a vytvoriť tenantový vlastný profil, upravovať číselné váhy rolí a úpravy faktorov, nastaviť vlastný profil ako tenant default, vymazať vlastné profily, ktoré nie sú priradené k Planom, a uložiť zmeny ako novú verziu. Key, názov a popis profilu sa upravujú cez akciu Edit v riadku profilu; vymazanie profilu je tiež akcia v riadku.

Tab používajte v tomto poradí:

  1. Vyberte profil a skontrolujte jeho uloženú konfiguráciu. Vstavané profily sú iba na čítanie; ak potrebujete upraviteľný vlastný základ, profil duplikujte.
  2. Nastavte hodnoty Base Role Weight pre bežnú preferenciu rozdelenia. Ide o relatívne hodnoty, nie percentá. Ich celkový súčet nemá samostatný význam: nie je to 100 % ani hodnota celkového úsilia.
  3. Additive Weight Adjustment použite iba vtedy, keď konkrétny Planning Factor a Factor Complexity Level majú zmeniť počiatočnú váhu uvedenej Affected Delivery Role.
  4. Profil uložte a potom v tabuľke iba na čítanie overte Normalized Delivery Role Shares. Profil nastavte ako Default iba vtedy, ak sa má predvybrať pre nové Plany.

Pre každý faktor a úroveň používa Planning iba doručovacie roly oprávnené pre daný faktor. Kombinovaná efektívna váha role je jej základná váha plus uvedená prídavná úprava; záporný výsledok sa obmedzí na nulu. Planning potom vydelí každú kladnú efektívnu váhu súčtom všetkých kladných váh oprávnených rolí a vytvorí normalizované podiely so súčtom 100 %. Efektívna tabuľka je odvodený náhľad uloženého profilu a obnoví sa po uložení; nejde o druhú sadu upraviteľných konfiguračných hodnôt. Keďže úpravy sú prídavné, na mierke základných váh záleží: ak vynásobíte všetky základné váhy bez rovnakého preškálovania úprav, zmení sa sila ich vplyvu na konečné podiely.

Factor Complexity Level je klasifikácia komplexity low, medium alebo high priradená danému faktoru na položke Scope; nejde o confidence. Confidence opisuje kvalitu dôkazov, na ktorých je assessment založený. Faktor klasifikovaný ako none neprispieva žiadnym úsilím do Role Allocation.

Role Allocation používa iba faktory úsilia UI, Backend, Data, Integration, Security a Test. Ambiguity zaznamenáva mieru nejasnosti alebo neúplnosti očakávaného správania, hraníc, závislostí či akceptačných dôkazov. Reuse potential zaznamenáva príležitosť znovu použiť existujúce aktíva. Oba sú signálmi assessmentu, nie košmi úsilia pre rozdelenie podľa rolí, preto sa ich hodnoty v tomto tabe profilu nezobrazujú ani neupravujú.

Role Allocation ukladá key, verziu a snapshot Delivery Role Profile ku každej sade allocation. Budúce Role Allocations používajú Delivery Role Profile priradený k Planu. Zmena tenant default mení iba predvýber profilu pre nové Plany; existujúce Plany a história allocation si ponechajú zachytené odkazy na profil, snapshoty a reconciliation dáta.

Stránka AI Usage

Účel

Stránku AI Usage používajte vtedy, keď chcete rýchlo pochopiť, čo sa deje s používaním AI v tenant-e alebo prostredí. Pomôže vám odpovedať na bežné prevádzkové otázky: ktorá feature zvýšila spotrebu, či rastú náklady a či už tenant prekročil zahrnutý mesačný rozpočet. Pred otvorením stránky nemusíte nič pripravovať a väčšina kontrol zaberie len minútu alebo dve. Stránka nie je určená na úpravu artefaktov.

Súvisiaci "Flow"

Hlavné akcie

Táto stránka sa najčastejšie používa na dva druhy kontrol: rýchly prehľad používania a mesačný billing review. Napríklad keď sa tím pýta, prečo sú tento týždeň vyššie náklady, môžete zmeniť rozsah, pozrieť rozpad podľa feature a modelu a potom to porovnať so stavom fakturácie v aktuálnom UTC mesiaci.

  • prepínať reporting range
  • nastaviť vlastný dátumový rozsah
  • obnoviť dashboard
  • kontrolovať odhadované náklady v čase, počet volaní, tokeny, breakdown podľa feature a modelu a recent events s dátumom a časom
  • sledovať AI fakturáciu tenantu pre zvolený fakturačný mesiac podľa UTC
  • stiahnuť CSV report používania agregovaný podľa dňa, projektu a feature pre zvolený fakturačný mesiac podľa UTC vrátane kľúča a názvu projektu
  • prepínať fakturačný mesiac podľa UTC pomocou ovládania predchádzajúci, nasledujúci a aktuálny mesiac
  • kontrolovať, koľko zo zahrnutého rozpočtu je už využité voči mesačnému rozpočtu
  • vidieť zostávajúci zahrnutý rozpočet alebo dodatočne účtovanú sumu za prémiové požiadavky
  • sledovať počet prémiových požiadaviek, prémiový poplatok a fakturovanú útratu
  • vidieť stav, či je prémiová brokerage už aktívna alebo sa aktivuje až po vyčerpaní zahrnutého rozpočtu

Stránka About

Účel

Stránku About používajte na potvrdenie toho, čo je v aktuálnom prostredí nasadené.

Súvisiaci "Flow"

Hlavné akcie

  • skontrolovať verziu aplikácie a edition
  • prezrieť effective feature flagy a ich popisy

Stránka Tenant

Účel

Stránku Tenant používajte na tenant-scoped administráciu, prehľad autentifikovaných používateľov, správu používateľov tenant-u, správu tenant patternov, správu planning estimation profilov a správu profilov delivery rolí.

Súvisiaci "Flow"

  • Flow buildera: krok 5a, keď execution alebo pattern setup závisí od tenant administrácie

Hlavné akcie

  • skontrolovať tenant details
  • pre používateľov s rolou Manager používať Dôkazy o organizácii s rovnakým spôsobom pridávania ako pri zdrojoch Project Workspace: Pridať súbory otvorí drag-and-drop výber viacerých súborov s priebehom nahrávania vrátane zošitov Excel .xlsx, ktorých hárky a atomické riadky zostanú zachované; voľby Pridať webovú stránku a Pridať text otvoria zamerané formuláre. Materiál prechádza existujúcim Source pipeline. Každá karta dôkazu zobrazuje priebeh spracovania, typ súboru, čas aktualizácie, stránky, sekcie, bloky, odkazy, koncepty a tvrdenia v rovnakom štýle ako zdroje AI Workspace. Štruktúra otvorí rovnaký hierarchický prehliadač zdroja ako AI Workspace a Znalosti otvoria rovnaké prehľadávateľné panely konceptov, tvrdení, výňatkov dôkazov a lokálneho grafu. Môžete opakovať spracovanie, nahradiť alebo odstrániť dôkaz a premenovať jeho čitateľný názov. Pridanie súboru s už existujúcim názvom otvorí štandardný potvrdzovací panel AIKOZO; po potvrdení sa existujúci obsah nahradí, jeho extrahovaná štruktúra, embeddingy a údaje znalostného grafu sa odstránia a znova vytvoria z nového súboru
  • extrahované informácie z úplne pripraveného zdroja nezávisle sprístupniť voľbami Dostupné pre AI Assistant a Dostupné pre AI Workspace Assistant. Ide o voliteľné tlačidlové karty namiesto zaškrtávacích polí. Obe sú predvolene vypnuté; nahradenie obsahu obe vypne, zatiaľ čo zmena iba názvu ich zachová. Dostupnosť vyžaduje pripravené spracovanie zdroja, vektory, štrukturálny graf, aktuálnu extrakciu Project Knowledge a jej grafovú projekciu
  • vedieť, že asistenti automaticky vyhľadávajú v dostupných normalizovaných výňatkoch, štrukturálnom kontexte a Project Knowledge. Pôvodné nahraté dokumenty sa asistentovi neposkytujú, používatelia Workspace dokumenty tenanta nevyberajú a nedostupné extrahované informácie zostávajú neviditeľné
  • prehliadať tenant users, ich aktuálne tenant roly, status a čas poslednej aktivity
  • pre používateľov s rolou Manager vytvoriť nového používateľa tenant-u so zadaním username, emailu, mena, priezviska, dočasného hesla a rolí
  • pre používateľov s rolou Manager vykonávať validáciu nového používateľa ešte pred odoslaním: dĺžka a jedinečnosť username v tenant-e, formát emailu, komplexita hesla a zhoda potvrdenia hesla
  • pre používateľov s rolou Manager deaktivovať používateľov tenant-u bez ich vymazania
  • spravovať tenant predvoľby formátu používané projektovými AI prompt parametrami a duplikovať existujúcu predvoľbu, keď je potrebná ďalšia predvoľba; názvy predvolieb sú obmedzené na 16 znakov
  • skontrolovať tenantový OpenAI timeout a AI model mapping zdedený z globálnych nastavení, podľa potreby zadať tenantový prepis modelu a resetovať prepis späť na zdedený globálny model
  • po potvrdení odstrániť predvoľbu formátu; vždy musí zostať aspoň jedna predvoľba a predvoľby používané projektmi treba pred odstránením presunúť
  • vedieť, že zmeny predvoľby ovplyvnia budúce AI generovania; minulé AI runy si ponechajú uloženú históriu promptu
  • zobraziť deterministické Planning estimation profily; Admini môžu duplikovať, upravovať, verzovať a vymazávať vlastné profily, ktoré nie sú priradené k Planom
  • zobraziť deterministické Delivery Role Profiles; Admini môžu duplikovať, upravovať, nastaviť default, vymazať a verzovať vlastné profily používané pre budúce Plany
  • prehliadať shared patterns
  • vytvárať, klonovať, upravovať a mazať tenant patterns
  • New tenant user: vytvorí nového tenant používateľa, priradí mu jednu alebo viac rolí a vynúti zmenu hesla pri prvom prihlásení
  • Edit tenant pattern

Stránka Profile

Účel

Stránku Profile používajte na kontrolu identity používateľa, claims z aktuálneho access tokenu, zmenu jazyka a témy UI, správu šifrovaných Personal Access Tokenov a správu uložených AI quick phrases.

Súvisiaci "Flow"

Hlavné akcie

  • skontrolovať user details
  • použiť ľavý navigation tree na prepínanie medzi User details, Security tokens a Architecture workspace phrases
  • zmeniť jazyk UI
  • prepnúť UI theme medzi Dark a Light
  • zobraziť alebo skryť token-derived claims
  • uložiť, nahradiť alebo odstrániť pomenované maskované Personal Access Tokeny pre JIRA, GitHub a GitLab; označiť jeden token pre každého providera ako default pre zdieľané Spec Connectiony; uložené hodnoty tokenov sa už nezobrazia
  • prepínať záložky Architecture workspace phrases pre modules, entities, values, processes, events, policies, components, interfaces a ADRs
  • označiť frázu ako obľúbenú alebo ju odstrániť

Default bezpečnostných tokenov

Bezpečnostné tokeny sa ukladajú pre konkrétneho autentifikovaného používateľa a tenant. Názov tokenu, napríklad sync_bot, je iba label, podľa ktorého vyberáte token na osobných Spec Connectionoch alebo Delivery targetoch. Označenie default je samostatný atribút zobrazený ako pill pri jednom uloženom tokene pre každého providera.

AIKOZO udržiava práve jeden default token pre každého providera, keď existuje aspoň jeden token:

  • prvý token uložený pre providera sa automaticky stane default
  • Make default presunie označenie default na daný uložený token
  • keď vymažete default token a pre rovnakého providera zostane iný token, AIKOZO označí jeden zo zostávajúcich tokenov ako default
  • hodnoty tokenov sa po uložení maskujú a už sa nezobrazia

Toto označenie default je dôležité pre zdieľané Spec Connectiony. Zdieľaný Spec Connection ukladá provider routing, napríklad JIRA project alebo GitHub repository, ale nikdy neukladá Personal Access Token a nikdy nepoužíva token používateľa, ktorý connection vytvoril. Keď cez zdieľaný connection validujete, importujete alebo spúšťate Sync SPEC, AIKOZO vyhľadá váš vlastný token označený ako default pre daného providera a provider volanie vykoná ako vy. Ak vo vašom profile pre providera nie je default token, zdieľaný connection zostane viditeľný, ale provider akcie nebudú dostupné, kým token neuložíte alebo neoznačíte ako default.

Osobné Spec Connectiony používajú vybraný názov tokenu z vášho profilu a vidíte ich iba vy. Tento režim použite, keď má samotný connection zostať súkromný alebo keď má používať konkrétny pomenovaný token namiesto provider defaultu.

Nastavenie JIRA tokenu

AIKOZO používa šifrované JIRA tokeny uložené v používateľskom profile pri validácii Spec Connectionov, importe source issues a downstream synchronizácii Requirements alebo Use Cases. Osobné Spec Connectiony používajú vybraný názov tokenu. Zdieľané Spec Connectiony vždy používajú JIRA token aktuálneho používateľa označený ako default, takže každý používateľ pracujúci so zdieľaným connectionom potrebuje vlastný použiteľný predvolený token pre daného providera. Uložené tokeny sa zobrazujú iba maskovane; plná hodnota tokenu sa už nezobrazí.

Pre JIRA Cloud:

  1. Otvorte stránku Atlassian API tokenov: https://id.atlassian.com/manage-profile/security/api-tokens.
  2. Vyberte Create API token alebo Create API token with scopes.
  3. Pomenujte token pre AIKOZO, vyberte dátum expirácie a token vytvorte.
  4. Token ihneď skopírujte. Atlassian ho neskôr už nezobrazí.
  5. V AIKOZO otvorte Profile > Security tokens, vyberte názov secretu, napríklad jira_sync, a vložte hodnotu v tvare <atlassian-email>:<api-token>, napríklad analyst@example.com:token. Ak sa má tento token používať pre zdieľané JIRA Spec Connectiony, použite Make default. AIKOZO tak použije JIRA Cloud basic autentifikáciu voči URL JIRA stránky nastavenej na Spec Connectione.

JIRA Cloud používa pre tento flow Atlassian account API tokeny. Ak ich váš tím nazýva PAT, použite vyššie uvedenú stránku API tokenov a nehľadajte menu Personal access tokens priamo v produkte JIRA Cloud.

Pre JIRA Data Center alebo Server:

  1. V JIRA otvorte menu avatara, vyberte Profile a potom Personal access tokens.
  2. Vyberte Create token, dajte tokenu jasný názov, voliteľne nastavte expiráciu a token vytvorte.
  3. Token ihneď skopírujte.
  4. V AIKOZO otvorte Profile > Security tokens, vyberte názov secretu, napríklad jira_sync, a vložte iba surovú hodnotu PAT. Ak sa má tento token používať pre zdieľané JIRA Spec Connectiony, použite Make default. AIKOZO posiela Data Center PAT ako Bearer token.

Oficiálna Atlassian dokumentácia pre Data Center PAT je dostupná na https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html.

JIRA účet, ku ktorému token patrí, musí vedieť prehliadať cieľový projekt a vytvárať alebo upravovať issues v tomto projekte. Ak vaša organizácia blokuje vytváranie tokenov alebo obmedzuje scoped tokeny, požiadajte JIRA alebo Atlassian administrátora o kontrolu token policy a oprávnení.

Nastavenie GitHub a GitLab tokenu

AIKOZO používa aj GitHub a GitLab tokeny uložené v Profile > Security tokens pri validácii týchto Spec Connectionov, importe source issues a pri synchronizácii Requirements alebo Use Cases do downstream issues. Osobné Spec Connectiony používajú vybraný názov tokenu. Zdieľané Spec Connectiony vždy používajú provider token aktuálneho používateľa označený ako default. Pred použitím zdieľaného alebo osobného connectionu uložte token, ktorý vie čítať nakonfigurovanú repository alebo projekt a vytvárať alebo upravovať issues. GitHub connectiony používajú owner/repository; GitLab connectiony používajú buď project ID alebo encoded repository path, napríklad group/project.

Pre GitHub repository-backed buildy použite token účtu, ktorý vie pushovať branche a otvárať pull requesty v cieľovej repository. Odporúčané repository permissions pre GitHub fine-grained PAT sú:

  • Metadata: read
  • Contents: read and write
  • Pull requests: read and write
  • Issues: read and write, keď sa ten istý token používa aj na issue sync
  • Workflows: write, keď AIKOZO môže vytvárať alebo upravovať súbory pod .github/workflows/

Pre classic GitHub PAT použite repo pre private repositories alebo public_repo pre public repositories. Pridajte classic scope workflow vždy, keď generovaný build výstup môže vytvoriť alebo upraviť GitHub Actions workflow súbory pod .github/workflows/. Bez workflow oprávnenia GitHub odmietne push s chybou, že token nemôže vytvárať alebo upravovať workflow súbory.

Po vytvorení alebo nahradení tokenu ho uložte v Profile > Security tokens. Pre osobné GitHub alebo GitLab Spec Connectiony a Delivery targety vyberte na connectione alebo targete názov uloženého tokenu. Pre zdieľané Spec Connectiony použite Make default na tokene, ktorý sa má používať pre váš účet. Pred spustením repository-backed buildov spustite validáciu connectionu alebo targetu.