# SPEC-FEEDBACK — visszacsatolás a spec-csapatnak **Dátum.** 2026.05.25 · **Verzió.** v0.5 (Phase 2A + 2B + **2C LEZÁRVA**; A1+A2+A3 SF-1..SF-17 · A4+A5 SF-18..SF-32 · **A6+A7+A8+A9 SF-33..SF-61** + SF-41 scope-finomítás) **Cél.** A Phase 2 spec-fedés review során feltárt `⚠` (spec-ben van, screen-en nincs — hiányosság) és `🔍` (screen-en van, spec-ben nincs, NEM dokumentált — UI-találmány) tételek konszolidált listája. **A Phase 3 elején a spec-csapatnak visszacsatolva** — javasolt változások a spec dokumentumokban vagy az adatmodellben. **NEM tartalmaz.** A `🟡` kategória tételeit (azokat D-X döntés rögzíti — dokumentált UX-választás, NEM spec-szelídítés). Az AUDIT-2.md 3.3 inline-organism-pótlás-jegyzéke szintén NEM ide tartozik (azok mock-szintű implementációs kényelmes-pótlások, a HANDOFF.md-ben átadási megjegyzések). > **Olvasási útmutató.** Minden tétel: forrás-screen / spec-hivatkozás / a probléma / javaslat (a → b) / döntés-státusz. A spec-csapat a `## Döntés-státusz` mezőt tölti vissza: > - `accepted` — a spec módosul a javaslat szerint > - `rejected` — a spec változatlan, a screen-mock pótolja > - `deferred` — pilot utáni iter > - `under-review` --- # Bevezetés a Phase 2A-hoz A Phase 2A (Bejelentés-ág, A1+A2+A3) spec-fedés-review **lezárult** (52 elem mező-szinten vizsgálva). **17 SF-tétel** keletkezett, amelyek 3 osztályba sorolódnak: - **Érdemi spec-szelídítések** (a spec-dokumentum módosul): SF-2, SF-7, SF-9, SF-16, SF-17 — 5 db - **Mock-szintű korrekciók** (NEM spec-szelídítés, HANDOFF.md átadási megjegyzés): SF-3, SF-5, SF-6, SF-8, SF-10, SF-13, SF-15 — 7 db - **Organism / DTO-bővítések** (kanonikus organism-API vagy DTO-prop): SF-4, SF-11, SF-12, SF-14 — 4 db - **Hatókör-pontosítás** (meglévő SF kibővítve): SF-1 — 1 db **SF-tételek áttekintése:** | # | Tétel | Kategória | Súly | |---|---|---|---| | SF-1 | `priority` + **bélyegkép** oszlopok az A1 listán | ⚠ | közepes | | SF-2 | `TicketListDto.assigneeType` mező bővítés | ⚠ | közepes (**spec-DTO-bővítés**) | | SF-3 | "(javasolt)" lista-oldali fallback mock-data-pótlás | ⚠ | alacsony | | SF-4 | `resolutionNote` Resolved-adatlap dedikált blokk | ⚠ | közepes | | SF-5 | Resolved Description.attrs 4 strukturált mező törlése | 🔍 | közepes (mock-korrekció) | | SF-6 | A1 adatlap MapMini → MapWidget (`view` mode) lat/lng-prop | ⚠ | közepes | | SF-7 | **`originalTicketId` redukált duplikátum-nézet (SD-29) — új 5. A1 adatlap-state** | ⚠ | **kritikus** | | SF-8 | A1 adatlap PhotoGallery `caption` mező törlése | 🔍 | alacsony | | SF-9 | A2 `PhoneBanner` (Manual-eredet) → D-7 retrofit vagy új D-18 | 🔍 | közepes (**DECISIONS.md-bővítés**) | | SF-10 | A2 `ValidationBanner` törlése (`[validationForm]` per-field-error elegendő) | 🔍 | alacsony (mock-korrekció) | | SF-11 | ActivityLog 3 hiányzó eseménytípus mock-bővítés (`Rejected`/`Reopened`/`Merged`) | ⚠ | közepes | | SF-12 | **ActivityLog stable-ID DTO-szerződés vs. magyar-szöveg mock** | ⚠ | **kritikus** (HANDOFF.md) | | SF-13 | `SimilarTicketDto.updatedAt` mock-bővítés (concurrency-token a szerep-csere flow-hoz) | ⚠ | közepes | | SF-14 | `InternalNotesPanel` edit/delete organism-bővítés (TicketNote CRUD a pilotra) | ⚠ | közepes | | SF-15 | ActivityLog `Reassigned` event mock-bug törlés vagy csere | 🔍 | alacsony | | SF-16 | **`SimilarTicketDto.attachmentCount` spec-bővítés (D-6 indokolja)** | 🔍 | közepes (**spec-DTO-bővítés**) | | SF-17 | **`TicketNote.authorRole` spec-bővítés** | 🔍 | közepes (**spec-DTO-bővítés**) | --- ## A1+A2+A3 spec-szelídítések ### SF-1 — `priority` + **bélyegkép** oszlopok az A1 listáról hiányoznak - **Forrás.** `manager-system/preview/screens/a1-bejelentes-lista.html` `ticketColumns` (6 oszlop, Prioritás és Bélyegkép nélkül). - **Spec.** `uploads/urbino-docs/20_admin_felulet/10_bejelentes_lista_es_adatlap.md` 4.2 — *"Prioritás | priority | badge (Alacsony/Normál/Magas) | ✓ szűrhető | ✓ rendezhető | ✓ alap-látható"* + *"Bélyegkép | thumbnailRef + attachmentCount | kis kép + 📷-szám badge | — szűrhető | — rendezhető | ✓ alap-látható"*. - **Probléma.** A spec szerinti `TableStateConfig` 9 alap-látható oszlopot ír elő (Azonosító, Bélyegkép, Cím, Kategória, Prioritás, Határidő, Felelős, Állapot, Beérkezett). A screen-mock 6 oszlopot rajzol (Cím, Kategória, Állapot, Felelős, Határidő, Beérkezett) — kimarad **Azonosító** (a TitleCell-be olvasztva `ALM-ID`-ként), **Bélyegkép** és **Prioritás**. A Prioritás a triage-szempontból érdemi (Magas-ügyek vizuális kiemelése); a Bélyegkép a 30 mp-anatómia része. - **Hatókör-pontosítás (Batch 2).** A `⚠ #7` (bélyegkép-oszlop hiánya, Batch 2) **az SF-1-be olvad** — nem új SF, hanem **SF-1 hatókör-bővítés**. - **Javaslat.** Két opció: - **(a) Spec-oldali szigorítás MEGTART.** A screen-mock 3 hiányzó oszloppal kibővítendő (Bélyegkép kis kép + 📷-badge; Prioritás 3-érték badge; Azonosító mono `displayId`-vetülettel külön cellában). Implementáció Phase 3-ban, Angular-portoláskor. - **(b) Spec-oldali enyhítés.** A `TableStateConfig` "alap-látható" listája szelektálható, és a Prioritás+Bélyegkép az alapból `rejthető`-ként kódolt. A screen-mock jelen állapota igazodik. - **Javasolt megoldás.** **(a)** — mind a Prioritás triage-szempontból érdemi, mind a Bélyegkép a 30 mp-anatómia része. - **Hatás.** `10` 4.2 `TableStateConfig`-vázlat módosulása NEM kell — a spec már most ezt írja elő, a screen-mock nem implementálta. Helyette **HANDOFF.md átadási megjegyzés**: az Angular-portoláskor a 3 hiányzó oszlop felvétele. - **Döntés-státusz.** `under-review` ### SF-2 — `TicketListDto.assigneeType` mező hiánya - **Forrás.** `a1-bejelentes-lista.html` `AssigneeCell` csak `User`-felelőst renderel (`UserChip name + role`); `assignedGroupId` esetén `userById` `undefined`-et ad, és `—` jelenik meg. - **Spec.** `10` 3.2.1 `TicketListDto.assigneeLabel: string?` egyetlen denormalizált string. A `10` 3.2.2 detail-DTO viszont `assigneeType: "group"|"user"|null` mezőt ad. - **Probléma.** A lista a denormalizált label-t kapja, de a kliens **nem tudja**, csoport vagy személy név-e — emiatt a rendering típus-érzéketlen kell legyen. A jelenlegi `UserChip name + role` minta személy-specifikus (a `role` mezőt csoportnak nem értelmezzük); a csoport-renderelés más glyph-et és nincs-role-mezőt igényel. - **Javaslat.** **A `TicketListDto`-ba `assigneeType: "group"|"user"|null` mező hozzáadása** (`10` 3.2.1 bővítés) — a detail-DTO-val konzisztensen. Implementáció: AutoMapper `ProjectTo()` egy `Switch`-szel olvassa az `assignedGroupId` / `assignedUserId` xor-t és állítja az `assigneeType`-ot. - **Hatás.** Minimal — egy enum-mező a list-DTO-ra, nem új tárolt mező. A screen-fázis fejlesztője `assigneeType`-szerinti CellRenderer-t épít (UserChip vs. GroupChip / Lucide `users` ikon). - **Döntés-státusz.** `under-review` ### SF-3 — `categoryLabel` lista-oldali "(javasolt)" fallback nincs renderelve - **Forrás.** `a1-bejelentes-lista.html` `CategoryCell` csak a confirmed kategóriát ismeri; `categoryId == null && citizenSuggestedCategoryId != null` esetén `—`-t mutat. - **Spec.** `10` 3.2.1 `TicketListDto.categoryLabel` — *"`categoryId` neve, ha kitöltött; különben `citizenSuggestedCategoryId` neve "(javasolt)" jelöléssel; különben `null` (SD-30)"*. A spec-szerződés szerint a SZERVER ad "(javasolt)" suffix-szel kombinált stringet. - **Probléma.** Ha a szerver-DTO valóban a spec szerint adja vissza (`"Utak és járdák (javasolt)"`), akkor a CellRenderer rendben rajzolja — ez **NEM ⚠ a screen-mock-on, hanem mock-data-rés**: a TICKETS mock `category` integer-ID-t hordoz (`category: 'utak'`), a `CATS[id]` feloldja nevet — de **a javasolt-eset egyáltalán nincs reprezentálva a mock-adatban**. - **Javaslat.** **Spec-oldal változatlan** (a "(javasolt)" suffix szervere a TicketListDto-DTO-ban). **A mock-data bővíthető**: legalább 1-2 `Új` ügy `categoryId === null && citizenSuggestedCategoryId !== null` állapotban, és a `categoryLabel` mock-érték `"Utak és járdák (javasolt)"`-szerű string. Külön visual-styling (italic? amber?) az SD-30 szellemében — a fejlesztő dönti. - **Hatás.** Mock-adat bővítése; HANDOFF.md átadási megjegyzés a vizuális finomításra (italic vagy halvány szín a "(javasolt)" suffix-en, hogy a fejléc-szín-kontextus pontos legyen). - **Döntés-státusz.** `under-review` ### SF-4 — `resolutionNote` dedikált megjelenítése a Resolved-adatlapon nincs - **Forrás.** `a1-bejelentes-adatlap.html` `StateResolved` — a `Description`-blokk a polgár leírását ismétli, és 4 strukturált meta-attrs (Lezárta / Munkaidő / Felhasznált anyag / Várt visszajelzés) mellette áll. **A `resolutionNote` szabad szöveg mező mint önálló blokk nincs rajzolva.** - **Spec.** `00_domain_model.md` §1.2.3 — *"`resolutionNote` (string ≤2000) — A lezárás szöveges dokumentációja"*. `10` 4.3 layout-blokkok: *"Bal: fotók, leírás, belső jegyzetek"* — implicit, hogy a Resolved-state-en a lezárás-megjegyzés valahol megjelenik. - **Probléma.** A spec szerint `Resolved` állapotba lépéshez legalább egy `ResolutionPhoto` vagy `resolutionNote` kötelező; a screen-mock a fotókat mutatja, de a szövegmező renderelése hiányzik. Pilot-szinten a `resolutionNote` az SLA-dokumentálás egyik fontos forrása — a polgári `screen_bejelentes_adatlap_2` később ezt is mutathatja a polgárnak (NY-bej-3 rokon). - **Javaslat.** **Mock-szintű bővítés** (NEM spec-szelídítés): a Resolved-state-re egy új `mgr-resolution-note` szekció kerüljön a `Description` után, ami a `resolutionNote` szabad szövegét rajzolja. Konkrét tartalom (mock): `"A kátyú betömve macskakő-aljzattal és zsalukő-szerkezettel. A munkaidő 6 óra volt 2 nap alatt elosztva, a polgár nem panaszkodott."` — a strukturált attrs törölve. - **Hatás.** A `🔍 #1` (Lezárta / Munkaidő / Felhasznált anyag / Várt visszajelzés) törlésével együtt megoldva — lásd SF-5. - **Döntés-státusz.** `under-review` ### SF-5 — Resolved Description.attrs 4 strukturált mezeje (UI-találmány) - **Forrás.** `a1-bejelentes-adatlap.html` `StateResolved` `Description.attrs`: - "Lezárta: Szabó Zoltán · 2026.05.19. 16:42" — származtatott `resolvedAt` + `Resolved`-esemény `actorId` → **OK**, megtartható - "Munkaidő: 6 óra (2 nap)" — **NINCS spec-mező** - "Felhasznált anyag: 2 m³ macskakő-aljzat + 5 db zsalukő" — **NINCS spec-mező** - "Várt visszajelzés: Nincs panasz a polgártól" — **NINCS spec-mező** - **Spec.** `00_domain_model.md` §1.2.3 — egyetlen szabad szöveges `resolutionNote`. Pilotra `workHours`, `materialUsed`, `citizenFeedback` strukturált mezők NEM léteznek. - **Javaslat.** **Törlés a screen-mockból.** A 4 strukturált attrs törölve, a Resolved-state-re egy szabad szöveges `resolutionNote`-blokk (SF-4 szerint). A "Lezárta" sor megtartható mint származtatott meta-attribútum (a `Description.attrs` 1 elemre rövidül), VAGY teljes `Description.attrs` törölve és a "Lezárta" a `TicketMetaBar`-ba/`ActionBar.hint`-be olvasztva (az `ActionBar.hint` jelenleg "Lezárva 3 napja · Szabó Zoltán." — ez már redundánsan tartalmazza). - **Hatás.** A `🔍 #1` lezárása. NEM spec-szelídítés, hanem mock-szintű korrekció. **HANDOFF.md átadási megjegyzés** az Angular-portolásra: a `Description.attrs` 4 mezeje NEM kerül az Angular-komponensbe. - **Döntés-státusz.** `accepted-pending-mock-update` (a screen-mock-fájl módosítása later iter — a SCREEN-CONVENTIONS.md "ez a fájl NEM régi javításához" elve miatt a mock most változatlan, de a HANDOFF.md ezt explicit kihagyja). ### SF-6 — A1 adatlap MapMini → kanonikus MapWidget (`view` mode) - **Forrás.** `a1-bejelentes-adatlap.html` `MapMini` komponens — CSS-pseudo-elemekkel rajzol fix pin-t és fix gradient-hátteret; **a `lat`/`lng` prop nincs definiálva**, csak `status` és `address`. - **Spec.** `00_domain_model.md` §1.2.4 `latitude`/`longitude` mező a `Ticket`-en; `10` 4.3 layout-blokkok **"Jobb: térkép"** explicit szekció. A `20_duplikacio` 2.5 a duplikáció-heurisztika térbeli jelét ezekre alapozza. - **D-7 alatti döntés.** A `MapWidget` organism a D-7/Iter 4 során lett kiemelve önálló fájlba a `LocationPicker` miatt. Props: `mode` ('view'|'picker'), `lat`, `lng`, `status`, `popupContent`, `zoom`, `containerClass`, `onLocationChange`. **Két fogyasztó** rögzítve: SimilarTicketsBox és LocationPicker; a D-7 explicit megemlíti, hogy "jövőben adatlap-térkép" — vagyis az A1 adatlap MapMini-jét **eredetileg is** a `MapWidget`-tel kellett volna fogyasztani. - **Probléma.** A `MapMini` szándékos CSS-stub, nem valódi térkép-vetület. A 4 A1 adatlap-state egyikében sincs valódi koordináta-rajzolt térkép. - **Javaslat.** **Mock-szintű korrekció (Angular-portoláskor):** a `MapMini` cserélje le a `MapWidget` `mode='view'` változata, és kapja meg a `lat`/`lng`/`status`/`addressText` propokat. A Leaflet-integráció már fut az A2-n; ugyanaz a komponens szolgálja ki az adatlapot is. - **Hatás.** Spec változatlan; HANDOFF.md átadási megjegyzés. A screen-mock-szinten most NEM kötelező (SCREEN-CONVENTIONS.md scope). - **Döntés-státusz.** `accepted-pending-implementation` ### SF-7 — `originalTicketId` redukált duplikátum-nézet (SD-29) — új 5. A1 adatlap-state **KRITIKUS** - **Forrás.** `a1-bejelentes-adatlap.html` 4 állapot-screen (`StateFolyamatban`, `StateNew`, `StateResolved`, `StateRejected`) **egyike sem** reprezentálja a duplikátum-vetületet. Az `originalTicketId`/`originalTicketDisplayId` mezőket egyetlen mock-ticket sem hordozza; a `Duplicate`-reason + originalTicket-link kombináció vizuálisan nem renderelt. - **Spec.** - `00_domain_model.md` §1.2.6 `originalTicketId` (self-FK, F-feltételes); `originalTicketDisplayId` DTO-derived (SD-48) - **`10` 4.3 SD-29** kiemelt szekció: *"Ha `originalTicketId` kitöltött: redukált, csak-olvasható nézet — a polgári nyersanyag (cím, leírás, fotók, helyszín) + hangsúlyos link az eredetire. **Nincs triage-sáv, nincs akció-gombsor, nincs duplikáció-doboz.**"* - `10` AC-C4: *"egy ügy `originalTicketId`-ja kitöltött → adatlap betöltődik redukált nézettel."* - **Probléma — KRITIKUS.** A duplikáció-feature (`20_duplikacio_es_osszevonas`) **fő mellékhatása** a duplikátum-oldali adatlap-megjelenítés. A pilot Wow #4 első fele ezen áll. **A teljes vizuális vetület hiányzik a mock-szintről** — sem a fejlesztő, sem a code-review nem tudja vizualizálni, hogy ez hogy néz ki Angular-felületen. Ez az **egyetlen** olyan tétel a Phase 2A-ban, ami **érdemi screen-mock-bővítést** igényel. - **Javasolt 5. state-artboard tartalom — `StateDuplicate`:** - **`TicketMetaBar`** lockolt nézet, `status='elutasitva'`, +1 új vizuális elem: a fejlécben egy "Duplikátum" tag (vagy a státusz-chip mellett `mgr-duplicate-badge`) - **NINCS** `TriageBar` (SD-29 expl.) - **NINCS** `ActionBar` — vagy egy `ActionBar` `lockedNote`-szerű üzenettel: *"Ez a bejelentés egy másik ügy duplikátuma. Az ügyintézést az eredeti bejelentésen folytasd. → ALM-1052"* - **NINCS** `SimilarTicketsBox` (SD-29 expl.) - **VAN** új `mgr-original-link` blokk a TicketMetaBar alatt: hangsúlyos link az eredetire (Lucide `corner-up-right` + "Eredeti bejelentés: ALM-1052 — Felázott útburkolat a Hősök terén") - **VAN** a polgári nyersanyag: `PhotoGallery` + `Description` + `MapWidget` (mind read-only) - **VAN** `ActivityTimeline` a `Merged`-eseménnyel: *"Tóth Béla összevonta az ALM-1052 ügybe — 2026.05.19. 09:15"* (D-5/AT-2B esemény-vizualizáció `Merged` esetén violet) - **VAN** `StatusTrackBranched` egy variánssal: `reason.title='Duplikáció'` + `reason.text=<>Ez a bejelentés a(z) ALM-1052 ügy duplikátuma. Az értesítéseket az eredeti ügy bejelentője az aktuális státusz-frissítésekkel együtt kapja.` - **Javaslat — kétlépcsős.** - **(a) Mock-szinten** — a screen-fázis fejlesztője a 9. lépés HANDOFF-csomag mintaprojektjében (`starter/`) építse meg ezt az 5. state-et. A jelen iteráció (Phase 2A) **NEM nyitja újra** a screen-mockot a SCREEN-CONVENTIONS.md scope miatt. - **(b) Spec-szinten** — `10` 4.3 SD-29 szekció kibővülhet egy expicit "5. állapot — duplikátum" mintajával (a fenti `StateDuplicate` tartalom-leírás). A spec jelen formájában elveket rögzít, nem konkrét layout-blokkot. Pontosítás javasolt. - **Hatás.** HANDOFF.md kritikus átadási megjegyzés; a `10` 4.3 SD-29 szekció szelíden bővíthető explicit layout-mintával. - **Döntés-státusz.** **`under-review`** (a spec-csapat döntse el, hogy a layout-minta a spec-be kerüljön-e, vagy a starter-mintaprojekt szabványosítsa) ### SF-8 — A1 adatlap PhotoGallery `caption` mező törlése - **Forrás.** `a1-bejelentes-adatlap.html` `PHOTOS=[{id:1, caption:'Felülnézet'}, ...]` → `PhotoGallery` 4 képet renderel egy `.a1d-photo__caption` overlay-jel a bal-alsó sarokban. - **Spec.** `00_domain_model.md` §1.3 `Attachment` mezők: `id`, `ticketId`, `kind`, `fileRef`, `fileName`, `contentType`, `sortOrder`. **`caption` mező NINCS.** - **Probléma.** A polgári Flutter `screen_uj_bejelentes_2` egyetlen fotó-feltöltő gombot ad, **caption-input nélkül**. A `caption` ezért adatforrás-szempontból bizonytalan — fejlesztői mock-találmány a vizuális density növelésére. - **Javaslat.** **Mock-szintű korrekció** — a `caption` mező törölve. A fotók aláírás nélkül jelennek meg. Esetleg a `sortOrder`-derived "1 / 4" számláló a jobb-alsó sarokban (ha vizuális density-re szükség van). - **Hatás.** Spec változatlan; HANDOFF.md átadási megjegyzés (NEM spec-szelídítés). - **Döntés-státusz.** `accepted-pending-mock-update` ### SF-9 — A2 `PhoneBanner` (Manual-eredet) → D-7 retrofit vagy új D-X - **Forrás.** `a2-uj-bejelentes.html` `StatePhoneIntake` `PhoneBanner` 📞-ikonnal + amber-tinted blokk, ami explicit kódolja az `origin=Manual` magatartást. - **Spec.** `00_architektura_v4.md` §6.1 a két create-utat rögzíti (`New` vagy azonnali `Assigned`), de a `Manual`-eredet **banner-figyelmeztetésével** nem foglalkozik. `10` 5.1 sem említi a banner-mintát. - **D-X.** D-7-ben **nincs kódolva**. A D-7 6 explorer-kérdése (F-1, F-2, F-3, L-1, L-2, L-3) a form-elrendezést, két-submit-mintát és LocationPicker-magatartást rögzíti — a banner nem szerepel köztük. - **Probléma.** A banner pedagógiai értéke nagy (a diszpécser tudja, hogy ezen az ágon a `reporterContactText` kötelezővé válik), de mint UI-elem a D-7 hatókörén túli találmány. - **Javaslat.** **D-X formalizálás** — két opció: - **(a) D-7 retrofit F-4 új ponttal:** *"Manual-eredet vizuális kiemelése amber-tinted banner-rel a form fejlécében — 📞 ikon + 'Telefonos bejelentés-felvétel' cím + 2-3-mondatos magyarázat. Pedagogikai érték: a diszpécser tudja, hogy a bejelentő-mezőt szabad szöveggel tölti, és az `origin=Manual` az adatmodell-szinten rögzül."* - **(b) Új D-18** — saját döntés-naplótétel a banner-mintára. - **Javasolt megoldás.** **(a) D-7 F-4 retrofit** — a D-7 az A2-feature záró iter-je volt, természetes helye az új pontnak. A `DECISIONS.md` v.minőszerűen módosulhat (régi D-7-bejegyzést NEM írjuk át, hanem új F-4 alpontot adunk a Hatás-szekció után — vagy egy mini-revízió-jelölés a Hatás-szekcióban). - **Hatás.** `DECISIONS.md` D-7-bővítés. - **Döntés-státusz.** `under-review` ### SF-10 — A2 `ValidationBanner` törlése - **Forrás.** `a2-uj-bejelentes.html` `StateValidationError` `ValidationBanner` !-ikonnal + 2-elemes mező-hiba-lista. - **Spec.** `10` 4.6 hibakezelési kulcs-csoport (`ticket.error.*`) — a szerver **mezőszintű** `fieldErrors`-t ad vissza, a meglévő `[validationForm]` minta szerint. Banner-szintű összesítő hiba-megjelenítés nincs spec-elve. - **Probléma.** A `[validationForm]` mintában a hiba-megjelenítés a form-field szintjén történik (`` jelenítteti meg az `fieldErrors[name]`-t). A banner egy plusz vizuális réteg, amit a spec nem ír elő — viszont a banner összesít. A2 4 form-mezős kontextusában az érték kétséges. - **Javaslat.** **Mock-szintű korrekció** — a `ValidationBanner` törölve. A per-field-error a ``-en a bejáratott pattern; a banner felesleges figyelem-konfliktust ad a per-field jelzéssel. A `` Lucide `alert-circle` ikont mutathat, ha a mezőn hiba van — ez elegendő. - **Hatás.** Spec változatlan; HANDOFF.md átadási megjegyzés. - **Döntés-státusz.** `accepted-pending-mock-update` --- ### SF-11 — ActivityLog 3 hiányzó eseménytípus mock-bővítés (`Rejected`/`Reopened`/`Merged`) - **Forrás.** `a1-bejelentes-adatlap.html` 4 állapot-screen ActivityTimeline-jai — a 7 `ActivityEventType` enum-ból csak 3 dedikált esemény-vetület renderelt (`Created`, `StatusChanged`, `Assigned`). A `Reassigned` mock-on rosszul címkézve (lásd SF-15); `Rejected`, `Reopened`, `Merged` egyik state-en sem szerepelnek. - **Spec.** `00_domain_model.md` §1.4 `ActivityEventType` 7-értékű enum; `10` 4.6 i18n-sablonok mind a 7-re. - **Probléma.** Az `ActivityTimeline` 7 dedikált ICONS-mapping-je (kék/piros/amber/violet háttér-tonok, D-5/AT-2B) **vizuálisan nem demonstrált**. A fejlesztő az Angular-portoláskor a 4 ikon-variánst látja, és a Rejected (piros X), Reopened (amber rotate), Merged (violet diagonal) ikonok valódi vizuális kontextusa hiányzik. - **Javaslat.** **Mock-bővítés a 4 állapot-screenen:** - **`StateRejected`** `REJ_ACTIVITY[1].eventType='StatusChanged'` → cserélve `'Rejected'`-re; az ikon piros X lesz (helyette a kék nyíl), a szöveg változatlan ("indok: Magánterület"). - **`StateResolved`** ActivityTimeline bővítve egy 8. eseménnyel: `{ id: 8, eventType: 'Reopened', actorName: 'Tóth Béla', occurredAt: '2026.05.20. · 14:30', relative: '2 napja', text: 'visszanyitotta a bejelentést — a polgár jelezte, hogy a kátyú újra megnyílt' }`. Ez demonstrálja az amber Reopened ikon-variánst. - **`StateDuplicate`** (új 5. state, SF-7) ActivityTimeline-ja tartalmazza a `Merged`-eseményt: `{ eventType: 'Merged', actorName: 'Tóth Béla', text: 'összevonta az ALM-1052 ügybe — eredeti maradt' }`. Ez demonstrálja a violet Merged ikon-variánst. - **Hatás.** Spec változatlan; HANDOFF.md átadási megjegyzés (a `starter/` mintaprojekt az Angular-portoláskor ezt explicit fedi). - **Döntés-státusz.** `accepted-pending-mock-update` ### SF-12 — ActivityLog stable-ID DTO-szerződés vs. magyar-szöveg mock **KRITIKUS (HANDOFF.md)** - **Forrás.** `a1-bejelentes-adatlap.html` ActivityTimeline `events[].text` mező — magyar-szöveg-vetület (`'státusz: Jóváhagyva → Folyamatban'`). - **Spec.** `00_domain_model.md` §1.4 + `10` 3.2.2 + **SD-30**: *"`activityLog.fromValue` / `toValue` — stabil, nyelvfüggetlen azonosítót hordoz (`enum`-név, vagy `type:id` referencia, pl. `'group:3'`), **nem magyar szöveget**. Az i18n-sablon (`ticket.activity.statusChanged` = `'{actor} módosította a státuszt: {from} → {to}'`) kliens-oldalon oldódik fel magyar szövegre."* - **Probléma.** A screen-mock a magyar-szöveg-vetületet hordozza, **kihagyva a stable-ID-réteget**: ``` Spec szerinti DTO Mock-szerződés (HIBÁS) ───────────────────── ───────────────────────── fromValue: 'Assigned' text: 'státusz: Jóváhagyva toValue: 'InProgress' → Folyamatban' i18n-feloldás kliens-old. (magyar szöveg hardcoded) ``` A 9. lépés Angular-portolásakor a fejlesztő ezt **NEM** veheti át literál módon — a sablon-feloldás kliens-oldali kell legyen az i18n-réteggel (`hu.json` `ticket.activity.*` kulcsok). - **Javaslat.** **Kétlépcsős — HANDOFF.md kritikus átadási megjegyzés:** - **(a) Angular-portolásra** — a `ActivityTimelineDto.events[]` szerződése a stable-ID-triplet (`eventType` + `fromValue` + `toValue` + `note` + `actorId` + `occurredAt`); a komponens `i18n.translate('ticket.activity.' + camelCase(eventType), {actor, from, to, reason})`-feloldást használ. - **(b) Mock-on most NEM kötelező** — a mock-szintű `events[].text` magyar-szöveg-mező kényelmes hardcode a vizuális density-hez; **NE legyen átemelve** literál módon Angular-szintre. A SCREEN-CONVENTIONS.md "mock-data nem 1:1 DTO-szerződés" elve a HANDOFF.md új sora. - **Hatás.** **HANDOFF.md kritikus átadási megjegyzés** — az `ActivityTimeline` az egyetlen organism, amelyik a screen-mockon **a DTO-szerződésnél lazább adat-modellt** használ. A Phase 3 fejlesztője ezt nem véletlen-szerűen veszi át. - **Döntés-státusz.** `accepted-pending-implementation` ### SF-13 — `SimilarTicketDto.updatedAt` mock-bővítés (concurrency-token a szerep-csere flow-hoz) - **Forrás.** `SIMILAR_FINDINGS` mock 7 mezővel (`id, displayId, title, statusKey, statusLabel, distanceMeters, ageLabel, categoryLabel, attachmentCount, thumbnailUrl`) — `updatedAt` NINCS. - **Spec.** `20_duplikacio` 3.1.2 `SimilarTicketDto.updatedAt: DateTime` — *"A találat concurrency-tokene — ha a felhasználó az összevonás-párbeszédben megfordítja a szerepeket, a `merge` ezt küldi `expectedUpdatedAt`-ként."* SD-32 minta. - **Javaslat.** **Mock-szintű korrekció** — a `SIMILAR_FINDINGS` `updatedAt: '2026-05-16T11:00:00Z'`-szerű ISO-stringgel bővítendő. A `SimilarTicketsBox.Thumb` nem rajzolja, de a `MergeDialog.onConfirm`-flow-nak szüksége lesz rá. - **Hatás.** Spec változatlan; HANDOFF.md átadási megjegyzés. - **Döntés-státusz.** `accepted-pending-mock-update` ### SF-14 — `InternalNotesPanel` edit/delete organism-bővítés - **Forrás.** `internal-notes-panel.jsx` — `notes` lista csak read-only renderelést mutat; `editable` / `onEdit` / `onDelete` prop nincs. - **Spec.** `00_domain_model.md` §1.5 *"A pilotra a `TicketNote` a létrehozás után **módosítható és törölhető** a szerző (és a vezető) által — standard CRUD."* `10` 3.5 + 3.8 `PUT /v1/ticket-notes/{id}` + `DELETE /v1/ticket-notes/{id}` jogosultsága `dispatcher`/`manager`. - **Javaslat.** **Organism-bővítés:** - `InternalNotesPanel.notes[].editable: boolean` prop (kliens-oldali logika: `note.authorId === currentUser.id || currentUser.roles ∋ 'manager'`) - `editable === true` esetén a jegyzet-soron egy `mgr-notes__item-actions` kebab-menü ('Szerkesztés' · 'Törlés') - Új propok: `onEditNote(id)`, `onDeleteNote(id)` - **Hatás.** Pilot-feature; **organism-API-bővítés**; HANDOFF.md átadási megjegyzés. - **Döntés-státusz.** `accepted-pending-organism-extension` ### SF-15 — ActivityLog `Reassigned` event mock-bug - **Forrás.** `a1-bejelentes-adatlap.html` `StateFolyamatban` `ACTIVITY[3]` (4. esemény) `eventType='Reassigned'`-pal címkézve, de a `text='határidő-módosítás: 2026.05.21 → 2026.05.23'`. - **Spec.** `00_domain_model.md` §1.4 `Reassigned`-definíció: *"Felelős-váltás (nem státuszváltás)"*. `10` 3.3 + AC-D1: *"`PUT .../due-date` `200`, … nem keletkezik `ActivityLog`-bejegyzés"* — a `dueDate`-inline-edit **nem vált eseményt**. - **Probléma.** Két spec-szabály megsérül: (a) `Reassigned` enum-érték más jelentésben használt, (b) a `dueDate`-edit nem generálható esemény mock-on. - **Javaslat.** **Mock-szintű korrekció** — két opció: - **(a) Törlés** — a 4. esemény eltávolítva, mert spec-szerinti adat-forrás nincs. - **(b) Csere valódi `Reassigned`-re** — pl. `text='felelőst váltott: Kovács Anna → Szabó Zoltán'`, demonstratív érték. - **Javasolt megoldás.** **(b)** — vizuális density-megőrzés + spec-konzisztencia. **HANDOFF.md átadási megjegyzés**. - **Döntés-státusz.** `accepted-pending-mock-update` ### SF-16 — `SimilarTicketDto.attachmentCount` spec-bővítés **SPEC-DTO-BŐVÍTÉS** - **Forrás.** `a1-bejelentes-adatlap.html` `SIMILAR_FINDINGS[*].attachmentCount=2 / 1` — a `SimilarTicketsBox.Thumb` `attachmentCount > 1` esetén Lucide `camera` + szám badge-et rajzol. - **Spec.** `20_duplikacio` 3.1.2 `SimilarTicketDto` mezőlistája **NEM tartalmazza** az `attachmentCount`-ot. A 10-mezős DTO: `id, displayId, title, status, categoryLabel, distanceMeters, ageDifferenceDays, createdAt, updatedAt, thumbnailRef`. - **D-X.** **D-6/SB-2A** expicit rögzíti a darabszám-badge UI-mintát — *"Bélyegkép balra 56×56; fotó-darabszám-badge jobb-alul."* - **Konfliktus.** A D-6 előírja az UI-elemet, de a spec-DTO nem hordozza az adatot. - **Javaslat.** **Spec-szelídítés** — `20_duplikacio` 3.1.2 `SimilarTicketDto` bővítendő: ```jsonc { // ... existing fields ... "thumbnailRef": "...", "attachmentCount": 2 // ← új mező } ``` Az adat triviálisan számolható szerver-oldalon (`Attachment.WHERE ticketId=findId AND kind='ReportPhoto'.COUNT`); pilot-méreten ~3-4 hasonló ügyenként ~5-10 fotó-COUNT-lekérdezés, elhanyagolható költség. - **Hatás.** `20_duplikacio` 3.1.2 DTO-séma + `SimilarTicketDto`-szerződés. AC-bővítés: `20_duplikacio` AC-...-be felvenni egy `attachmentCount`-megjelenítési kritériumot. - **Döntés-státusz.** `under-review` (spec-csapat döntse el) ### SF-17 — `TicketNote.authorRole` spec-bővítés **SPEC-DTO-BŐVÍTÉS** - **Forrás.** `a1-bejelentes-adatlap.html` `NOTES[*].role='diszpécser' / 'terepi dolgozó' / 'vezető'` — az `InternalNotesPanel` `.mgr-notes__item-role` cellán "· diszpécser" suffix-szel renderel. - **Spec.** `00_domain_model.md` §1.5 `TicketNote` mezők: `id, ticketId, authorId, body` + `AuditableEntity`-örökölt. **`authorRole` mező NINCS.** `10` 3.2.2 `notes[]` beágyazás: `{ id, authorId, authorName, body, createdAt }` — szintén nincs. - **Honnan jönne.** A `TenantUser.roles[]` (`enum[] TenantRole`, §2.3) — a jegyzet szerzőjének tenant-szintű szerepkörei. A megjelenítés `roles[0]` magyar-i18n-vetülete. - **Probléma.** A role-suffix pedagogikai érték (a jegyzet kontextusa: "ki írta — diszpécser, terepi, vezető?") — de a `TicketNote`-DTO **nem hordozza ezt az adatot**. A kliens cross-lookup-pal a `TenantUser.roles`-ból kellene előállítania minden notes-betöltéskor. - **Javaslat.** **Spec-szelídítés** — `10` 3.2.2 `notes[]` bővítendő: ```jsonc "notes": [ { "id": 1, "authorId": 3, "authorName": "Kovács Anna", "authorRole": "Dispatcher", // ← új mező, TenantUser.roles[0] "body": "...", "createdAt": "..." } ] ``` A `authorRole` enum-érték (kódbeli `TenantRole`), a kliens i18n-feloldja (`hu.json` `roles.dispatcher` = "diszpécser"). Pilot-szinten kis költségű cross-DB join az AutoMapper-projekcióban. - **Hatás.** `10` 3.2.2 detail-DTO + `00_domain_model.md` §1.5 mező-tábla bővítés (a `TicketNote` adatmodell-szinten ezt nem rögzíti — DTO-szintű derived projekció). - **Döntés-státusz.** `under-review` (spec-csapat döntse el) --- # Phase 2A — záró összegzés a SPEC-FEEDBACK-hez A 17 SF-tétel **3 érdemi spec-szelídítést** ad (a spec-csapat döntésére): | # | Spec-szelídítés | Hatókör | |---|---|---| | SF-2 | `TicketListDto.assigneeType: "group"\|"user"\|null` | `10` 3.2.1 | | SF-16 | `SimilarTicketDto.attachmentCount: int` | `20_duplikacio` 3.1.2 | | SF-17 | `notes[].authorRole: string` (detail-DTO bővítés) | `10` 3.2.2 | **+ 1 DECISIONS.md-bővítés** (SF-9: D-7 retrofit F-4 új ponttal a Manual-eredet banner-mintára). **+ 2 HANDOFF.md kritikus átadási megjegyzés** (SF-7 originalTicketId redukált nézet + SF-12 ActivityLog stable-ID DTO). **A többi 11 SF mock-szintű korrekció** vagy organism-bővítés — NEM spec-szelídítés, csak átadási megjegyzés. --- --- # Bevezetés a Phase 2B-hez A Phase 2B (Riport-ág, A4 Dashboard + A5 archívum-lista + A5 adatlap) spec-fedés-review **lezárult** (`SPEC-COVERAGE-A4A5.md` 80 elem mező-szinten vizsgálva — 41 ✅ · 8 ⚠ · 20 🟡 · 11 🔍). **14 SF-tétel** keletkezett (SF-18..SF-31), amelyek 4 osztályba sorolódnak: - **Érdemi spec-szelídítések** (a spec-dokumentum módosul): SF-23, SF-25(b), SF-30(b) — 3 db - **Spec-i18n-bővítés**: SF-21(a) — 1 db - **DECISIONS.md-bővítés** (új D-18, ha a PDF inline preview formalizálódik): SF-29(b) — 1 db (alternatíva, NEM preferált) - **Mock-szintű korrekciók** (NEM spec-szelídítés, HANDOFF.md átadási megjegyzés): SF-19, SF-20, SF-22, SF-24, SF-27, SF-28, SF-29(a), SF-30(a), SF-31 — 9 db - **Organism-bővítés** (kanonikus organism-API + DS-pótlás): SF-18, SF-26 — 2 db - **Mock-data-pótlás**: SF-32 (a `⚠ #5` `allfailed` deliveryStatus-szal állapotú sor csere) — 1 db **SF-tételek áttekintése:** | # | Tétel | Kategória | Súly | |---|---|---|---| | SF-18 | `team[].isTopPerformer` vizuális jelölés a `TeamPerformanceTable` organism-ben hiányzik (D-16 deklarálja, az organism JSX-render nem rajzolja) | ⚠ organism-bővítés | közepes | | SF-19 | A4 "Aznap lezárt" KPI lefúrás-URL VF-R1-konform átmeneti törlés ÉS `10`-átvezetés emlékeztető | ⚠ mock-korrekció + spec-emlékeztető | közepes | | SF-20 | A4 fejléc-egyszerűsítés — hét-eyebrow + greeting + prózai summary törlés (3 elem összevont) | 🔍 mock-korrekció | **közepes** | | SF-21 | A4 "Múlt heti riport · 20. hét" CTA-hint formalizálása új `dashboard.downloadReport.latestHint` i18n-kulcsra VAGY törlés | 🔍 spec-i18n-bővítés VAGY mock-korrekció | alacsony | | SF-22 | A4 section-subtitle törlése (mock-developer-vetület, nem vezetőnek szól) | 🔍 mock-korrekció | alacsony | | SF-23 | **A5 lista "Időszak" külön oszlop spec-szelídítés (a Hét cella hordozza)** | ⚠ **spec-szelídítés** | alacsony | | SF-24 | A5 "📄" + "⟳" + "!" emoji-csere stroke-Lucide-ra (DS-konformitás) | 🔍 mock-korrekció | alacsony | | SF-25 | A5 lista "Legutóbbi riport letöltése" PageHeader-CTA formalizálása `40` §4.3-ba VAGY törlés | 🔍 spec-bővítés VAGY mock-korrekció | közepes | | SF-26 | A5 adatlap "Kategória szerinti bontás" sidebar-kártya bővítés (új `CategoryBreakdownCard` organism) | ⚠ mock-korrekció + organism-bővítés | **közepes** | | SF-27 | A5 adatlap "Audit" szekció hiánya (Létrehozva / Módosítva) | ⚠ mock-korrekció | alacsony | | SF-28 | A5 adatlap Resend confirm-dialog 5. mock-state hiánya (SD-57 konkrét címzett-felsorolás) | ⚠ mock-korrekció | alacsony | | SF-29 | **A5 adatlap PDF inline preview-stub visszavágás VAGY formalizálás (új D-18)** | 🔍 **KRITIKUS** mock-korrekció VAGY DECISIONS-bővítés | **kritikus** | | SF-30 | **A5 adatlap per-recipient delivery-status visszavágás VAGY spec-bővítés (`WeeklyReportDelivery` aldetail pilot-emelés)** | 🔍 **KRITIKUS** mock-korrekció VAGY spec-bővítés | **kritikus** | | SF-31 | A5 adatlap `MetaCard` "PDF méret" sor törlése (`WeeklyReportDto` nem hordoz `pdfSize`-t) | 🔍 mock-korrekció | alacsony | | SF-32 | A5 lista `allfailed` `deliveryStatus`-szal állapotú `WeeklyReport` mock-data hiánya | ⚠ mock-data-pótlás | alacsony | --- ## A4+A5 spec-szelídítések ### SF-18 — `team[].isTopPerformer` vizuális jelölés a `TeamPerformanceTable` organism-ben hiányzik - **Forrás.** `manager-system/preview/screens/a4-fooldal.html` `TEAM_ROWS[0].isTopPerformer: true` (Szabó Zoltán) mock-data; `manager-system/organisms/team-performance-table.jsx` render-függvény (sor 38–88). - **Spec.** `40_riport.md` §3.2.2 — *"`isTopPerformer: true` annál az **egy** sornál, amelynek `resolvedThisWeek` szigorúan max ÉS `> 0`. Holtverseny esetén vagy ha mindenki `0`: minden sor `false`."* + SD-55/a. D-16 vizuális rögzítés: *"a sor jobb-szélén egy **csillag-glyph + 'A hét teljesítménye' tooltip**"*. AC-B8/B9/B10 3 acceptance criterion erre épül. - **Probléma.** A `TeamPerformanceTable` JSX-render-függvénye **sehol nem olvassa be a `r.isTopPerformer` propot** — a 4-oszlopos grid-row változatlanul renderel, csillag/jelölés nincs. A `_styles.css`-ben a `mgr-tpt__row--top-performer` modifier sincs definiálva. A mock-prop a screen-fájlban átadva (`isTopPerformer: true`), az organism elhallgatja. - **Hatás.** D-16 deklarációja **félre-implementált**: a backend DTO-mező (`isTopPerformer: bool`) pontosan érkezik, a render-réteg hallgat. Az Angular-portoláskor a fejlesztő **nem fog észrevenni rést** — a `DashboardDto.team[].isTopPerformer` mező a JSON-payload-ban szerepel, de a UI nem jeleníti. - **Javaslat.** **Organism-pótlás:** ```jsx // team-performance-table.jsx, a .mgr-tpt__name-cell után, a row első cellájában: {r.isTopPerformer && ( ★ )} ``` + `_styles.css`: ```css .mgr-tpt__star { display: inline-flex; align-items: center; justify-content: center; margin-left: var(--u-space-2); color: var(--u-amber-500); font-size: 15px; flex-shrink: 0; } ``` Az ikon-stratégia D-16-konform: csillag-glyph; a tooltip i18n-kulcsa `dashboard.team.topPerformer.tooltip` (`40` §4.6 `dashboard.team.*` csoporthoz olvasztva). - **Hatás.** Mock-szintű organism-pótlás; spec-szelídítés NEM kell. **HANDOFF.md átadási megjegyzés** és/vagy közvetlen organism-fix még a Phase 3 előtt. - **Döntés-státusz.** `under-review` ### SF-19 — A4 "Aznap lezárt" KPI lefúrás-URL VF-R1-konform átmeneti törlés - **Forrás.** `a4-fooldal.html` `KPIS_NORMAL[3].href = '/bejelentesek?tab=lezart&resolvedFrom=ma&resolvedTo=ma'`. - **Spec.** `40` §4.2 — *"Az 'Aznap lezárt' az egyetlen, amelyhez a `10` lista bővítése kell: egy `resolvedAt` 'lezárás dátuma' szűrő — ez a **VF-R1 visszacsorgó jelzés** a `10` feature-spec felé. Amíg a VF-R1 nincs átvezetve, az 'Aznap lezárt' **átmenetileg** a `/bejelentesek?tab=lezart`-ra fúr le dátum-szűrő nélkül."* - **Probléma.** A screen-mock a teljes `resolvedFrom/To` URL-t rajzolja, mintha a szűrő a `10` listán már létezne — a Phase 2A SF-1 viszont 6 oszlopra szűkítette a `10` listát, a `resolvedFrom/To` query-paraméter sem oszlop-szinten, sem szűrő-szinten nem implementált. - **Javaslat.** **Kettős:** - **(a) Mock-átmeneti törlés:** a `KPIS_NORMAL[3].href` `'/bejelentesek?tab=lezart'`-ra szűkíteni — a `40` §4.2 átmeneti viselkedés-leírásának pontos tükrözése. - **(b) Spec-emlékeztető:** a `10_bejelentes_lista_es_adatlap.md` 4.2 oszlop-katalógusa egy `resolvedAt`-szűrővel (dátum-tartomány, `resolvedFrom`/`resolvedTo`) bővítendő. A `40` §8.3 VF-R1 ezt már rögzíti — a SPEC-FEEDBACK-ben csak újra-jelölés. - **Hatás.** Pilot-mock-élmény pontossága. **HANDOFF.md átadási megjegyzés** + `10` 4.2 oszlop-katalógus-bővítés-javaslat. - **Döntés-státusz.** `under-review` ### SF-20 — A4 fejléc-egyszerűsítés: hét-eyebrow + greeting + prózai summary TÖRLÉS (3 elem összevont) - **Forrás.** `a4-fooldal.html` `HeadRow`: - `.a4-head__eyebrow` "FŐOLDAL · 2026. 21. HÉT · SZERDA, 05.20" (font-mono uppercase) - `.a4-head__title` "Jó reggelt, Béla!" / "Szép munka, Béla!" / "Üdv a Urbino-ban, Béla!" - `.a4-head__sub` "**34 nyitott** ügy van Balatonalmádi-ban — **3 közülük már határidőn túl**. Ma 6 új bejelentés érkezett, 8-at pedig lezártatok." (és variánsok) - **Spec.** `40_riport.md` §4.2 a fejlécre **kizárólag a tenant nevét** rögzíti (*"A tenant neve ('Főoldal — ', a tenant-név a `50_konfig` `/beallitasok/altalanos`-ból)"*) **és a 'Heti riport letöltése' gombot**. D-16 explicit **TÖRLI** a hét-választó nyilakat és a delta-mérést — ugyanennek a "snapshot, nem trend" elvnek a folytatása a passzív hét-eyebrow + greeting + prózai summary törlése. A `TONE-OF-VOICE.md` manager-felület 30/70 warm/official ratio-t ír — "Jó reggelt, Béla!" jelentősen túlcsordul. - **Probléma.** 3 elem **UI-találmány**, D-16-konceptuális elvével ütközik, a 4 KPI-kártyát prózai narratívával **megduplázza**, és a NavStore breadcrumb-jával (egyszerű "Főoldal" string) inkonzisztens. - **Javaslat.** **3-elemű törlés**: - `.a4-head__eyebrow` törlése (vagy a NavStore breadcrumb fedezi). - `.a4-head__title` "Jó reggelt, Béla!" stb. → **"Főoldal — Balatonalmádi Önkormányzat"** (a spec literal-cím; a tenant-név dinamikusan a `TENANT.name`-ből). - `.a4-head__sub` prózai összegző sor teljes törlése. - **Hatás.** A fejléc tisztább, a 4 KPI-kártya válik az elsődleges szám-fókusszá (a spec szándéka szerint). A `latestReport.year/isoWeek` információ a CTA-hint-be költözik (SF-21). - **Hatás.** **HANDOFF.md átadási megjegyzés**; mock-szintű korrekció. - **Döntés-státusz.** `under-review` ### SF-21 — A4 "Múlt heti riport · 20. hét" CTA-hint formalizálása új i18n-kulcsra VAGY törlés - **Forrás.** `a4-fooldal.html` `HeadRow.a4-head__cta-hint` "Múlt heti riport · 20. hét" (mono, statikus). - **Spec.** `40_riport.md` §4.2 + §4.6 — a `dashboard.downloadReport.*` i18n-kulcs-csoport tartalmazza a CTA-feliratot és a `disabledHint`-et, **`latestHint`-et NEM**. A `DashboardDto.latestReport.{year,isoWeek}` mezők enélkül csak az `available`-flag számolására lennének (vékony hozzáadott érték). - **Hasznosság.** A felhasználó-élmény szempontjából **érdemi információ** — a vezető tudja, hogy a múlt-heti riportot kapja, nem a jelen-hetit. - **Javaslat.** **Kettős:** - **(a) Spec-i18n-bővítés:** a `40` §4.6 `dashboard.downloadReport.*` csoport bővítése: `latestHint` kulcs, paraméterek `{year}`, `{isoWeek}`, formátum "Múlt heti riport · {isoWeek}. hét". A `DashboardDto.latestReport.{year,isoWeek}` mezők szabványos fogyasztói lesznek. - **(b) Törlés:** a CTA önmagában elegendő; a disabled-tooltip biztosítja a kontextust. - **Preferált.** **(a)** — a `latestReport.{year,isoWeek}` mezők enélkül indokolatlanok lennének a DTO-ban. - **Hatás.** `40` §4.6 i18n-kulcs-bővítés (egyetlen kulcs). - **Döntés-státusz.** `under-review` ### SF-22 — A4 section-subtitle törlése - **Forrás.** `a4-fooldal.html` `.a4-sect-head__sub`: - "Klikkre a számon: /bejelentesek listára visz előszűrve." - "Aktív terepi munkatársak heti tevékenysége. A névre kattintva a hozzá rendelt ügyek listája." - **Spec.** `40_riport.md` §4.2 a section-fejléceket rögzíti ("Ez a hét", "Terepi csapat-teljesítmény"), **leíró sub-szöveg sehol nem szerepel**. - **Probléma.** A "/bejelentesek lista" path-utalás **mock-developer-vetület** (a vezető nem tudja, mi az). A "Wow #2 lefúrás" affordance-a a `KpiCard` chevron-jában és a TPT name-link-ben már jelzett. - **Javaslat.** **Törlés** — a section-fejléc önmagában elegendő. - **Hatás.** **HANDOFF.md átadási megjegyzés**; mock-szintű korrekció. - **Döntés-státusz.** `under-review` ### SF-23 — A5 lista "Időszak" külön oszlop spec-szelídítés - **Forrás.** `a5-riportok-lista.html` `columns` — 5 oszlop (Hét / Generálva / Állapot / Kézbesítés / Letöltés); az Időszak a `WeekCell` második sorként van a Hét-oszlopban. - **Spec.** `40_riport.md` §4.3 oszlop-katalógusa az "Időszakot" **külön oszlopként** rögzíti: ✓ szűrhető (dátum-tartomány), ✓ rendezhető, ✓ alap-látható. - **Probléma.** Pilot-volumenen (heti egy sor, ~13 sor / negyedév) a "Hét DESC" szortolás **1:1 leképezés** az "Időszak DESC"-re — a két oszlop közti különbség null. A vizuális elrendezés (Hét + Időszak egy cellában) **density-szempontból jobb** — kevesebb oszlop, jobb áttekintés. A "Generálva" oszlop dátum-tartomány-szűrhetősége ekvivalens az Időszak-oszlop szűrhetőségével (a generálás hétfőn 06:00 az `[periodStart, periodEnd)` után 0-X órával). - **Javaslat.** **Spec-szelídítés** — a `40` §4.3 oszlop-tábla "Időszak" sorát törölni (a `WeeklyReportListDto.periodStart` + `periodEnd` mezők megmaradnak, csak nem külön oszlop-renderelést kapnak). A `TableStateConfig`-vázlat alap-látható listája 5-re csökken. - **Hatás.** `40` §4.3 oszlop-tábla revízió. NEM DTO-szerződés-változás. - **Döntés-státusz.** `under-review` ### SF-24 — A5 lista "📄" + A5 adatlap "⟳" + "!" emoji-csere stroke-Lucide-ra - **Forrás.** - `a5-riportok-lista.html` `StateEmpty` `a5-empty__icon` "📄" 26px Unicode. - `a5-riportok-adatlap.html` `StateGenerating` `a5d-gen-skel__icon` "⟳" 26px Unicode (spinner) + `StateFailed` `a5d-failed__icon` "!" 26px Unicode. - **Spec / DS.** `README.md` Emoji-szabály: *"Default: no emoji. Not in buttons, not in status chips, **not in form labels, not in error messages**."* Két kivétel: citizen-side report-categories + citizen-side home-screen wave. Manager-felület **emoji-tilalom**. - **Javaslat.** **3 csere:** - A5 lista "📄" → `` (vagy Urbino-mark white-on-blue). - A5 adatlap "⟳" → `` + `animation: spin 1.6s linear infinite` (a már megírt `@keyframes spin` reuse). - A5 adatlap "!" → ``. - **Hatás.** Mock-szintű DS-konformitás-javítás; NEM spec-szelídítés. **HANDOFF.md átadási megjegyzés**. - **Döntés-státusz.** `under-review` ### SF-25 — A5 lista "Legutóbbi riport letöltése" PageHeader-CTA formalizálása `40` §4.3-ba VAGY törlés - **Forrás.** `a5-riportok-lista.html` `LatestCta` button a `PageHeader.actions` slotban (`A5Screen.showCta=true`). - **Spec.** `40_riport.md` §4.2 az R-5 (`GET /v1/weekly-reports/latest/pdf`) CTA-elhelyezést a **Dashboard** fejlécbe köti. §4.3 (`/riportok` lista) nem írja elő ezt a CTA-t a fejlécbe — a "Eltérés a mintától: a `WeeklyReport` lista csak olvasható — nincs 'Új riport' gomb" rész a PageHeader-akciókat **implicit kizárja** (nincs írásművelet). - **Probléma.** A `/riportok` listán a `Hét` oszlop legfelső sora a `Completed` legutóbbi — a `Letöltés`-cella minden sornál ott van. A PageHeader-CTA tehát **redundáns** (a top-row letöltés-gombja egyenértékű). - **Javaslat.** **Kettős:** - **(a) Törlés (preferált):** a `/riportok` lista PageHeader-je akció-üres (vagy egy "Beállítások / Címzettek" link a `50_konfig` oldalhoz). A vezető a sor `Letöltés`-cellájával éri el ugyanazt. - **(b) Formalizálás:** `40` §4.3 a PageHeader-akcióban explicit rögzíti a "Legutóbbi riport letöltése" R-5-CTA-t. - **Hatás.** **HANDOFF.md átadási megjegyzés** VAGY `40` §4.3 spec-bővítés. - **Döntés-státusz.** `under-review` ### SF-26 — A5 adatlap "Kategória szerinti bontás" sidebar-kártya bővítés - **Forrás.** `a5-riportok-adatlap.html` `REPORT_W20.categoryBreakdown` (4 sor) megvan, de **kizárólag a PDF inline preview-stubban** renderelt (a `🔍 #11` UI-találmány része). A sidebar-szekciók közt (MetaCard / NumbersCard / RecipientsCard) **nincs `CategoryBreakdownCard`**. - **Spec.** `40_riport.md` §4.4 explicit **3. szekció**: *"**Kategória szerinti bontás** — a `snapshotData.categoryBreakdown` sorai (gyökér-kategória + lezárt szám)"*. Olvasásra rendezve, a vezető PDF-letöltés NÉLKÜL látja a kategóriás bontást. - **Probléma.** A `snapshotData.categoryBreakdown` mező a `WeeklyReportDto` része, de a screen csak a PDF-stubban használja. Ha az SF-29 alapján a PDF-stub visszavágódik, a `categoryBreakdown` **láthatatlanná válik**. - **Javaslat.** **Új `CategoryBreakdownCard` sidebar-kártya** a `NumbersCard` és a `RecipientsCard` közé: ```jsx const CategoryBreakdownCard = ({ categories, resolvedTotal }) => (
Kategória szerinti bontás
{categories.map((c, i) => (
{c.name}
{c.count}
))}
); ``` Kis bar + count formátum a heti riport-PDF kategória-bontás-szakaszával vizuális analógia. NEM kanonikus organism (egyszeri használat — A5 adatlap-specifikus); a sidebar-kártya-mintába illeszkedik. - **Hatás.** Mock-szintű organism-pótlás. **HANDOFF.md átadási megjegyzés**. - **Döntés-státusz.** `under-review` ### SF-27 — A5 adatlap "Audit" szekció hiánya - **Forrás.** `a5-riportok-adatlap.html` sehol nem renderel "Audit" szekciót. - **Spec.** `40_riport.md` §4.4 explicit **5. szekció**: *"**Audit** — Létrehozva / Módosítva (a standard `AuditableEntity`-minta, tenant-időzóna)."* A `WeeklyReport` `AuditableEntity` (§2.2); a `resend` akció az `updatedBy`-t rögzíti — a vezető visszakeresheti, ki indított utolsó újraküldést, mikor. - **Javaslat.** A `MetaCard`-hoz 2 sor hozzáadása ("Létrehozta", "Módosította" mezők, mindkettő `displayName + relatív-időbélyeg` formátum). Pilot-volumenen ritkán használt; NEM kritikus. - **Hatás.** Mock-szintű korrekció. **HANDOFF.md átadási megjegyzés**. - **Döntés-státusz.** `under-review` ### SF-28 — A5 adatlap Resend confirm-dialog 5. mock-state hiánya - **Forrás.** `a5-riportok-adatlap.html` 4 `DCArtboard`-állapot (Completed+AllSent, Completed+Partial, Failed, Generating). **A Resend-confirm-dialog mock-state hiányzik** (sem 5. DCArtboard-ként, sem overlay-placeholderként). - **Spec.** `40_riport.md` §4.4 + SD-57: *"'Riport újraküldése' — az R-6-ot (`resend`) hívja; csak `Completed` esetén aktív. Megerősítő párbeszéd a **konkrét címzettek** felsorolásával: 'Újraküldöd a riportot a következő címzetteknek: ?'"* - **Javaslat.** **5. DCArtboard** a Resend-confirm-dialog-mock-state-tel: a `ConfirmDialog` organism (Tier-1) `MergeBody` mintát követő body-pal — 4-soros címzett-felsorolás + "Mégse" / "Újraküldés a 4 címzettnek" akciók. A SD-57 literal-text ("Újraküldöd a riportot a következő címzetteknek:") a body-bevezetőben. - **Hatás.** Mock-szintű demonstráció-pótlás. **HANDOFF.md átadási megjegyzés**; alacsony prioritás. - **Döntés-státusz.** `under-review` ### SF-29 — A5 adatlap PDF inline preview-stub visszavágás VAGY formalizálás (új D-18) — **KRITIKUS** - **Forrás.** `a5-riportok-adatlap.html` `PdfInlineStub` komponens (sor 396–467) az `a5d-twocol` bal-oszlopban — **a teljes 1100px-magasság ~80%-át kitölti**. A stub 4 sub-blokkot renderel: toolbar + PDF-header + "A hét számai" + "A múlt héthez képest" + "Kategória szerinti bontás" + footer. - **Spec.** `40_riport.md` §4.4 a riport-adatlap **5 szekcióját** rögzíti (Alapadatok / A hét számai / Kategória szerinti bontás / Címzettek / Audit). **PDF inline preview-t NEM ír.** A "Letöltés" gomb a R-4 endpoint bináris PDF-output-ját adja (Content-Type: application/pdf, Content-Disposition: attachment) — a böngésző natívan rendereli, de **a screen-mock-fájl egy custom HTML-renderelést készít a PDF-tartalom-stubjaként**. - **Probléma.** - **Funkcionálisan duplikálja** a `NumbersCard` szekciót (a "hét számai" kétszer renderel). - **A `prevWeek` mock-adatot vezeti be** (`REPORT_W20.prevWeek: { resolved: 18, avgDays: 2.4, newCount: 24 }`) — a `WeeklyReport` entitás **nem hordoz `prevWeek` mezőt**. A spec szerint a "múlt héthez képest" a generálás-időben számolódik a két `snapshotData`-ból. A `prevWeek` mező a screen-mockban **kitalált DTO-vetület**. - **Q2=A explorer-hivatkozás** a screen-headerben — DE a Q2 **NEM rögzített D-X-ként** a `DECISIONS.md`-ben (D-1..D-17 áttekintve). Ez egy 8. lépés-belüli explorer-jegyzet, ami nem emelkedett kanonikus döntésre. - **Javaslat.** **Kettős:** - **(a) Visszavágás (preferált):** a `PdfInlineStub` komponens TÖRLÉSE. A baloldali oszlop tartalma egy **valódi `