Project

General

Profile

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