PetroNet SystemБаримт бичиг
Клиент

Native клиентүүд

5 мин уншихdocs/NATIVE-APPS.mdGitHub дээр засах

Дөрвөн клиент, хоёр шугам, нэг бүтээгдэхүүн. Энэ хуудсан дахь зураг бүр бодит апп-аас авагдсан — макет ч биш, зурсан ч биш. Кодыг нь native-apps/ дотроос уншина.


01Аппын нэр нь шугамаа дагана

ШугамХаягАппын нэрКлиент
desktopdesktop.petronet.mnPetroNetDesktopmacOS, Windows
mobilemobile.petronet.mnPetroNetMobileiOS/iPadOS, Android
kioskkiosk.petronet.mnPetroNetKioskЗАХИАЛГАТАЙ — клиент хараахан байхгүй
pospos.petronet.mnPetroNetPosЗАХИАЛГАТАЙ — клиент хараахан байхгүй

Нэр нь ПЛАТФОРМЫГ биш, ТӨХӨӨРӨМЖИЙН ШУГАМЫГ нэрлэдэг. Ширээн дээрх Mac ба ширээн дээрх Windows хоёр нэг апп байгаа нь алдаа биш: хүн тэр хоёрын аль дээр нь ч сандал дээр суугаад, гар талдаа байлгаж ажилладаг тул дэлгэцийн нягтрал, товчны хэмжээ, юуг эхэнд тавих нь ижил. Бүрхүүл өөрийгөө юу гэж хэлж байгаа нь тусдаа зүйл бөгөөд window.GeregeShell.platform дээр хэвээр.

Иргэний харах нэр нь эдгээрийн аль нь ч биш — PetroNet.


02Нэвтрэлт — платформ бүрт өөр, session нь ижил

