PetroNet System
Платформын бусад баримт цөмийн зан төлөвийг тайлбарладаг. Энэ нэг нь өөр асуултад хариулна: энэ хост дээр юу хаана ажиллаж байна, ямар хаалга нээлттэй, юу нөөцлөгдөж байна.
01Нэрнүүд, нэг хост
| Нэр | Юу | Ард нь |
|---|---|---|
petronet.mn | Платформ — frontend ба /api/v1/* | Next.js + Go |
admin. | Операторын консол — / | Мөн тэр хоёр, CONTROL_ |
developer. | Хөгжүүлэгчийн портал — OAuth клиент, scope, түлхүүр (цөмийн /dev) | Мөн тэр хоёр, DEVELOPER_HOST |
monitoring. | / → /monitoring: цөмийн мониторингийн апп; нэвтрээгүй хүнд «Ажиглалт» дизайн (цөмийн door, features/) | Мөн тэр хоёр, MONITOR_HOST |
reports. | Дата агуулах ба тайлан (цөмийн /dwh) | Мөн тэр хоёр, REPORTS_HOST |
backups. | Нөөцлөлтийн апп | Мөн тэр хоёр, BACKUPS_HOST |
docs. | Энэ баримт | Цөмийн docs апп, DOCS_HOST |
www. нь petronet.mn руу 308. Хост нь Proxmox core-dev pool-ийн
core-app-02 (10.130.0.21), стек нь /opt/petronet-д
(erdenebatt/-ийн stack/petronet). TLS ба vhost бүр edge
core-nginx-01 дээр (stack/).
Олон нэр нь гоо зүйн биш: cookie нь hostname-аар хязгаарлагддаг тул тусдаа нэр нь тусдаа эрх гэсэн үг.
02Төхөөрөмжийн шугамууд
Дээрх нэрс нь өөр өөр апп нээдэг. Доорх дөрөв нь тийм биш: яг ижил frontend
ба API, зөвхөн өөр origin дээр. Native клиент бүр өөрийн host-оор ханддаг тул
webview доторх дуудлага same-origin болж, session cookie нь SameSite=Strict
хэвээр ажиллаж, CORS preflight огт үүсэхгүй.
| Шугам | Аппын нэр | Клиент |
|---|---|---|
desktop. | PetroNetDesktop | macOS, Windows |
mobile. | PetroNetMobile | iOS/iPadOS, Android |
kiosk. | PetroNetKiosk | ЗАХИАЛГАТАЙ — клиент хараахан байхгүй |
pos. | PetroNetPos | ЗАХИАЛГАТАЙ — клиент хараахан байхгүй |
Хаяг нь хүн төхөөрөмжийг ХЭРХЭН БАРЬДГИЙГ нэрлэнэ, үйлдлийн системийг биш:
нэг ширээн дээрх Mac ба Windows хоёр нэг шугам. vhost нь edge дээрх
stack/, эх сурвалж нь
native-apps/.
Шинэ шугам нэмэх дараалал нь ДҮРЭМ: эхлээд edge-ийн vhost ба гэрчилгээ,
ХАМГИЙН СҮҮЛД клиентийн доторх хаяг (device_ → client).
Эсрэгээр явбал апп байхгүй host руу чиглэж унана.
03Портууд
| Порт | Юу |
|---|---|
| 8220 | backend API |
| 3220 | бүрхүүл (Next.js) |
Эх сурвалж нь stack/-ийн ports: — энэ хүснэгт
зөрвөл compose зөв. Postgres, Redis, OSRM, Prometheus ба exporter-ууд
(postgres-exporter 9188, node-exporter) нь стекийн дотоод сүлжээнд. Гадагшаа
гарах цорын ганц зам нь edge core-nginx-01.
04Хаалганууд
Хувийн муж — үргэлж нээлттэй
PLATFORM_. eID-ээр танигдсан иргэн бүртгэлтэй болж,
өөрийн гэртээ буудаг. Миграц 00085-аас хойш шинэ данс хэний ч
байгууллагад ордоггүй тул «гэр нээлттэй» гэдэг яг энэ тохиргоотой тэнцэнэ.
Байгууллага — өөрөө сонгоно
Байгууллагын тохиргоо → «Хаалга»:
on_request(анхдагч) — хүсэлт илгээнэ, админ шийднэ;open— богино нэрийг мэдсэн хэн ч шууд гишүүн болно.
Шууд нэгдсэн хүн платформын анхдагч user ролийг авдаг бөгөөд тэр нь
*.read зөвшөөрлүүдийг агуулна. Хаалга нээх ба мэдээллээ харуулах хоёр нэг
зүйл. Хэн, хэзээ орсныг join_requests дээрх ACCEPTED мөр үлдээнэ;
decided_by нь NULL — хүн биш, бодлого шийдсэн.
Консол
Гурван хаалга дараалж: хаягийн шалгалт (CONTROL_-оос өөр нэрээр
ирсэн хүсэлт 404), нууц үг, authenticator-ийн код. Операторын бүртгэл нь
хэрэглэгчийнхээс тусдаа хүснэгт, тусдаа cookie, тусдаа audit.
Түүнээс өмнө хаягийн жагсаалт: консол зөвхөн
CONTROL_ (150.)-аас нээгдэнэ.
05eID
Relying-party итгэмжлэл хостын .env-д (EID_RP_UUID, EID_RP_SECRET) —
тавиагүй бол eID-ийн нэвтрэлт унтраастай. Иргэн апп дотроо уншиж зөвшөөрдөг
нэр нь EID_RP_NAME, хоосон бол BRAND_NAME («PetroNet System»).
rp. руу mTLS-ээр ханддаг: клиентийн гэрчилгээ CN=petronet.mn
(eID Mongolia Organization Issuing CA, 2029-10-30 хүртэл), түлхүүр нь хост
дээр үүссэн, /-д.
eID дээр бүртгэлтэй callback нь яг https://
байх ёстой — платформ өөр хост, өөр замыг дуудахаасаа өмнө татгалздаг.
06Нөөцлөлт
Өдөр бүр 03:15-д / (cron-ийг setup.sh
тавина). Стекийн postgres-ээс pg_dumpall авч restic-ээр Garage руу
шифрлэн илгээнэ (backups/), амжилт бүрд
backup_-ийг бичнэ — хуучирвал BackupStale
дохио өгнө. restic ба Garage-ийн түлхүүр нь /-д.
Лог: /. restic-ээс сэргээх алхмууд
OPERATIONS.md-д.
Сэргээх нь хаягдах сан руу, ажиллаж байгаа руу биш — бүрэн шалгалт нь шинэ кластер дээр (OPERATIONS.md).
07Ажиглалт
Стекийн өөрийн Prometheus (stack/; 15 сек, 15 хоног /
2GB) гурван зорилт цуглуулна: энэ бүтээгдэхүүний API, postgres-exporter, ба
node-exporter. Цөмийн мониторингийн апп (monitoring.)
түүнээс уншина (PROMETHEUS_URL). Нийтийн гурван самбар — шатахууны урсгал,
API, дэд бүтэц — grafana. дээр; monitoring. тэдгээр
рүү заана.
Лог ба trace (Loki, Tempo) энд байхгүй.
08Нууцууд
Репод нууц байхгүй. Хостын / (chmod 600): сангийн нууц үг,
built-in клиентийн нууц, шифрлэлтийн түлхүүрүүд, eID-ийн хос. Нөөцлөлтийнх
нь /.
09Шинэчлэлт
Хост дээр гараар юу ч солихгүй. Зам нь ганцхан:
commit → PR → main → CI (ci.yml) ногоон → Deploy (deploy.yml).
CI нь backend ба бүрхүүл хоёр образыг тестийн хажуугаар
pending-tree-* гэж барьж, ногоон бол tree-* ба commit-ийн SHA-аар
ghcr. руу
тэмдэглэнэ; ижил tree-тэй commit образоо дахин ашиглана. Deploy нь
[self-hosted, core-dev] runner-оос deploy@10. руу орж,
brand/-ийг хуулж, IMAGE_-аар docker compose pull && up -d
хийгээд 8220, 3220 ба https://-ийн эрүүл мэндийг шалгана.
Миграц (cmd/migrate: цөм, дараа нь petro) backend асахаас өмнө ажиллана —
зөвхөн урагш.
Цөм нь core.lock-ийн таг (gerege-systems/, backend/) —
backend ба бүрхүүл хоёулаа түүнээс барьдаг тул хоёр тал нэг API гэрээн дээр
байна. Шинэчлэх нь core.lock, go.mod ба deploy/-ийн ARG VERSION-ийг нэг PR-аар солих.
10Мартагддаг зүйлс
http2 on;нь тусдаа заавар байх ёстой — certbot түүнийг бичдэггүй тул шинэ vhost бүр HTTP/1.1 дээр үлддэг (edge дээр ч мөн адил).add_headerөв залгамжлахгүй: хүү блок дотор нэг ч байвал дээд түвшнийхийг бүгдийг нь хаяна.- Порт бүр нэг эзэнтэй. Дээрх хүснэгтийг шинэ сервис нэмэх бүрд шалгана.
bash1curl -s -o /dev/null -w "http/%{http_version} %{http_code}\n" https://<нэр>/2curl -sI https://<нэр>/ | grep -iE 'strict-transport|x-frame|x-content'