From 87482be2b1b560bfeb137ad8644a9d270e7332d7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B6=8C=ED=98=81=EC=84=B1?= <shine1324@gmail.com>
Date: Wed, 25 Feb 2026 13:37:01 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20=EC=9A=B4=EC=98=81=EC=84=9C=EB=B2=84=20?=
 =?UTF-8?q?LibreOffice=20=EB=B0=8F=20=ED=8F=B0=ED=8A=B8=20=EC=84=A4?=
 =?UTF-8?q?=EC=B9=98=20=EA=B0=80=EC=9D=B4=EB=93=9C=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- LibreOffice 24.2.7 헤드리스 문서 변환 설정
- Pretendard (9 웨이트), Nanum, Noto CJK 폰트 설치 정보
- 폰트 관리 명령어 및 추가 절차

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 deploys/ops-manual/03-service-prod.md | 59 +++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/deploys/ops-manual/03-service-prod.md b/deploys/ops-manual/03-service-prod.md
index c28d524..c6a72c0 100644
--- a/deploys/ops-manual/03-service-prod.md
+++ b/deploys/ops-manual/03-service-prod.md
@@ -277,4 +277,63 @@ sudo ufw allow from IP주소 to any port 포트번호   # 규칙 추가
 sudo ufw delete 번호            # 규칙 삭제 (번호 기반)
 sudo ufw disable                # 비활성화 (비상시만)
 sudo ufw enable                 # 활성화
+```
+
+---
+
+## LibreOffice (문서 변환)
+
+API 서버에서 문서 변환(Excel→PDF 등)에 사용. 헤드리스 모드로 동작.
+
+**버전:** 24.2.7.2 (개발/운영 동일)
+
+**명령어:**
+
+```bash
+libreoffice --version                    # 버전 확인
+libreoffice --headless --convert-to pdf input.xlsx   # CLI 변환 테스트
+```
+
+**설치 패키지:**
+
+```bash
+sudo apt-get install -y libreoffice-core libreoffice-writer libreoffice-calc libreoffice-impress
+```
+
+---
+
+## 폰트
+
+LibreOffice 문서 변환 시 폰트가 없으면 글자가 깨지므로 개발/운영 서버 동일하게 설치 필수.
+
+**설치된 한글 폰트:**
+
+| 폰트 | 설치 방식 | 경로 |
+|------|----------|------|
+| **Pretendard** (9 웨이트) | 수동 설치 (OTF) | `/usr/local/share/fonts/Pretendard-*.otf` |
+| **Nanum** (고딕/명조/스퀘어/손글씨 등) | apt (`fonts-nanum`, `fonts-nanum-extra`) | `/usr/share/fonts/truetype/nanum/` |
+| **Noto CJK** (Sans/Serif) | apt (`fonts-noto-cjk`) | `/usr/share/fonts/opentype/noto/` |
+
+**폰트 관리 명령어:**
+
+```bash
+fc-list :lang=ko family | sort -u       # 설치된 한글 폰트 목록
+fc-list | grep -i pretendard             # Pretendard 설치 확인
+sudo fc-cache -fv                        # 폰트 캐시 갱신 (새 폰트 추가 후 필수)
+```
+
+**새 폰트 추가 시:**
+
+```bash
+# 1. OTF/TTF 파일을 /usr/local/share/fonts/ 에 복사
+sudo cp *.otf /usr/local/share/fonts/
+
+# 2. 폰트 캐시 갱신
+sudo fc-cache -fv
+
+# 3. 확인
+fc-list | grep -i "폰트이름"
+```
+
+> **주의:** 개발서버에 폰트를 추가하면 운영서버에도 동일하게 설치해야 변환 결과가 일치한다.
 ```
\ No newline at end of file