# 동백쉴만한교회 CMS — 로컬 개발환경 및 신규 운영 서버 구축·배포 가이드

> 문서 버전: 0.1 / 2026-10-12  
> 대상 저장소: https://github.com/GilbertMoon/dbresting-website  
> 서비스 도메인: https://dbresting.com / https://www.dbresting.com  
> 상태: **실행 가이드 초안**. 현재 저장소는 요구사항 중심으로, Django 소스·Dockerfile·Compose·CI/CD workflow는 아직 구현되지 않았다. 아래 일부 명령은 해당 파일이 생성된 뒤에만 실행 가능하다. **이 문서를 추가하는 행위가 서버 배포를 수행하는 것은 아니다.**

## 1. 목표와 배포 방식

목표: 신규 Cafe24 Linux VPS에서 먼저 HTTP/HTTPS 및 임시 페이지를 확인하고, 이후 Django + Wagtail + PostgreSQL을 배포하여 /admin/ 로그인과 주보·메뉴 CMS 기능을 점진적으로 검증한다.

권장 구성:
- 로컬: Windows 11, PowerShell, Git, VS Code, Python 3.12, Python venv, PostgreSQL 16, Node.js(프런트 빌드가 필요한 경우만).
- 운영: Ubuntu Server 24.04 LTS, Docker Engine + Docker Compose plugin, Nginx(호스트), Certbot, Django/Gunicorn 컨테이너, PostgreSQL 컨테이너, 볼륨 기반 미디어/DB 데이터.
- CMS: Django + Wagtail(최종 PoC 승인 전 후보), PDF: WeasyPrint(별도 검증).
- 배포: GitHub Actions에서 테스트, 운영 서버는 제한된 SSH 배포 계정으로 pull/build/up; 운영 DB 마이그레이션은 사전 백업 및 승인 절차 후 수행.
- 운영·개발 환경 비밀키와 DB를 절대 공유하지 않는다.

**전제 확인**: 서버 공인 IPv4, Cafe24 계정/SSH 접속 권한, 도메인 DNS 관리 권한, GitHub 비공개 저장소 접근 수단, 관리자 이메일, 서버 방화벽 포트 22/80/443, 운영 서비스 백업 대상 확보.

## 2. 작업 체크포인트

| 단계 | 완료 기준 |
|---|---|
| A 서버 | SSH 접속, Ubuntu 버전·디스크·시간 확인 |
| B DNS | dbresting.com/www가 서버 공인 IP로 조회 |
| C HTTP | http://dbresting.com/ 에서 임시 페이지 표시 |
| D HTTPS | 유효한 TLS 인증서로 https://dbresting.com/ 접속 |
| E 로컬 | Python venv, DB 연결, Django 개발 서버 실행 |
| F 앱 | Wagtail /admin/ 및 기본 페이지 실행 |
| G 운영 | Gunicorn 컨테이너, DB, Nginx 연동 |
| H CI/CD | 테스트 PASS, 승인된 배포, HTTPS 확인 |
| I 운영 | 백업·복구·로그·인증서 갱신 검증 |

각 단계의 정상 결과를 확인하기 전 다음 단계로 넘어가지 않는다.

## 3. Cafe24 신규 VPS 준비

### 3.1 서버 생성 시 선택
1. Cafe24에서 **Linux VPS**를 생성한다. Ubuntu 24.04 LTS가 선택 가능하면 **OS만 설치**(PHP/APM 묶음 불필요).
2. 초기 권장: 2 vCPU, RAM 4GB 이상, SSD 40GB 이상. 실제 사양은 사용량에 맞춰 조정한다.
3. 공인 IPv4, SSH 접속 포트, 관리자 계정, 초기 비밀번호 또는 SSH 키를 확인한다.
4. Cafe24 관리 패널의 방화벽/보안 그룹에서 **TCP 22(관리 IP만), 80, 443** 허용. DB 5432와 Gunicorn 8000은 외부에 공개하지 않는다.
5. 서버 공인 IP는 아래 문서에서 `SERVER_IP`로 표기한다. 실제 IP를 GitHub 문서에 기록하지 않아도 된다.
6. Ubuntu 제공 여부, VPS 콘솔, 기본 사용자명, 방화벽 UI는 Cafe24 상품별로 다를 수 있으므로 실제 패널에서 확인한다.

### 3.2 Windows PowerShell에서 접속
```powershell
ssh <SERVER_USER>@<SERVER_IP>
```
첫 연결 시 서버 호스트키 지문을 Cafe24 콘솔/별도 안전한 경로와 대조한 후 승인한다.

