4.6 KiB
Executable File
4.6 KiB
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 | DevOps: Docker Stack, Hálózatok, MinIO, Biztonsági mentés. |
| 05_Identity_Auth_MDM | Core: Person vs User, Auth Flow, Master Data Management (Deduplikáció). |
| 06_Economy_Fleet_Marketplace_2.0 | Business: Triple Wallet, Csomagok (Tiers), Szerviz Életciklus (Ghost/Active). |
| 07_API_Communication_2.0 | Interface: API Végpontok, Admin Panel, i18n, Security (Sentinel). |
| 12_Automated_Events_Notifications_2.0 | Events: Értesítési központ, Lejáratok figyelése, Push/Email triggerek. |
| 13_Roadmap_Testing_Pitfalls_2.0 | DevGuide: Jövőkép, Tech Debt (JSONB), Fejlesztői buktatók. |
| 19_Permissions_Tiers_Branches_2.0 | Access: RBAC (L0-L3), Sales Agent rendszer, Telephely hierarchia. |
| 22_Robot_Ecosystem_2.0 | 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:
# 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?