Developer Portal¶

Production · Слой 4 — Отраслевой продукт · Репозиторий: developer-gerege-mn · developer.gerege.mn

Единая точка входа для разработчиков, создающих продукты на экосистеме Gerege: каталог API, инструкции по регистрации приложений и ИИ-помощник — организованные по информационной структуре лучших мировых порталов для разработчиков (Stripe · Twilio · Singapore APEX).

Охват — умышленно узкий¶

Этот портал не пытается делать всё. Что внутри:

панель разработчика (шаги для начала работы),
каталог API — по каждому API: scope, endpoint'ы и работающие примеры cURL,
инструкции по регистрации приложения,
ИИ-помощник,
минимальное административное ядро.

Чего внутри НЕТ: услуг для граждан, документооборота, платежей. Всё это находится на Gerege Platform.

Самое важное правило — credential здесь не живут¶

Портал НЕ СОЗДАЁТ OAuth-клиентов

Developer Portal не создаёт OAuth-клиентов и не видит и не хранит client secret. Регистрация приложений целиком происходит на Gerege SSO (sso.gerege.mn).

Портал лишь объясняет, что нужно подготовить, и даёт глубокую ссылку в консоль SSO.

Причина: если учётные данные живут сразу в двух системах, рано или поздно они разойдутся — удалённый на одной стороне клиент продолжает работать на другой, ротация секрета не доходит до второй стороны и так далее. Единственный источник — единственный надёжный вариант.

Аутентификация¶

Сам портал является OIDC RP для Gerege SSO — вход происходит на sso.gerege.mn по eID. Собственной системы паролей у него нет.

Структура¶

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 — собственная документация портала

Основные страницы¶

Путь	Содержание
`/dashboard`	Панель с шагами для начала работы
`/apis`	Каталог API — scope, endpoint'ы, примеры cURL
`/apps`	Как зарегистрировать приложение (ссылки в консоль SSO)

Государственный вариант¶

developer.dgov.mn (репозиторий developer-dgov-mn) — тот же портал на государственной линии. Он с открытым исходным кодом — см. Государственная линия.

Подробная документация¶

Собственный сайт документации портала находится в каталоге docs-site/ репозитория developer-gerege-mn, собран на MkDocs, на монгольском и английском. Основные разделы: Введение · Архитектура · Аутентификация (eID + SSO, регистрация приложения, eID Service Proxy, API Gateway) · Безопасность · Эксплуатация.