Merge pull request #25 from Gfermoto/dev

chore(github): Projects bootstrap, CONTRIBUTING

Author: Gfermoto

CHANGELOG.md

@@ -10,6 +10,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ### Added
 
+- **GitHub (репозиторий):** включены Discussions и Issues; метки `area:*`, `priority:*`, `triage`; вехи `v0.2.3`, `Backlog (no milestone)`; приветственная Discussion; скрипт `scripts/github-bootstrap-project.sh` для создания Project v2 после `gh auth refresh -s project`.
 - **CI:** PR workflow builds `app/ui` and runs docs checks (`check-docs-version.py` + `mkdocs build --strict`).
 - **Docs:** interactive OpenAPI (Redoc) pages under `docs/reference/`; nav entries in `mkdocs.yml`.
 - **Community:** issue template `good_first_issue`, Discussions link in issue chooser; ROADMAP / CONTRIBUTING (EN+RU) — public priorities and `good first issue` guidance.

CONTRIBUTING.md

@@ -59,3 +59,14 @@ Look for issues labelled **`good first issue`** — small, scoped tasks for newc
 
 - **Discussions:** https://github.com/Gfermoto/BirdLense-Hub/discussions  
 - **Security:** follow [SECURITY.md](SECURITY.md) — do not report vulnerabilities in public threads.
+
+## GitHub Projects (maintainers)
+
+**Issues**, **Discussions**, and **Projects** are enabled on the repo. Labels `area:*`, `priority:*`, and `triage` support triage; milestones **v0.2.3** and **Backlog (no milestone)** are available.
+
+To create the Kanban project **BirdLense Hub — Roadmap** and link this repository (requires GitHub CLI with `project` scope):
+
+```bash
+gh auth refresh -s project -s read:project
+bash scripts/github-bootstrap-project.sh
+```

CONTRIBUTING.ru.md

@@ -59,3 +59,14 @@ make start
 
 - **Discussions:** https://github.com/Gfermoto/BirdLense-Hub/discussions  
 - **Безопасность:** только по [SECURITY.md](SECURITY.md), не в открытых тредах.
+
+## GitHub Projects (мейнтейнерам)
+
+В репозитории включены **Issues**, **Discussions** и **Projects**. Метки `area:*`, `priority:*`, `triage` и вехи **v0.2.3** / **Backlog (no milestone)** уже заведены.
+
+Создать проект **BirdLense Hub — Roadmap**, привязать репозиторий и поле «Поток» (канбан):
+
+```bash
+gh auth refresh -s project -s read:project
+bash scripts/github-bootstrap-project.sh
+```

scripts/github-bootstrap-project.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+# Создаёт GitHub Project (v2) у владельца, линкует репозиторий BirdLense-Hub,
+# добавляет поле «Поток» (Backlog → … → Done) поверх стандартного Status.
+#
+# Требуется один раз расширить gh-токен:
+#   gh auth refresh -s project -s read:project
+#
+set -euo pipefail
+
+OWNER="${GITHUB_PROJECT_OWNER:-Gfermoto}"
+REPO_FULL="${GITHUB_REPO:-Gfermoto/BirdLense-Hub}"
+PROJECT_TITLE="${GITHUB_PROJECT_TITLE:-BirdLense Hub — Roadmap}"
+
+if ! gh project list --owner "$OWNER" --limit 1 >/dev/null 2>&1; then
+  echo "gh не может читать Projects (нужны scope project / read:project). Выполните:"
+  echo "  gh auth refresh -s project -s read:project"
+  echo "Затем снова запустите этот скрипт."
+  exit 1
+fi
+
+exists_json=$(gh project list --owner "$OWNER" --format json --limit 50)
+proj_num=$(echo "$exists_json" | jq -r --arg t "$PROJECT_TITLE" '.projects[] | select(.title == $t) | .number' | head -1)
+
+if [[ -z "$proj_num" || "$proj_num" == "null" ]]; then
+  echo "Создаю проект «$PROJECT_TITLE»…"
+  create_out=$(gh project create --owner "$OWNER" --title "$PROJECT_TITLE" --format json)
+  proj_num=$(echo "$create_out" | jq -r '.number')
+  echo "Создан проект #$proj_num"
+else
+  echo "Проект «$PROJECT_TITLE» уже есть (#$proj_num)"
+fi
+
+echo "Линкую $REPO_FULL…"
+gh project link "$proj_num" --owner "$OWNER" --repo "$REPO_FULL" 2>/dev/null || true
+
+# Доп. поле для канбана (рядом со стандартным полем Status в Projects)
+echo "Добавляю поле «Поток» (если ещё нет — при дубликате будет ошибка, её можно игнорировать)…"
+gh project field-create "$proj_num" --owner "$OWNER" \
+  --name "Поток" \
+  --data-type "SINGLE_SELECT" \
+  --single-select-options "Backlog,Ready,In progress,In review,Done" 2>/dev/null \
+  || echo "(поле «Поток» уже есть или не удалось создать — проверьте в UI проекта)"
+
+echo
+echo "Готово. Открыть в браузере:"
+gh project view "$proj_num" --owner "$OWNER" --web 2>/dev/null || echo "  gh project view $proj_num --owner $OWNER --web"