მმართველობითი ფორმების autofill state-ის ანალიზი
Document ID: GOS-40-FORMS-AUTOFILL-STATE-DISCOVERY
Version: 1.1.0
Status: DRAFT
Owner Role: DOCUMENT_CUSTODIAN
Last Review Date: 2026-02-26
Next Review Date: 2026-03-28
1. მიზანი
ეს შენიშვნა აღწერს, რომელი workflow state-ებია საჭირო ფორმების ავტომატური შევსების deterministic მხარდაჭერისთვის.
მიზანი:
- განისაზღვროს autofill-ისთვის საჭირო მინიმალური state gate-ები
- გამოიკვეთოს შუალედი governance state-machine დოკუმენტებსა და მიმდინარე runtime state-ებს შორის
- შეიქმნას ფორმების ავტომატიზაციისთვის მზადყოფნაში მყოფი საწყისი ბაზა
2. მიმდინარე state-ების დაფარვა
2.1 მიწის მესაკუთრე / ნაკვეთის რეგისტრაცია
Governance spec (EX-PL-01) განსაზღვრავს:
- DRAFT
- SUBMITTED
- UNDER_VERIFICATION
- VERIFICATION_COMPLETED
- CORRECTION_REQUIRED
- REGISTERED
- DECLINED
- CANCELLED
მიმდინარე runtime onboarding state-ები (stakeholder application):
- DRAFT
- SUBMITTED
- UNDER_REVIEW
- REQUIRES_INFO
- APPROVED
- VERIFIED
- REJECTED
- EXPIRED
- SUSPENDED
მიმდინარე UI edit gate:
- რედაქტირება შესაძლებელია მხოლოდ DRAFT ან REQUIRES_INFO მდგომარეობაში
- გაგზავნა დაშვებულია მხოლოდ მაშინ, როცა ფორმა editable-ა, სავალდებულო დოკუმენტები არსებობს და მინიმუმ ერთი ნაკვეთია დამატებული
შუალედი:
- EX-PL-01 state-ები პირდაპირ runtime მნიშვნელობებად არ არის დანერგილი
- onboarding ამჟამად stakeholder_application state machine-ზე მუშაობს და არა EX-PL-01 canonical label-ებზე
2.2 ტენდერი (EX-TN-01) და procurement (EX-PR-01)
Governance spec-ის state-ები runtime tender status-ზე უფრო მდიდარია.
EX-TN-01 მოიცავს:
- DRAFT, PUBLISHED, BIDDING_OPEN, BIDDING_CLOSED, UNDER_EVALUATION, SELECTION_PROPOSED, APPROVED, REJECTED, CLOSED
EX-PR-01 მოიცავს:
- INITIATED, ELIGIBILITY_REVIEW, TENDER_OPEN, TENDER_CLOSED, EVALUATION, SELECTION, DECISION, CORRECTION, REJECTED, SETTLED, CLOSED
მიმდინარე runtime tender status:
- DRAFT
- SUBMITTED
- APPROVED
- REJECTED
- CANCELLED
შუალედი:
- procurement/tender-ის მმართველობითი ფაზები runtime tender status-ში სრულად არ არის წარმოდგენილი
2.3 კონტრაქტი (EX-CT-01) და settlement (EX-ST-01)
EX-CT-01 state-ები:
- PROPOSED, LEGAL_REVIEW, APPROVED, SIGNATURE_AUTHORIZED, SIGNED, CLOSED, CANCELLED
EX-ST-01 state-ები:
- INITIATED, PAYMENT_EVIDENCE_SUBMITTED, UNDER_VERIFICATION, VERIFIED, ANCHORED, SETTLED, REJECTED, CANCELLED
Runtime:
- auction/tender სერვისები ციკლის მხოლოდ ნაწილობრივ state-ებს აჩვენებს
- settlement-ის სპეციალიზებული workflow state-ები დღეს ძირითადად specification-ის დონეზეა
2.4 EX-IP-04 Inspection
მიმდინარე governance state machine (EX-IP-04) state-ები:
- INITIATED
- SUBMITTED
- ASSIGNED
- UNDER_INSPECTION
- UNDER_VERIFICATION
- VERIFICATION_COMPLETED
- UNDER_REVIEW
- DECISION_PENDING
- CORRECTION_REQUIRED
- APPROVED
- REJECTED
- ANCHORED
- SETTLED
- CLOSED
- CANCELLED
გავლენა:
- inspection form automation-ს ახლა უკვე შეუძლია canonical lifecycle gate-ები გამოიყენოს placeholder ვარაუდების ნაცვლად
3. Autofill-ისთვის საჭირო state gate-ები
ფორმის უსაფრთხო ავტომატური შევსებისთვის თითოეულ instance-ს ეს lifecycle gate-ები სჭირდება:
- NOT_STARTED
- instance ჯერ არ არსებობს
- დასაშვებია მხოლოდ identity/profile-ის prefill
- DRAFT_EDITABLE
- მფლობელის ველები შეიძლება ცნობილი წყაროებიდან წინასწარ შეივსოს
- მომხმარებელს შეუძლია დასაშვები ველების შეცვლა
- READY_TO_SUBMIT
- წარმოებული validation state (საჭირო ჩანაწერები არსებობს)
- ჯერ transition არაა, მხოლოდ gate check
- SUBMITTED_LOCKED
- შინაარსი მფლობელისთვის immutable ხდება
- მხოლოდ review metadata შეიძლება დაემატოს
- UNDER_REVIEW_LOCKED
- მხოლოდ reviewer-ის მოქმედებებია დაშვებული
- მფლობელის edit დაბლოკილია
- REQUIRES_INFO_EDITABLE
- მიზანმიმართული კორექციის რეჟიმი
- autofill-მა წინარე მნიშვნელობები უნდა შეინარჩუნოს და მხოლოდ მოთხოვნილი ცვლილებები გამოიყენოს
- APPROVED_OR_VERIFIED_LOCKED
- გადაწყვეტილება დასრულებულია
- payload ველების რედაქტირება აღარ შეიძლება
- ANCHORED_OR_SETTLED_OR_CLOSED_TERMINAL
- ფინალიზებული ჩანაწერის კონტექსტი
- მხოლოდ-წაკითხვადი; მხოლოდ მტკიცებულება და proof
- REJECTED_OR_DECLINED_OR_CANCELLED_TERMINAL
- ნეგატიური საბოლოო გზა
- მხოლოდ-წაკითხვადი reason/evidence visibility წესებით
- EXPIRED_OR_SUSPENDED_LOCKED
- ადმინისტრაციული lifecycle lock
- მხოლოდ-წაკითხვადი, თუ governance policy არ უშვებს რეაქტივაციას
4. Autofill-ისთვის მინიმალური მონაცემთა წყაროები
Autofill engine-მა უნდა იკითხოს canonical aggregate-ებიდან:
- application state:
stakeholder_applications.state
- profile patch aggregate:
stakeholder_application_payloads.payload_json
- plot records:
land_plots
- document records:
stakeholder_application_documents
- audit timeline:
stakeholder_application_events (timeline/audit-ისთვის, მაგრამ არა როგორც ერთადერთი truth source)
5. იმპლემენტაციის რიგი
- გამოქვეყნდეს canonical crosswalk:
- governance state-ების runtime state-ებზე მიბმა თითო domain-ისთვის (EX-PL/EX-TN/EX-PR/EX-CT/EX-ST)
- EX-IP-04 state-ები lifecycle gate-ებზე აისახოს კოდში:
- correction და decision loop-ები ფორმების mutability წესებში მკაფიოდ უნდა ჩანდეს
- კოდში დაინერგოს shared form lifecycle enum:
- Section 3-ში აღწერილი gate-ებით
- enforced state-aware field mutability:
- editable ველები მხოლოდ editable gate-ებში
- computed/autofilled ველები მხოლოდ-წაკითხვადი locked/terminal gate-ებში
- დაემატოს projection endpoint(ები):
- ერთ პასუხში აბრუნებდეს current gate-ს, ნაკლოვან მოთხოვნებს და prefilled payload-ს
6. ღია მმართველობითი გადაწყვეტილებები
- EX-PL transition-ების ნაწილის საბოლოო authority mapping ჯერაც UNDEFINED-ია
- correction loop-ის საზღვრები რამდენიმე პროცედურაში UNDEFINED-ად რჩება
- EX-IP-04 reviewer mandatory/optional policy ჯერაც UNDEFINED-ია
- საჯარო ხილვადობისა და disclosure policy-ის დეტალები კვლავ procedure-specific UNDEFINED საკითხებია