Blueprints
Ez a tényleges munka nyomkövetési rétege — nem összetévesztendő a
Generate motor Work Package-ével:
| Work Package | Blueprint / Block / Part | |
|---|---|---|
| Mi | Atomi, egy AC-hez tartozó, determinisztikusan generált munkautasítás-lap | Folyamatos, tech-csomag szerint szervezett projekt-tábla |
| Élettartam | Egy generálás pillanatnyi kimenete | Hosszabb távú, kézzel is bővíthető |
A kettő kapcsolódhat (egy Part hivatkozhat egy Work Package-re), de nem ugyanaz a réteg.
(A képernyőkép pótlása folyamatban.)
Hierarchia (valódi beágyazás)
Blueprint
└─ Block
└─ Part
└─ Tweak (utólagos javítás egy Part-on)
└─ Tweak (a Block egészére)
└─ Tweak (a teljes Blueprint-re)
A rendszer-Blueprint (BP-system)
Projektenként mindig létezik (a workspace.Load() biztosítja), nem törölhető, nem
duplikálható. Pontosan négy fix Block:
| Block | Miből lesz benne Part | Forrás-típus |
|---|---|---|
| Flow | Minden action/decision-típusú Flow node | flow-node |
| Schema | Minden model-típusú Flow node | flow-node |
| Oldal | Minden screen- és api-típusú Flow node (+ screen componentIds) | flow-node |
| User Story | Egy AC minden When/Then lépése (And is) — a Given kimarad | user-story |
Egyéb Blueprint-ek (pl. „Frontend", „CI/CD Infra") teljesen kézi.
Auto-deriválás
- Minden Flow- és User Story-mentéskor az engine biztosít (ensure) egy Part-ot a
megfelelő Block-ban, a forrásra hivatkozva (
flowId:nodeId, illetvestoryId:acId:lépésindex). - Javaslat-szintű, nem visszafordíthatatlan, sosem írja felül a meglévőt. A felhasználó szabadon átnevezheti, törölheti, más Block-ba mozgathatja, státuszt válthat.
- Idempotens (a forrás-azonosító a kulcs).
Stale vs. prune: ha egy auto-Part minden auto-forrása eltűnt: ha érintetlen
(status=todo, nincs tweak/szín/dátum, nincs átnevezve), törlődik; ha dolgoztak rajta,
megmarad Stale=true jelzéssel (borostyán badge).
Sources (forrás-hivatkozás)
Egy Block/Part/Tweak tetszőleges számú forrásra mutathat. A készlet:
user-story | business-case | flow-node | page | schema-model | component | design-token.
Ha egy forrás már nem létezik, a badge sárga „elavult" jelzést kap — a forrás maga nem törlődik.
Part munka-brief
GET /api/v1/blueprints/{id}/parts/{partId}/context (MCP: get_part_context) — a Part
forrásán végigkövetve összeállít egy önmagában értelmezhető Markdown briefet: kapcsolódó
User Story + Gherkin, szülő Business Case, érintett adatmodell mezőkkel, képernyő +
komponensek tokenekkel/adatmezőkkel, szomszédos flow-lépések, vonatkozó skillek — plusz
ugrás-linkek.
Tweak
Mindig kézzel jön létre (BUG vagy módosítási feladat): done: boolean, szabad log,
opcionális image, sources. Nincs automatikus generálás.