서버에서:
```bash
cat /etc/os-release
uname -a
df -h
free -h
timedatectl
```
정상 결과: Ubuntu 24.04 계열, 디스크/메모리 확인, 시간 동기화 활성.

### 3.3 OS 업데이트 및 기본 보안
```bash
sudo apt update
sudo apt upgrade -y
sudo apt install -y git curl ca-certificates gnupg ufw nginx certbot python3-certbot-nginx
sudo systemctl enable --now nginx
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status verbose
```
**주의:** SSH가 22가 아닌 사용자 지정 포트면 `OpenSSH` 대신 실제 포트를 먼저 허용한다. UFW 활성화 전 **두 번째 SSH 세션으로 재접속 가능 여부**를 확인한다. Cafe24 외부 방화벽과 OS 방화벽을 모두 점검한다.

관리자 계정의 SSH 키 인증, 비밀번호 로그인 제한, root 직접 로그인 제한은 키 접속이 검증된 뒤 단계적으로 적용한다. 자동화 배포용 계정은 최소 권한으로 별도 생성한다.

## 4. 도메인 DNS 연결

### 4.1 DNS 관리 화면
도메인을 구매·관리하는 서비스의 DNS 레코드 편집 화면으로 이동한다. Cafe24에서 구매했더라도 네임서버가 다른 곳이면 **실제 권한 있는 DNS 제공자**에서 수정한다.

권장 레코드(예시):
| 타입 | 호스트 | 값 | 비고 |
|---|---|---|---|
| A | @ | `<SERVER_IP>` | 루트 도메인 |
| CNAME | www | `dbresting.com` | www 별칭 |
| AAAA | @/www | 미설정 또는 **실제 작동하는 IPv6** | 오래된 AAAA 레코드 주의 |

기존 웹서비스·메일 레코드(MX/TXT/SPF/DKIM/DMARC)는 함부로 삭제하지 않는다. Cloudflare 등 프록시가 있다면 인증서 발급 전에 DNS-only 또는 적절한 검증 방식을 검토한다.

### 4.2 Windows에서 확인
```powershell
nslookup dbresting.com
nslookup www.dbresting.com
Resolve-DnsName dbresting.com -Type A
Resolve-DnsName dbresting.com -Type AAAA
```
정상 결과: A 레코드가 운영 VPS 공인 IP로 연결되고, 유효하지 않은 AAAA 레코드가 없다. DNS 전파는 TTL·캐시에 따라 지연될 수 있다.

## 5. HTTP 임시 페이지 배포 — 애플리케이션 없어도 즉시 검증

서버에서:
```bash
sudo mkdir -p /var/www/dbresting-bootstrap
echo '<!doctype html><html lang="ko"><meta charset="utf-8"><title>동백쉴만한교회</title><body><h1>동백쉴만한교회</h1><p>서버 연결 테스트 성공</p></body></html>' | sudo tee /var/www/dbresting-bootstrap/index.html >/dev/null
sudo tee /etc/nginx/sites-available/dbresting.conf >/dev/null <<'EOF'
server {
    listen 80;
    server_name dbresting.com www.dbresting.com;
    root /var/www/dbresting-bootstrap;
    index index.html;
    location / { try_files $uri $uri/ =404; }
}
EOF
sudo ln -s /etc/nginx/sites-available/dbresting.conf /etc/nginx/sites-enabled/dbresting.conf
sudo nginx -t
sudo systemctl reload nginx
```
`sites-enabled/dbresting.conf`가 이미 존재하면 symlink 명령은 건너뛴다. 기본 사이트가 혼동을 주면 해당 서버에서 기본 Nginx 설정의 우선순위를 점검한다.

Windows에서:
```powershell
curl.exe -I http://dbresting.com/
```
정상 결과: `HTTP/1.1 200 OK`; 브라우저에 **서버 연결 테스트 성공** 표시.

실패 시: `sudo systemctl status nginx`, `sudo journalctl -u nginx -n 50 --no-pager`, DNS, Cafe24 방화벽, UFW 확인.

## 6. 무료 TLS 인증서 발급 및 자동 갱신

**사전 조건:** 80/443 포트 외부 접속 가능, 루트/www DNS 모두 정상, Nginx HTTP 임시 페이지 동작.

