DealerCRM Platform — dokumentacja techniczna

Jak integrować nowe aplikacje (BMS, Service, Analytics, …) z DealerID, CRM i resztą platformy DealerCRM.

Co znajdziesz w tej dokumentacji

Zaczynamy

Architektura platformy, role poszczególnych aplikacji, jak zarejestrować nową apkę jako klienta OAuth2 w DealerID. Czytaj: Przegląd platformy → Rejestracja aplikacji.

OAuth2 / OIDC

Authorization Code + PKCE, ekran zgody (consent) vs. first-party auto-approve, kontrakt /userinfo, co znaczy claim is_internal_staff. Czytaj: Flow logowania → Endpoint /userinfo.

App Directory

Każda aplikacja eksponuje endpoint do enumeracji „kart Applications” dla zalogowanego usera. DealerID agreguje je na /account/apps. Czytaj: Kontrakt /api/dealerid/user-apps → Implementacja.

Internal Staff

Pracownicy Grupy Dealer (@grupadealer.pl) — auto-provisioning po SSO Google, propagacja claimu is_internal_staff do downstream apek, blokada loginu hasłem. Czytaj: SSO Google + auto-provisioning.

Multitenancy

Model host → application → organization. 4 application kinds (dealer_main, importer_main, importer_network, staff), branding dziedziczony z organization, routing wyłącznie z Host header. Czytaj: Aplikacje (kindy, branding, routing).

Konwencje

UI po polsku, ścieżki po angielsku. Hexagonal modular monolith. PR-y do apps/dealerid, apps/crm-api, apps/crm-frontend — bez modyfikacji cudzych modułów bez zgody właściciela.

Dla kogo to jest

Ta strona to wewnętrzna dokumentacja dla zespołów Grupy Dealer budujących kolejne aplikacje platformy DealerCRM (BMS, Service, Analytics, Portal Klienta). Nie jest publicznym SDK — wszystko opisane tutaj zakłada dostęp do repo dealercrm4 i komunikację bezpośrednio z zespołem DealerID.

Jeśli budujesz nową aplikację, twoja ścieżka:

Przegląd platformy — zrozum, gdzie pasujesz.
Rejestracja aplikacji — dostań client_id + client_secret w DealerID.
Flow OAuth2 — zaimplementuj logowanie przez DealerID.
App Directory — implementacja — wystaw endpoint, żeby user widział twoją apkę na /account/apps.