# 사용자 화면 한글화 진행 기록

> 완료 확정 · 2026-09-27
> 후속 번역과 플러그인 검수를 마쳤다. 활성 일반 화면과 관리자 화면의 번역 누락은 0개다. 아래 내용은 2026-09-25 당시의 진행 상태를 보존한 기록이다. 최종 결과와 배포 절차는 `2026-09-27-localization-complete-and-deployment.md`에서 확인한다.

- 작업일: 2026-09-25
- 담당: 이창현
- 대상: `https://forum.itosm.co.kr`
- 저장소: `syskiller/discourse-korean-localization`
- Trilium 위치: `Ubuntu 서버 운영 > Discourse 한국어 배포 > 사용자 화면 한글화 진행 기록 · 2026-09-25`

## 진행 범위

Discourse 코어의 일반 화면 및 시스템 번역을 네 차례로 나눠 적용했다. 묶음별 수량은 150개와 150개와 150개와 300개이며 총 750개다. 채팅과 음성 대화 플러그인의 사용자 화면 번역도 보완했다. 실제 화면에서 발견한 신고 창과 검색과 글 작성기와 404 안내와 태그 입력의 영문 문구도 함께 정리했다.

영어로 작성돼 있던 운영 게시물 3건은 제목과 본문을 한국어로 바꿨다. 데이터베이스 구조를 바꾸거나 데이터를 이전하지 않았다.

## 운영 반영

운영 플러그인 경로는 `/var/www/discourse/plugins/itosm-admin-korean`이다. 변경한 한국어 번역 파일과 플러그인 코드를 반영한 뒤 `app` 컨테이너만 다시 시작했다. 포럼의 HTTP 200 응답을 확인했다.

## 검사 결과

| 검사 | 결과 |
|---|---|
| YAML 구조 | 통과 |
| 1차부터 3차 화면 확인 | 신고 창과 검색과 글 작성기와 오류 안내와 태그 입력의 한국어 표시 확인 |
| 4차 후보 수 | 300개 확인 |
| 4차 화면별 문맥 검사 | 후속 진행 필요 |
| 운영 접속 | HTTP 200 |
| SSH 보호 | 현재 접속 출발지를 차단 제외 목록에 반영하고 새 연결 확인 |

## 남은 분량

| 구분 | 사용자 화면 및 시스템 | 관리자 화면 | 합계 |
|---|---:|---:|---:|
| 클라이언트 | 4,627개 | 1,921개 | 6,548개 |
| 서버 | 1,758개 | 192개 | 1,950개 |
| 합계 | 6,385개 | 2,113개 | 8,498개 |

## 백업과 다음 작업

이번 기록 시점에는 사용자 지시에 따라 새 백업을 만들지 않았다. 다음 작업은 일반 화면 번역을 300개 단위로 이어서 적용하는 것이다. 각 묶음은 구조 검사와 운영 응답 확인 뒤 실제 화면에서 문맥을 검수한다.