name: Deploy Documentation

on:
  push:
    branches:
      - master

jobs:
  build-and-deploy:
    runs-on: docker  # 기본 매핑된 node:20-bookworm 이미지에서 작동
    steps:
      - name: 저장소 체크아웃
        uses: actions/checkout@v4

      # 1. 기존 APT 캐시 복원 (가장 최근 상태 불러오기)
      - name: Restore APT Cache
        id: restore-apt
        uses: actions/cache/restore@v4
        with:
          path: /var/cache/apt/archives
          # 매칭되지 않는 임시 키를 사용하여 항상 restore-keys가 작동하도록 유도
          key: linux-apt-temp 
          restore-keys: |
            linux-apt-

      # 2. 시스템 패키지 설치 및 구버전 찌꺼기 청소
      - name: Install System Packages
        run: |
          # 2-1. 다운로드된 패키지 파일이 지워지지 않도록 docker-clean 무력화
          if [ -f /etc/apt/apt.conf.d/docker-clean ]; then
            echo 'Binary::apt::APT::Keep-Downloaded-Packages "true";' | tee /etc/apt/apt.conf.d/keep-cache
            rm -f /etc/apt/apt.conf.d/docker-clean
          fi
          
          # 2-2. 패키지 업데이트 및 설치
          apt-get update
          apt-get install -y python3 python3-pip python3-venv graphviz
          
          # 2-3. (핵심) 캐시 용량 최적화를 위해 더 이상 안 쓰는 구버전 패키지 파일만 삭제
          apt-get autoclean -y
          
          # 2-4. 다운로드 중단된 임시 파일 삭제 (캐시 오염 방지)
          rm -f /var/cache/apt/archives/partial/*

      # 3. .deb 파일명 목록 기반 고유 해시(Hash) 계산 (내용을 읽지 않아 초고속)
      - name: Calculate APT Cache Hash
        id: apt-hash
        run: |
          # 파일 내용 대신 이름(-printf "%f\n")만 추출하여 해시를 계산합니다.
          # 새 파일이 생기거나 autoclean으로 파일이 지워졌을 때만 해시값이 바뀝니다.
          DEB_HASH=$(find /var/cache/apt/archives -name "*.deb" -type f -printf "%f\n" | sort | md5sum | awk '{print $1}')
          echo "hash=$DEB_HASH" >> $GITHUB_OUTPUT

      # 4. 계산된 해시값을 Key로 캐시 저장
      - name: Save APT Cache
        if: steps.restore-apt.outputs.cache-matched-key != format('linux-apt-{0}', steps.apt-hash.outputs.hash)
        uses: actions/cache/save@v4
        with:
          path: /var/cache/apt/archives
          # 내용물에 변화가 없으면 해시가 동일하므로 업로드를 자동으로 건너뜁니다 (Skip)
          key: linux-apt-${{ steps.apt-hash.outputs.hash }}

      - name: Cache Python Virtual Environment
        id: cache-venv
        uses: actions/cache@v4
        with:
          path: venv
          key: linux-venv-${{ hashFiles('requirements.txt') }}
          restore-keys: |
            linux-venv-

      - name: Install Python Requirements
        if: steps.cache-venv.outputs.cache-hit != 'true'
        run: |
          python3 -m venv venv
          . venv/bin/activate
          pip install -r requirements.txt

      - name: Compile Docs
        run: |
          . venv/bin/activate
          python3 build_docs.py

      - name: gh-pages 브랜치로 site/ 배포
        env:
          # Forgejo Actions 가 자동 주입 — 추가 secret 등록 불필요
          DEPLOY_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          REPO: ${{ github.repository }}
          ACTOR: ${{ github.actor }}
        run: |
          cd site
          git init -b master
          git config user.name "Forgejo Actions Bot"
          git config user.email "actions@1gnis-git.duckdns.org"
          git add .
          git commit -m "Auto-deploy Docs (${GITHUB_SHA::8})"
          SERVER_URL="${{ github.server_url }}"
          HOST_ADDR="${SERVER_URL#*//}"
          PROTO="${SERVER_URL%%//*}"
          git push --force \
            "${PROTO}//${ACTOR}:${DEPLOY_TOKEN}@${HOST_ADDR}/${REPO}.git" \
            master:gh-pages