Developer Portal¶

Production · Layer 4 — Vertical product · Repo: developer-gerege-mn · developer.gerege.mn

The single entry point for developers building on the Gerege ecosystem: an API catalogue, guidance on registering applications, and an AI assistant — organised along the information architecture of the world's better developer portals (Stripe · Twilio · Singapore APEX).

Scope — deliberately narrow¶

This portal does not try to do everything. What is inside:

the developer dashboard (getting-started steps),
the API catalogue — per-API scopes, endpoints and working cURL examples,
guidance on registering an application,
an AI assistant,
a minimal admin core.

What is NOT inside: citizen-facing services, document workflows, payments. Those live on Gerege Platform.

The most important rule — credentials do not live here¶

The portal does NOT create OAuth clients

The Developer Portal does not create OAuth clients and does not see or store client secrets. Application registration happens entirely on Gerege SSO (sso.gerege.mn).

The portal only explains what you need to prepare and deep-links into the SSO console.

The reason: if credentials live in two systems at once, sooner or later they diverge — a client deleted on one side keeps working on the other, a rotated secret never reaches the other side, and so on. A single source is the only reliable arrangement.

Authentication¶

The portal is itself an OIDC RP of Gerege SSO — sign-in happens at sso.gerege.mn using eID. It has no password system of its own.

Structure¶

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

Main pages¶

Path	Contents
`/dashboard`	Getting-started dashboard
`/apis`	API catalogue — scopes, endpoints, cURL examples
`/apps`	How to register an application (links into the SSO console)

The government variant¶

developer.dgov.mn (repo developer-dgov-mn) is the same portal on the government line. It is open source — see Government line.

Full documentation¶

The portal's own documentation site lives in the docs-site/ directory of the developer-gerege-mn repository, built with MkDocs, in MN and EN. Main chapters: Introduction · Architecture · Authentication (eID + SSO, registering an app, the eID Service Proxy, the API Gateway) · Security · Operations.