Feature #1287
openFeature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1228: [MDGU-11] 증명서·출력 (서현)
[MDGU-11-01] 증명서 PDF 기반(WeasyPrint·3개 국어 폰트·템플릿 엔진)
0%
Description
목적¶
대학 서식이 오기 전에도 만들 수 있는 PDF 생성 기반을 먼저 만들어, 서식 수령 후 바로 증명서를 구현할 수 있게 합니다. (FR-DOC-002, 003, NFR-OPS-005)
쉬운 설명¶
증명서를 PDF로 만드는 기반(WeasyPrint)과 한국어·영어·중국어 글꼴, 공통 템플릿 엔진을 준비합니다.
기술 스택¶
WeasyPrint, Django Templates(HTML+CSS print), Noto Sans CJK(한·중)·영문 폰트, Docker(Linux)에서 검증.
예상 결과(산출물)¶
documents 앱의 PDF 렌더링 서비스, 공통 증명서 레이아웃 템플릿, 언어 전환(ko/en/zh-hans) 규칙, 샘플 PDF, 테스트.
개발 작업 상세¶
- Docker 환경(04-03)에서 WeasyPrint가 3개 언어 글꼴로 PDF를 만드는지 먼저 검증한다.
- 렌더링 서비스
render_certificate(template, context, lang)를 만든다. - 공통 레이아웃(머리·본문·발급번호 자리·직인 자리)을 만든다.
- 언어별 문구 파일을 분리한다(번역 명칭은 00-04 수령 후 확정).
- 합성 데이터로 샘플 PDF를 만들어 글꼴 깨짐·줄바꿈을 확인한다.
완료 기준¶
- 3개 언어 샘플 PDF에서 글꼴이 깨지지 않는다.
충돌 방지(소유 범위)¶
documents/ 앱은 서현 소유.
선행·후행·위험¶
선행: 04-03 Dockerfile·Compose·/health/·Gunicorn·Nginx 연결·운영 설정(성용, 11/25 종료)
후행: 11-02 재학·휴학·수료·졸업 증명서 서식 3개 국어(서현)
위험: 글꼴·WeasyPrint 의존성 문제는 Docker에서 먼저 확인.
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- 3개 언어 샘플 PDF에서 글꼴이 깨지지 않는다.
- pytest가 모두 통과한다.
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
시작 전 준비¶
- 선행 일감의 결과물(문서·코드)을 먼저 읽고 약속된 이름·구조를 확인한다.
- 저장소를 최신으로 맞춘다: git switch main 후 git pull --ff-only origin main
- 저장소 README 8번과 팀 로컬 세팅 안내 순서대로 환경을 준비한다. 보통 py -3.12 -m venv .venv, 가상환경 켜기, python -m pip install -r requirements-dev.txt, Windows에 설치한 PostgreSQL 18에서 개인 로컬 DB(university_dev) 생성, .env.local 설정(DB_NAME, DB_USER, DB_PASSWORD, DB_HOST, DB_PORT), python manage.py check, python manage.py migrate 순서이다. 최초 실행에 makemigrations는 필요 없고, .env.local과 비밀번호는 공유·커밋하지 않는다.
- #1226의 폴더 소유 표에서 내가 고칠 수 있는 폴더를 확인한다.
작업 진행 순서¶
- 브랜치를 만든다: git switch -c feature/1287-<짧은영문설명>
- "개발 작업 상세"의 번호 순서대로 한 단계씩 구현하고, 단계마다 pytest로 확인한다.
- 모델을 바꾸면 python manage.py makemigrations, 그다음 python manage.py migrate를 실행한다.
- 화면은 python manage.py runserver로 실행해 직접 열어 보고 "완료 기준"과 하나씩 대조한다.
- git add, git commit, git push 후 PR을 만든다. PR 템플릿의 체크리스트를 채우고 폴더 소유자의 리뷰를 받는다.
- 병합 후 이 일감 메모에 PR 링크와 확인 결과를 적고 상태와 진행률을 갱신한다.
막힐 때 확인¶
글자가 깨지면 서버에 폰트가 설치되었는지와 CSS font-family를 확인하세요.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- WeasyPrint: HTML과 CSS로 만든 문서를 PDF로 바꿔 주는 Python 도구입니다. 증명서 PDF를 만드는 데 사용합니다.
- Docker·Docker Compose: 프로그램과 실행 환경을 한 상자(컨테이너)로 묶어 어디서나 같은 방식으로 실행하게 해 주는 도구이고, Compose는 여러 상자(앱·DB)를 한꺼번에 켜고 끄게 해 줍니다.
- 합성 데이터: 실제 개인정보가 아닌, 시험용으로 만든 가짜 데이터입니다.
- Django 템플릿: HTML에 데이터가 들어갈 자리를 표시해 둔 화면 틀입니다. 기본(base) 템플릿을 상속해 공통 메뉴를 재사용합니다.
성양 Updated by 성용 양 19 days ago
- Precedes Feature #1288: [MDGU-11-02] 재학·휴학·수료·졸업 증명서 서식 3개 국어 added
성양 Updated by 성용 양 19 days ago
- Due date changed from 12/04/2026 to 11/23/2026
- Start date changed from 11/30/2026 to 11/17/2026
- Follows Feature #1265: [MDGU-04-03] Dockerfile·Compose·/health/·Gunicorn·Nginx 연결·운영 설정 added