Ширээн дээр зөвшөөрөгч нь хөрш утас тул QR ба баталгаажуулах код гарна. Гар утсан дээр зөвшөөрөгч нь өөрөө тэр утас — өөрийнхөө дэлгэц дээрх QR-ыг скан хийж чадахгүй тул app-to-app үсэрнэ. Вэб (EIDLogin.tsx, eidAppLink) eID-ийн өгсөн https холбоос руу очно: {device_link_base}?sessionId=…&vc=… (жишээ https://ca.eidmongolia.mn/dl?…) — апп суусан утсанд Universal/App Link аппыг нээнэ, үгүй бол store холбоостой хуудас. eidmongolia:// схемийг RP дуудахгүй — тэр нь eID-ийн дотоод fallback (developer.eidmongolia.mn/#native-app); eID холбоос өгөөгүй үед вэб QR ба кодоо харуулсаар үлдэнэ.

iOS дээр холбоосыг ҮРГЭЛЖ системд өгнө (EIDDeviceLink): open(url, options: [.universalLinksOnly: true]), бүтэхгүй бол энгийн open(url). Бүрхүүлийн WKWebView вэб нэвтрэлтийн device link руу шилжихийг барьж (MobilePlatformPage.decidePolicyFor) webview дотор ачаалахгүй — Universal Link webview дотроос ажилладаггүй. Буцах хаяг https://petronet.mn/auth/eid/callback (AASA); native дэлгэц түүнд нэг удаагийн state залгаж, буцалт ирэхэд тулгана — URL-ийн sessionId-д итгэхгүй, үр дүнг серверийн poll-оос авна. Татгалзах/хугацаа дуусахад callback ирэхгүй тул апп нүүрэнд буцмагц poll дахин асууна (вэб: visibilitychange, native: scenePhase).

Гурвуулан ижил POST /api/start → GET /api/status дээр суудаг: session нь хэн зөвшөөрснөөс үл хамааран ижил тул app-to-app-д НЭГ Ч шинэ backend endpoint нэмээгүй.

macOS — QR ба баталгаажуулах код

macOS нэвтрэх дэлгэц: QR код ба баталгаажуулах код
macOS — QR ба таван оронтой баталгаажуулах код. Хажууд нь 5 минутын таймер.

QR ба доорх таван орон нь амьд backend-ээс ирсэн бодит session — таймер 5 минут тоолж, дуусмагц код хүчингүй болно.

iOS ба Android — app-to-app

iOS нэвтрэх дэлгэц монголоор
iOS · монголоор
Android нэвтрэх дэлгэц англиар
Android · англиар

Зүүн талд iOS монголоор, баруун талд Android англиар: ижил дэлгэц, ижил урсгал, зөвхөн төхөөрөмжийн хэл өөр. Долоон хэлний мөрийг sync-i18n.sh энэ репогийн frontend-ээс үүсгэдэг тул вэб ба апп нэг толь бичгээс уншина.

eID Mongolia апп суугаагүй бол «Өөр төхөөрөмж дээрээ зөвшөөрөх» зам үлдэнэ.


03Native хүрээ, вэб ажлын муж

Энэ бол архитектурын гол санаа: бүрхүүл нь нэвтрэлт, цэс, толгой хэсэг, төхөөрөмжийн хандалтыг өөртөө авдаг; вэб апп нь өөрийн chrome-оо нуугаад зөвхөн ажлын муж болж рендерлэгддэг. Хоёр тал Bridge гэрээ-гээр ярина.

macOS бүрхүүл дотор petronet.mn-ий ажлын муж
macOS — зүүн талын хажуу цэс native, баруун талын бүх зүйл petronet.mn.

Зүүн талын хар хажуу цэс, доод мөрийн PetroNet v1.0.9 (10) · petronet.mn нь native. Баруун талын бүх зүйл — гарчиг, ШТС-уудын газрын зураг, хэмжүүрүүд — нь petronet.mn-ий яг тэр хуудас.

iOS дээрх ажлын муж, доор нь native таб мөр
iOS — доод талын таб мөр native, дээрх бүх зүйл вэб.

Утсан дээр ч ижил дүрэм: доод талын таб мөр native, дээрх бүх зүйл вэб.

Шугам асаалттай үеийн бүтэн гинж

macOS клиент desktop.petronet.mn дээр, доод мөрөнд шугамын хаяг
Доод зүүн буланд desktop.petronet.mn — клиент өөрийн шугам дээр, ямар ч override-гүйгээр.
Ажлын мужид desktop шугамын нүүр дэлгэц
Тэр шугамын webview нь /-ыг /line/desktop болгож, «Ажлын ширээ»-г үзүүлж байна.

Хоёр зураг нь гинжийг бүтнээр нь харуулна: клиент өөрийн хаягаар очиж, nginx түүнийг frontend рүү дамжуулж, proxy.ts нь Host-оос шугамыг таниад тухайн шугамын нүүр рүү чиглүүлж байна. «Нэвтрээгүй байна» гэдэг нь алдаа биш — бүрхүүлийн нэвтрэлт ба webview-ийн cookie тусдаа.


04Ажлын дэлгэц ба тохиргоо

iOS хяналтын самбар
Хяналтын самбар — session байхгүй тул тоонууд тэг.
iOS тохиргоо: долоон хэл ба серверийн хаяг
Тохиргоо — долоон хэл, шугамын хаяг.

Тохиргооны «Сервер» талбар нь тухайн клиентийн шугамыг харуулна — https://mobile.petronet.mn. Тэр нэг мөр нь аппыг өөр байрлуулалт руу чиглүүлэх цорын ганц зам бөгөөд түүнийг хамгийн сүүлд солино: DNS, vhost, TLS, DEVICE_LINE_ORIGINS дөрвүүлэн бэлэн болохоос өмнө чиглүүлбэл апп байхгүй host руу очиж унана.

macOS хяналтын самбар
macOS хяналтын самбар. Нэвтэрсэн хүний нэрийг далдалсан.

Хажуугийн цэсэн дэх «Токенууд», «Токен уншигч» хоёр нь ЗӨВХӨН ширээнийх: PKCS#11 USB токен, ws://127.0.0.1 дээрх eSign гүүр хоёр гар утсан дээр байхгүй.


05Харагдац

Дөрвүүлэнгийн өнгө нь вэбийн палитраас (brand/frontend/src/app/petronet.css) гаралтай — иргэн хөтөч дээрх PetroNet ба гар дээрх PetroNet хоёрыг нэг бүтээгдэхүүн гэж уншина.

ТокенУтгаХаана
pn-blue#0064DFҮндсэн үйлдэл, холбоос, идэвхтэй мөр
pn-navy#061827Ширээний хажуу цэс, гүн дэвсгэр
pn-orange#F5A800Сонгогдсон таб, анхааруулга
pn-green#0D9B68Баталгаажсан, «болсон»

Ширээ ба утас хоёрын дизайны токен ТУСДАА байдаг: ширээнийх Windows аппын Colors.xaml-тай хосолсон (тэр хоёр клиент нэг л зүйл харагдах ёстой), утасныхыг тусад нь барьдаг. Гар дээрх өөрчлөлт ширээ рүү давалгаа явуулах ёсгүй.


06Эдгээр зургийг хэрхэн авсан бэ

Дахин авах боломжтой байхын тулд бичив.

bash
# macOScd native-apps/desktop/macos && ./build.shAPI_BASE_URL=https://petronet.mn EID_DEBUG_TAB=platform \  ~/Library/Developer/Xcode/DerivedData/PetroNetDesktop-*/Build/Products/Debug/PetroNetDesktop.app/Contents/MacOS/PetroNetDesktop # iOScd native-apps/mobile/ios && ./build.shxcrun simctl install booted <…>/PetroNetMobile.appSIMCTL_CHILD_API_BASE_URL=https://petronet.mn SIMCTL_CHILD_EID_DEBUG_TAB=platform \  xcrun simctl launch --terminate-running-process booted mn.petronet.mobilexcrun simctl io booted screenshot ios-platform.png # Androidcd native-apps/mobile/android && ./gradlew assembleDebugadb install -r app/build/outputs/apk/debug/app-debug.apkadb exec-out screencap -p > android-login.png

EID_DEBUG_TAB нь зөвхөн DEBUG build-д ажилладаг: нэвтрэлт нь иргэний утсанд push илгээдэг тул дэлгэцийн алдааг хөөж байгаа хүн бүр жинхэнэ eID-ээр нэвтрэх шаардлагатай болдог байв. Release build-д энэ код БАЙХГҮЙ, тиймээс нэвтрэлтийг тойрох зам ч байхгүй.

API_BASE_URL нь клиентийг өөр байрлуулалт руу заана. Энэ хуудсан дахь зургууд авагдах үед төхөөрөмжийн шугамууд хараахан асаагүй байсан тул petronet.mn гэж зааж байв. 2026-09-05-нд дөрвүүлэн асав — одоо клиент API_BASE_URL-гүйгээр, өөрийн анхдагч хаягаараа шууд ажиллана (Байрлуулалт § Төхөөрөмжийн шугамууд).

Хувь хүний мэдээллийг далдалсан. Зурган дээрх бүдгэрсэн хэсгүүд нь нэвтэрсэн хүний нэр. «Миний ID» дэлгэц нь регистрийн болон иргэний бүртгэлийн дугаарыг харуулдаг тул энэ хуудсанд ОГТ оруулаагүй — бусад бүх тоо, огноо, хаяг бодит хэвээр.

Энэ хуудас тус болсон уу?Таны хариу баримтыг сайжруулахад тусална.
    DEV · Хөгжүүлэлтийн орчин