Feature #662
Updated by 성용 양 26 days ago
## 목적
h3. 목표
주보 PoC(공통-06)와 이후 개발이 서버와 같은 Linux 환경에서 실행되도록 최소 Docker 환경을 먼저 만듭니다. (가이드 §7.3, §15)
## 전제·입력
* 선행: 공통-02, 공통-03
* 후행: 공통-06(PoC), B-09 h3. 구현 범위
## 작업 내용
* Dockerfile: Python 3.12, WeasyPrint 의존 OS 패키지, 한글 폰트, non-root 사용자
* compose.yml 최소 구성: web + db(PostgreSQL), DB healthcheck
* /health/ 엔드포인트(비밀·DB 상세 정보 노출 금지)
* 운영용 구성(compose.prod.yml, 승인형 배포)은 B-09에서 마무리
## 사용 기술·도구
Docker, Docker Compose, /health/, WeasyPrint, Noto Sans CJK KR
※ 완료된 일감의 기술·산출물은 계획 h3. 완료 기준 요약이며 실제 구현은 연결된 GitHub PR을 따릅니다.
## 산출물
최소 Docker 환경
## 완료 기준
* docker compose up 으로 /admin/ 와 /health/ 응답
* 컨테이너 안에서 WeasyPrint 한글 PDF 생성 확인
## 이 일감에서 하지 않는 것
기능 구현은 하지 않는다 h3. 선행·충돌 관리
## 연결 일감·충돌 관리
* 선행: 공통-02, 공통-03
* 후행: 공통-06(PoC), B-09
* 주 소유 경로: Dockerfile, compose.yml, config/health
## h3. 비고
* 검수 반영(2026-10-13): 가이드 §15가 첫 개발 PR에 Dockerfile·Compose·/health/를 포함하라고 하고, 가이드 §7.3이 PDF 테스트를 Docker/Linux에서 먼저 하라고 해서 추가
Back