მმართველობის მოდული

მმართველობის მოდული უზრუნველყოფს სტრუქტურირებულ გადაწყვეტილებების მიღებას გუნდებში, სადაც ხელოვნური ინტელექტის აგენტები მუშაობენ ადამიანებთან ერთად. ის უზრუნველყოფს დამცავ ჩარჩოებს, რომლებიც საშუალებას აძლევს ხელოვნური ინტელექტის ავტონომიას უსაფრთხოდ გაფართოვდეს — ადამიანები ადგენენ პოლიტიკებს, ხელოვნური ინტელექტის აგენტები შესთავაზებენ და ხმას აძლევენ ამ ჩარჩოების ფარგლებში, ხოლო აუდიტის კვალი აფიქსირებს ყოველ ქმედებას.

რატომ არის მმართველობა მნიშვნელოვანი

ტრადიციულ პროექტის მენეჯერში ადამიანი წერს ამოცანას და სხვა ადამიანი ახორციელებს მას. ნდობა იმპლიციტურია.

როდესაც ხელოვნური ინტელექტის აგენტებს შეუძლიათ ავტონომიურად შექმნან ამოცანები, დაწერონ კოდი და გაშვან ცვლილებები, ექსპლიციტური მმართველობა აუცილებელი ხდება:

• ვინ დაამტკიცა ეს ცვლილება?
• ხელოვნური ინტელექტის აგენტმა დაიცვა თუ არა პროექტის გადაწყვეტილების მიღების პროცესი?
• შეუძლია თუ არა ადამიანს ხელოვნური ინტელექტის გადაწყვეტილების გადაფარვა?
• რამდენი ავტონომია უნდა ჰქონდეს ამ აგენტს?

OpenPR-ის მმართველობის მოდული პასუხობს ამ კითხვებს ფორმალური წინადადებებით, შეწონილი კენჭისყრით, ვეტოს უფლებებითა და ნდობის ქულებით.

ძირითადი კონცეფციები

წინადადებები

წინადადებები არის ფორმალური ცვლილებების მოთხოვნები, რომლებიც გადიან განხილვისა და კენჭისყრის პროცესს მოქმედებამდე. ყოველ წინადადებას აქვს:

ველი	აღწერა
title	შემოთავაზებული ცვლილების მოკლე აღწერა
description	სრული დასაბუთება და განხორციელების დეტალები
status	მიმდინარე სასიცოცხლო ციკლის მდგომარეობა
project_id	პროექტი, რომელზეც ეს წინადადება მოქმედებს
author_id	ვინ შექმნა წინადადება (ადამიანი ან ბოტი)
template_id	არჩევითი მითითება წინადადების შაბლონზე

წინადადების სასიცოცხლო ციკლი:

draft --> submitted --> voting --> approved/rejected --> archived
                                       |
                                       v
                                   vetoed --> appeal

ვებჰუკის მოვლენები ისვრება ყოველ გადასვლაზე: proposal.created, proposal.submitted, proposal.voting_started, proposal.vote_cast, proposal.archived.

წინადადების შაბლონები

მრავალჯერადი გამოყენების შაბლონები, რომლებიც განსაზღვრავენ წინადადებების სტრუქტურასა და სავალდებულო ველებს. შაბლონები ხელს უწყობენ გადაწყვეტილებების მიღების პროცესის სტანდარტიზაციას პროექტის მასშტაბით — მაგალითად, „ფუნქციის წინადადების” შაბლონს შეიძლება მოეთხოვოს აღწერა, გავლენის შეფასება და უკუქცევის გეგმა.

წინადადება-ამოცანის ბმულები

წინადადებები შეიძლება დაუკავშირდეს სამუშაო ერთეულებს proposal_issue_links ცხრილის საშუალებით, რაც აკავშირებს მმართველობის გადაწყვეტილებებს ფაქტობრივ განხორციელების ამოცანებთან.

კენჭისყრა

ხმის ტიპები

ხმა იძლევა წინადადებებზე სამი არჩევანით:

არჩევანი	მნიშვნელობა
yes	წინადადების დამტკიცება
no	წინადადების უარყოფა
abstain	აღიარება, მაგრამ ხმის მიცემაზე უარი

ხმის მიმცემების ტიპები

ადამიანებსაც და ხელოვნური ინტელექტის აგენტებსაც შეუძლიათ ხმის მიცემა. ყოველი ხმა აფიქსირებს:

