Developer Portal¶

Production · Давхарга 4 — Салбар продукт · Репо: developer-gerege-mn · developer.gerege.mn

Gerege экосистем дээр бүтээх хөгжүүлэгчдэд зориулсан нэгдсэн гарц. API каталог, апп бүртгэлийн заавар, AI туслах — дэлхийн жишгийн developer portal-уудын (Stripe · Twilio · Singapore APEX) мэдээллийн бүтцээр.

Хамрах хүрээ — зориудаар нарийн¶

Энэ портал нь бүх зүйлийг хийхийг оролддоггүй. Дотор нь байгаа зүйлс:

хөгжүүлэгчийн самбар (эхлэх алхмууд),
API каталог — API тус бүрийн scope · endpoint · ажилладаг cURL жишээ,
апп бүртгэх заавар,
AI туслах,
хамгийн бага админ цөм.

Дотор нь БАЙХГҮЙ: иргэнд харсан үйлчилгээ, баримт бичгийн урсгал, төлбөр. Тэдгээр нь Gerege Platform дээр байна.

Хамгийн чухал дүрэм — credential энд амьдардаггүй¶

Портал OAuth client ҮҮСГЭДЭГГҮЙ

Developer Portal нь OAuth client үүсгэхгүй, client secret-ийг харахгүй, хадгалахгүй. Апп бүртгэл нь бүхэлдээ Gerege SSO (sso.gerege.mn) дээр явагдана.

Портал зөвхөн: юу бэлдэх ёстойг тайлбарлаж, SSO консол руу гүн холбоос хийнэ.

Учир нь credential хоёр системд зэрэг амьдарвал хэзээ нэгэн цагт зөрнө — нэг талд устгагдсан client нөгөө талд ажилласаар байх, secret ротаци нөгөө талд хүрэхгүй байх гэх мэт. Нэг эх сурвалж байх нь цорын ганц найдвартай арга.

Танилт¶

Портал өөрөө Gerege SSO-ийн OIDC RP — нэвтрэлт нь 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) нь мөн адил портал, төрийн шугам дээр. Тэр нь нээлттэй эх — Төрийн шугам хуудаснаас үзнэ үү.

Дэлгэрэнгүй баримт¶

Порталын өөрийн баримтын сайт нь developer-gerege-mn репо-гийн docs-site/ хавтаст MkDocs-оор, MN/EN хоёр хэлээр байрлана. Гол бүлгүүд: Танилцуулга · Архитектур · Нэвтрэлт (eID + SSO, апп бүртгэх, eID Service Proxy, API Gateway) · Аюулгүй байдал · Ажиллагаа.