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

Bridge гэрээ

15 мин уншихdocs/SHELL_CONTRACT.mdGitHub дээр засах

Native бүрхүүл (Swift, C#, Kotlin) ба web app хоёрын хооронд байх window.GeregeShell гэрээний бүртгэл.

Баримт бичгийн төв рүү буцах


011. Зорилго

Платформ хоёр хэлбэрээр ажиллана:

  • Хөтчийн горим — web app өөрөө бүрэн апп: толгой хэсэг, хажуугийн цэс, мобайл таб, нэвтрэлт бүгд түүнийх.
  • Бүрхүүлийн горим — native бүрхүүл нь session-ий амьдралын мөчлөг (сэргээх, дахин нэвтрүүлэх, гарах), толгой хэсэг, цэс, хөл, төхөөрөмжийн хандалтыг эзэмшинэ. Web app өөрийн chrome-оо нуугаад зөвхөн ажлын муж болж рендерлэгдэнэ. Нэвтрэлтийн дэлгэц нь платформын native UI; web-ийн /login зөвхөн browser/PWA горимд үлдэнэ.

Гэрээ нь энэ хоёрын хилийг тодорхойлно. Хамгийн чухал шаардлага: хөтчийн горим ямар ч нөхцөлд өөрчлөгдөхгүй. Бүрхүүл байхгүй үед window.GeregeShell тодорхойлогдоогүй байна; web талын бүх helper null эсвэл false буцаана; data-shell атрибут <html> дээр огт тавигдахгүй.

Web талын хэрэгжилт: цөмийн frontend-ийн src/shell/shell.ts. Бүрхүүлийн талын хэрэгжилтүүд: native-apps/.


021a. Нэг хүрээний дүрэм

Native клиент бүр цорын ганц хүрээтэй: macOS/Windows дээр нэг цонх, iOS/ Android дээр нэг scene. Нэвтрэлт, ажлын муж, тохиргоо, профайл — бүгд тэр хүрээн дотор солигддог дэлгэцүүд болохоос тусдаа цонх биш.

Хүрээнээс гарч болох цорын ганц зүйл бол popup: богино насалдаг, эцэг цонхондоо холбогддог, өөрөө навигаци агуулдаггүй элемент.

Зөвшөөрөгдөнө (popup)Зөвшөөрөгдөхгүй
NSAlert, NSMenu, NSSavePanelХоёр дахь NSWindow
MessageBox, файл сонгох диалогWindow.ShowDialog(), Window.Show()
alert, confirmationDialog, share sheetХоёр дахь WindowGroup/scene
BiometricPrompt, зөвшөөрлийн диалогХоёр дахь Activity

Мөн ажлын мужаас window.open / target="_blank" хийсэн шилжилт нь webview-ийн шинэ цонх нээхийг хүсдэг. Бүрхүүл тэр цонхыг үүсгэхгүй — хаяг нь зөвшөөрөгдсөн scheme-тэй бол системийн хөтчөөр нээгдэнэ.

Дүрмийн шалтгаан нь загварын амт биш. Тусдаа цонх нь хэрэглэгчийг нэг аппын хоёр хүрээ хооронд үсрүүлж, taskbar/Dock дээр хоёр дахь бичлэг үлдээж, kiosk болон бүтэн дэлгэцийн горимд бүр огт олдохгүй болдог.

Дэлгэц солигдоход ажлын мужийг устгахгүй. Native дэлгэц гарахад webview-г харагдацаас нуух нь зөв; view модоос хасах нь буруу. Хасвал webview дахин үүсч, хэрэглэгчийн байсан хуудас, гүйлгэсэн байрлал, бөглөж байсан маягт бүгд алга болно.


031b. Төхөөрөмжийн domain шугам

Backend цор ганц. Гэхдээ клиент бүр өөрийн host-оор ханддаг:

ШугамХэн ашиглахТөлөв
petronet.mnХөтөч / PWA — web app өөрөө бүрэн апп✅ ажиллаж байна
desktop.petronet.mnmacOS, Windows — PetroNetDesktop✅ ажиллаж байна
mobile.petronet.mniOS/iPadOS, Android — PetroNetMobile✅ ажиллаж байна
kiosk.petronet.mnKiosk (Windows, Android)✅ шугам асаалттай, клиент байхгүй
pos.petronet.mnPOS (Windows, Android)✅ шугам асаалттай, клиент байхгүй

Хаяг нь FORM FACTOR-ыг нэрлэнэ, платформыг биш. Ширээн дээрх Mac ба ширээн дээрх Windows хоёр НЭГ шугам: хүн тэр хоёртой ижил байдлаар — сандал дээр суугаад, гар талдаа байлгаж — харьцдаг тул дэлгэцийн нягтрал, товчны хэмжээ, юуг эхэнд тавих нь ижил. Бүрхүүл өөрийгөө юу гэж хэлж байгаа нь ТУСДАА зүйл бөгөөд window.GeregeShell.platform дээр хэвээр байна — шаардлагатай бол нэг шугамын дэлгэц дотроос платформоор салаалж болно.

kiosk ба pos нь desktop/mobile дотор ОРООГҮЙ: нэг Windows машин дээр ажлын ширээний клиент ба киоск зэрэг ажиллаж болох тул тэдэнд host-only cookie-гийн тусгаарлалт хэрэгтэй хэвээр.

DNS дээр *.petronet.mn wildcard байгаа тул нэр өөрөө edge (core-nginx-01) руу хүрнэ. Гэхдээ шугам бүр өөрийн vhost-той (stack/edge/<шугам>.petronet.mn.conf — erdenebatt/proxmox-gerege-net), wildcard server_name биш: тэр edge дээр өөр бүтээгдэхүүний домэйнууд сууж байгаа бөгөөд wildcard нь ирээдүйн өөр дэд домэйныг чимээгүй залгих байсан.

ШИНЭ шугам нэмэхдээ клиентийг урьдчилж чиглүүлж БОЛОХГҮЙ.

DNS, edge-ийн vhost ба TLS бэлэн болохоос өмнө клиентийг зааж өгвөл апп A server with the specified hostname could not be found гэж унаж, нэвтрэх боломжгүй болно — энэ нь нэг удаа тохиолдсон. Дараалал ба тухайн платформын яг аль мөрийг солихыг native-apps/shared/device_lines.json-ы $provisioning заана.

Шугам бүр өөрийн host дээрээ /api/v1-ээ мөн үйлчилнэ; edge тэдгээрийг бүгдийг НЭГ ижил API upstream (core-app-02:8220) руу дамжуулна. Шугам нь тусдаа origin өгөхийн тулд байгаа болохоос тусдаа сервис өгөхийн тулд биш.

Тэр upstream нь DS стек (ds.petronet.mn, loopback 3012/8096) — petronet.mn-ийнх БИШ. Шалтгаан нь зохион байгуулалтынх: native клиентүүд энэ repository-д амьдардаг, энэ repository нь DS стек рүү deploy хийдэг, тиймээс клиентүүдийн ажлын муж тэндээс баригдана. Шугамыг нөгөө стек рүү заавал өөр модноос баригдсан frontend үйлчилнэ — тэр модонд бүрхүүлийн гэрээ огт байхгүй бөгөөд яг ингэж native клиент өөрийн хүрээн дотор web-ийн нэвтрэх дэлгэцийг зурдаг.

Энэ нь тав тухын шийдэл биш: ажлын мужаас гарах дуудлага same-origin болж, session cookie нь SameSite=Strict хэвээр ажиллаж, CORS preflight огт үүсэхгүй. Хэрэв клиентийг хуваалцсан host руу чиглүүлбэл cookie-гаар баталгаажсан бичих үйлдэл бүр cross-site болно.

Шугам бүр тусдаа host учраас cookie нь host-only: mac дээрх session нь pos руу урсахгүй. Энэ бол тусгаарлалт, регресс биш.

API-гийн хаяг нь шугам дээр ҮРГЭЛЖ харьцангуй байх ёстой. NEXT_PUBLIC_API_URL нь build үед шингэдэг ба production-д https://petronet.mn/api/v1 гэж бичигддэг. Тэр утгыг төхөөрөмжийн шугам дээр ашиглавал дуудлага cross-origin болж, host-only session cookie ОГТ илгээгдэхгүй — API 401 буцааж, ажлын муж нэвтрэлт дууссан гэж үзээд web-ийн /login руу түлхэнэ. Native талд амжилттай нэвтэрсэн хэрнээ ажлын мужид нэвтрэх дэлгэц гарч ирэх хэлбэрээр илэрдэг. Тиймээс шугам дээр бүх fetch нь өөрийн host-ын /api/v1 руу, хөтөч дээр build-ийн утга руу.

Шугамын нүүр дэлгэц

Шугам бүрийн үндэс (/) нь тухайн платформын өөрийн нүүр дэлгэц рүү шилжинэ: цөмийн frontend-ийн src/app/(lines)/edge/[line]/. Native клиент нэвтэрсний дараа /-ыг нээх ба тэндээс тухайн төхөөрөмжийн web дэлгэцүүд хөгжинө.

Нүүр дэлгэц нэвтрэлт шаардахгүй. Тэр нь ажлын мужид web-ийн нэвтрэх дэлгэц гарч ирэхийг орлохын тулд байгаа тул session байхгүй үед ч зогсоно — эс бөгөөс шийдэх гэсэн асуудлаа өөрөө үүсгэнэ.

Дэлгэцүүд нь өнгө, гарчгаараа биш байрлалаараа ялгаатай: ширээ (desk), гарын алга (hand), олон нийтийн терминал (public) гурав нь товчны хэмжээ, нягтрал, юуг эхэнд тавихыг шийднэ.

Бүртгэлүүд — шугам нэмэхэд гурвуулыг нь өөрчилнө:

  • native-apps/shared/device_lines.json — native талын эх сурвалж
  • цөмийн frontend-ийн src/shell/device-line.ts — web талын хуулбар
  • edge-ийн vhost (stack/edge/<шугам>.petronet.mn.conf) — deploy тал

Web тал шугамыг Host-оор нь таньж (цөмийн src/proxy.ts) Vary: Host тавьж, /login-ыг хаана: төхөөрөмжийн шугам дээр нэвтрэлт бол native UI.


042. Инжекцийн дүрэм

ДүрэмУтга
ХугацааDocument start — hydration эхлэхээс өмнө объект байрандаа байна.
Хамрах хүрээMain frame only. Дэд frame (iframe) руу скрипт inject хийхгүй.
ДавхардалОбъект аль хэдийн байвал скрипт юу ч хийхгүй буцна.
Хувиршгүй байдалwindow.GeregeShell нь Object.freeze хийгдсэн.

Document start дээр inject хийх шаардлага нь зөвхөн тохь тухын асуудал биш: ThemeProvider анхны рендер дээрээ data-shell-ийг тавьдаг тул объект хожуу ирвэл хэрэглэгч эхлээд web-ийн харагдацыг хараад дараа нь native рүү үсэрнэ.


053. Объектын бүтэц

ts
interface GeregeShell {  version: string;       // гэрээний semver, одоо "1.4"  platform: "macos" | "windows" | "ios" | "android" | "kiosk" | "pos";  formFactor: "desktop" | "mobile" | "tablet" | "kiosk" | "pos";  capabilities: string[];  invoke<T>(method: string, params?: Record<string, unknown>): Promise<T>;  on(event: string, handler: (payload: unknown) => void): () => void;}
  • version — гэрээний хувилбар, бүрхүүл програмын хувилбар БИШ.
  • platform — <html data-shell="..."> атрибутын утга болно.
  • capabilities — тухайн бүрхүүлд үнэхээр хэрэгжсэн чадварууд. Энд байхгүй боломжийг зарлах нь web талын fallback-ыг ажиллах боломжгүй болгоно.
  • on() — буцаах утга нь бүртгэлээ цуцлах функц (useEffect-ийн cleanup).

064. Capability нэрс

НэрУтга
biometricTouch ID / Windows Hello / төхөөрөмжийн эзэн танилт.
notifyСистемийн мэдэгдэл.
badgeАпп дүрсэн дээрх тоолуур.
external.openСистемийн хөтчөөр гадаад хаяг нээх.
print.systemСистемийн хэвлэх харилцах цонх.
fs.saveФайлыг хэрэглэгчийн сонгосон газарт хадгалах (fs.saveAs method).
secure-storeKeychain / Credential Manager маягийн нууц хадгалалт.
menu.nativeNative цэсийг тенантын цэснээс динамикаар барих.
shell.paneБүрхүүлийн эзэмшдэг дэлгэц рүү хүрээн дотор шилжих (shell.openPane).

Capability нэр ба method нэр нь тусдаа: capability нь боломж, method нь дуудлага. Жишээ нь fs.save чадвар нь fs.saveAs method-оор хэрэгжинэ.


075. Method-ууд

Бүх дуудлага invoke(method, params) хэлбэртэй ба Promise буцаана. Дэмжигдээгүй method-ыг бүрхүүл reject хийх ёстой — тэр үед web тал өөрийн fallback-аа ажиллуулна.

auth.reLogin

Session дуусахад нэвтрэлтийн урсгалыг эхлүүлнэ.

ПараметрБайхгүй
Хариуnull — бүрхүүл нэвтрэлтийг барьж авсан, web тал өгөгдлөө дахин татна
АлдааБүрхүүл нэвтрэлтийг эзэмшдэггүй бол reject; web тал /login руу шилжинэ

Web тал үүнийг нэг session-д нэг л удаа оролдоно: дахин нэвтэрсэн ч session хүчингүй хэвээр байвал мөчлөг үүсэхээс сэргийлнэ.

auth.lock

Native biometric/PIN түгжээг гаргана. Unlock дуусах хүртэл resolve хийхгүй, цуцалбал reject хийнэ. auth.reLogin, auth.lock нь lifecycle method учраас capability шаардахгүй.

notify.show

Параметр{ title: string, body?: string }
Хариуnull
АлдааМэдэгдлийн зөвшөөрөл олгогдоогүй бол reject

badge.set

Параметр{ count: number } — 0 бол тоолуурыг арилгана
Хариуnull

biometric.authenticate

Параметр{ reason?: string } — хэрэглэгчид харагдах шалтгаан
Хариу{ authenticated: true }
АлдааЦуцлагдсан, амжилтгүй, эсвэл боломжгүй үед системийн алдааны текстээр reject

external.open

Параметр{ url: string }
Хариуnull
АлдааЗөвхөн http, https, mailto, tel scheme зөвшөөрөгдөнө; бусад нь reject

print.system

ПараметрБайхгүй
Хариуnull — харилцах цонх хаагдсаны дараа
АлдааХэвлэх цонх нээх боломжгүй бол reject

fs.saveAs

Параметр{ filename?: string, base64?: string, text?: string }
Хариу{ path: string }
АлдааАгуулга дутуу/буруу, хэрэглэгч цуцалсан, бичиж чадаагүй үед reject

Замыг web тал заахгүй — зөвхөн санал болгох файлын нэр дамжуулна. Бүрхүүл хэрэглэгчийн сонгосон газарт л бичнэ, дамжуулсан нэрнээс зөвхөн сүүлийн бүрэлдэхүүнийг авна.

Тенантын апп цэс өөрчлөгдсөнийг мэдэгдэнэ; бүрхүүл native цэсээ дахин барих боломжтой болно.

Параметр{}
Хариуnull

shell.openPane

Бүрхүүлийн эзэмшдэг дэлгэц рүү шилжинэ. Capability: shell.pane.

Параметр{ pane: "work" | "settings" }
Хариуnull
АлдааТанихгүй нэр, эсвэл хэрэглэгч хараахан нэвтрээгүй бол reject

Энэ нь цонх нээх дуудлага биш — ижил хүрээн доторх дэлгэц солигдоно (§1a). Ажлын муж "Төхөөрөмжийн тохиргоо" гэсэн холбоос гаргах бол native тохиргоог өөрөө зурахын оронд үүнийг дуудна. Reject ирвэл web тал өөрийн тохиргооны хуудсаа үзүүлнэ.

Device method-ууд (v1.1–v1.3)

MethodCapabilityПараметрХариу
escpos.printescpos{ text?: string, base64?: string, cut?: boolean }null
escpos.drawerescpos{ pulse_ms?: number }null
scanner.start / scanner.stopscanner{ mode?: string } / {}null; уншилт shell:scan event-ээр ирнэ
serial.transactserial{ port?: string, baud?: number, base64: string, read_timeout_ms?: number }{ base64: string }
device.identitydevice.identity{}Нууц token-гүй device identity
camera.scancamera.scan{ formats?: string[] }{ value: string, format: string }
kiosk.lockdownkiosk.lockdown{ enabled: boolean }{ enabled: boolean }
telemetry.emittelemetry{ level: string, event: string, payload?: object }null
payments.startpayments{ amount: number, currency: string, reference: string }Vendor-neutral төлбөрийн үр дүн

payments.start нь vendor SDK суусан adapter байхгүй үед reject хийнэ. Web тал тэр үед өөр төлбөрийн арга руу fallback хийнэ. Device token, secure-store key, printer raw credential зэрэг нь ямар ч method-ын хариунд орж болохгүй.


086. Event-ууд

Event нь бүрхүүлээс ажлын муж руу чиглэнэ. on(name, handler) нь handler-т payload-ыг шууд дамжуулна.

EventPayloadУтга
shell:navigate{ path: string }SPA router-ээр шилжинэ. Зөвхөн /-ээр эхэлсэн дотоод зам хүлээн авна.
shell:search{ query: string }Ажлын мужийн хайлтыг нээж, үгийг нь дамжуулна.
shell:menu-refreshБайхгүй (null)Цэсээ сервертэй дахин тааруулахыг хүснэ.
shell:auth-changed{ reason: string, user_id?: string }Session/ажилтан солигдсон; tenant data-г дахин татна.
shell:capabilities-changed{ capabilities: string[] }Peripheral/settings өөрчлөгдсөн; web fallback-аа дахин тооцно.
shell:scan{ value: string, format: string }Keyboard wedge, camera эсвэл vendor scanner уншилт.

097. Хувилбарын дүрэм

Гэрээ semver-ээр явна. GeregeShell.version нь гэрээний хувилбар.

  • Minor (1.0 → 1.1) — шинэ method, шинэ event, шинэ capability, эсвэл сонголтот параметр нэмэх. Хуучин web бүрхүүлийн шинэ хувилбартай ажиллана.
  • Major (1.x → 2.0) — байгаа method-ын нэр, параметр, хариу, эсвэл event-ийн payload өөрчлөх, юм хасах. Бүрхүүл шинэ version-оо ЗААВАЛ зарлана.
  • v1.4 нь minor: shell.openPane method ба shell.pane capability нэмэгдсэн, байгаа юу ч өөрчлөгдөөгүй. v1.3 бүрхүүл дээр v1.4 web ажиллана — shell.openPane нь reject хийж, web тал өөрийн тохиргооны хуудас руу шилжинэ.
  • Device method нэмэхдээ түүнд харгалзах capability-г мөн зарлана. auth.* lifecycle method-ууд capability шаардахгүй.
  • Web тал үл мэдэгдэх method-ыг дуудаж болно — reject ирнэ гэдгийг тооцсон fallback-тай байх ёстой. Энэ нь хуучин бүрхүүл дээр шинэ web ажиллах гол механизм.

108. Аюулгүй байдлын шаардлага

Бүрхүүл хэрэгжүүлэх бүрд дараах зүйлс заавал биелэх ёстой.

  1. Origin шалгалт. Гүүрээр ирсэн мессежийг боловсруулахын өмнө илгээгч frame-ийн одоогийн хаягийн origin нь платформын web origin-той тохирч байгааг шалгана. Тохирохгүй бол мессежийг үл тоомсорлоно.
  2. Main frame only. Скриптийг зөвхөн гол frame-д inject хийж, мессеж хүлээн авахдаа isMainFrame-ийг дахин шалгана. iframe нь биометр, файл, мэдэгдэлд хүрэхгүй.
  3. JSON serialize. Native талаас JS руу орох бүх утга JSON-оор кодлогдоно. Алдааны текст, callback ID, хайлтын үг зэргийг JS эх бичвэрт мөр залгаж оруулахыг хориглоно — ямар ч эх сурвалжаас ирсэн текст код болж ажиллах боломжгүй байх ёстой.
  4. Хариуг нэг цэгээр. Native хариу зөвхөн __geregeShellResolve(id, json) гэсэн нэг entry point-оор буцна. Дуудлага бүрд шинэ дэлхийн функц үүсгэдэггүй.
  5. Navigation allowlist. Гол frame-ийн шилжилт зөвхөн зөвшөөрөгдсөн origin дотор явна: платформын web origin, API origin, түүнчлэн тодорхой нэрлэгдсэн танилтын origin-ууд. Бусад бүх хаяг webview дотор биш, системийн хөтчөөр нээгдэнэ.
  6. Scheme хязгаарлалт. external.open нь зөвхөн http, https, mailto, tel-ийг хүлээн авна. file:// болон бүртгэгдсэн дурын scheme нь webview-гээс код ажиллуулах гарц болно.
  7. Файлын зам. Хадгалах байршлыг web тал сонгохгүй; зөвхөн хэрэглэгчийн сонгосон газар руу бичнэ.

119. Бүрхүүлийн одоогийн байдал

Хэрэгжилтүүд нь native-apps/ доторх Swift/AppKit ба C#/.NET сууриас эхэлнэ; Kotlin/Android суурь мөн энд нэмэгдэнэ. Linux нь PWA.

ЗүйлУтга
version1.4
platformmacos, windows, ios, android, kiosk, pos
capabilitiesnotify, badge, external.open, print.system, fs.save, shell.pane
Хэрэгжсэн methodnotify.show, badge.set, external.open, print.system, fs.saveAs, menu.changed, auth.reLogin, shell.openPane
ХүрээДөрвөн платформ дээр цорын ганц цонх/scene; тохиргоо нь хүрээн доторх дэлгэц (§1a)
Reject хийдэгbiometric.authenticate — desktop дээр хэрэгжилт алга; web тал өөрийн fallback-аа ажиллуулна
Илгээдэг eventshell:navigate (deep link, цэс, tray), shell:search (⌘/Ctrl+F)

menu.native зарлагдаагүй: навигацийн цэсийг ажлын муж өөрөө зурдаг тул бүрхүүл тенантын цэсийг native байдлаар барихаа больсон. Тиймээс shell:menu-refresh мөн илгээгддэггүй — menu.changed дуудлагыг хүлээж авч, хариу нь амжилттай гэдгийг л баталгаажуулна.

secure-store капабилити зарлагдаагүй: гэрээний v1-д түүнийг ашиглах method тодорхойлогдоогүй тул зарлах нь дуудагдах боломжгүй амлалт болно. Хэрэглэх шаардлагатай болбол гэрээнд method нэмж, хувилбарыг minor болгож өсгөнө.

Гол frame-д анхдагчаар зөвшөөрөгдөх origin-ууд: Web ба API хаяг (dev горимд Тохиргооны цонхноос, production-д compile-time тогтмол), мөн eID-ийн танилтын origin-ууд. Байгууллага өөрийн интеграцийн OAuth зөвшөөрлийн дэлгэцийг (Google, Dropbox гэх мэт) апп дотор үлдээхийг хүсвэл тэдгээрийн origin-ыг нэмнэ. Нэмээгүй бол урсгал таслагдахгүй — зөвхөн системийн хөтөч дээр үргэлжилнэ.

Анхаар.

Swift-ийн WKNavigationDelegate, WebView2-ийн NavigationStarting, Android-ийн WebViewClient гурвуул main-frame origin allowlist-ыг bridge message бүр дээр давхар шалгана.


1210. Гараар шалгах хувилбарууд

Бүрхүүлийн өөрчлөлт бүрийн дараа дараах жагсаалтыг гүйцэтгэнэ.

A. Хөтчийн горим өөрчлөгдөөгүй эсэх

  1. cd frontend && npm run dev, дараа нь хөтчөөр http://localhost:3000 руу орж нэвтэрнэ.
  2. Толгой хэсэг, хажуугийн цэс, мобайл таб бүгд урьдын адил байгааг харна.
  3. DevTools → Elements: <html> дээр data-shell атрибут байхгүй.
  4. Console: window.GeregeShell → undefined.

B. Бүрхүүлийн горимд chrome нуугдсан эсэх

  1. Тухайн native target-ыг ажиллуулж, native дэлгэцээр нэвтэрнэ.
  2. Нэвтэрсний дараа gerege-topbar, хажуугийн цэс, мобайл таб аль нь ч зурагдаагүй; зөвхөн ажлын муж ба AI туслах харагдана.
  3. Апп Стороос модуль асаагаад/унтраагаад цэсний өгөгдөл шинэчлэгдэж байгааг шалгана — өгөгдлийн fetch нь зурагдахгүй ч ажиллаж байх ёстой.

C. data-shell тавигдсан эсэх

  1. Аппын цонхон дээр баруун товшоод Inspect Element (dev build).
  2. Elements: <html data-shell="macos" ...> — эсвэл windows / ios / android.
  3. Console: getComputedStyle(document.body).fontFamily — Inter биш, системийн фонтоор эхэлсэн байна.

D. Дэмжигдээгүй method няцаагдаж байгаа эсэх

Console дээр:

js
await window.GeregeShell.invoke("biometric.authenticate", { reason: "Тест" })
  1. Promise reject хийнэ — desktop дээр биометр хэрэгжээгүй.
  2. window.GeregeShell.capabilities дотор biometric байхгүйг шалгана: web тал fallback-аа ажиллуулах болзол нь тэр.
  3. Хэрэгжсэнийг шалгана: await window.GeregeShell.invoke("notify.show", { title: "Тест" }) → системийн мэдэгдэл гарна.

E. iframe-ээс гүүр дуудагдахгүй эсэх

Console дээр:

js
const f = document.createElement("iframe");document.body.appendChild(f);f.contentWindow.GeregeShell;                       // undefined байх ёстойf.contentWindow.webkit?.messageHandlers?.geregeShell; // undefined байх ёстой

F. Гадаад URL webview дотор нээгдэхгүй эсэх

  1. Console дээр window.location.href = "https://example.com".
  2. Хуудас системийн хөтөч дээр нээгдэнэ; аппын цонх өөрчлөгдөхгүй үлдэнэ.
  3. window.open("https://example.com") — мөн адил гадаад хөтчөөр нээгдэнэ.
  4. Аппын дотоод холбоос (жишээ нь /apps) хэвийн ажиллана.

G. Нэг хүрээний дүрэм зөрчигдөөгүй эсэх (§1a)

  1. Тохиргоог нээнэ: цэснээс, rail/tab-аас, мөн console дээр await window.GeregeShell.invoke("shell.openPane", { pane: "settings" }).
  2. Гурвуулын дараа шинэ цонх гараагүй: macOS дээр Dock дүрс нэг хэвээр, Windows дээр taskbar-д нэг бичлэг, Android дээр Recents-д нэг entry.
  3. Тохиргоон дээр байхад толгойн ribbon/menu, rail/tab bar, footer бүгд байрандаа хэвээр — зөвхөн дунд хэсэг солигдсон.
  4. Ажлын муж руу буцаад хуудас дахин ачаалагдаагүй эсэхийг шалгана: тохиргоо руу орохын өмнө хуудсыг доош гүйлгээд, буцаж ирэхэд ижил байрлалдаа байх ёстой.

H. Төхөөрөмжийн domain шугам зөв эсэх (§1b)

  1. Ажлын мужийн console дээр location.host — тухайн ШУГАМ байна (desktop., mobile., kiosk., pos.), платформын нэр БИШ.
  2. Network таб: /api/v1/... дуудлагууд ижил host руу явж байна; OPTIONS preflight огт байхгүй.
  3. document.cookie-д session_token харагдахгүй (HttpOnly) ч API дуудлага 200 буцааж байна — cookie same-origin-оор явж байгаагийн шинж.
  4. Хөтчөөр https://desktop.petronet.mn/login руу орвол /apps руу шилжинэ — тэр шугам дээр нэвтрэлт нь native UI.
  5. https://petronet.mn хэвээр бүрэн web app: толгой хэсэг, хажуугийн цэс, /login бүгд урьдын адил.

I. Функциональ регресс байхгүй эсэх

  1. Цэсний мөрийн Хайх (⌘F) → үг бичиж Enter дарахад ажлын мужид хайлтын давхарга нээгдэж, үр дүн гарна.
  2. Toolbar-ын Апп Стор / E-Sign / Төрийн үйлчилгээ товчнууд шилжүүлнэ.
  3. Хэвлэх (⌘P), файл татах (Save panel), tray цэс, gerege://apps deep link бүгд ажиллана.
Энэ хуудас тус болсон уу?Таны хариу баримтыг сайжруулахад тусална.
    DEV · Хөгжүүлэлтийн орчин