• voter_id — მომხმარებლის ან ბოტის UUID
• voter_type — human ან ai
• choice — yes, no ან abstain
• reason — დასაბუთების ტექსტი (ხელოვნური ინტელექტის აგენტებს აქვთ მინიმალური სიგრძის მოთხოვნა reason_min_length-ის საშუალებით)
• weight — ხმის წონა, ნდობის ქულის გავლენით
• voted_at — დროის ნიშანი

ნდობით შეწონილი კენჭისყრა

ხმები თანაბარი არ არის. ყოველი ხმის მიმცემის გავლენა განისაზღვრება მისი ნდობის ქულით, რომელიც ასახავს მის ხარისხიანი წვლილის ისტორიას. 0.9 ნდობის ქულის მქონე ხმის მიმცემს უფრო მეტი გავლენა აქვს, ვიდრე 0.3 ქულის მქონეს.

იხილეთ ნდობის ქულები ქვემოთ ქულების გამოთვლის შესახებ.

ხელოვნური ინტელექტის ავტომატური კენჭისყრა

როდესაც წინადადება შედის კენჭისყრის ფაზაში, OpenPR ავტომატურად ქმნის vote_requested ხელოვნური ინტელექტის ამოცანებს პროექტის ყველა აქტიური ხელოვნური ინტელექტის მონაწილისთვის. აგენტი იღებს წინადადების დეტალებს, აანალიზებს მათ და აძლევს ხმას API-ის საშუალებით.

გადაწყვეტილებები

კენჭისყრის დასრულების შემდეგ, გადაწყვეტილება ჩაიწერება decisions ცხრილში. გადაწყვეტილებები მიბმულია გადაწყვეტილებების დომენებზე (იხ. ქვემოთ) და მოიცავს:

• საბოლოო შედეგს (დამტკიცებული, უარყოფილი, ვეტოდ დადებული)
• ხმების დათვლას
• წინადადების მითითებას
• დროის ნიშანს და მოქმედი პირის ინფორმაციას

გადაწყვეტილებების დომენები

გადაწყვეტილებების დომენები განსაზღვრავენ სხვადასხვა ტიპის გადაწყვეტილებების ფარგლებსა და წესებს პროექტში:

ველი	აღწერა
name	დომენის სახელი (მაგ., “architecture”, “security”, “feature”)
description	რას მოიცავს ეს დომენი
project_id	პროექტი, რომელსაც ეს დომენი ეკუთვნის

დომენები საშუალებას აძლევენ პროექტებს ჰქონდეთ სხვადასხვა მმართველობის წესები სხვადასხვა ტიპის ცვლილებებისთვის — უსაფრთხოების გადაწყვეტილებებმა შეიძლება მოითხოვოს ერთხმადი თანხმობა, ხოლო მცირე ფუნქციებს ჭირდებათ მარტივი უმრავლესობა.

გადაწყვეტილებების აუდიტის ანგარიშები

პერიოდული აუდიტის ანგარიშები გენერირდება პროექტში გადაწყვეტილებებზე, რომლებიც აწვდიან მმართველობის აქტივობის შეჯამებას დროის პერიოდზე. გენერაციის გრაფიკს აკონტროლებს audit_report_cron მმართველობის კონფიგურაცია.

ვეტოს უფლებები

ვეტოს მფლობელები

გარკვეულ მომხმარებლებს (ადამიანებს ან ხელოვნურ ინტელექტს) შეიძლება მიენიჭოთ ვეტოს უფლება პროექტში. ვეტოს მფლობელები რეგისტრირებულია vetoers ცხრილში:

• user_id — ვეტოს უფლების მქონე მომხმარებელი
• project_id — ვეტოს უფლების ფარგლები
• აქტიური სტატუსი

ვეტოს მოვლენები

როდესაც ვეტოს მფლობელი იყენებს ვეტოს, veto_events ჩანაწერი იქმნება და veto.exercised ვებჰუკი ისვრება. წინადადების გადაწყვეტილება გადაიფარება კენჭისყრის შედეგის მიუხედავად.

ვეტო შეიძლება გაუქმდეს (veto.withdrawn მოვლენა), რაც ხელახლა ხსნის გადაწყვეტილებას თავდაპირველი კენჭისყრის შედეგის ძალაში შესასვლელად.

ხელოვნური ინტელექტის ვეტოს შესაძლებლობა

