92 lines
4.6 KiB
Markdown
Executable File
92 lines
4.6 KiB
Markdown
Executable File
# 📘 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? |