# 📘 SERVICE FINDER - MASTER BOOK 2.0 (v2.0)
**Traffic Ecosystem SuperApp - Single Source of Truth**

Ez a dokumentáció a rendszer véglegesített, konszolidált tudásbázisa. Minden korábbi verziót felülír. A fejlesztés során kizárólag az itt hivatkozott szabályok és struktúrák érvényesek.

## 🚀 1. A Rendszer Alapjai (Core Documentation)
A teljes tudásbázis 8 db, logikailag elkülönített "könyvbe" (modulba) lett szervezve:

| Fájl | Tartalom / Felelősségi kör |
| :--- | :--- |
| **[03_Infrastructure_Operations_2.0](./03_Infrastructure_Operations_2.0.md)** | **DevOps:** Docker Stack, Hálózatok, MinIO, Biztonsági mentés. |
| **[05_Identity_Auth_MDM](./05_Identity_Auth_MDM.md)** | **Core:** Person vs User, Auth Flow, Master Data Management (Deduplikáció). |
| **[06_Economy_Fleet_Marketplace_2.0](./06_Economy_Fleet_Marketplace_2.0.md)** | **Business:** Triple Wallet, Csomagok (Tiers), Szerviz Életciklus (Ghost/Active). |
| **[07_API_Communication_2.0](./07_API_Communication_2.0.md)** | **Interface:** API Végpontok, Admin Panel, i18n, Security (Sentinel). |
| **[12_Automated_Events_Notifications_2.0](./12_Automated_Events_Notifications_2.0.md)** | **Events:** Értesítési központ, Lejáratok figyelése, Push/Email triggerek. |
| **[13_Roadmap_Testing_Pitfalls_2.0](./13_Roadmap_Testing_Pitfalls_2.0.md)** | **DevGuide:** Jövőkép, Tech Debt (JSONB), Fejlesztői buktatók. |
| **[19_Permissions_Tiers_Branches_2.0](./19_Permissions_Tiers_Branches_2.0.md)** | **Access:** RBAC (L0-L3), Sales Agent rendszer, Telephely hierarchia. |
| **[22_Robot_Ecosystem_2.0](./22_Robot_Ecosystem_2.0.md)** | **AI/Robots:** R1-R4 Robotok specifikációja, AI Search RAG, Safe-Merge logika. |

---

## 🗺️ 2. Kód & Dokumentáció Térkép (Code Mapping)
Hol találod a kódban azt, amiről a dokumentáció beszél?

### 🤖 Robotok & AI
| Dokumentáció | Implementáció (File Path) |
| :--- | :--- |
| **Robot 1 (Catalog)** | `app/workers/catalog_scout.py` (vagy releváns worker) |
| **Robot 2 (Enricher)** | `app/workers/technical_enricher.py` (v1.2.6) |
| **AI Service (RAG)** | `app/services/ai_service.py` (v1.2.5) |
| **OCR Robot** | `app/workers/ocr_robot.py` (v1.0) |

### 🏢 Üzleti Logika & Modellek
| Dokumentáció | Implementáció (File Path) |
| :--- | :--- |
| **Identity (Person)** | `app/models/identity.py` |
| **Wallet & Ledger** | `app/models/audit.py` / `app/models/identity.py` |
| **RBAC & Security** | `app/core/security.py` / `app/services/auth_service.py` |
| **MDM / Assets** | `app/models/vehicle_definitions.py` / `app/models/asset.py` |

---

## 🧹 3. Archiválási Jegyzőkönyv (Cleanup Log)
A Master Book 2.0 létrejöttével az alábbi korábbi (v1.0) állományok elavulttá váltak. Javasolt az `_archive/` mappába mozgatásuk vagy törlésük.

- `00_README.md` (Régi index)
- `01_Project_Overview.md` (Beépült a 05/06-ba)
- `02_Architecture_System_Context.md` (Beépült a 03-ba)
- `03_Dev_Environment_Runbook.md` (Beépült a 03-ba)
- `04_Infrastructure_Docker_Stack.md` (Beépült a 03-ba)
- `05_AUTH_AND_IDENTITY_SPEC.md` (Beépült a 05-be)
- `06_Database_Guide.md` (Beépült a 05-be)
- `07_API_Guide.md` & `07_REGISTRATION...` (Beépült a 07-be)
- `08_Frontend_Guide.md` (Tartalma elavult, UI refaktorra vár)
- `09_Admin_API_Guide.md` (Beépült a 07/19-be)
- `10_Billing_Credits_Subscriptions.md` (Beépült a 06-ba)
- `11_Gamification_Social.md` (Beépült a 06/19-be)
- `12_Operations_Backup_Monitoring.md` (Beépült a 03-ba)
- `13_Roadmap_Tech_Debt.md` (Beépült a 13-ba)
- `15_Changelog.md` (Beépült a 13-ba / Git history)
- `16_TESTING...` & `17_DEVELOPER...` (Beépült a 13-ba)
- `18_ASSET...` & `20_Service_Finder...` (Beépült a 06-ba)
- `19_ADMIN...` & `23_BRANCH...` (Beépült a 19-be)
- `21_DEEP_ASSET...` (Beépült a 05-be)
- `22_ROBOT_ÖKOSZISZTÉMA.md` (Beépült a 22-be)

---

## 🚦 4. Gyorsindítás (Quick Start)
A rendszer indítása a v2.0 infrastruktúra alapján:

```bash
# 1. Környezeti változók ellenőrzése
cat .env

# 2. Konténerek indítása (V2 parancs)
docker compose up -d --build

# 3. Logok követése (Robot Enricher)
docker logs -f service_finder_robot_enricher

---

### 🏛️ Architekti Zárszó

Ezzel a lépéssel a projekt átlépett a "Kísérleti" fázisból az **"Ipari"** fázisba.
1.  A dokumentáció tiszta, nem redundáns.
2.  A fejlesztők pontosan tudják, hova nyúljanak.
3.  A robotok logikája "kőbe van vésve".

**Mi legyen a következő technikai lépés?**
Most, hogy a könyvtár rendben van, javaslom, hogy térjünk vissza a kódhoz és kezdjük el a **Fuzzy Search API** (kereső) fejlesztését, vagy a **Frontend (UI)** felzárkóztatását az új adatokhoz?