Native клиентүүд
Дөрвөн клиент, хоёр шугам, нэг бүтээгдэхүүн. Энэ хуудсан дахь зураг бүр
бодит апп-аас авагдсан — макет ч биш, зурсан ч биш. Кодыг нь
native-apps/
дотроос уншина.
01Аппын нэр нь шугамаа дагана
| Шугам | Хаяг | Аппын нэр | Клиент |
|---|---|---|---|
| desktop | desktop. | PetroNetDesktop | macOS, Windows |
| mobile | mobile. | PetroNetMobile | iOS/iPadOS, Android |
| kiosk | kiosk. | PetroNetKiosk | ЗАХИАЛГАТАЙ — клиент хараахан байхгүй |
| pos | pos. | PetroNetPos | ЗАХИАЛГАТАЙ — клиент хараахан байхгүй |
Нэр нь ПЛАТФОРМЫГ биш, ТӨХӨӨРӨМЖИЙН ШУГАМЫГ нэрлэдэг. Ширээн дээрх Mac ба
ширээн дээрх Windows хоёр нэг апп байгаа нь алдаа биш: хүн тэр хоёрын аль
дээр нь ч сандал дээр суугаад, гар талдаа байлгаж ажилладаг тул дэлгэцийн
нягтрал, товчны хэмжээ, юуг эхэнд тавих нь ижил. Бүрхүүл өөрийгөө юу гэж
хэлж байгаа нь тусдаа зүйл бөгөөд window. дээр хэвээр.
Иргэний харах нэр нь эдгээрийн аль нь ч биш — PetroNet.
02Нэвтрэлт — платформ бүрт өөр, session нь ижил
Ширээн дээр зөвшөөрөгч нь хөрш утас тул QR ба баталгаажуулах код гарна.
Гар утсан дээр зөвшөөрөгч нь өөрөө тэр утас — өөрийнхөө дэлгэц дээрх
QR-ыг скан хийж чадахгүй тул app-to-app үсэрнэ. Вэб (EIDLogin.tsx,
eidAppLink) eID-ийн өгсөн https холбоос руу очно:
{device_ (жишээ https://) —
апп суусан утсанд Universal/App Link аппыг нээнэ, үгүй бол store холбоостой
хуудас. eidmongolia:// схемийг RP дуудахгүй — тэр нь eID-ийн дотоод
fallback (developer.eidmongolia.mn/#native-app); eID холбоос өгөөгүй үед вэб
QR ба кодоо харуулсаар үлдэнэ.
iOS дээр холбоосыг ҮРГЭЛЖ системд өгнө (EIDDeviceLink):
open(url, options: [., бүтэхгүй бол энгийн
open(url). Бүрхүүлийн WKWebView вэб нэвтрэлтийн device link руу шилжихийг
барьж (MobilePlatformPage.) webview дотор ачаалахгүй —
Universal Link webview дотроос ажилладаггүй. Буцах хаяг
https:// (AASA); native дэлгэц түүнд нэг удаагийн
state залгаж, буцалт ирэхэд тулгана — URL-ийн sessionId-д итгэхгүй, үр
дүнг серверийн poll-оос авна. Татгалзах/хугацаа дуусахад callback ирэхгүй тул
апп нүүрэнд буцмагц poll дахин асууна (вэб: visibilitychange, native:
scenePhase).
Гурвуулан ижил POST / → GET / дээр суудаг: session нь
хэн зөвшөөрснөөс үл хамааран ижил тул app-to-app-д НЭГ Ч шинэ backend
endpoint нэмээгүй.
macOS — QR ба баталгаажуулах код
QR ба доорх таван орон нь амьд backend-ээс ирсэн бодит session — таймер 5 минут тоолж, дуусмагц код хүчингүй болно.
iOS ба Android — app-to-app
Зүүн талд iOS монголоор, баруун талд Android англиар: ижил дэлгэц, ижил
урсгал, зөвхөн төхөөрөмжийн хэл өөр. Долоон хэлний мөрийг
sync-i18n.sh
энэ репогийн frontend-ээс үүсгэдэг тул вэб ба апп нэг толь бичгээс уншина.
eID Mongolia апп суугаагүй бол «Өөр төхөөрөмж дээрээ зөвшөөрөх» зам үлдэнэ.
03Native хүрээ, вэб ажлын муж
Энэ бол архитектурын гол санаа: бүрхүүл нь нэвтрэлт, цэс, толгой хэсэг, төхөөрөмжийн хандалтыг өөртөө авдаг; вэб апп нь өөрийн chrome-оо нуугаад зөвхөн ажлын муж болж рендерлэгддэг. Хоёр тал Bridge гэрээ-гээр ярина.
Зүүн талын хар хажуу цэс, доод мөрийн PetroNet v1.
нь native. Баруун талын бүх зүйл — гарчиг, ШТС-уудын газрын зураг,
хэмжүүрүүд — нь petronet.mn-ий яг тэр хуудас.
Утсан дээр ч ижил дүрэм: доод талын таб мөр native, дээрх бүх зүйл вэб.
Шугам асаалттай үеийн бүтэн гинж
desktop.petronet.mn — клиент өөрийн шугам дээр, ямар ч override-гүйгээр.
/-ыг /line/desktop болгож, «Ажлын ширээ»-г үзүүлж байна.Хоёр зураг нь гинжийг бүтнээр нь харуулна: клиент өөрийн хаягаар очиж, nginx
түүнийг frontend рүү дамжуулж, proxy.ts нь Host-оос шугамыг таниад тухайн
шугамын нүүр рүү чиглүүлж байна. «Нэвтрээгүй байна» гэдэг нь алдаа биш —
бүрхүүлийн нэвтрэлт ба webview-ийн cookie тусдаа.
04Ажлын дэлгэц ба тохиргоо
Тохиргооны «Сервер» талбар нь тухайн клиентийн шугамыг харуулна —
https://. Тэр нэг мөр нь аппыг өөр байрлуулалт руу
чиглүүлэх цорын ганц зам бөгөөд түүнийг хамгийн сүүлд солино: DNS,
vhost, TLS, DEVICE_ дөрвүүлэн бэлэн болохоос өмнө чиглүүлбэл
апп байхгүй host руу очиж унана.
Хажуугийн цэсэн дэх «Токенууд», «Токен уншигч» хоёр нь ЗӨВХӨН ширээнийх:
PKCS#11 USB токен, ws://127.0.0.1 дээрх eSign гүүр хоёр гар утсан дээр
байхгүй.
05Харагдац
Дөрвүүлэнгийн өнгө нь вэбийн палитраас (brand/)
гаралтай — иргэн хөтөч дээрх PetroNet ба гар дээрх PetroNet хоёрыг нэг
бүтээгдэхүүн гэж уншина.
| Токен | Утга | Хаана |
|---|---|---|
pn-blue | #0064DF | Үндсэн үйлдэл, холбоос, идэвхтэй мөр |
pn-navy | #061827 | Ширээний хажуу цэс, гүн дэвсгэр |
pn-orange | #F5A800 | Сонгогдсон таб, анхааруулга |
pn-green | #0D9B68 | Баталгаажсан, «болсон» |
Ширээ ба утас хоёрын дизайны токен ТУСДАА байдаг: ширээнийх Windows аппын
Colors.xaml-тай хосолсон (тэр хоёр клиент нэг л зүйл харагдах ёстой),
утасныхыг тусад нь барьдаг. Гар дээрх өөрчлөлт ширээ рүү давалгаа явуулах
ёсгүй.
06Эдгээр зургийг хэрхэн авсан бэ
Дахин авах боломжтой байхын тулд бичив.
bash1# macOS2cd native-apps/desktop/macos && ./build.sh3API_BASE_URL=https://petronet.mn EID_DEBUG_TAB=platform \4 ~/Library/Developer/Xcode/DerivedData/PetroNetDesktop-*/Build/Products/Debug/PetroNetDesktop.app/Contents/MacOS/PetroNetDesktop5 6# iOS7cd native-apps/mobile/ios && ./build.sh8xcrun simctl install booted <…>/PetroNetMobile.app9SIMCTL_CHILD_API_BASE_URL=https://petronet.mn SIMCTL_CHILD_EID_DEBUG_TAB=platform \10 xcrun simctl launch --terminate-running-process booted mn.petronet.mobile11xcrun simctl io booted screenshot ios-platform.png12 13# Android14cd native-apps/mobile/android && ./gradlew assembleDebug15adb install -r app/build/outputs/apk/debug/app-debug.apk16adb exec-out screencap -p > android-login.pngEID_DEBUG_TAB нь зөвхөн DEBUG build-д ажилладаг: нэвтрэлт нь иргэний
утсанд push илгээдэг тул дэлгэцийн алдааг хөөж байгаа хүн бүр жинхэнэ
eID-ээр нэвтрэх шаардлагатай болдог байв. Release build-д энэ код БАЙХГҮЙ,
тиймээс нэвтрэлтийг тойрох зам ч байхгүй.
API_BASE_URL нь клиентийг өөр байрлуулалт руу заана. Энэ хуудсан дахь
зургууд авагдах үед төхөөрөмжийн шугамууд хараахан асаагүй байсан тул
petronet.mn гэж зааж байв. 2026-09-05-нд дөрвүүлэн асав — одоо клиент
API_BASE_URL-гүйгээр, өөрийн анхдагч хаягаараа шууд ажиллана
(Байрлуулалт § Төхөөрөмжийн шугамууд).
Хувь хүний мэдээллийг далдалсан. Зурган дээрх бүдгэрсэн хэсгүүд нь нэвтэрсэн хүний нэр. «Миний ID» дэлгэц нь регистрийн болон иргэний бүртгэлийн дугаарыг харуулдаг тул энэ хуудсанд ОГТ оруулаагүй — бусад бүх тоо, огноо, хаяг бодит хэвээр.