```bash
sudo certbot --nginx -d dbresting.com -d www.dbresting.com --redirect
```
Certbot 프롬프트에서 실제 운영 관리자 이메일을 입력하고 약관을 확인한다. 두 도메인 모두 DNS가 연결되지 않았다면 **www를 포함하지 않고 루트만 먼저 발급**한 뒤 나중에 확장한다.

검증:
```bash
sudo nginx -t
sudo systemctl reload nginx
sudo certbot certificates
sudo certbot renew --dry-run
curl -I https://dbresting.com/
curl -I https://www.dbresting.com/
```
정상 결과: 브라우저 자물쇠/유효한 인증서, HTTPS 200, HTTP는 HTTPS로 리다이렉트. www를 루트로 통일할지는 별도 Nginx 리다이렉트 정책으로 확정한다.

인증서 자동 갱신 타이머:
```bash
systemctl list-timers | grep -i certbot
```
갱신 방식은 패키지/OS에 따라 timer 또는 cron일 수 있다. `renew --dry-run`이 성공해야 한다. 포트 80 차단 시 HTTP-01 갱신이 실패할 수 있다.

## 7. Windows 로컬 개발환경

### 7.1 필수 설치
- Git for Windows: https://git-scm.com/downloads/win
- Python 3.12: https://www.python.org/downloads/
- VS Code: https://code.visualstudio.com/
- PostgreSQL: https://www.postgresql.org/download/windows/
- (선택) Docker Desktop: https://www.docker.com/products/docker-desktop/

PowerShell:
```powershell
git --version
py -3.12 --version
code --version
psql --version
```
`psql` 명령을 찾지 못하면 PostgreSQL 설치 경로의 bin을 PATH에 추가하거나 pgAdmin에서 접속 테스트한다.

### 7.2 저장소 복제 및 가상환경
```powershell
mkdir C:\DEV -ErrorAction SilentlyContinue
cd C:\DEV
git clone https://github.com/GilbertMoon/dbresting-website.git
cd dbresting-website
py -3.12 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
```
PowerShell 정책상 활성화가 차단되면 정책을 임의로 시스템 전체에 변경하지 말고 `.\.venv\Scripts\python.exe`를 직접 실행할 수 있다. 필요 시 조직 보안정책 확인 후 CurrentUser 범위에서만 변경한다.

### 7.3 Django/Wagtail 초기 프로젝트 생성 — **소스 생성 전용**
**현재 저장소에는 Django 프로젝트 코드가 아직 없다.** 아래 명령은 별도 기능 구현 단계에서 실행하고, 사용 버전의 Django/Wagtail 호환성을 검증한 뒤 requirements 파일에 버전을 고정한다.

```powershell
python -m pip install "Django>=5.2,<6" wagtail "psycopg[binary]" python-dotenv gunicorn
python -m wagtail start config .
```
`wagtail start` 명령의 설치 버전별 사용법을 확인하고 기존 파일 덮어쓰기 여부를 먼저 점검한다. **위 명령은 초기 스캐폴딩 예시이지, 완성된 교회 CMS가 아니다.** 운영 배포 전 의존성 버전을 lock하고 개발/운영 requirements를 정리한다. Windows에서 Gunicorn은 실행하지 않고 `runserver`를 사용한다. WeasyPrint는 Windows에서 별도 네이티브 라이브러리가 필요할 수 있어 PDF 테스트는 Docker/Linux 환경에서 우선 검증한다.

### 7.4 로컬 PostgreSQL
PostgreSQL 관리 계정으로:
```sql
CREATE ROLE dbresting_dev LOGIN PASSWORD 'CHANGE_TO_STRONG_LOCAL_PASSWORD';
CREATE DATABASE dbresting_dev OWNER dbresting_dev ENCODING 'UTF8';
```
실제 비밀번호를 문서나 Git에 올리지 않는다.

예시 `.env.local` (**Git에 커밋 금지**):
```dotenv
DJANGO_DEBUG=True
DJANGO_SECRET_KEY=GENERATE_UNIQUE_LOCAL_SECRET
DJANGO_ALLOWED_HOSTS=127.0.0.1,localhost
DATABASE_URL=postgresql://dbresting_dev:URL_ENCODED_PASSWORD@127.0.0.1:5432/dbresting_dev
```
주의: 위 환경변수는 **권장 계약 예시**다. Django settings에서 직접 파싱하거나 `django-environ` 등으로 연결하는 코드를 구현해야 한다. 특수문자가 있는 DB 비밀번호는 URL 인코딩이 필요하다.