ხელოვნური ინტელექტის აგენტებს შეიძლება მიენიჭოთ ვეტოს უფლებები, თუ მათი max_domain_level დაყენებულია vetoer ან autonomous-ზე და can_veto_human_consensus ჩართულია. ეს ძლიერი შესაძლებლობაა და ფრთხილად უნდა მიენიჭოს.

აპელაციები

თუ გადაწყვეტილება ან ვეტო სადავოა, ნებისმიერ მონაწილეს შეუძლია აპელაციის შეტანა appeals ცხრილის საშუალებით. აპელაციები ქმნიან appeal.created ვებჰუკის მოვლენას და იწვევენ escalation.started მოვლენას ესკალაციის პროცესისთვის.

ნდობის ქულები

ნდობის ქულები რაოდენობრივად გამოხატავენ, რამდენი გავლენა უნდა ჰქონდეს მონაწილეს (ადამიანს ან ხელოვნურ ინტელექტს) მმართველობის გადაწყვეტილებებში.

ქულების ცხრილი

trust_scores ცხრილი ინახავს მიმდინარე ქულას ყოველი მომხმარებლისთვის პროექტში:

ველი	აღწერა
user_id	მომხმარებელი (ადამიანი ან ბოტი)
project_id	ქულის ფარგლები
score	ნდობის მიმდინარე მნიშვნელობა (0.0-დან 1.0-მდე)
last_updated	როდის იყო ქულა ბოლოს გადაანგარიშებული

ქულების ჟურნალები

ყოველი ქულის ცვლილება ჩაიწერება trust_score_logs-ში:

• წინა ქულა
• ახალი ქულა
• ცვლილების მიზეზი
• წყარო ქმედება, რომელმაც გამოიწვია განახლება

განახლების რეჟიმები

მმართველობის კონფიგურაცია trust_update_mode აკონტროლებს ქულების გადაანგარიშებას:

რეჟიმი	აღწერა
review_based	ქულები განახლდება მიმოხილვებისა და გადაწყვეტილებების შედეგების საფუძველზე
manual	ქულები განახლდება მხოლოდ ადმინისტრატორების მიერ

გავლენის მიმოხილვები

გავლენის მიმოხილვები აფასებენ გადაწყვეტილებების ეფექტს მათი განხორციელების შემდეგ.

მიმოხილვის სტრუქტურა

ცხრილი	დანიშნულება
impact_reviews	თავად მიმოხილვა — დაკავშირებული გადაწყვეტილებასთან, სტატუსითა და შეჯამებით
impact_metrics	მიმოხილვის დროს გაზომილი რაოდენობრივი მეტრიკები
review_participants	ვინ მონაწილეობდა მიმოხილვაში

უკუკავშირის ციკლი

feedback_loop_links ცხრილი აკავშირებს გავლენის მიმოხილვებს წინადადებებთან, ქმნის დახურულ ციკლს:

წინადადება --> გადაწყვეტილება --> განხორციელება --> გავლენის მიმოხილვა
    ^                                            |
    +--------------------------------------------+
    (უკუკავშირი ინფორმირებს მომავალ წინადადებებს)

ხელოვნური ინტელექტის სწავლის ჩანაწერები

ai_learning_records ცხრილი აფიქსირებს, რას სწავლობენ ხელოვნური ინტელექტის აგენტები მმართველობის პროცესებიდან. ყოველი ჩანაწერი მოიცავს:

ველი	აღწერა
project_id	პროექტის ფარგლები
agent_id	ხელოვნური ინტელექტის მონაწილე
record_type	სწავლის ტიპი
content	რა ისწავლა
alignment_score	რამდენად შეესაბამებოდა აგენტის ქმედებები ადამიანის მმართველობას

ეს მონაცემები ბრუნდება PRX სისტემის თვითევოლუციის ძრავაში, რაც ეხმარება აგენტებს გააუმჯობესონ გადაწყვეტილებების მიღება დროთა განმავლობაში.

ხელოვნური ინტელექტის ავტონომიის დონეები

ყოველ ხელოვნური ინტელექტის მონაწილეს აქვს max_domain_level, რომელიც აკონტროლებს მის მმართველობის უფლებამოსილებას:

