Developer Portal¶

Production · Couche 4 — Produit vertical · Dépôt : developer-gerege-mn · developer.gerege.mn

Le point d'entrée unique des développeurs qui construisent sur l'écosystème Gerege : un catalogue d'API, la marche à suivre pour enregistrer une application, et un assistant IA — organisés selon l'architecture d'information des meilleurs portails développeurs (Stripe · Twilio · Singapore APEX).

Périmètre — volontairement étroit¶

Ce portail ne cherche pas à tout faire. Ce qu'il contient :

le tableau de bord développeur (les premières étapes),
le catalogue d'API — par API : scopes, endpoints et exemples cURL fonctionnels,
la marche à suivre pour enregistrer une application,
un assistant IA,
un noyau d'administration minimal.

Ce qu'il ne contient PAS : les services destinés aux citoyens, les circuits documentaires, les paiements. Tout cela se trouve sur Gerege Platform.

La règle la plus importante — les identifiants ne vivent pas ici¶

Le portail NE CRÉE PAS de clients OAuth

Le Developer Portal ne crée pas de clients OAuth et ne voit ni ne stocke les client secrets. L'enregistrement des applications se fait intégralement sur Gerege SSO (sso.gerege.mn).

Le portail se contente d'expliquer ce qu'il faut préparer et de renvoyer par lien profond vers la console SSO.

La raison : si des identifiants vivent simultanément dans deux systèmes, ils finiront par diverger — un client supprimé d'un côté continue de fonctionner de l'autre, une rotation de secret n'atteint jamais l'autre côté, etc. Une source unique est le seul montage fiable.

Authentification¶

Le portail est lui-même un RP OIDC de Gerege SSO — la connexion a lieu sur sso.gerege.mn par eID. Il n'a aucun système de mots de passe propre.

Structure¶

developer-gerege-mn/
├── backend/     # Go · chi · pgx · PostgreSQL · Redis · Gerege SSO (RP OIDC)
│   └── docs/    # ARCHITECTURE · DEVELOPMENT · API_CONTRACT · SECURITY (EN/MN)
├── frontend/    # BFF Next.js
└── docs-site/   # MkDocs — la documentation propre du portail

Pages principales¶

Chemin	Contenu
`/dashboard`	Tableau de bord des premières étapes
`/apis`	Catalogue d'API — scopes, endpoints, exemples cURL
`/apps`	Comment enregistrer une application (liens vers la console SSO)

La variante gouvernementale¶

developer.dgov.mn (dépôt developer-dgov-mn) est le même portail sur la ligne gouvernementale. Il est open source — voir Ligne gouvernementale.

Documentation détaillée¶

Le site de documentation propre au portail se trouve dans le répertoire docs-site/ du dépôt developer-gerege-mn, construit avec MkDocs, en mongol et en anglais. Chapitres principaux : Introduction · Architecture · Authentification (eID + SSO, enregistrer une application, l'eID Service Proxy, l'API Gateway) · Sécurité · Exploitation.