User Story (L2)

Mit rögzít: egy fejlesztésre kész story-t (As … / Want … / So …), a szülő Business Case AC-jaira való hivatkozásokkal, kategória-szintű elfogadási sávval és a Value Proposition Canvas visszacsatolással.

Ki hozza létre: a felhasználó, kézzel, egy Business Case-hez kötve.

Perzisztencia: .craftingtable/levels/l2/DEV-*.json + testvér DEV-*.md.

Képernyőkép — User Story szerkesztő

(A képernyőkép pótlása folyamatban.)

A JSON-anatómia (schema 1.1.0)

{
  "id": "DEV-001",
  "type": "user-story",
  "title": "Offline-First Helyi Adatperzisztencia",
  "level": 2,
  "priority": "must",
  "status": "draft",
  "persona": "Szoftverarchitekt",
  "story": { "as": "Szoftverarchitekt", "want": "…", "so": "…" },
  "acceptanceCriteriaRefs": [
    { "id": "AC-1", "generatesTask": true },
    { "id": "AC-2" }
  ],
  "criteria": {
    "business": "…", "compliance": "…", "performance": "…",
    "security": "…", "usability": "…"
  },
  "vpc": { "painReliever": "…", "gainCreator": "…", "metric": "…", "businessValue": "…" },
  "refs": { "parents": ["BC-001"] },
  "doc": "DEV-001.md"
}

• acceptanceCriteriaRefs — a refs.parents[0] Business Case AC-jait pipálja ki. A Gherkin szöveg a BC-n marad. A generatesTask story-szintű: ugyanaz az AC az egyik story-ban generál Work Package-et, a másikban nem.
• criteria — kategória-szintű, nem funkcionális elfogadási sáv (Business / Compliance / Performance / Security / Usability), szabad szöveg cellánként.
• vpc — visszacsatolás a Value Proposition Canvas GOAL-ra.

Mindhárom mező opcionális és omitempty — az 1.0.0 fájlok változatlanul olvashatók. A régi, saját acceptanceCriteria-t hordozó User Story-k továbbra is működnek (a motor visszaesik a story saját listájára).

Kapcsolatok

• ← Business Case: valódi szülő (refs.parents).
• ↔ Flow: M:N tag (Flow.linkedStories). Nem tulajdonlás — egy Flow törlése nem érinti a story-t, egy story törlése csak a tag-et távolítja.
• ← Skill: refs.userStories tag.
• → Blueprint: minden When/Then/And AC-lépés egy Part a User Story blokkban.
• → Generate: a generatesTask: true AC-kből lesz Work Package.