🔍 Admin Service Provider Root Cause Analysis

Összefoglaló

Felfedezett hiba: Az admin felület szolgáltató (provider) listája és "Jóváhagyásra váró" oldala csak a marketplace.service_providers táblában tárolt 6 rekordot jeleníti meg. A robotok által begyűjtött 8569 rekord a marketplace.service_staging táblában teljesen láthatatlan az admin számára.

Dátum: 2026-06-30 Vizsgáló: Rendszer-Architect

🗺️ Adatbázis Táblák Állapota

Tábla	Séma	Rekordszám	Státuszértékek	Forrás
`service_providers`	`marketplace`	6	approved, rejected	API (user/manuális)
`service_staging`	`marketplace`	8569	research_in_progress (5096), no_web_presence (3472), auditing (1)	Robotok (bot)
`organizations`	`fleet`	1 (service_provider = true)	active	Regisztráció

🔬 Root Cause Analysis

1. Admin API csak a `service_providers` táblát kérdezi

A backend/app/api/v1/endpoints/admin_providers.py list_providers() metódusa kizárólag a ServiceProvider modellre hivatkozik:

@router.get("", response_model=List[ProviderListItem])
async def list_providers(...):
    query = select(ServiceProvider)  # ← CSAK marketplace.service_providers
    ...

Ugyanez a helyzet a get_provider_stats() endpointtal (261. sor).

Következmény: A botok által felfedezett 8569 rekord admin felületről nem látható, nem moderálható, nem kereshető.

2. A Public API már helyesen kezeli a 3 forrást

A backend/app/services/provider_service.py search_providers() (public API) UNION ALL lekérdezéssel egyesíti mindhárom forrást:

org_query = select(Organization.id, Organization.name, ...)
staging_query = select(ServiceStaging.id, ServiceStaging.name, ...)
provider_query = select(ServiceProvider.id, ServiceProvider.name, ...)
union_query = union_all(org_query, staging_query, provider_query)

Ezt a mintát kell alkalmazni az admin API-ban is.

3. A "Jóváhagyásra váró" lista azért üres, mert...

A service_providers táblában nincs pending státuszú rekord (csak approved/rejected)
A service_staging tábla 8569 rekordja ki van zárva az admin lekérdezésből
A frontend pending.vue ugyanezt az admin API-t hívja status=pending paraméterrel

4. Validációs rendszer már létezik, csak csatornázni kell

A meglévő adatbázis tartalmazza az összes szükséges validációs infrastruktúrát:

marketplace.provider_validations - upvote/downvote rendszer súlyozással, dedikált validációs tábla
marketplace.service_providers.validation_score - közvetlen validációs pontszám
marketplace.service_providers.status - moderációs státusz (ModerationStatus enum)
marketplace.service_profiles.trust_score - bizalmi pontszám
marketplace.service_profiles.is_verified - ellenőrzöttségi jelző
marketplace.service_profiles.verification_log - JSON validációs napló

Nem kell új mezőket létrehozni - a ServiceStaging adatokat megfelelően be kell csatornázni a meglévő validációs rendszerbe.

🩹 Javasolt Javítási Terv

Rövid távú (P0) - Admin API UNION ALL kiterjesztése

list_providers() módosítása admin_providers.py-ban:
- UNION ALL lekérdezés a ServiceStaging táblából is (a search_providers() mintájára)
- A ServiceStaging rekordok leképezése a ProviderListItem response modelre
- A ServiceStaging rekordoknál: status -> research_in_progress mint pending, source -> bot
get_provider_stats() módosítása admin_providers.py-ban:
- A pending count kiegészítése a research_in_progress ServiceStaging rekordokkal
Jóváhagyási flow (approve/reject):
- ServiceStaging rekord jóváhagyásakor: ServiceProvider rekord létrehozása az adatokkal
- A meglévő provider_validations és service_profiles validációs rendszer használata

Implementációs Részletek

A ProviderListItem modelt ki kell egészíteni egy source_table mezővel, hogy a frontend tudja, melyik táblából jött a rekord:

class ProviderListItem(BaseModel):
    id: int
    name: str
    address: Optional[str]
    city: Optional[str]
    status: str  # "pending" | "approved" | "rejected"
    source: str  # "api" | "manual" | "bot"
    source_table: str  # "service_providers" | "service_staging" | "organizations"
    validation_score: Optional[int]
    created_at: datetime

🔗 Érintett Fájlok

Fájl	Szerep
`backend/app/api/v1/endpoints/admin_providers.py`	Root cause - Javítandó fájl
`backend/app/services/provider_service.py`	Minta - UNION ALL implementáció
`backend/app/models/identity/social.py`	`ServiceProvider` modell
`backend/app/models/marketplace/service.py`	`ServiceStaging` modell
`frontend_admin/pages/providers/index.vue`	Admin provider lista oldal
`frontend_admin/pages/providers/pending.vue`	Admin pending queue oldal
`plans/logic_spec_service_provider_discovery_admin.md`	Meglévő tervdokumentáció

✅ Következő Lépések

Gitea kártya létrehozása: Admin API UNION ALL kiterjesztése ServiceStaging táblával
ProviderListItem response model kiegészítése source_table mezővel
list_providers() módosítása: UNION ALL 3 forrás
get_provider_stats() módosítása: staging rekordok beszámítása
Jóváhagyási flow: ServiceStaging -> ServiceProvider átvezetés
Tesztelés: frontend pending lista megjelenése

6.5 KiB Raw Blame History