name: Update Docker Hub Description

# ==============================================================================
# 🔧 非關鍵流程 - 即使失敗也不影響 Release
# ==============================================================================

env:
  # Docker Hub Repository 名稱（與 GitHub repo 不同）
  DOCKER_IMAGE: convertx/convertx-cn

on:
  push:
    branches:
      - main
    paths:
      - README.md
      - .github/workflows/dockerhub-description.yml
  # 也在 Release 完成後觸發
  workflow_run:
    workflows: ["Release"]
    types:
      - completed

jobs:
  dockerHubDescription:
    runs-on: ubuntu-latest
    # 只在 workflow_run 成功或直接 push 時執行
    if: ${{ github.event_name == 'push' || github.event.workflow_run.conclusion == 'success' }}

    steps:
      - uses: actions/checkout@v4

      - name: Update Docker Hub Description
        # 非關鍵流程 - 失敗不阻擋
        continue-on-error: true
        uses: peter-evans/dockerhub-description@v4
        with:
          username: ${{ secrets.DOCKERHUB_USERNAME }}
          password: ${{ secrets.DOCKERHUB_TOKEN }}
          repository: ${{ env.DOCKER_IMAGE }}
          short-description: ${{ github.event.repository.description }}
          enable-url-completion: true

      - name: Summary
        run: |
          echo "## 📝 Docker Hub Description Update" >> $GITHUB_STEP_SUMMARY
          echo "" >> $GITHUB_STEP_SUMMARY
          echo "Repository: \`${{ env.DOCKER_IMAGE }}\`" >> $GITHUB_STEP_SUMMARY