docs: enhance README and CI workflow to clarify Docker image build conditions and Gitea Container Registry usage, including new job flags for OpenAPI and code changes

.gitea/README.md

@@ -2,7 +2,16 @@
 
 В репозитории включён workflow [workflows/ci.yaml](workflows/ci.yaml).
 
-Job **openapi** (Redocly) запускается только если в коммите или PR изменились `docs/openapi.yaml` или `redocly.yaml`; иначе шаг пропускается. Остальные jobs (`go`, `bird2`) выполняются как раньше.
+Job **changes** вычисляет два флага:
+
+- **`openapi`** — в диффе есть `docs/openapi.yaml` или `redocly.yaml` → запускается **openapi** (Redocly lint).
+- **`code`** — в диффе есть **хотя бы один файл вне «только документация»** → запускаются **go**, **bird2** и при push в main/master **docker-images**.
+
+Если изменены **только** файлы из списка ниже, **`code=false`**: Go-тесты, bird2 и сборка образов **не** запускаются; при необходимости всё ещё выполняется **openapi**, если трогали OpenAPI или `redocly.yaml`.
+
+**Список путей «только документация» (без полной сборки):** всё под `docs/`, корневой `README.md`, `web/README.md`, `.gitea/README.md`, `redocly.yaml`.
+
+Любой другой путь (в т.ч. `.gitea/workflows/ci.yaml`, `go.mod`, `web/package.json`, `deploy/**`, `**/*.go`) включает полный пайплайн.
 
 Требования к runner:
 
@@ -56,6 +65,8 @@ git.shts.su/<owner_lowercase>/<имя>:<тег>
 docker pull git.shts.su/myuser/evobgp-api:latest
 ```
 
+Полная таблица образов, тегов, ссылок на страницы пакетов в Gitea и минимальный `docker run` для сервера без сборки — в [docs/quickstart.md](../docs/quickstart.md) (раздел «Готовые образы без сборки»).
+
 Убедитесь, что в **Gitea** включены пакеты (Container Registry) и у токена есть права на создание/обновление образов. Другой хост реестра — правьте **`registry:`** и префикс **`IMG=`** в [ci.yaml](workflows/ci.yaml).
 
 ### Примечания

.gitea/workflows/ci.yaml

@@ -10,43 +10,77 @@ jobs:
   changes:
     runs-on: ubuntu-latest
     outputs:
-      openapi: ${{ steps.openapi.outputs.changed }}
+      openapi: ${{ steps.detect.outputs.openapi }}
+      code: ${{ steps.detect.outputs.code }}
     steps:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
-      - id: openapi
-        name: Detect OpenAPI-related file changes
+      - id: detect
+        name: Detect changed paths (OpenAPI vs doc-only vs code)
         run: |
           set -euo pipefail
-          PATHS="docs/openapi.yaml redocly.yaml"
-          changed=false
+
+          openapi=false
+          code=true
 
           if [ "${{ github.event_name }}" = "pull_request" ]; then
             base="${{ github.event.pull_request.base.sha }}"
             head="${{ github.event.pull_request.head.sha }}"
-            if git diff --name-only "$base" "$head" -- $PATHS | grep -q .; then
-              changed=true
-            fi
+            FILES="$(git diff --name-only "$base" "$head")"
           else
             before="${{ github.event.before }}"
             after="${{ github.sha }}"
             if [ -n "$before" ] && [ "$before" != "0000000000000000000000000000000000000000" ]; then
-              if git diff --name-only "$before" "$after" -- $PATHS | grep -q .; then
-                changed=true
-              fi
+              FILES="$(git diff --name-only "$before" "$after")"
             elif git rev-parse --verify HEAD~1 >/dev/null 2>&1; then
-              if git diff --name-only HEAD~1 HEAD -- $PATHS | grep -q .; then
-                changed=true
-              fi
+              FILES="$(git diff --name-only HEAD~1 HEAD)"
             else
-              # Нет родителя (первый коммит / тонкий clone) — линт OpenAPI выполняем один раз
-              changed=true
+              # Нет родителя (первый коммит / тонкий clone) — полный пайплайн + OpenAPI
+              openapi=true
+              code=true
+              echo "openapi=$openapi" >> "$GITHUB_OUTPUT"
+              echo "code=$code" >> "$GITHUB_OUTPUT"
+              echo "No parent commit: openapi=true code=true"
+              exit 0
             fi
           fi
 
-          echo "changed=$changed" >> "$GITHUB_OUTPUT"
-          echo "OpenAPI lint will run: $changed"
+          # Пустой diff (редко) — не отключаем сборку из осторожности
+          if [ -z "$(printf '%s' "$FILES" | tr -d '[:space:]')" ]; then
+            openapi=false
+            code=true
+            echo "openapi=$openapi" >> "$GITHUB_OUTPUT"
+            echo "code=$code" >> "$GITHUB_OUTPUT"
+            echo "Empty diff: openapi=false code=true"
+            exit 0
+          fi
+
+          if printf '%s\n' "$FILES" | grep -qE '^docs/openapi\.yaml$|^redocly\.yaml$'; then
+            openapi=true
+          fi
+
+          doc_only_all=true
+          while IFS= read -r f || [ -n "${f:-}" ]; do
+            [ -z "${f:-}" ] && continue
+            if [[ "$f" == "README.md" || "$f" == ".gitea/README.md" || "$f" == "web/README.md" || "$f" == "redocly.yaml" || "$f" == docs/* ]]; then
+              continue
+            fi
+            doc_only_all=false
+            break
+          done <<< "$FILES"
+
+          if $doc_only_all; then
+            code=false
+          else
+            code=true
+          fi
+
+          echo "openapi=$openapi" >> "$GITHUB_OUTPUT"
+          echo "code=$code" >> "$GITHUB_OUTPUT"
+          echo "Changed files (first 20):"
+          printf '%s\n' "$FILES" | head -n 20
+          echo "openapi=$openapi code=$code"
 
   openapi:
     needs: [changes]
@@ -61,6 +95,8 @@ jobs:
         run: npx --yes @redocly/cli@1 lint docs/openapi.yaml
 
   go:
+    needs: [changes]
+    if: needs.changes.outputs.code == 'true'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4