Gerege App¶

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

Иргэний өдөр тутмын үйлчилгээ нэг апп дотор. Цахим үнэмлэхээрээ танигдаж, лавлагаа авах, гэрээнд гарын үсэг зурах, төлбөр хийх, байгууллагаа удирдах — олон апп, олон нууц үг, олон дараалал шаардахгүйгээр.

Эзэмшил

Платформыг Gerege App ХХК эзэмшин ажиллуулна. Техникийн суурь нь Gerege Systems-ийн хувилбартай дундын Go модуль open-gerege-core — танилт, аюулгүй байдал, AI, үйлчилгээний тулгуур давхаргыг эндээс өвлөнө.

Юуг шийддэг вэ¶

Иргэн үйлчилгээ бүрт өөр апп нээж, өөр нууц үг сануулж, ижил бичиг баримтаа дахин дахин хавсаргадаг. Gerege App энэ гурвыг нэг дор хаана:

Асуулт	Хариу
Хэн нэвтэрч байна вэ?	eID танилт — QR / App2App / регистрийн дугаараар push
Дахин нэвтрэх үү?	Нэг л удаа — платформ өөрөө OIDC provider (SSO)
Ижил бичгийг дахин шаардах уу?	Үйлчилгээний регистр once-only зөрчлийг илрүүлнэ
Хүсэлт хаана явж байна вэ?	Хүсэлтийн timeline + relay-ийн SLA хяналт

Гол чадварууд¶

eID + Gerege SSO

Цорын ганц нэвтрэх арга нь eID. Нууц үг, и-мэйл OTP байхгүй. Мөн Gerege SSO-гийн relying party.
Өөрөө ч OIDC provider

OAUTH_ISSUER тохируулагдсан үед платформ өөрөө identity provider болно — өөрийн Go код, PKCE S256, RS256 id_token.
Төрийн үйлчилгээний портал

Каталог → хүсэлт → албан хаагчийн дараалал → шийдвэр → лавлагаа, төлбөр, цаг захиалга. ZGW-ийн явц/үр дүнгийн ялгаатай төлөвийн машин.
Үйлчилгээний нэгдсэн регистр

CPSV-AP паспорт, хувилбарын түүх, нотолгооны каталог, once-only зөрчлийн илрүүлэлт (Эстонийн зарчим).
Платформ хоорондын relay

Дээд платформоос ирсэн хугацаатай хүсэлтийг доод байгууллагууд руу чиглүүлж, SLA-г хянана. Webhook нь платформ бүрийн нууцаар гарын үсэглэнэ.
AI туслах (Gemini)

Чат, яриа→текст, текст→яриа, шууд орчуулга. pgvector семантик хайлттай мэдлэгийн сан; нэвтрэлтгүй зочны чат тусдаа тусгаарлагдсан.

Түүнчлэн: PAdES цахим гарын үсэг + sign relay, admin-аас удирдах API gateway, RBAC + супер админ (TOTP MFA), байгууллага ба гишүүнчлэл, eID PKI профайл, Google Drive · Dropbox · Google Meet холболт, өөрийн SFTP хадгалалт (Gerege Space), дөрвөн хэлний UI (mn · en · zh · ru).

Экосистем дэх байрлал¶

flowchart TD
    EID[eID Mongolia<br/>Давхарга 1] --> SSO[Gerege SSO<br/>Давхарга 2]
    SSO -->|OIDC RP| APP[Gerege App<br/>Давхарга 4]
    SSO -->|eID proxy · sign relay| APP
    CORE[(open-gerege-core<br/>Давхарга 3)] -.суурь модуль.-> APP

eID рүү шууд ханддаггүй. Зөвшөөрөгдсөн eID үйлчилгээ нь SSO-гийн eID proxy (/rp/eid, /rp/eid-org) болон sign relay (/rp/sign)-ээр дамжина.
Client secret нь SSO дээр. gerege-app-mn client нь sso.gerege.mn дээр бүртгэлтэй; secret нь тэнд зөвхөн hash хэлбэрээр амьдарна.
Суурь нь дундын. Backend нь open-gerege-core-ийн лавлах хэрэгжилт (main.go ~30 мөр) — өөрийн нэмэлт маршрутгүй. Аюулгүй байдлын нөхөөс нэг цэгээс тархана.

Технологи¶

Давхарга	Сонголт
Backend	Go 1.26 · chi (net/http) · pgx (ORM-гүй, гар бичмэл SQL)
Өгөгдөл	PostgreSQL 16 + pgvector · Redis 7
Frontend	Next.js 15 (BFF) · TanStack Query
AI	Gemini REST (SDK-гүй) — чат · STT · TTS · орчуулга
Ажиглалт	OpenTelemetry · Prometheus · Zap
Байршуулалт	Docker Compose + edge nginx, `geregeapp.mn`

Дэлгэрэнгүйг Технологийн стек-ээс.

Аюулгүй байдлын тулгуур¶

Postgres Row-Level Security — api нь superuser БИШ ролиор холбогдоно; boot дээр энэ нөхцөлийг guard шалгана. gov_* хүснэгтүүд дээр албан хаагчийн тусдаа policy бий.
BFF загвар — токен httpOnly cookie-д, браузерын JS-д хэзээ ч хүрэхгүй; давхар CSRF хамгаалалт (custom header + origin).
Fail-closed фичер — креденшл байхгүй бол чадвар унтарна, худал ажиллахгүй; boot guard зөрчил илрүүлбэл API асахаас татгалзана.
Hash-chain аудит — /api/v1/audit/verify нь гинжийн бүрэн бүтэн байдлыг шалгана.

Экосистемийн нийтлэг шаардлагыг Аюулгүй байдал-аас.

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

Хэрэгжүүлэлтийн түвшний бүрэн баримт — чадварын матриц, endpoint лавлах, байршуулалтын runbook — тусдаа сайтад:

Gerege App баримт →

Хуудас	Юуны тухай
Чадварын матриц	Модуль бүр, эрх, UI хуудас нэг харцаар
Төрийн үйлчилгээ	Хүсэлтийн бүтэн мөчлөг, албан хаагчийн дараалал
Үйлчилгээний регистр	CPSV-AP паспорт, once-only зөрчил
Апп холбох (OIDC RP)	Өөрийн апп-аа нэвтрүүлэх алхмууд
API лавлах	Бүх endpoint нэг хүснэгтэд
Байршуулалт	Compose, env, nginx, rollback