Төрийн үйлчилгээ¶

Иргэн рүү харсан үйлчилгээний гадаргуу: каталогоос үйлчилгээ сонгож хүсэлт гаргах, албан хаагч түүнийг хянах, лавлагаа / төлбөр / цаг захиалга хүртэл бүтэн мөчлөг. UI: /me/services, /me/applications, /manager/requests.

Хүсэлтийн амьдралын мөчлөг¶

Загвар нь Голландын ZGW сургамжийг дагаж, явц (status) ба үр дүн (result)-ийг тусад нь хадгална — «татгалзав» гэдэг нь хүсэлт хаагдсаныг заадаг ч шалтгааныг заадаггүй.

stateDiagram-v2
  [*] --> submitted: иргэн илгээв
  submitted --> registered: албан ёсоор бүртгэв (SLA эхлэв)
  registered --> in_review: албан хаагч авав
  in_review --> info_required: нэмэлт баримт хүсэв
  info_required --> in_review: иргэн ирүүлэв
  in_review --> approved: зөвшөөрөв
  in_review --> rejected: татгалзав
  approved --> completed: гаралт олгогдов
  submitted --> cancelled: иргэн буцаав
  info_required --> expired: хугацаа дуусав

Явц (`status`)	Утга
`submitted`	Иргэн илгээв
`registered`	Албан ёсоор бүртгэгдэв — SLA эндээс эхэлнэ
`in_review`	Албан хаагч хянаж байна
`info_required`	Иргэнээс нэмэлт баримт хүлээж байна
`approved` · `rejected`	Шийдвэр гарав
`completed`	Гаралт (лавлагаа / баримт) олгогдов
`cancelled` · `expired`	Иргэн буцаав / хугацаа дуусав

Үр дүн (`result`)	Утга
`granted`	Олгов
`refused`	Татгалзав
`withdrawn`	Иргэн татав
`not_admissible`	Хүлээн авах боломжгүй
`processed`	Шийдвэргүйгээр боловсруулав (автомат)

Иргэний endpoint-ууд¶

Endpoint	Юу
`GET /v1/gov/services` · `/life-events`	Каталог, амьдралын үйл явдал
`GET /v1/gov/overview`	Миний тойм (хүсэлт, мэдэгдэл, төлбөр)
`GET /v1/gov/applications`	Миний хүсэлтүүд
`POST /v1/gov/applications`	Шинэ хүсэлт
`GET /v1/gov/applications/{id}/timeline`	Хүсэлтийн түүх
`POST /v1/gov/applications/{id}/provide-info`	Нэмэлт баримт ирүүлэх
`POST /v1/gov/applications/{id}/cancel`	Хүсэлт буцаах

Бүх бичих үйлдэлд ~30/мин rate limit; бүх мөр RLS-ийн self policy-ээр хамгаалагдсан.

Албан хаагчийн дараалал¶

gov.review эрх шаардана. UI: /manager/requests.

Endpoint	Юу
`GET /v1/gov/officer/stats`	Ажлын ачааллын тоо
`GET /v1/gov/officer/queue`	Дараалал
`GET /v1/gov/officer/queue/{id}`	Хүсэлтийн дэлгэрэнгүй
`POST /v1/gov/officer/queue/{id}/assign`	Өөртөө хуваарилах
`POST /v1/gov/officer/queue/{id}/request-info`	Нэмэлт баримт хүсэх
`POST /v1/gov/officer/queue/{id}/decide`	Шийдвэр (approve / reject + result)
`POST /v1/gov/officer/queue/{id}/complete`	Гаралтыг олгож хаах

RLS дээрх officer policy

gov_* хүснэгтүүд дээр self · admin · service-ээс гадна officer policy байдаг. Албан хаагч зөвхөн өөрт хамаарах хүсэлтийн мөрийг харна — query алдаа гарсан ч бусад иргэний өгөгдөл задрахгүй.

Лавлагаа¶

Endpoint	Юу
`GET /v1/gov/references`	Олгогдсон лавлагаанууд
`POST /v1/gov/references`	Лавлагаа үүсгэх (үйлчилгээний гаралт)

Лавлагаа нь хүсэлт completed болоход үүсдэг гаралтын нэг хэлбэр. Шаардлагатай бол PAdES гарын үсэг-тэйгээр PDF болгож олгоно.

Мэдэгдэл¶

Endpoint	Юу
`GET /v1/gov/notifications`	Жагсаалт
`POST /v1/gov/notifications/{id}/read`	Нэгийг уншсанд тооцох
`POST /v1/gov/notifications/read-all`	Бүгдийг уншсанд тооцох

Хүсэлтийн төлөв өөрчлөгдөх бүрд мэдэгдэл үүснэ. UI: /me/notifications.

Төлбөр¶

Endpoint	Юу
`GET /v1/gov/payments`	Төлбөрийн жагсаалт
`POST /v1/gov/payments/{id}/pay`	Төлөх

UI: /me/payments. Төлбөрийн мөр нь хүсэлттэй холбогдож, төлөгдсөний дараа ажлын урсгал үргэлжилнэ.

Цаг захиалга¶

Endpoint	Юу
`GET /v1/gov/appointments`	Миний цагууд
`POST /v1/gov/appointments`	Цаг захиалах
`POST /v1/gov/appointments/{id}/cancel`	Цуцлах

UI: /me/appointments.

Каталог удирдах¶

Каталогийн бичлэгүүд (gov_services, gov_life_events) нь үйлчилгээний регистрээс гаралтай — паспорт, хувилбар, нотолгооны шаардлага тэнд амьдарна. Дэлгэрэнгүйг Үйлчилгээний регистр-ээс үз.

Нийтэд харагдах уншилтын гадаргуу:

Endpoint	Юу
`GET /v1/catalog/services`	Нийтлэгдсэн үйлчилгээ
`GET /v1/catalog/services/{id}`	Дэлгэрэнгүй
`GET /v1/catalog/life-events`	Амьдралын үйл явдлаар бүлэглэсэн

Каталогийг засварлахад gov.catalog эсвэл registry.manage эрх шаардана.

Хүсэлтийг доод байгууллага руу дамжуулах¶

Нэг хүсэлт хэд хэдэн байгууллагад хамаарах тохиолдолд relay модуль ажиллана — SLA-тай хуваарилалт, дагалдах хяналт. Хүсэлт дамжуулах (Relay)-ыг үз.