PetroNet SystemБаримт бичиг
Платформ

Архитектур

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

Кодоос уншиж бичсэн. Хэмжээ, нэр, тоо бүр 2026-08-30-нд backend/ дотроос шалгагдсан — энэ баримт нь зорилго биш, одоогийн байдал.


01Нэг бинарь, гурван урсгал

cmd/api нэг процесс ачаалж, дотор нь хоорондоо import хийдэггүй гурван хүсэлтийн урсгал ажиллана.

Ажлын урсгалОператорын урсгалХүний урсгал
ХэндБайгууллага доторх хүнСистемийг удирдах операторХүн өөрөө, аль ч байгууллагаас гадуур
Originpetronet.mnadmin.petronet.mnpetronet.mn
API угтвар/api/v1/*/api/platform/v1/*/api/v1/me/*
Cookiesession_tokencp_sessionsession_token
Бүртгэлregistry.users + workspace.membershipsoperator.operator_accountsregistry.users
DB rolegerege_nexus_tenantgerege_nexus_operatorgerege_nexus_tenant
Go багцinternal/workspace/*internal/operator/*internal/person

158 HTTP замын 64 нь операторынх.

Операторын бүртгэл нь хэрэглэгчийн бүртгэл биш. Нэг хүн хоёуланд нь нэвтэрч болох ч тусдаа identity, cookie, эрх, audit ашиглана. Оператор байгууллагын нүдээр харах шаардлагатай бол шалтгаан бүхий, хугацаа хязгаартай impersonation урсгалыг ашиглана — тэр нь бүртгэгддэг.

Хүний урсгал нь ажлын урсгалтай нэг cookie, нэг DB role хуваалцдаг. Ялгаа нь хамрах хүрээ: /api/v1/me/* нь нэг хүний зүйлсийг бүх байгууллагаар нь хариулна — түүнд ирсэн зүйлс, түүний гишүүн болох хүсэлтүүд, лавлах. Тиймээс энэ нь workspace-ийн дэд багц биш, тусдаа багц: workspace-ийн query бүр байгууллага дотор ажиллаж байгаа хүнд зориулж бичигдсэн бөгөөд тэдгээрийг энд import хийх нь тэр query-үүдийг ямар ч байгууллагад харьяалагдахгүй хүсэлтээс дуудагдах боломжтой болгоно. Session-ээс хэрэгтэй зүйл нь ганц асуулт — «энэ token хэн бэ» — асуулт нь import биш, port.

Гурван урсгал хоорондоо import хийхгүйг internal/planes_test.go компиляцын граф дээр шалгана: workspace ↮ operator, person ↮ workspace, person ↮ operator. Энэ бол баримтын амлалт биш, тестийн батламж.

text
ажлын origin ─┐                            ┌─ internal/workspace/*  → workspace schema              │                            │              ├─ pkg/host/server.go ───────┼─ internal/person       → registry + workspace              │     дундын middleware      │операторын ───┘                            └─ internal/operator/*   → operator + registry                          │                    internal/kernel/*                          │                      PostgreSQL

backend/pkg/host нь composition root — гурваас илүүг нэрлэх эрхтэй цорын ганц газар. run.go нь бүх зүйлийг дараалалтайгаар босгоно: лог, trace, метрик, алдааны бүртгэл, өгөгдлийн сангийн pool, tenant binding, audit sink, Redis, сервер, суурь өгөгдөл, ардын ажил. server.go нь гурван route table-ыг нэг router дээр mount хийнэ.

Дундын middleware гинж, дарааллаараа:

text
RequestID → Tracing → RequestLogger → Recovery → LoadShedder → Metrics          → SecurityHeaders → CORS → CSRF

02Гурван schema

SchemaХүснэгтЮу эзэмшдэг
workspace32Байгууллагын ажил: гишүүнчлэл, эрх, апп суулгалт, баримт, тайлан, SSO
registry22Системийн бүртгэл: байгууллага, хүн, тэдгээрийн таних тэмдэг
operator7Операторын бүртгэл, audit, зөвшөөрөл

Хуваалт нь гоо зүйн биш: db/migrations-ийн guardrail тест нь schema бүрийн хүснэгтийн тоог тоолж, бичсэн тоотой тулгадаг. Хүснэгт нэмэх нь тэр тоог шинэчлэхийг шаардана — өөрөөр хэлбэл хилийг санамсаргүй давах боломжгүй.

03Өгөгдлийн тусгаарлалт — хоёр давхарга

Query бүр WHERE tenant_id = $1 авч явдаг ба тэр нь үндсэн хяналт хэвээр. Доор нь хоёр дахь давхарга байна: internal/kernel/dbguard.

pgxpool нь query бүрд холболт гаргаж өгдөг ба BeforeAcquire нь хүсэлтийн контексттэйгээ ажилладаг. Тэр нь аль холболт ашиглагдах гэж байгааг ба хэн ашиглах гэж байгааг хоёуланг нь мэддэг цорын ганц цэг тул уяа тэнд хийгдэнэ:

text
контекстэд байгууллага   → SET ROLE gerege_nexus_tenant, app.current_tenant = <id>контекстэд хүн           → SET ROLE gerege_nexus_tenant, байгууллагагүйаль нь ч биш             → SET ROLE NONE (нэвтрэх role, бодлогод захирагдахгүй)

Гурав дахь тохиолдол нь цоорхой биш — платформын зам юм: нэвтрэлт, session тайлах, OAuth callback, шүүрдэлт зэрэг байгууллагагүй ажил тэрүүгээр явна.

Үр дүн нь: ирээдүйд, өөр хүний бичсэн модульд WHERE мартагдвал тэр нь өөр байгууллагын мөрийг буцаахгүй, юу ч буцаахгүй.

app.current_user нь мөн бүх уясан холболт дээр тавигдана. Ихэнх бодлого түүнийг уншдаггүй — тэдгээр байгууллагаар тусгаарладаг. Уншдаг нь хүнд харьяалагддаг хүснэгтүүд: тэнд тусгаарлах зүйл нь хүн өөрөө тул түлхүүр нь ч хүн байх ёстой. Заримдаа байдаг уяа нь бодлого бичигчийн бодох ёстой нэмэлт тохиолдол болдог учир үргэлж тавигддаг.

04Цөм — internal/kernel

Аль ч урсгалыг import хийдэггүй 20 багц: appid, async, cache, config, credentials, dbguard, flags, httpx, memo, resilience, security, settings, telemetry, usage ба гадаад системийн клиентүүд (appcatalog, eidrp, eidsign, gemini, geregecore, mailrail).

Хамаарлын чиглэл нэг талдаа: урсгалууд цөмийг уншина, цөм урсгалыг мэдэхгүй.

Load shedder-ийн тааз нь нэг зэрэг 1000 хүсэлт. Түүнээс хойш ирсэн хүсэлт 503 авна — дараалал уртсаж бүх хүн хүлээхээс, зарим нь шууд хариу авах нь дээр.

05Аппын уяа

backend/internal/apps нь distribution модулийн угсрах цэг бөгөөд нэг ч бизнес апп агуулахгүй. Тэр нь дутуу ажил биш, төгссөн байдал: экосистемийн стратегийн тавьсан шалгуур нь «нэг ч бизнес аппгүйгээр ачаалж, апп бүрийг каталогоос авдаг платформ» байсан. catalog/apps.json нь энэ репод [].

Апп бүр pkg/nexus-ээр өөрийгөө бүртгүүлж, каталогоор ирнэ. Дэлгэрэнгүйг Модуль бичих.

06Хэмжсэн хэмжээс

2026-08-30-нд тоологдсон.

Go эх код (тестгүй)49,698 мөр
Go тест26,232 мөр, 167 файл — эх кодын 53%
Frontend (TS/TSX)33,924 мөр, 219 файл
HTTP зам158 (64 нь операторын)
Migration104
Каталог дахь апп0

Тест нь хамгаалалт болж ажилладаг нь чухал: маршрутын golden file (pkg/host/testdata/routes.txt), schema-ийн хилийн тоолол, RLS бодлогын хэлбэр, гурван урсгалын import граф. Эдгээр нь онолын зөвийг биш, буруу зүйл чимээгүй нэвтрэхийг хардаг.

07Гадагш хандах зам

СистемЮунд
eID MongoliaИргэний танилт, гарын үсэг
ДАНТөрийн танилт
ХУР (XYP)Лавлагаа
Gerege eSign (HSM)Байгууллагын гарын үсэг
GeminiAI туслах
Hosted email verifyХаяг баталгаажуулалт

Дуудлага бүр нэг histogram-аар хэмжигдэнэ — external_request_duration_seconds{system,operation,status}. Аль тал нь удааширсныг маргах шаардлагагүй байхын тулд.

Системийн нэр нь хаалттай олонлог (internal/kernel/telemetry/external.go). Танихгүй нэр other болж нугалагдана: тогтмолгүй нэр нь хэзээ ч арилахгүй time series үүсгэдэг.

08Native бүрхүүл

macOS, iOS/iPadOS, Windows, Android — дөрвүүлээ нэг web shell ачаалж, нэг bridge гэрээгээр ярина (SHELL_CONTRACT.md). Дөрвөн удаа бичсэн апп биш, дөрвөн удаа савласан нэг апп.

09Ажиглалт

Хэмжүүр бүр OpenTelemetry-ийн SDK-аар дамжиж, Prometheus exporter-ээр /metrics дээр гарна. HTTP-ийнх нь semantic convention-ыг дагана (http_server_request_duration_seconds); хүсэлтийн тоо нь тэр гистограммын _count цуврал.

Trace асаалттай үед гистограммын сэмпл бүр trace_id авч явна, тиймээс латенси графикийн удаан цэг нь тэр хүсэлтийн trace руу нээгддэг холбоос болно. Дэлгэрэнгүйг Ажиллагаа.

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