OpenPR
OpenPR არის ღია კოდის პროექტ-მართვის პლატფორმა, შექმნილი გამჭვირვალე მმართველობის, AI-ასისტირებული სამუშაო ნაკადებისა და პროექტ-მონაცემებზე სრული კონტროლის მოთხოვნილი გუნდებისთვის. ის issue-თვალყური, sprint-დაგეგმვა, kanban-დაფები და სრული მმართველობის ცენტრი -- წინადადებები, ხმა-მიცემა, ნდობ-ქულები, ვეტო-მექანიზმები -- ერთ თვით-ჰოსტ-პლატფორმაში აერთიანებს.
OpenPR Rust-ზე (Axum + SeaORM) backend-ისა და SvelteKit-ის frontend-ის გამოყენებით, PostgreSQL-ის გამოყენებით. ის REST API-სა და ჩაშენებულ MCP სერვერს სამ სატრანსპორტო პროტოკოლზე 34 ინსტრუმენტით ამოქმედებს, AI ასისტენტებისთვის, მათ შორის Claude, Codex და სხვა MCP-თავსებადი კლიენტებისთვის, პირველ-კლასიანი ინსტრუმენტ-მომწოდებელია.
რატომ OpenPR?
პროექტ-მართვის ინსტრუმენტების უმეტესობა ან დახურული-კოდის SaaS პლატფორმებია შეზღუდული კასტომიზაციით, ან ღია-კოდის ალტერნატივები მმართველობ-ფუნქციის გარეშე. OpenPR სხვა მიდგომას იღებს:
- თვით-ჰოსტ და აუდიტ-საყვედური. პროექტ-მონაცემები შენს ინფრასტრუქტურაზე რჩება. ყველა ფუნქცია, ყველა გადაწყვეტილებ-ჩანაწერი, ყველა აუდიტ-ლოგი შენი კონტროლის ქვეშ.
- ჩაშენებული მმართველობა. წინადადებები, ხმა-მიცემა, ნდობ-ქულები, ვეტო-ძალა და ესკალაცია არ არის შემდგომი ფიქრი -- ისინი სრული API მხარდაჭერის მქონე ძირითადი მოდულებია.
- AI-ნეიტიური. ჩაშენებული MCP სერვერი OpenPR-ს AI აგენტებისთვის ინსტრუმენტ-მომწოდებლად გარდაქმნის. ბოტ-ტოკენები, AI-ამოცან-მინიჭება და webhook-გამოძახება სრულად ავტომატური სამუშაო ნაკადების შესაძლებელს ხდის.
- Rust-შესრულება. Backend ათასობით ერთდროულ მოთხოვნას მინიმალური რესურს-მოხმარებით ამუშავებს. PostgreSQL-ის სრული-ტექსტ-ძებნა ყველა ერთეულში მყისიერ ძებნას უზრუნველყოფს.
ძირითადი ფუნქციები
| კატეგორია | ფუნქციები |
|---|---|
| პროექტ-მართვა | სამუშაო სივრცეები, პროექტები, issue-ები, kanban-დაფა, sprint-ები, ეტიკეტები, კომენტარები, ფაილ-დანართები, საქმიანობ-feed, შეტყობინებები, სრული-ტექსტ-ძებნა |
| მმართველობის ცენტრი | წინადადებები, კვორუმ-ხმა-მიცემა, გადაწყვეტილებ-ჩანაწერები, ვეტო და ესკალაცია, ნდობ-ქულები ისტორიითა და გასაჩივრებით, წინადადებ-შაბლონები, გავლენ-მიმოხილვები, აუდიტ-ლოგები |
| AI ინტეგრაცია | ბოტ-ტოკენები (opr_ პრეფიქსი), AI-აგენტ-რეგისტრაცია, AI-ამოცან-მინიჭება პროგრეს-თვალყურით, AI-მიმოხილვა წინადადებებზე, MCP სერვერი (34 ინსტრუმენტი, 3 სატრანსპორტო), webhook-გამოძახება |
| ავთენტიფიკაცია | JWT (access + refresh ტოკენები), ბოტ-ტოკენ-ავთენტიფიკაცია, როლ-დაფუძნებული წვდომა (admin/user), სამუშაო სივრც-სკოპ-ნებართვები (owner/admin/member) |
| განასახება | Docker Compose, Podman, Caddy/Nginx reverse proxy, PostgreSQL 15+ |
არქიტექტურა
graph TB
subgraph Client["Clients"]
BROWSER["Browser<br/>SvelteKit Frontend"]
AI["AI Assistants<br/>Claude / Codex / Cursor"]
CLI["CLI / Scripts<br/>curl / custom tools"]
end
subgraph Frontend["Frontend (Port 3000)"]
SVELTE["SvelteKit + TailwindCSS<br/>shadcn-svelte"]
end
subgraph Backend["Backend Services"]
API["API Server (Port 8080)<br/>Rust · Axum · SeaORM"]
MCP["MCP Server (Port 8090)<br/>HTTP · stdio · SSE"]
WORKER["Worker<br/>Background Tasks"]
end
subgraph Data["Data Layer"]
PG["PostgreSQL 16<br/>38 Tables · FTS"]
FS["File Storage<br/>Uploads Directory"]
end
BROWSER --> SVELTE
AI --> MCP
CLI --> API
SVELTE --> API
MCP --> API
WORKER --> PG
API --> PG
API --> FSტექ-სტეკი
| ფენა | ტექნოლოგია |
|---|---|
| Backend | Rust, Axum, SeaORM, PostgreSQL |
| Frontend | SvelteKit, TailwindCSS, shadcn-svelte |
| MCP | JSON-RPC 2.0 (HTTP + stdio + SSE) |
| Auth | JWT (access + refresh) + Bot Tokens (opr_) |
| განასახება | Docker Compose, Podman, Caddy, Nginx |
სწრაფი დაწყება
git clone https://github.com/openprx/openpr.git
cd openpr
cp .env.example .env
docker-compose up -dსერვისები იწყება:
- Frontend: http://localhost:3000
- API: http://localhost:8080
- MCP სერვერი: http://localhost:8090
პირველი დარეგისტრირებული მომხმარებელი ავტომატურად admin-ი ხდება.
სრული განასახებ-მეთოდებისთვის იხ. ინსტალაციის სახელმძღვანელო, ან სწრაფი დაწყება 5 წუთში გასაშვებად.
დოკ-სექციები
| სექცია | აღწერა |
|---|---|
| ინსტალაცია | Docker Compose, source-build და განასახებ-ვარიანტები |
| სწრაფი დაწყება | OpenPR-ის 5 წუთში გაშვება |
| სამუშაო სივრც-მართვა | სამუშაო სივრცეები, პროექტები და წევრ-როლები |
| Issues & თვალყური | Issue-ები, სამუშაო ნაკად-სტატუსები, sprint-ები და ეტიკეტები |
| მმართველობის ცენტრი | წინადადებები, ხმა-მიცემა, გადაწყვეტილებები და ნდობ-ქულები |
| REST API | ავთენტიფიკაცია, endpoint-ები და პასუხ-ფორმატები |
| MCP სერვერი | AI ინტეგრაცია 34 ინსტრუმენტით და 3 სატრანსპორტო პროტოკოლით |
| კონფიგურაცია | გარემო-ცვლადები და პარამეტრები |
| განასახება | Docker და წარმოებ-განასახებ-სახელმძღვანელოები |
| პრობლემ-მოგვარება | გავრცელებული პრობლემები და გადაწყვეტები |
მასთან დაკავშირებული პროექტები
| საცავი | აღწერა |
|---|---|
| openpr | ძირითადი პლატფორმა (ეს პროექტი) |
| openpr-webhook | Webhook-მიმღები გარე ინტეგრაციებისთვის |
| prx | AI ასისტენტ-ფრეიმვორკი ჩაშენებული OpenPR MCP-ით |
| prx-memory | ლოკალ-first MCP მეხსიერება კოდ-აგენტებისთვის |
პროექტ-ინფო
- ლიცენზია: MIT OR Apache-2.0
- ენა: Rust (2024 edition)
- საცავი: github.com/openprx/openpr
- მინიმ. Rust: 1.75.0
- Frontend: SvelteKit