Django 설정 및 모델 구현 후:
```powershell
python manage.py check
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver 127.0.0.1:8000
```
정상 결과: http://127.0.0.1:8000/ 및 /admin/ 접속. **이 명령들은 manage.py가 실제 생성된 뒤에만 동작한다.**

## 8. 운영 Docker 설치

서버에서 Docker 공식 Ubuntu 저장소 설치 절차(https://docs.docker.com/engine/install/ubuntu/)를 따른다. 배포 시점에 최신 명령을 공식 문서에서 재확인한다.

```bash
sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo ${UBUNTU_CODENAME:-$VERSION_CODENAME}) stable" | sudo tee /etc/apt/sources.list.d/docker.list >/dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker
sudo docker version
sudo docker compose version
```
주의: Docker 그룹 가입은 사실상 root 권한을 주므로 무분별하게 부여하지 않는다. Docker가 방화벽 규칙에 영향을 줄 수 있으므로 앱/DB 컨테이너 포트를 공인 인터페이스에 publish하지 않는다.

## 9. 운영 애플리케이션 배포 준비

### 9.1 디렉터리
```bash
sudo mkdir -p /opt/dbresting /var/backups/dbresting
sudo chown <DEPLOY_USER>:<DEPLOY_GROUP> /opt/dbresting
```
`<DEPLOY_USER>`, `<DEPLOY_GROUP>`는 실제 최소 권한 배포 계정/그룹으로 치환한다.

### 9.2 비공개 GitHub 저장소 접근
- 서버에 전용 **읽기 전용 Deploy Key** 생성 후 GitHub 저장소의 Settings → Deploy keys에 등록.
- 서버 SSH 호스트키와 GitHub 호스트키 지문을 검증한 뒤 연결.
- 배포 계정으로 `git clone git@github.com:GilbertMoon/dbresting-website.git /opt/dbresting`.
- 개인 PAT를 서버의 shell history/스크립트에 하드코딩하지 않는다.

### 9.3 운영 .env (서버에만)
예시 경로 `/opt/dbresting/.env.production`:
```dotenv
DJANGO_DEBUG=False
DJANGO_SECRET_KEY=GENERATE_UNIQUE_PRODUCTION_SECRET
DJANGO_ALLOWED_HOSTS=dbresting.com,www.dbresting.com
DJANGO_CSRF_TRUSTED_ORIGINS=https://dbresting.com,https://www.dbresting.com
POSTGRES_DB=dbresting
POSTGRES_USER=dbresting
POSTGRES_PASSWORD=GENERATE_STRONG_DB_PASSWORD
DATABASE_URL=postgresql://dbresting:URL_ENCODED_PASSWORD@db:5432/dbresting
```
`chmod 600 /opt/dbresting/.env.production` 적용. GitHub Secrets/Actions 로그에 실제 값을 출력하지 않는다. 위 값은 **Django settings 및 Compose와 동일한 계약으로 구현해야만 적용**된다.

### 9.4 필요한 배포 파일 — **아직 구현 전**
저장소에 다음 파일을 추가해야 한다:
- `Dockerfile`: Python 3.12 기반, OS 패키지(WeasyPrint 의존성), pinned dependencies, non-root 사용자, Gunicorn.
- `compose.prod.yml`: `web`(Gunicorn) + `db`(PostgreSQL), DB healthcheck, 데이터/미디어 볼륨, 내부 네트워크, 재시작 정책.
- `config/settings/production.py` 또는 동등 설정: DEBUG=False, ALLOWED_HOSTS, DB, STATIC_ROOT, MEDIA_ROOT, HTTPS proxy 헤더 신뢰 범위, 보안 쿠키, 로깅.
- `requirements*.txt` 또는 lockfile, `.env.example`, `.gitignore`.
- `/health/` 또는 동등 헬스체크 엔드포인트(비밀·DB 상세정보 노출 금지).
- `.github/workflows/ci.yml`, 승인형 `deploy.yml`.
- Wagtail CMS 메뉴/페이지 타입과 주보 모듈은 별도 개발.

**이 파일들이 없는 현재 상태에서 `docker compose up` 또는 운영 마이그레이션을 실행하지 않는다.**

### 9.5 컨테이너/호스트 연결 정책
- DB `5432`: 외부 노출 금지.
- Gunicorn `8000`: 호스트의 **127.0.0.1:8000**에만 바인딩하거나 Unix socket 이용.
- Nginx: 외부 80/443, 내부 `proxy_pass http://127.0.0.1:8000;`.
- 미디어·정적파일: 컨테이너와 Nginx 간 공유 볼륨 및 권한을 설계; 배포 때 `collectstatic`.
- PDF 생성 파일: 영속 볼륨 또는 별도 스토리지, 백업/접근 정책 수립.

### 9.6 앱 배포 후 Nginx 전환
**7절 임시 페이지 + HTTPS 검증이 끝나고 앱이 로컬 127.0.0.1:8000에서 응답할 때만** 기존 HTTPS server 블록의 `location /`를 다음과 같이 변경한다:
```nginx
location / {
    proxy_pass http://127.0.0.1:8000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_connect_timeout 10s;
    proxy_read_timeout 60s;
}
```
Certbot이 만든 `listen 443 ssl`, `ssl_certificate`, `ssl_certificate_key`, HTTP 리다이렉트 설정은 유지한다. **기존 Nginx 설정을 통째로 덮어쓰지 않는다.** 정적/미디어 경로는 별도 `alias`로 설정하고, 비공개 파일은 직접 서빙하지 않는다. Django에서 `SECURE_PROXY_SSL_HEADER`를 설정할 경우 프록시 헤더를 Nginx에서만 신뢰하도록 제한한다.

```bash
sudo nginx -t && sudo systemctl reload nginx
curl -I http://127.0.0.1:8000/
curl -I https://dbresting.com/
```

## 10. 운영 첫 배포 및 DB 변경 통제

1. 테스트 통과한 Git commit SHA 확정.
2. 운영 DB·미디어 백업 상태 확인.
3. 서버에서 해당 SHA checkout 또는 안전한 fast-forward pull.
4. `sudo docker compose -f compose.prod.yml --env-file .env.production config`로 구성 검증. **config 출력에는 비밀값이 나타날 수 있으므로 공유/로그 업로드 금지.**
5. 이미지 build 후 앱/DB 기동(파일 구현 후):
```bash
sudo docker compose -f compose.prod.yml --env-file .env.production build
sudo docker compose -f compose.prod.yml --env-file .env.production up -d
sudo docker compose -f compose.prod.yml --env-file .env.production ps
```
6. `check --deploy`와 `migrate --plan`을 먼저 실행하고, **초기 빈 DB인지 확인** 후 승인된 migration만 실행한다. 실제 명령은 앱 서비스명이 `web`으로 구현된 경우:
```bash
sudo docker compose -f compose.prod.yml --env-file .env.production exec web python manage.py check --deploy
sudo docker compose -f compose.prod.yml --env-file .env.production exec web python manage.py migrate --plan
# 검토 및 백업 확인 후 승인된 경우에만:
sudo docker compose -f compose.prod.yml --env-file .env.production exec web python manage.py migrate
sudo docker compose -f compose.prod.yml --env-file .env.production exec web python manage.py collectstatic --noinput
```
7. 관리자 생성은 초기 1회만 안전한 서버 세션에서 `createsuperuser` 실행.
8. /, /admin/, /health/ 및 정적 파일 확인 후 Nginx를 앱으로 전환.
9. 실패 시 이전 앱 이미지/commit으로 복귀하되 **DB 마이그레이션은 자동 역실행하지 않는다**. 백업·스키마 호환성을 먼저 검토한다.

## 11. GitHub Actions CI/CD 설계

### 11.1 CI — PR과 main push
- Python 버전/의존성 고정, PostgreSQL 서비스 컨테이너 테스트.
- `python manage.py check`, `python manage.py test` 또는 pytest, migration drift 검사, 보안/HTML sanitizer 테스트, 주보 PDF 레이아웃 테스트.
- 테스트 결과 실패 시 merge/배포 차단.
- 운영 비밀값을 PR 테스트에 제공하지 않는다.
- Linux 기본 GitHub 호스팅 러너의 무료 할당량을 확인하고 Actions budget/사용량 알림을 설정한다.

### 11.2 CD — 안전한 첫 운영 배포
- [권장] `workflow_dispatch` 수동 배포 + GitHub Environment `production` 승인자 설정.
- 배포 workflow는 CI PASS, 검증된 SHA, 배포 승인, 백업 확인을 요구.
- 서버 접속용 SSH 키는 GitHub Environment Secrets에 저장, 호스트키 핑거프린트 검증.
- 서버 배포 계정의 sudo/Docker 권한은 공격 표면이 크므로 최소화하고 허용 명령을 제한한다.
- 최초에는 자동 migration 금지; 변경 계획 검토·백업·승인 후 실행.
- 배포 후 HTTPS 헬스체크 실패 시 실패 알림 및 수동 복구 절차 제공.
- 무료 범위는 요금제·비공개 저장소 실행 시간·계정 총사용량에 따라 달라진다.

## 12. 백업·모니터링·운영 점검

### 12.1 백업
- PostgreSQL 논리 백업 + 미디어/PDF 파일 + 복구에 필요한 설정/비밀키를 **분리된 안전한 저장소**에 보관.
- 일일 백업, 보존기간, 암호화, 오프사이트 복제는 운영 정책으로 확정.
- 실제 복구 연습을 별도 환경에서 수행해 성공 여부 기록.
- 백업 파일은 공개 웹 루트에 두지 않는다.

### 12.2 로그/상태
```bash
sudo systemctl status nginx
sudo journalctl -u nginx -n 100 --no-pager
sudo docker compose -f /opt/dbresting/compose.prod.yml --env-file /opt/dbresting/.env.production ps
sudo docker compose -f /opt/dbresting/compose.prod.yml --env-file /opt/dbresting/.env.production logs --tail=100 web
df -h
free -h
sudo certbot renew --dry-run
```
로그에는 비밀번호·토큰·선교 관련 민감 정보가 남지 않도록 필터링한다.

## 13. 장애 진단표

| 증상 | 확인 |
|---|---|
| DNS가 이전 IP | A/CNAME/AAAA, 실제 네임서버, TTL |
| HTTP 연결 실패 | Cafe24 방화벽, UFW, Nginx 상태, 포트 80 |
| 인증서 발급 실패 | DNS·80 포트·도메인별 응답·ACME rate limit |
| HTTPS 502 | Gunicorn 실행, 127.0.0.1:8000, 컨테이너 로그 |
| Django 400 Bad Request | ALLOWED_HOSTS, 프록시 헤더 |
| CSRF 403 | CSRF_TRUSTED_ORIGINS, HTTPS, 쿠키, 프록시 설정 |
| 관리자 CSS 깨짐 | collectstatic, STATIC_ROOT, Nginx alias |
| DB 연결 실패 | Compose 네트워크, DB 서비스명, 인증정보, healthcheck |
| PDF 한글 깨짐 | 한글 폰트 설치·임베딩, WeasyPrint OS 라이브러리 |
| PDF 레이아웃 깨짐 | 용지 규격, 템플릿, 글꼴, 긴 텍스트 오버플로 |
| 배포 실패 | CI 결과, Git SHA, 권한, 이미지/디스크 용량, 앱 로그 |

## 14. 단계별 최종 검증 체크리스트

- [ ] Cafe24 서버 신규 생성 및 SSH 접속
- [ ] 서버 OS·리소스·방화벽 확인
- [ ] DNS A/CNAME/AAAA 검증
- [ ] Nginx 임시 페이지 HTTP 200
- [ ] Certbot HTTPS 인증서 발급 및 자동 갱신 dry-run PASS
- [ ] Windows VS Code/Python venv/PostgreSQL 준비
- [ ] Django/Wagtail 스캐폴딩 및 /admin/ 로컬 실행
- [ ] Dockerfile/Compose/설정 파일 구현 및 검증
- [ ] 운영 DB 최초 migration 승인·완료
- [ ] Nginx ↔ Gunicorn ↔ PostgreSQL 연결
- [ ] 관리자 계정 생성·로그인
- [ ] 정적파일/이미지/PDF 경로 확인
- [ ] GitHub Actions CI PASS 및 승인형 CD
- [ ] 운영 백업/복구 검증
- [ ] 사이트 공개 전 보안·접근성·주보 PDF 검수

## 15. 현재 시점의 다음 구현 작업

이 가이드가 완성되어도 실제 앱 파일은 자동으로 생성되지 않는다. 다음 개발 PR에서 **최소 실행 가능한 Wagtail 스캐폴드 + Dockerfile + Compose + .env.example + /health/ + GitHub Actions CI**를 만들고, 로컬 테스트 후 서버 연결을 검증해야 한다. 디자인과 주보 PDF는 그 다음 기능 단계에서 구현한다.

**운영 주의:** 실제 서버 계정, IP, SSH 키, DB 비밀번호, Django SECRET_KEY, 개인/선교사 정보는 GitHub 문서·PR·CI 로그에 기록하지 않는다.