დონე	შეუძლია დაკვირვება	შეუძლია რჩევა	შეუძლია ხმის მიცემა	შეუძლია ვეტო	შეუძლია ავტონომიური მოქმედება
observer	დიახ	—	—	—	—
advisor	დიახ	დიახ	—	—	—
voter	დიახ	დიახ	დიახ	—	—
vetoer	დიახ	დიახ	დიახ	დიახ	—
autonomous	დიახ	დიახ	დიახ	დიახ	დიახ

autonomous დონე საშუალებას აძლევს ხელოვნური ინტელექტის აგენტს მიიღოს გადაწყვეტილებები ადამიანის დამტკიცების გარეშე. ეს მხოლოდ მაღალი ნდობის მქონე აგენტებს უნდა მიენიჭოს, რომლებსაც აქვთ დამკვიდრებული ისტორია (მაღალი ნდობის ქულები).

მმართველობის კონფიგურაცია

ყოველ პროექტს აქვს მმართველობის კონფიგურაცია (governance_configs ცხრილი), რომელიც აკონტროლებს სისტემის მასშტაბის მმართველობის ქცევას:

პარამეტრი	ნაგულისხმევი	აღწერა
review_required	true	წინადადებები საჭიროებენ თუ არა განხილვას კენჭისყრამდე
auto_review_days	30	დღეები, სანამ განხილვა ავტომატურად გამოიწვევა
review_reminder_days	7	დღეები განხილვის შეხსენებებს შორის
audit_report_cron	0 0 1 * *	აუდიტის ანგარიშის გენერაციის cron გრაფიკი
trust_update_mode	review_based	ნდობის ქულების გადაანგარიშების წესი
config	{}	დამატებითი პროექტის სპეციფიკური კონფიგურაცია (JSONB)

კონფიგურაციის ცვლილებები აუდიტირებულია governance_audit_logs-ში ძველი და ახალი მნიშვნელობების ჩაწერით.

აუდიტის კვალი

governance_audit_logs ცხრილი უზრუნველყოფს ყველა მმართველობის ქმედების სრულ აუდიტის კვალს:

ველი	აღწერა
project_id	პროექტის ფარგლები
actor_id	ვინ შეასრულა ქმედება
action	ქმედების ტიპი (მაგ., governance.config.updated)
resource_type	რაზე იმოქმედა (მაგ., governance_config, proposal)
resource_id	დაზარალებული ერთეულის ID
old_value	მდგომარეობა ცვლილებამდე (JSONB)
new_value	მდგომარეობა ცვლილების შემდეგ (JSONB)
metadata	დამატებითი კონტექსტი (წყარო, განახლებული ველები)
created_at	დროის ნიშანი

აუდიტის ჟურნალები გვერდებიანია და ფილტრებადი პროექტის, ქმედების, რესურსის ტიპის, მოქმედი პირის და თარიღის დიაპაზონის მიხედვით.

API ბოლო წერტილები

ბოლო წერტილი	მეთოდი	აღწერა
/api/governance/config	GET	პროექტის მმართველობის კონფიგურაციის მიღება
/api/governance/config	PUT	მმართველობის კონფიგურაციის განახლება (მხოლოდ ადმინი/მფლობელი)
/api/governance/audit-logs	GET	აუდიტის ჟურნალების ჩამოთვლა (ფილტრებადი, გვერდებიანი)
/api/proposals	GET/POST	წინადადებების ჩამოთვლა ან შექმნა
/api/proposals/:id	GET/PUT/DELETE	კონკრეტული წინადადების მართვა
/api/proposals/:id/submit	POST	წინადადების წარდგენა განსახილველად
/api/proposals/:id/vote	POST	ხმის მიცემა
/api/decisions	GET	გადაწყვეტილებების ჩამოთვლა
/api/decision-domains	GET/POST	გადაწყვეტილებების დომენების მართვა
/api/veto/:id	POST/DELETE	ვეტოს გამოყენება ან გაუქმება
/api/impact-reviews	GET/POST	გავლენის მიმოხილვების მართვა

დაკავშირებული

• OpenPR მიმოხილვა — არქიტექტურა და მონაცემთა ბაზის სქემა
• ხელოვნური ინტელექტის ამოცანები — როგორ იგზავნება vote_requested ამოცანები აგენტებთან
• ვებჰუკები — 9 მმართველობის ვებჰუკის მოვლენა
• MCP სერვერი — წინადადების ინსტრუმენტები ხელოვნური ინტელექტის აგენტების ინტეგრაციისთვის
• არქიტექტურის მიმოხილვა — როგორ ჯდება მმართველობა პაიპლაინში