API logic нийцлийн матриц

9. APIAPI — програмын харилцах интерфэйс logic нийцлийн матриц

API logic Хууль зүйн шаардлага Системийн хэрэгжилтийн санал Алдаа/guard Эх сурвалж
authorization Эрх, үүрэг бүхий тал бүр зөвхөн хуулийн чиг үүргээр үйлдэнэ; хороо бусад этгээдтэй шууд харилцахгүй Role + байгууллага + тендерийн хүрээний policy; хамгийн бага эрх; үүргийн зааг 403 ACTOR_NOT_AUTHORIZEDACTOR_NOT_AUTHORIZED — Оролцогч энэ үйлдлийг хийх эрхгүй; шийдвэрийг давж өөрчлөхөд үндэслэл шаардах ACTACT — Эрх, үүрэг бүхий тал — худалдан авах ажиллагаанд тодорхой эрх, үүрэг хэрэгжүүлэгч этгээд, байгууллага эсхүл бүтэц бүртгэл; REQ-024REQ-024 — Норматив шаардлага: Хороо захиалагчаас бусад этгээдтэй шууд харилцахгүй; шаардлагатай харилцааг захиалагчаар…
төлөв шилжилт Хугацаа, шийдвэр, түдгэлзүүлэлт, баталгаа, гэрээний зөвшөөрсөн transition-ийг мөрдөнө; complaint hold үед contract sign хоригтой; REQ-077REQ-077 — Норматив шаардлага: 100 саяас дээш төсөвт гүйцэтгэлийн баталгааг тухайн жилд санхүүжих дүнгийн 3 хувиар шаардана;… үйлчлэх бол баталгаа баталгаажсаны дараа sign хийнэ Server-side төлөвийн машин; client талын төлөвт найдахгүй; transition бүр reason/evidence-тэй 409 INVALID_STATE_TRANSITIONINVALID_STATE_TRANSITION — Зөвшөөрөгдөөгүй төлөв шилжилт; 423 PROCUREMENT_SUSPENDED_BY_COMPLAINTPROCUREMENT_SUSPENDED_BY_COMPLAINT — Гомдлын улмаас ажиллагааг түдгэлзүүлсэн; 422 GUARANTEE_NOT_ACTIVEGUARANTEE_NOT_ACTIVE — Баталгаа хүчингүй §7 state model; REQ-072AREQ-072A — Норматив шаардлага: Эрх бүхий гомдол шийдвэрлэх байгууллага эсхүл шүүх тендерийг түдгэлзүүлсэн, эрх олгосон…, 076A, 077
хугацааны тооцоо Хууль, журамд “ажлын өдөр” болон цагийн хугацааг яг мөрдөнө Нэгдсэн business calendar, timezone Asia/Ulaanbaatar, stopped-clock ledger; rule version 422 DEADLINE_RULE_VIOLATIONDEADLINE_RULE_VIOLATION — Хугацааны дүрмийн зөрчил REQ-009REQ-009 — Норматив шаардлага: Санхүүжилт батлагдсанаас хойш төлөвлөгөөг 10 ажлын өдөрт дээд шатанд илгээнэ–010, 033–034, 042, 045–047, 063–067, 072–073, 085
тоон гарын үсэг Тендер ба холбогдох цахим баримтыг тоон гарын үсгээр баталгаажуулна Certificate chain/status, signer authority, payload digest, signed-at-г immutable хадгалах 422 DIGITAL_SIGNATURE_INVALIDDIGITAL_SIGNATURE_INVALID — Тоон гарын үсэг хүчингүй; 422 SIGNER_AUTHORITY_UNVERIFIEDSIGNER_AUTHORITY_UNVERIFIED — Гарын үсэг зурагчийн эрх баталгаажаагүй REQ-007REQ-007 — Норматив шаардлага: Тоон гарын үсгээр баталгаажуулж цахим системээр илгээсэн баримтыг бичгээр үйлдсэнд тооцно, 023, 039
баримтын бүрдэл Баримт бичиг, тендер, хувийн хэрэг, гомдлын нотолгоог бүрэн хадгална Schema-driven checklist; эх сурвалж/заалтын холбоос; malware scan нь хэрэгжилтийн санал 422 REQUIRED_EVIDENCE_MISSINGREQUIRED_EVIDENCE_MISSING — Шаардлагатай нотлох баримт дутуу REQ-027REQ-027 — Норматив шаардлага: Баримт бичигт мэдээлэл, шаардлага, заавар, шалгуур/аргачлал, гэрээний нөхцөл, техникийн…, 032, 049–050, 068, 074, 081
давхардсан хүсэлт Нэг оролцогч нэг тендер; код давтагдахгүй Idempotency key + unique constraints scoped by tender/lot/participant; safe replay 409 DUPLICATE_TENDERDUPLICATE_TENDER — Давхардсан тендер; 409 DUPLICATE_PROCUREMENT_CODEDUPLICATE_PROCUREMENT_CODE — Давхардсан худалдан авалтын код REQ-015REQ-015 — Норматив шаардлага: Төсөл/арга хэмжээний нэр нь батлагдсан төсвийн нэртэй ижил, тендерийн дугаар дахин давтагдахгүй…, 038
өөрчлөлтийн түүх Төлөвлөгөө, баримт бичиг, гэрээ, бүртгэлийн өөрчлөлтийг мөрдөх Append-only version metadata; before/after hash; эрх, үүрэг бүхий тал/reason; soft supersede 409 VERSION_CONFLICTVERSION_CONFLICT — Хувилбарын зөрчил REQ-011REQ-011 — Норматив шаардлага: Төлөвлөгөө, тайлан, тэдгээрийн бүх өөрчлөлтийг цахим системээр хөтөлнө, 014, 035, 075–076
шийдвэрийн үндэслэл Буцаалт, татгалзалт, шалгараагүй, арга сонголт, өөрчлөлт, гомдлын шийдвэр үндэслэлтэй Structured reason code + free-text legal reasoning + evidence links 422 LEGAL_BASIS_REQUIREDLEGAL_BASIS_REQUIRED — Хууль зүйн үндэслэл шаардлагатай REQ-014REQ-014 — Норматив шаардлага: Нийтэлсэн төлөвлөгөөнд зөвхөн журамд заасан үндэслэлээр өөрчлөлт оруулж, шийдвэрээс хойш 10…, 016, 048, 052, 059–060, 063, 068, 076
босго/дүн 20/100/150 сая, 100 сая баталгааны босго, 0.5%, 3%, 5–10%, 20/15%-ийн хязгаарыг зөв тооцож, §14.9/§42.10-ын байгууллагын үл хамаарах нөхцөлийг эхэлж шалгана Integer MNTMNT — Монгол төгрөг minor unit; versioned rules; inclusive comparison; currency conversion evidence 422 METHOD_THRESHOLD_MISMATCHMETHOD_THRESHOLD_MISMATCH — Аргын босгын зөрчил; 422 GUARANTEE_AMOUNT_INVALIDGUARANTEE_AMOUNT_INVALID — Баталгааны дүн буруу; exception guard ЭХ-001 §10, §14, §36, §42; ЭХ-002
нууц ба ил тод байдал Хуулийн хугацаа хүртэл үнэлгээний мэдээлэл задруулахгүй; зөвшөөрсөн мэдээллийг хугацаанд ил болгоно; эмзэг мэдээллийг хамгаална Field-level classification/redaction; public/private projections; access log 403 INFORMATION_NOT_YET_DISCLOSABLEINFORMATION_NOT_YET_DISCLOSABLE — Мэдээллийг ил болгох хугацаа болоогүй; 422 REDACTION_BASIS_REQUIREDREDACTION_BASIS_REQUIRED — Нууцлах үндэслэл шаардлагатай ЭХ-001 §22.5–22.6, §29; ЭХ-003 §6
лавлагаа Нээлттэй мэдээллийг оролцогчоос давхар шаардахгүй; тасалдвал мэргэжлийн байгууллагад хандана Source snapshot + retrieval timestamp; unavailable state; retry without changing legal effective date 503 OFFICIAL_DATA_SOURCE_UNAVAILABLEOFFICIAL_DATA_SOURCE_UNAVAILABLE — Албан мэдээллийн эх сурвалж ажиллахгүй байна ЭХ-001 §15.2; ЭХ-003 §2.16–2.19
эрэмбэ Нийцсэн тендерт л үнэлгээ; tie нь submitted-at; олон багцын чадавх Deterministic calculator, reproducible ledger, signed rule version 422 EVALUATION_INPUT_INCOMPLETEEVALUATION_INPUT_INCOMPLETE — Үнэлгээний оролт дутуу REQ-052REQ-052 — Норматив шаардлага: Бүх шаардлагыг зэрэг хангасныг шаардлагад нийцсэн гэж үзнэ; §26.10-ын тендерээс татгалзана–058
гомдлын hold Түдгэлзүүлэлтээр холбогдох ажиллагаа, clock зогсоно Transactional hold flag + allowed-action allowlist; deadline pause segments 423 PROCUREMENT_SUSPENDED_BY_COMPLAINT REQ-064REQ-064 — Норматив шаардлага: Захиалагчид гомдол шийдвэрлэх хугацаанд §57.4-ийн үндэслэлгүй бол §28.1-ийн шийдвэр гаргахгүй, 067
баталгааны lifecycle Хүчинтэй байдал, шинэчлэл, зөв trigger-ээр орлого болголт External guarantee ref verification; expiry jobs; two-person control нь хэрэгжилтийн санал 422 GUARANTEE_NOT_ACTIVE; 409 FORFEITURE_TRIGGER_NOT_METFORFEITURE_TRIGGER_NOT_MET — Хураах үндэслэл бүрдээгүй REQ-069REQ-069 — Норматив шаардлага: Багц/тендерийн төсөв 100 саяас дээш бол тендерийн баталгааг төсөвт өртгийн 0.5 хувиар шаардана;…–071, 077–079
id/шаардлагын холбоос Тендерийн код давтагдахгүй, багц/тендер/шийдвэр/гэрээ холбоотой байна UUIDUUID — дахин давтагдашгүй таних дугаар internal + official code; correlation id; no IDID — таних дугаар reuse 409 IDENTIFIER_CONFLICTIDENTIFIER_CONFLICT — Дугаарын зөрчил REQ-015; ЭХ-005 §2.14
эхийн хувилбар ба хүчингүй заалт Зөвхөн хүчинтэй нэгтгэсэн хувилбарын дүрэм үйлчилнэ; хүчингүй заалтыг хэрэгжүүлэхгүй Rule manifest-д source ID, clause, effective-from/to; regression denylist 409 LEGAL_RULE_VERSION_CONFLICTLEGAL_RULE_VERSION_CONFLICT — Хууль зүйн дүрмийн хувилбарын зөрчил REQ-100REQ-100 — Норматив шаардлага: Хүчингүй болсон ЭХ-003 §2.5.3, ЭХ-007 §5.6, ЭХ-008 §2.14.1-ийг идэвхтэй дүрэм, field,…; REPEALED-001REPEALED-001 — Хүчингүй заалтын бүртгэл 001 — хэрэглэхийг хориглосон хүчингүй заалт
мэдээллийн аюулгүй ажиллагааны audit 2 жил тутам мэдээллийн аюулгүй байдлын audit хийж, нөөц сервер/эрсдэлийн хяналтыг хангана Audit schedule, evidence registry, recovery test нь хэрэгжилтийн санал 503 SECURITY_ASSURANCE_OVERDUESECURITY_ASSURANCE_OVERDUE — Аюулгүй байдлын баталгаажуулалтын хугацаа хэтэрсэн REQ-099REQ-099 — Норматив шаардлага: Цахим системд эрсдэлийн үнэлгээ, байнгын хяналт/шинэчлэл, 2 жил тутмын мэдээллийн аюулгүй…; ЭХ-003 §6.2