Discourse 한국어 번역과 Gitea 배포 구성 완료

일반 화면과 관리자 화면 및 활성 플러그인의 최종 한국어 번역을 반영했다.

기능별 검수 원본과 보드 화면 패치 원본을 저장소에 포함했다. yarn test와 yarn deploy 및 yarn verify:deployment 명령을 추가했다.

활성 플러그인 29개의 번역 키 6,005개에서 누락 0개를 확인했다. PC와 390픽셀 모바일 화면을 확인했다. 운영 app 컨테이너에 재배포하고 HTTP 200 응답을 확인했다.

데이터베이스 구조 변경과 데이터 이전은 없다. 사용자 요청이 없어 백업은 만들지 않았다.

README.md

@@ -1,18 +1,65 @@
-# ITOSM 관리자 한국어 보완
+# Discourse 한국어 보완
 
-Discourse 관리자 설정 화면에서 내부 설정 키를 영어 문장으로 표시하는 항목을 자연스러운 한국어 이름으로 바꾼다.
+`forum.itosm.co.kr`에서 사용하는 Discourse 한국어 번역과 관리자 설정 이름 보완 플러그인이다. 일반 화면과 관리자 화면 및 활성 플러그인의 한국어 누락을 보완한다.
 
-- 한국어 화면에서만 동작한다.
-- 등록하지 않은 설정은 Discourse 기본 이름을 그대로 사용한다.
-- 데이터베이스와 사이트 설정값은 변경하지 않는다.
-- Discourse 기본 번역 구조가 설정 이름을 지원하게 되면 공식 번역으로 옮길 수 있다.
+## 구성
+
+- `plugin.rb`: 관리자 설정 이름과 플러그인 표시 문구 보완
+- `config/locales/client.ko.yml`: 브라우저 화면 번역
+- `config/locales/server.ko.yml`: 서버 문구와 설정 설명 번역
+- `config/locales/*-quality.ko.yml`: 기능별 검수 원본
+- `patches/`: 별도 플러그인에 반영한 화면 수정 원본
+- `docs/`: 작업 기록과 Trilium 대응 문서
 
 ## 작성자
 
 이창현 (Lee Chang Hyun) <syskiller@naver.com>
 
-## 프로젝트 기록
+## 검사
+
+저장소 루트에서 다음 명령을 실행한다.
+
+```bash
+yarn test
+```
+
+Ruby 문법과 모든 한국어 YAML 파일의 구조를 검사한다.
+
+## 운영 배포
+
+Ubuntu 서버에서 저장소를 최신 상태로 만든 뒤 다음 명령을 실행한다.
+
+```bash
+yarn deploy
+```
+
+기본 배포 대상은 `app` 컨테이너와 `https://forum.itosm.co.kr`이다. 다른 환경에서는 아래처럼 지정한다.
+
+```bash
+DISCOURSE_CONTAINER=app DISCOURSE_URL=https://forum.itosm.co.kr yarn deploy
+```
+
+배포 명령은 검사 통과 후 실행 파일만 `itosm-admin-korean` 플러그인 경로에 복사한다. 이후 대상 컨테이너만 다시 시작하고 HTTP 200 응답을 확인한다. 백업은 자동으로 만들지 않는다. 백업이 필요한 작업은 별도 승인을 받은 뒤 먼저 진행한다.
+
+배포하지 않고 운영 상태만 확인하려면 다음 명령을 사용한다.
+
+```bash
+yarn verify:deployment
+```
+
+## Gitea에서 새 서버로 설치
+
+서버의 Git 인증 설정을 사용해 저장소를 받은 뒤 검사와 배포를 실행한다. 인증 정보는 저장소나 명령에 넣지 않는다.
+
+```bash
+git clone https://gitea.itosm.co.kr/syskiller/discourse-korean-localization.git
+cd discourse-korean-localization
+corepack yarn test
+corepack yarn deploy
+```
+
+## 기록
 
 - `PROJECT_MEMORY.md`: 운영 결정과 적용 범위
-- `수정기록.txt`: 날짜별 변경과 검사 및 복구 기준
+- `수정기록.txt`: 날짜별 변경과 검사 결과
 - `docs/`: Trilium 대응 문서와 상세 운영 기록