service-finder/docs/organization_member_audit_report_2026-06-17.md

🏗️ OrganizationMember Audit Report & Garage Selector Implementation

Dátum: 2026-06-17 Készítette: Fast Coder (Core Developer) Verzió: 1.0

---

1. Végrehajtott Módosítások

1.1 Backend: get_my_organizations végpont javítása

Fájl: backend/app/api/v1/endpoints/organizations.py

A lekérdezés logikája az alábbiakra változott:

• RÉGI: INNER JOIN az OrganizationMember táblán → csak azokat a szervezeteket adta vissza, ahol a felhasználónak volt member rekordja. Kizárta a tulajdonosi viszonyt (owner_id).
• ÚJ: LEFT JOIN + OR feltétel → visszaadja azokat a szervezeteket, ahol a felhasználó:
  • a) Technikai tulajdonos (Organization.owner_id == current_user.id)
  • VAGY
  • b) Szerepel az OrganizationMember táblában tagként (OrganizationMember.user_id == current_user.id)

SQL változás:

# RÉGI (hibás):
select(Organization).join(OrganizationMember).where(OrganizationMember.user_id == current_user.id)

# ÚJ (javított):
select(Organization).outerjoin(OrganizationMember, OrganizationMember.organization_id == Organization.id)\
    .where(or_(Organization.owner_id == current_user.id, OrganizationMember.user_id == current_user.id))\
    .distinct()

Válasz bővítése: A végpont most user_role mezőt is visszaad, amely a felhasználó szerepkörét tartalmazza az adott szervezetben (OWNER, ADMIN, FLEET_MANAGER, DRIVER, MECHANIC, RECEPTIONIST). Ha a felhasználó a tulajdonos, de nincs member rekordja, "OWNER"-t ad vissza.

1.2 Backend: OrganizationMember modell bővítése

Fájl: backend/app/models/marketplace/organization.py

A modellhez az alábbi hiányzó oszlopok kerültek hozzáadásra:

Oszlop	Típus	Alapértelmezés	Leírás
status	String(20)	'active'	Tag státusza (active, pending, inactive)
created_at	DateTime(timezone=True)	func.now()	Létrehozás időpontja
updated_at	DateTime(timezone=True)	onupdate=func.now()	Utolsó módosítás időpontja

Ezek az oszlopok hiányoztak az adatbázisból, de a kód már hivatkozott rájuk (pl. organizations.py:421,481 sorokban status="pending", status="active"), ami futási hibát okozott volna.

1.3 Adatbázis szinkronizáció

A sync_engine sikeresen hozzáadta a 3 hiányzó oszlopot a fleet.organization_members táblához.

---

2. Audit Jelentés: OrganizationMember Tábla

2.1 Oszlopok (Jelenlegi állapot a javítás után)

#	Oszlop	Típus	Kötelező	Alapértelmezett	Megjegyzés
1	id	integer	YES	auto-increment	PK
2	organization_id	integer	YES	-	FK → fleet.organizations.id
3	user_id	integer	NO	-	FK → identity.users.id (lehet NULL pending invite-nál)
4	person_id	bigint	NO	-	FK → identity.persons.id
5	role	ENUM (OrgUserRole)	YES	DRIVER	OWNER, ADMIN, FLEET_MANAGER, DRIVER, MECHANIC, RECEPTIONIST
6	permissions	json	NO	{}	JSONB jogosultságok
7	is_permanent	boolean	NO	false	Állandó vs. ideiglenes tagság
8	is_verified	boolean	NO	false	Ellenőrzött tag
9	status 🆕	varchar(20)	NO	'active'	Tag státusza
10	created_at 🆕	timestamptz	NO	now()	Létrehozás dátuma
11	updated_at 🆕	timestamptz	YES	-	Módosítás dátuma

2.2 Meghívási Folyamat (Invite Flow)

Meglévő API végpontok:

Végpont	Metódus	Státusz	Leírás
POST /api/v1/organizations/{org_id}/invitations	POST	✅ Létezik	Meghívó küldése email címre. Ha a user létezik → pending tag létrehozása. Ha nem → VerificationToken (org_invite típus)
POST /api/v1/organizations/invitations/{token}/accept	POST	✅ Létezik	Meghívó elfogadása token alapján (regisztráció után)
POST /api/v1/organizations/{org_id}/join-request	POST	✅ Létezik	Csatlakozási kérelem (ha van aktív admin)
POST /api/v1/organizations/{org_id}/claim/request	POST	✅ Létezik	Árva cég átvételi kérelem (OTP küldés)
POST /api/v1/organizations/{org_id}/claim/verify	POST	✅ Létezik	Árva cég átvétel OTP-vel

Hiányzó API végpontok (P2 - Következő iteráció):

Végpont	Metódus	Hiány	Hatás
GET /api/v1/organizations/{org_id}/members	GET	❌ Hiányzik	Nincs lehetőség a tagok listázására
PATCH /api/v1/organizations/{org_id}/members/{member_id}/role	PATCH	❌ Hiányzik	Nincs lehetőség a szerepkör módosítására
DELETE /api/v1/organizations/{org_id}/members/{member_id}	DELETE	❌ Hiányzik	Nincs lehetőség a tag eltávolítására
GET /api/v1/organizations/{org_id}/invitations	GET	❌ Hiányzik	Nincs lehetőség a függő meghívók listázására
DELETE /api/v1/organizations/{org_id}/invitations/{invitation_id}	DELETE	❌ Hiányzik	Nincs lehetőség a meghívó visszavonására

2.3 Jogosultságkezelés

• Tag felvétele: A POST /invitations végponton keresztül lehetséges (meghívó küldése). A POST /join-request lehetővé teszi a felhasználóknak, hogy maguk kérjenek csatlakozást.
• Szerepkör módosítása: ❌ Nincs implementálva. Nincs PATCH végpont a tag szerepkörének módosítására.
• Tag eltávolítása: ❌ Nincs implementálva. Nincs DELETE végpont a tag eltávolítására.
• Meghívó visszavonása: ❌ Nincs implementálva. Nincs DELETE végpont a függő meghívók visszavonására.

2.4 Javasolt Javítási Sorrend

1. P0 - KÉSZ: status, created_at, updated_at oszlopok hozzáadva az OrganizationMember modellhez
2. P0 - KÉSZ: get_my_organizations javítva OR logikára + user_role visszaadása
3. P1 - JELEN FELADAT: Tagkezelő API végpontok implementálása (list, role change, remove)
4. P2 - KÖVETKEZŐ: Meghívókezelő API végpontok (list pending, revoke)

---

3. Frontend Állapot

A frontend oldalon nem volt szükség változtatásra, mivel:

1. A HeaderCompanySwitcher.vue már használja az authStore.fetchMyOrganizations() hívást, ami a /organizations/my végpontot hívja.
2. A companyOrganizations computed property (144. sor) megfelelően szűri az individual, service_provider, service típusokat.
3. A authStore.switchOrganization() metódus már implementálva van a PATCH /users/me/active-organization hívással.
4. Az OrganizationItem típus már tartalmazza a user_role mezőt (nem kötelező).

---

4. Teszt Eredmények

• ✅ sync_engine sikeresen lefutott - 3 hiányzó oszlop hozzáadva
• ✅ GET /api/v1/organizations/my végpont működik, visszaadja a user_role mezőt
• ✅ A végpont helyesen szűri a service_provider típusú szervezeteket
• ✅ Az adatbázis séma konzisztens a kóddal