OpenPR: ხელოვნური ინტელექტისთვის შექმნილი პროექტების მართვა

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

პოზიცია პაიპლაინში

Plan  -->  Think  -->  Build  -->  Ship  -->  Protect
 ^
 OpenPR

OpenPR არის ამოსავალი წერტილი. აქ შექმნილი ამოცანები მიედინება პაიპლაინის დანარჩენ ნაწილში: PRX ირჩევს შესაბამის ხელოვნური ინტელექტის მოდელს, აგენტი წერს კოდს, Fenfa ანაწილებს არტეფაქტს, ხოლო WAF + SD იცავს გაშვებულ აპლიკაციას.

ძირითადი ფუნქციები

ამოცანების თვალყურის დევნება და დაფები

სამუშაო ერთეულები (ამოცანები) მხარს უჭერენ სრულ სასიცოცხლო ციკლს ოთხი მდგომარეობით:

მდგომარეობა	მნიშვნელობა
`backlog`	ჯერ არ არის დაგეგმილი
`todo`	დაგეგმილია მიმდინარე ან შემდეგი სპრინტისთვის
`in_progress`	აქტიურად მუშავდება
`done`	დასრულებული

თითოეულ ამოცანას აქვს პრიორიტეტი (low, medium, high, urgent), არჩევითი ლეიბლები, მინიჭებული პირები (ადამიანი ან ბოტი) და სპრინტის მიბმა. ამოცანები ეკუთვნის პროექტებს, ხოლო პროექტები — სამუშაო სივრცეებს.

სპრინტები

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

მმართველობა

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

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

ამოცანები შეიძლება მინიჭებულ იქნას ბოტ-მომხმარებლებზე და გაიგზავნოს სტრუქტურირებული ამოცანების სახით ხელოვნური ინტელექტის კოდირების აგენტებთან (Codex, Claude Code, OpenCode). სამუშაო პროცესი ამოწმებს მომლოდინე ამოცანებს, აგზავნის მათ ვებჰუკის საშუალებით, ხოლო აგენტი აბრუნებს შედეგებს API-ის საშუალებით. იხილეთ ხელოვნური ინტელექტის ამოცანები სრული სამუშაო პროცესისთვის.

MCP სერვერი

OpenPR აქვეყნებს 34 ინსტრუმენტს Model Context Protocol (MCP) საშუალებით, რაც ხელოვნური ინტელექტის აგენტებს საშუალებას აძლევს მართონ პროექტები, ამოცანები, სპრინტები, ლეიბლები, წინადადებები და სხვა სტანდარტიზებული ინტერფეისის საშუალებით. იხილეთ MCP სერვერი სრული ინსტრუმენტების კატალოგისთვის.

ვებჰუკები

30 ტიპის მოვლენა გაისვრება HMAC-SHA256 ხელმოწერილი HTTP ვებჰუკებით, რომლებიც მოიცავს ამოცანებს, კომენტარებს, ლეიბლებს, სპრინტებს, წინადადებებს, მმართველობას და ხელოვნური ინტელექტის ამოცანების სასიცოცხლო ციკლს. იხილეთ ვებჰუკები მოვლენების ტიპებისა და პეილოადის სტრუქტურისთვის.

შეტყობინებები

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

გვერდები

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

არქიტექტურა

OpenPR შედგება ხუთი სერვისისგან:

სერვისი	პორტი	როლი
api	8080	REST API სერვერი (Axum)
worker	—	ფონური ამოცანების დისპეტჩერი (`ai_tasks` ცხრილის გამოკითხვა)
mcp-server	8090	MCP პროტოკოლის სერვერი (HTTP, stdio, SSE)
frontend	80	ვებ ინტერფეისი (SvelteKit, nginx-ით მოწოდებული)
postgres	5432	PostgreSQL 16 მონაცემთა ბაზა

არჩევითი webhook სერვისი მართავს გამავალ მოვლენების მარშრუტიზაციას და WSS ტუნელის მხარდაჭერას NAT-ის უკან მყოფი აგენტებისთვის.

Frontend (nginx :3000) --> API (:8080) <-- MCP Server (:8090)
                              |
                         PostgreSQL (:5432)
                              |
                         Worker (ფონური)

მონაცემთა ბაზა

OpenPR იყენებს PostgreSQL 16-ს 38 ცხრილით, ორგანიზებული სამ ჯგუფად:

პროექტების მართვის ბირთვი — users, workspaces, workspace_members, projects, work_items, comments, activities, labels, work_item_labels, sprints

მმართველობა — proposals, proposal_templates, proposal_comments, proposal_issue_links, votes, decisions, decision_domains, decision_audit_reports, governance_configs, governance_audit_logs, vetoers, veto_events, appeals, trust_scores, trust_score_logs, impact_reviews, impact_metrics, review_participants, feedback_loop_links

ინფრასტრუქტურა — notifications, webhooks, webhook_deliveries, pages, job_queue, scheduled_jobs, cache_entries, ai_learning_records, ai_participants

მიგრაციები დანომრილია 0001-დან 0019-მდე და ავტომატურად გამოიყენება პირველ გაშვებაზე PostgreSQL-ის docker-entrypoint-initdb.d მექანიზმით.

სწრაფი დაწყება

წინაპირობები

Docker და Docker Compose
Git

გაშლა Docker Compose-ით

git clone https://github.com/openprx/openpr
cd openpr

# დააყენეთ პროდაქშენის JWT საიდუმლო
export JWT_SECRET="your-secure-random-string"

# გაუშვით ყველა სერვისი
docker compose up -d

ეს იწყებს PostgreSQL-ს, უშვებს მიგრაციებს და ამუშავებს API-ს, worker-ს, MCP სერვერს და ფრონტენდს.

წვდომა

ბოლო წერტილი	URL
ვებ ინტერფეისი	`http://localhost:3000`
REST API	`http://localhost:8081`
MCP სერვერი	`http://localhost:8090`

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

გარემოს ცვლადები

ცვლადი	ნაგულისხმევი	აღწერა
`JWT_SECRET`	`change-me-in-production`	JWT ტოკენების ხელმოწერის საიდუმლო
`JWT_ACCESS_TTL_SECONDS`	`2592000` (30 დღე)	წვდომის ტოკენის სიცოცხლის ხანგრძლივობა
`JWT_REFRESH_TTL_SECONDS`	`2592000` (30 დღე)	განახლების ტოკენის სიცოცხლის ხანგრძლივობა
`DATABASE_URL`	(compose-ში დაყენებული)	PostgreSQL კავშირის სტრიქონი
`RUST_LOG`	`info`	ლოგირების დონის ფილტრი
`UPLOAD_DIR`	`/app/uploads`	ფაილების ატვირთვის შენახვის დირექტორია

პროდაქშენის გაშლა

პროდაქშენისთვის განათავსეთ რევერს პროქსი (Caddy, nginx) ფრონტენდის წინ:

# Caddy კონფიგურაციის მაგალითი
your-domain.com {
    reverse_proxy localhost:3000
}

Caddy ავტომატურად უზრუნველყოფს TLS სერტიფიკატებს Let’s Encrypt-ის საშუალებით.

მომხმარებლის მოდელი

OpenPR განასხვავებს ორ ერთეულის ტიპს:

ერთეულის ტიპი	აღწერა
`human`	ჩვეულებრივი მომხმარებელი ელფოსტა/პაროლის ავტორიზაციით
`bot`	ხელოვნური ინტელექტის აგენტი ბოტის ტოკენის ავტორიზაციით (`opr_` პრეფიქსი)

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

რა არის შემდეგი

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