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

ეს სახელმძღვანელო OpenPR-ის გამართვასა და პირველი სამუშაო სივრცის, პროექტისა და issue-ების შექმნაში გეხმარება. ვარაუდობს, რომ ინსტალაცია უკვე დასრულდა.

ნაბიჯი 1: OpenPR-ის გაშვება

ჯერ სერვისების გაშვება, თუ ეს ჯერ არ გაკეთებულა:

cd openpr
docker-compose up -d

ყველა სერვისის ჯანსაღობის ლოდინი:

docker-compose ps

ნაბიჯი 2: Admin-ანგარიშის რეგისტრაცია

ბრაუზერში http://localhost:3000 გახსენი. Register-ს დააჭირე და ანგარიში შექმენი.

პირველი მომხმარებელი Admin-ია

პირველი დარეგისტრირებული მომხმარებელი ავტომატურად admin-ის როლს იღებს. ეს მომხმარებელი ყველა სამუშაო სივრცეს, პროექტს და სისტემ-პარამეტრებს მართავს.

ნაბიჯი 3: სამუშაო სივრცის შექმნა

შესვლის შემდეგ, პირველი სამუშაო სივრცის შექმნა:

1. Dashboard-ზე Create Workspace-ზე დაჭერა.
2. სახელის შეყვანა (მაგ., "My Team") და slug-ის (მაგ., "my-team").
3. Create-ზე დაჭერა.

სამუშაო სივრცე ყველა პროექტისა და წევრის უმაღლეს-დონიანი კონტეინერია.

ნაბიჯი 4: პროექტის შექმნა

სამუშაო სივრცის შიგნით:

1. New Project-ზე დაჭერა.
2. სახელის შეყვანა (მაგ., "Backend API") და პროექტ-კლუჩის (მაგ., "API"). კლუჩი issue-იდენტიფიკატორ-პრეფიქსად გამოიყენება (მაგ., API-1, API-2).
3. Create-ზე დაჭერა.

ნაბიჯი 5: Issue-ების შექმნა

პროექტში გადასვლა და issue-ების შექმნა:

1. New Issue-ზე დაჭერა.
2. სათაური და აღწერის შეყვანა.
3. სტატუსის დაყენება (backlog, todo, in_progress ან done).
4. სურვილისამებრ პრიორიტეტის (low, medium, high, urgent), პასუხისმგებლის და ეტიკეტების დაყენება.
5. Create-ზე დაჭერა.

Issue-ები API-ის ან MCP სერვერის გავლითაც შეიძლება შეიქმნას:

# Create an issue via REST API
curl -X POST http://localhost:8080/api/projects/<project_id>/issues \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your_token>" \
  -d '{
    "title": "Set up CI pipeline",
    "state": "todo",
    "priority": "high"
  }'

ნაბიჯი 6: Kanban-დაფის გამართვა

პროექტში Board ხედზე გადასვლა. Issue-ები სტატუსის მიხედვით სვეტებად არის დალაგებული:

სვეტი	სტატუსი	აღწერა
Backlog	backlog	იდეები და მომავლის სამუშაო
To Do	todo	მიმდინარე ციკლისთვის დაგეგმილი
In Progress	in_progress	აქტიურად მიმდინარე
Done	done	დასრულებული სამუშაო

სტატუსის განახლებისთვის issue-ები სვეტებს შორის გადათრევა.

ნაბიჯი 7: გუნდ-წევრების მოწვევა

Workspace Settings > Members-ზე გადასვლა:

1. Invite Member-ზე დაჭერა.
2. ელ-ფოსტ-მისამართის შეყვანა.
3. როლის შერჩევა: Owner, Admin ან Member.

როლი	ნებართვები
Owner	სრული წვდომა, სამუშაო სივრცის წაშლა
Admin	პროექტების, წევრების, პარამეტრების მართვა
Member	Issue-ების, კომენტარების შექმნა და მართვა

ნაბიჯი 8: AI ასისტენტების დაკავშირება (სურვილისამებრ)

MCP სერვერის გამართვა AI ასისტენტებისთვის, რომ პროექტები მართონ:

1. Workspace Settings > Bot Tokens-ზე გადასვლა.
2. ახალი ბოტ-ტოკენის შექმნა. მას opr_ პრეფიქსი ექნება.
3. AI ასისტენტის ტოკენით კონფიგურაცია.

Claude Desktop-ის კონფ-მაგალითი:

{
  "mcpServers": {
    "openpr": {
      "command": "/path/to/mcp-server",
      "args": ["--transport", "stdio"],
      "env": {
        "OPENPR_API_URL": "http://localhost:3000",
        "OPENPR_BOT_TOKEN": "opr_your_token_here",
        "OPENPR_WORKSPACE_ID": "your-workspace-uuid"
      }
    }
  }
}

AI ასისტენტს ახლა 34 MCP ინსტრუმენტის გავლით პროექტების ჩამოთვლა, issue-ების შექმნა, sprint-ების მართვა და სხვა შეუძლია.

შემდეგი ნაბიჯები

• სამუშაო სივრც-მართვა -- სამუშაო სივრც-ორგანიზაციისა და წევრ-როლების შესახებ
• Issues & სამუშაო ნაკადი -- issue-თვალყურისა და სტატუს-მართვის სიღრმე
• Sprint-დაგეგმვა -- sprint-ციკლების გამართვა
• მმართველობის ცენტრი -- წინადადებების, ხმა-მიცემისა და ნდობ-ქულების ჩართვა
• API ცნობარი -- გარე ინსტრუმენტებთან ინტეგრაცია
• MCP სერვერი -- AI ასისტენტებისთვის სრული MCP ინსტრუმენტ-ცნობარი