ci: add Docker image auto-build and publish workflow

- Add .github/workflows/docker.yml for automatic Docker image building
- Publish images to GitHub Container Registry (ghcr.io)
- Images tagged with: latest, main branch, and commit SHA
- Update README.md with Docker image instructions:
  - Recommend using pre-built image (ghcr.io/tkavelli/reezonly-space-openapi:latest)
  - Provide local build alternative
  - Document CI/CD pipelines (pages.yml + docker.yml)
  - Add GitHub Actions status check links

Now users can:
1. Pull ready-to-use Docker image: docker pull ghcr.io/tkavelli/reezonly-space-openapi:latest
2. Or build locally: docker build -t reezonly-space-openapi .

Every push to main triggers:
- GitHub Pages deployment (documentation)
- Docker image build and push to ghcr.io

Author: tkavelli

.github/workflows/docker.yml

@@ -0,0 +1,49 @@
+name: Build and Push Docker Image
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/${{ github.repository }}
+          tags: |
+            type=ref,event=branch
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=sha
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

README.md

@@ -6,7 +6,19 @@
 
 ## Быстрый старт (Docker)
 
-Самый простой способ поднять проект локально:
+### Вариант 1: Готовый образ (рекомендуется)
+
+Образ автоматически собирается при каждом push в main:
+
+```bash
+# запуск контейнера на порту 3000 с готовым образом из GitHub Container Registry
+docker run -p 3000:80 ghcr.io/tkavelli/reezonly-space-openapi:latest
+
+# открыть в браузере
+open http://localhost:3000
+```
+
+### Вариант 2: Собрать образ локально
 
 ```bash
 # сборка образа
@@ -164,30 +176,51 @@ reezonly-space-openapi/
 
 ## Docker
 
-### Собрать образ
+### Использовать готовый образ (рекомендуется)
+
+Образ автоматически собирается в GitHub Actions при каждом push:
 
 ```bash
-docker build -t reezonly-space-openapi .
-```
+# запустить готовый образ с Docker Hub
+docker run -d -p 3000:80 --name space-api ghcr.io/tkavelli/reezonly-space-openapi:latest
 
-### Запустить контейнер
+# проверить логи
+docker logs -f space-api
 
-```bash
-docker run -d -p 3000:80 --name space-api reezonly-space-openapi
+# остановить контейнер
+docker stop space-api && docker rm space-api
 ```
 
-### Проверить логи
+### Собрать образ локально
 
 ```bash
+# собрать образ
+docker build -t reezonly-space-openapi .
+
+# запустить контейнер
+docker run -d -p 3000:80 --name space-api reezonly-space-openapi
+
+# проверить логи
 docker logs -f space-api
+
+# остановить контейнер
+docker stop space-api && docker rm space-api
 ```
 
-### Остановить контейнер
+### Доступные образы
+
+При каждом push в `main` GitHub Actions автоматически собирает и публикует образ:
+- `ghcr.io/tkavelli/reezonly-space-openapi:latest` — последняя версия из main
+- `ghcr.io/tkavelli/reezonly-space-openapi:main` — текущий branch
+- `ghcr.io/tkavelli/reezonly-space-openapi:sha-<commit>` — конкретный коммит
 
+Скачать образ:
 ```bash
-docker stop space-api && docker rm space-api
+docker pull ghcr.io/tkavelli/reezonly-space-openapi:latest
 ```
 
+Проверить статус сборки: https://github.com/tkavelli/reezonly-space-openapi/actions
+
 ---
 
 ## Дополнительная документация
@@ -198,15 +231,29 @@ docker stop space-api && docker rm space-api
 
 ---
 
-## Continuous Integration (GitHub Pages)
+## Continuous Integration (CI/CD)
+
+### GitHub Pages (pages.yml)
+
+При push в `main`:
+1. Восстанавливает зависимости: `npm ci && npm ci --prefix tools`
+2. Генерирует документацию: `npm run build-docs`
+3. Деплоит в GitHub Pages: https://tkavelli.github.io/reezonly-space-openapi
+
+### Docker Image (docker.yml)
 
 При push в `main`:
-1. GitHub Actions запускает `.github/workflows/pages.yml`
-2. Восстанавливает зависимости: `npm ci && npm ci --prefix tools`
-3. Генерирует документацию: `npm run build-docs`
-4. Деплоит в GitHub Pages: https://tkavelli.github.io/reezonly-space-openapi
+1. Собирает Docker образ
+2. Публикует в GitHub Container Registry (ghcr.io)
+3. Доступен на: `ghcr.io/tkavelli/reezonly-space-openapi:latest`
 
-Проверить статус: https://github.com/tkavelli/reezonly-space-openapi/actions
+### Проверить статус
+
+Все workflows: https://github.com/tkavelli/reezonly-space-openapi/actions
+
+Что происходит:
+- `pages.yml` — деплой на GitHub Pages (через nginx в докере)
+- `docker.yml` — сборка и публикация Docker образа
 
 ---