Initial commit: Robot ökoszisztéma v2.0 - Stabilizált jármű és szerviz robotok

This commit is contained in:
Kincses
2026-03-04 02:03:03 +01:00
commit 250f4f4b8f
7942 changed files with 449625 additions and 0 deletions

View File

@@ -0,0 +1,15 @@
# Master Grand Book v1.0 Service Finder / Traffic Ecosystem SuperApp
Ez a dokumentáció a projekt **kanonikus tudásbázisa**.
Két párhuzamos könyvtár létezik:
- V01_chatgpt technikai, mérnöki, architekturális megközelítés
- V01_gemini alternatív gondolkodás, validáció, kiegészítő perspektíva
Cél:
- Tudás megőrzése
- Döntések visszakövethetősége
- Fejlesztési minőség mérése (kód + beállítás + hibajavítás hatékonyság)
- Új projektek benchmark alapja
Ez a v1.0 verzió a **baseline állapot** dokumentálása.

View File

@@ -0,0 +1,24 @@
# Projekt áttekintés
Projekt neve: Traffic Ecosystem SuperApp 2.0 (Service Finder)
Cél:
Egy moduláris platform létrehozása, amely:
- kezeli a járművek életciklusát,
- nyilvántartja a költségeket, eseményeket, szervizeket,
- összeköti a felhasználókat valós szolgáltatókkal,
- automatizált adatgyűjtést végez (discovery botok),
- skálázható SaaS modellben működik.
Fő modulok:
- Auth / User / Organization
- Fleet & Vehicle Lifecycle
- Service Provider Marketplace
- Billing / Credits / Subscription
- Gamification & Social
- Discovery Bots (adatgyűjtés)
- Dokumentumfeldolgozás (OCR pipeline tervezett)
Non-goals (v1.0):
- Teljes üzleti automatizmus
- Külső fizetési gateway éles integráció

View File

@@ -0,0 +1,19 @@
# Fejlesztői környezet
Indítás:
- docker compose up -d
Alapszolgáltatások:
- API: :8000
- Frontend: :3001
- MinIO: :9000 / :9001
- Redis: belső háló
Tipikus ellenőrzések:
- API online: GET /
- OpenAPI: /api/v2/openapi.json
- Frontend betölt
Ismert jellegzetességek:
- v1 és v2 API párhuzamosan él
- .env alapú konfiguráció

View File

@@ -0,0 +1,26 @@
# Adatbázis Baseline állapot
DB: PostgreSQL (shared-postgres)
Séma: data
Táblák száma: ~55
Kulcs entitások:
- users
- persons
- companies
- vehicles, vehicle_models, vehicle_variants
- service_providers, service_specialties
- fuel_stations
- credit_logs, vouchers, subscriptions
- audit_logs
Migráció:
- Alembic
- Head rev: 5aed26900f0b
- Persons + owner_person_id implementálva
Seed:
- fuel_stations ~7300
- service_providers ~7200

View File

@@ -0,0 +1,13 @@
# API Áttekintés
Verziók:
- v1: üzleti modulok (fleet, billing, reports)
- v2: auth és új generációs endpointok
Elvek:
- JWT alapú auth
- Verziózott API
- OpenAPI dokumentált
Megjegyzés:
A v1 → v2 egységesítés külön roadmap tétel.

View File

@@ -0,0 +1,10 @@
# Anchor Log döntési napló
Ez a fejezet rögzíti:
- fontos architekturális döntéseket,
- API-szerződés változásokat,
- adatmodell átalakításokat,
- stratégiai irányváltásokat.
Cél:
- később visszakövethető legyen, miért úgy épült a rendszer, ahogy.

View File

@@ -0,0 +1,6 @@
# Changelog
v1.0 Baseline
- Mester dokumentum struktúra létrehozva
- DB baseline rögzítve
- API verziózás dokumentálva