Быстрый старт

Это руководство проведёт вас через настройку OpenPR и создание первого рабочего пространства, проекта и задач. Предполагается, что вы уже выполнили установку.

Шаг 1: Запустите OpenPR

Если вы ещё не запустили сервисы:

cd openpr
docker-compose up -d

Дождитесь, пока все сервисы не станут здоровыми:

docker-compose ps

Шаг 2: Зарегистрируйте аккаунт администратора

Откройте http://localhost:3000 в браузере. Нажмите Register и создайте аккаунт.

Первый пользователь — администратор

Первый зарегистрированный пользователь автоматически получает роль admin. Этот пользователь может управлять всеми рабочими пространствами, проектами и системными настройками.

Шаг 3: Создайте рабочее пространство

После входа создайте первое рабочее пространство:

1. Нажмите Create Workspace на дашборде.
2. Введите название (например, "My Team") и slug (например, "my-team").
3. Нажмите Create.

Рабочее пространство — это контейнер верхнего уровня для всех ваших проектов и участников.

Шаг 4: Создайте проект

Внутри рабочего пространства:

1. Нажмите New Project.
2. Введите название (например, "Backend API") и ключ проекта (например, "API"). Ключ используется как префикс для идентификаторов задач (например, API-1, API-2).
3. Нажмите Create.

Шаг 5: Создайте задачи

Перейдите в ваш проект и создайте задачи:

1. Нажмите New Issue.
2. Введите название и описание.
3. Установите состояние (backlog, todo, in_progress или done).
4. Опционально установите приоритет (low, medium, high, urgent), исполнителя и метки.
5. Нажмите Create.

Задачи также можно создавать через API или MCP-сервер:

# Создать задачу через 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 в вашем проекте. Задачи организованы в колонки по состоянию:

Колонка	Состояние	Описание
Backlog	backlog	Идеи и будущая работа
To Do	todo	Запланировано на текущий цикл
In Progress	in_progress	Активно выполняется
Done	done	Выполненная работа

Перетаскивайте задачи между колонками для обновления их состояния.

Шаг 7: Пригласите участников команды

Перейдите в Workspace Settings > Members:

1. Нажмите Invite Member.
2. Введите адрес электронной почты.
3. Выберите роль: Owner, Admin или Member.

Роль	Разрешения
Owner	Полный доступ, может удалять рабочее пространство
Admin	Управление проектами, участниками, настройками
Member	Создание и управление задачами, комментариями

Шаг 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-инструмента.

Что дальше?

• Управление рабочим пространством — узнайте об организации рабочего пространства и ролях участников
• Задачи и рабочий процесс — подробное изучение отслеживания задач и управления состояниями
• Планирование спринтов — настройка циклов спринтов
• Центр управления — включите предложения, голосование и оценки доверия
• Справочник API — интеграция с внешними инструментами
• MCP-сервер — полный справочник инструментов MCP для AI-ассистентов