discourse-korean-localization/PROJECT_MEMORY.md

Discourse 한국어 보완 프로젝트 기록

이 문서는 포럼과 관리자 화면의 한국어 보완과 공식 기여 준비 기록을 관리한다. 게임과 게임 제작 도구의 기록과 분리한다.

2026-09-20 Discourse 한국어 화면 보완과 운영 확인

• forum.itosm.co.kr의 최신 글과 관리자 대시보드와 채팅과 음성 대화방과 로그인 화면에서 영어로 남은 사용자 문구를 한국어 재정의로 보완했다.
• Discourse 코어와 Chat 플러그인과 Voice 플러그인의 번역 누락을 구분해 총 182개의 한국어 재정의를 저장했다. 기본 음성 대화방 이름은 자유 대화방으로 바꾸고 설명도 한국어로 정리했다.
• 변경 전 업로드 파일을 포함한 Discourse 전체 백업 itosm-2026-09-20-093718-v20260915204557.tar.gz을 만들었다. 백업 크기는 7.0 MB다.
• 공식 실행 구성인 /var/discourse/launcher와 /var/discourse/containers/app.yml은 수정하지 않았다. 컨테이너 재시작도 하지 않았다. aaPanel에서 기존 Docker 컨테이너와 8880 포트 연결과 forum.itosm.co.kr 역방향 프록시와 SSL 연결을 유지했다.
• 데스크톱과 390×844 모바일 화면에서 최신 글과 관리자 대시보드가 정상 표시되는지 확인했다. 비로그인 로그인 화면과 비밀번호 재설정 창도 실제 메일 발송이나 비밀번호 변경 없이 확인했다.
• 로그인과 SMTP 설정은 이미 정상인 상태를 보존했다. 계정과 비밀번호와 메일 서버 설정은 변경하지 않았다.
• 일부 기본 안내 글 제목과 Discourse 제품 표기는 번역 대상이 아닌 콘텐츠와 제품 고유 표기로 남아 있다.

2026-09-20 Discourse 관리자 한글화 확대와 Yarn 실행 환경 정비

• 사용자 전용 경로에 Node.js 22.23.2와 Corepack 0.34.6을 설치하고 저장소가 지정한 Yarn 4.0.0-rc.40을 활성화했다. 공식 체크섬 검사를 통과했다.
• /home/syskiller/.local/bin에서 node, npm, npx, corepack, yarn 명령을 사용할 수 있다.
• yarn lint-staged를 실행해 명령이 정상 동작함을 확인했다.
• 관리자 대시보드와 탐색 메뉴와 플러그인 상단 안내의 누락 번역을 보완했다. 한국어 번역 덮어쓰기는 182개에서 234개로 늘었다.
• 신뢰 레벨 변화와 검색 요약과 릴리스 변경 수와 새 소식 및 고급 메뉴를 실제 관리자 화면에서 확인했다.
• 플러그인 표의 제품명과 설명 중 일부는 번역 키가 아니라 플러그인 코드 메타데이터에 직접 적혀 있어 일반 번역 덮어쓰기로 바뀌지 않는다. 정식 배포판 반영 작업에서 플러그인별 변경으로 분리한다.
• 데이터베이스 구조와 일반 콘텐츠 데이터는 변경하지 않았다. Discourse 한국어 번역 덮어쓰기 레코드만 추가했다.
• 컨테이너와 서비스는 재시작하지 않았다. 기존 전체 백업 itosm-2026-09-20-093718-v20260915204557.tar.gz를 복구 기준으로 유지한다.
• Discourse 공식 번역은 Crowdin 기반이며 translate.discourse.org에서 기여한 번역이 정기적으로 저장소에 반영된다. 누락 번역을 검증한 뒤 공통 번역과 플러그인 코드 변경을 나눠 공식 기여용으로 정리한다.

2026-09-20 공식 기여자 표기 확정

• Discourse 한국어 번역과 관련 코드의 공식 제출자 이름은 이창현 (Lee Chang Hyun)으로 사용한다.
• 공식 제출 및 커밋 이메일은 syskiller@naver.com으로 사용한다.
• 저장소 로컬 Git 작성자 설정도 같은 정보로 맞췄다.

2026-09-25 사용자 화면 한글화 4차 진행과 운영 반영

