Epic 3: Economy & Billing Engine (Pénzügyi Motor)

docs/v02/00_README.md

@@ -0,0 +1,92 @@
+# 📘 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?