# Urbino Manager — UI-átadási csomag

**Verzió:** 1.0 · **Dátum:** 2026.05.27 · **Forrás:** Urbino Manager UI-csapat
**Címzett:** Senior Angular fejlesztő + Claude Code

---

## Mi ez a csomag?

A Urbino Manager **12-screen-es admin-felület** pilot-portolásához szükséges teljes tudás-anyag.
**Nem Angular-kód** — UX-mockok, döntés-napló, spec-visszacsatolás és tenant-DB seed-data.

A pilot-portolás a meglévő `project_backend_client_angular` Angular-infrastruktúrára épül
(`[tableState]`, `[validationForm]`, `<app-gallery>`, PrimeNG v21 Aura, ngx-translate),
**NEM** új Angular-projektet ad át.

---

## Hol kezdjem?

### 1. lépés — Olvasd el a navigációs hubot

Nyisd meg a böngészőben: **`Urbino Manager.html`**

Egyetlen önálló oldal a teljes projekt áttekintésével: a 9-lépéses tervet, a 17 UX-döntést,
a 28 React-mock screen direkt-linkjeit, és az új deliverable-ek hivatkozásait tartalmazza.
A `.html` natívan rendereződik bármely modern böngészőben.

### 2. lépés — Olvasd el a HANDOFF.md-t (30 perc)

A teljes átadási dokumentum 10 szekcióban:

- Áttekintés + olvasási sorrend
- A 16 [★]-döntés véglegesített állapota
- **P0 fix-tételek a portoláskor (15 tétel)**
- **Cross-mapping React-mock → `core/`-minta** (42 organism)
- Onboarding-checklist a Claude Code-nak (first 5 hours)
- Performance + A11y budget

### 3. lépés — A spec-csapatnak küldd el a SPEC-FEEDBACK-et

`SPEC-FEEDBACK-FOR-SPEC-TEAM.md` — **40 SF-tétel**, amire spec-csapat-válasz kell.
**A pilot-portolás megindulhat ezalatt**, mert a `confirmed` és `accepted` tételek már
egyértelmű utat adnak.

### 4. lépés — Indítsd a fejlesztést

A `seed-data-balatonalmadi-pilot.json` betöltése a tenant-DB-be (admin-API vagy migration).
A `i18n-keys-mgr.json` beolvasztása a `src/i18n/hu.json`-be (új `manager`-szintű kulcsok).
A `manager-system/preview/screens/` mappa böngészése vizuális hivatkozásként.

---

## A csomag tartalma

### Fő deliverable-ek (gyökérben)

| Fájl | Cél |
|---|---|
| **`HANDOFF.md`** | A fő átadási dokumentum (~27 KB, 10 szekció). |
| **`SPEC-FEEDBACK-FOR-SPEC-TEAM.md`** | 40 SF-tétel a spec-csapatnak (~50 KB, 4 szekció). |
| **`seed-data-balatonalmadi-pilot.json`** | Tenant-DB seed (~101 KB, ~270 rekord). |
| **`i18n-keys-mgr.json`** | `ngx-translate`-kompatibilis magyar kulcsok (~21 KB, 351 kulcs). |
| **`Urbino Manager.html`** | Navigációs hub az egész projekthez (natív böngésző-renderelés). |
| **`README.md`** | Ez a fájl. |

### Támogató dokumentumok (mélyebb kontextus)

| Fájl | Cél |
|---|---|
| `HANDOFF-PREP.md` | 16 [★]-döntés részletes naplója. |
| `SPEC-FEEDBACK.md` | Belső munkadokumentum (forrás-réteg a SPEC-FEEDBACK-FOR-SPEC-TEAM mögé). |
| `SPEC-COVERAGE-A1A2A3.md` + `-A4A5.md` + `-A6A7A8A9.md` + `-A10A11A12.md` | Spec-fedés-leltár (~370 mező/végpont/UI-elem, mind a 4 ág). |
| `AUDIT.md` + `AUDIT-2.md` | 6. + 8. lépés végi auditok. |
| `REVIEW.md` | Átadás előtti review-jegyzet. |
| `SCREEN-CONVENTIONS.md` | 11-dimenziós screen-mock-szabvány. |

### `manager-system/`

A React-mock + organism + döntés-napló réteg.

```
manager-system/
  DECISIONS.md           D-1..D-20 UX-döntés-napló
  ORGANISMS.md           42 organism API + Tier-besorolás
  SITEMAP.md             12 screen × 42 organism használat-mátrix
  preview/
    screens/             28 React-mock screen (statikus HTML, böngészőben futtatható)
    organisms-index.html Organism-katalógus
  organisms/             42 JSX-fájl + _styles.css (vizuális forrás)
```

### `design-system/`

A Urbino Design System fixture-másolata. A `manager-system/`-organism-ek ide hivatkoznak
(`colors_and_type.css`, `components/`, fontok, ikonok). A pilot-átadás után az Angular
oldalon a meglévő `core/` réteg ezt már beépíti.

### `uploads/urbino-docs/` *(opcionális — ha még nincs a fejlesztő-projektben)*

A spec-csomag forrásdokumentumai (`00_domain_model.md`, `01_kozos_mintak.md`,
`20_admin_felulet/*.md`, `kanonikus_donek.md`, `99_donesnaplo.md`). **Valószínűleg már be van
húzva** a `project_backend_client_angular/docs/spec/` mappába a Phase 1 időszakból.

---

## Mit nem kell

- **Angular kód** — a meglévő `core/` réteg + a HANDOFF.md cross-mapping-tábla elegendő.
- **Mock-backend Angular-szerver** — a `seed-data-balatonalmadi-pilot.json` a tenant-DB-be kerül.
- **Build-step a HTML-mockokhoz** — a `manager-system/preview/screens/*.html` natívan rendereződik.

---

## Függő pontok az átadáskor

1. **Spec-csapat válaszai a 40 SF-tételre.** Várt időszükséglet ~10-15 munkanap. A
   pilot-portolás megindulhat ezalatt (a `confirmed` + `accepted` tételek elegendőek).
2. **4 `under-review` technikai kérdés** (SF-2, SF-16, SF-17, SF-52) — fejlesztő-csapat
   technikai döntésére. A HANDOFF.md `4.3` szekciója listázza.
3. **1 `deferred` tétel** (SF-61: `Tenant.logoUploadedAt/By`) — Phase 2-re halasztott.

---

## Kapcsolat

A csomag az Urbino Manager UI-csapat 2026.05.27-i állapotát rögzíti. Új iteráció a
pilot-feedback után (~2026 nyár vége / ősz eleje).

*— Urbino Manager UI-csapat · 2026.05.27*