• Discourse 코어의 일반 화면 및 시스템 번역을 네 차례로 나눠 150개와 150개와 150개와 300개씩 총 750개 보완했다.
• 채팅과 음성 대화 플러그인의 사용자 화면 번역을 보완했다. 신고 창과 검색과 글 작성기와 404 안내와 태그 입력 등 실제 사용 중 발견한 영문 문구도 함께 정리했다.
• 영어로 작성돼 있던 운영 게시물 3건의 제목과 본문을 한국어로 바꿨다. 데이터베이스 구조 변경과 데이터 이전은 없었다.
• 운영 플러그인 itosm-admin-korean에 번역 파일을 반영했다. app 컨테이너만 다시 시작했으며 포럼의 HTTP 200 응답을 확인했다.
• 활성 번역 기준으로 남은 항목은 총 8,498개다. 일반 화면 및 시스템은 6,385개이며 관리자 화면은 2,113개다.
• 앞선 화면별 검사에서는 신고 창과 검색과 글 작성기와 오류 안내와 태그 입력의 한국어 표시를 확인했다. 4차 300개 묶음은 YAML 구조와 후보 수와 운영 응답을 검사했으나 화면별 문맥 검수는 후속 작업으로 남겼다.
• 현재 SSH 접속 출발지는 Fail2ban의 SSH 차단 제외 목록에 반영했다. 실제 주소는 기록에 남기지 않았다.
• 이번 기록 시점에는 사용자 지시에 따라 새 백업을 만들지 않았다. 다음 작업은 일반 화면 번역을 300개 단위로 이어서 적용하고 화면별 문맥을 확인하는 것이다.

2026-09-27 한국어 번역 완료와 Gitea 배포 준비

• 활성 일반 화면과 관리자 화면 및 활성 플러그인의 번역 누락을 모두 정리했다.
• 활성 플러그인 29개의 번역 키 6,005개를 검사했으며 누락은 0개다.
• 전체 활성 번역에서 원문과 값이 같은 216개는 브랜드명과 형식 문자열 및 주소 예시처럼 유지해야 하는 기술 값이다.
• 업무 흐름과 보드와 RSS 가져오기와 외부 채팅 연동 및 GitHub 연동과 자동화 화면을 확인했다.
• PC와 390픽셀 모바일 화면에서 일반 화면과 관리자 화면의 가로 넘침이 없음을 확인했다. 브라우저 오류도 없었다.
• 보드 설정에 노출되던 Boards enabled를 보드 사용으로 바꿨다.
• yarn test와 yarn deploy 및 yarn verify:deployment 명령을 추가해 Gitea 저장소에서 검사와 운영 배포를 수행할 수 있게 했다.
• 운영 app 컨테이너만 갱신했으며 포럼의 HTTP 200 응답을 확인했다.
• 데이터베이스 구조 변경과 데이터 이전은 없다. 사용자 요청이 없어 백업은 진행하지 않았다.

2026-10-04 ITOSM 피아노 학습실 포럼 구성

• 정식 서비스 이름을 ITOSM 피아노 학습실로 확인하고 https://learn.itosm.co.kr에 연결되는 전용 포럼 공간을 만들었다.
• 상위 카테고리와 시작 안내와 사용법 및 곡 공유와 연습 자료와 질문과 문제 해결 및 오류 신고와 개선 제안 하위 카테고리를 구성했다.
• 서비스 소개와 처음 시작하는 방법 및 MIDI와 악보 공유 안내와 난이도별 연습 정보와 질문 및 오류 작성 안내를 등록했다.
• 자료 공유 양식에 원본 출처와 저작권 상태 및 이용 허가와 재배포 가능 여부를 필수 확인 항목으로 넣었다.
• 다섯 개 카테고리는 비회원이 볼 수 있다. 회원은 글을 작성할 수 있다. 안내 글 여섯 개도 비회원 공개 상태다.
• 서비스와 포럼 및 안내 글 여섯 개가 모두 HTTP 200으로 응답했다. 390×844 모바일 화면에서는 가로 넘침이 없었다.
• 임시 이름은 제목과 본문 및 글쓰기 양식에서 모두 제거했다. NoteRain 표기도 사용하지 않았다.
• 기존 포럼 설정과 게시물은 삭제하지 않았다. 데이터베이스 구조 변경과 데이터 이전도 없다.
• 사용자 요청이 없어 백업을 만들지 않았다. 컨테이너 재시작도 하지 않았다.
• 실제 MIDI 장치를 이용한 서비스 동작 검사는 피아노 학습 서비스 자체의 장치 검증 작업으로 남는다.