남은 API 참고 화면 5개 한글화와 Swagger 문서 표시 복구

updates/2026-09-05/PROGRESS.md

@@ -2,29 +2,35 @@
 
 갱신: 2026-09-13
 
-대상은 Trilium입니다. 한국어 표기는 이스톰을 사용합니다.
+이번에 남아 있던 API 참고 화면 5개까지 번역과 서버 반영 및 검증을 마쳤습니다. 대상은 Trilium입니다.
 
 | 구분 | 완료 | 진행률 |
 |---|---:|---:|
 | 도움말 본문 | 173/173 | 100% |
 | 도움말 목록 제목 | 181/181 | 100% |
-| 영문 감지 이미지의 한국어 설명 보완 | 206/206 | 100% |
-| API 참고 웹 보기 | 0/5 | 0% |
+| 영문 감지 이미지의 한국어 설명 | 206/206 | 100% |
+| API 참고 화면 | 5/5 | 100% |
 
-기본 예제의 본문과 도표 및 통계 표시와 속성 이름 및 PDF는 번역하여 운영에 적용했습니다. PDF는 11쪽이며 194개 문단의 누락 검사와 브라우저 확인을 마쳤습니다. 전체 완료율은 항목마다 규모가 달라 단순 평균으로 계산하지 않습니다.
+기본 예제와 예제 PDF 및 UI 수정분도 운영에 반영했습니다. 이미지는 원본 유지와 한국어 설명 보완 방식입니다.
 
-## 2026-09-13 추가 적용: 화면 문구와 이미지 한국어 설명
+## 2026-09-13 API 참고 화면 5개 추가 완료
 
-- 사용자 선택: 사용량을 절약하기 위해 기존 이미지는 유지하고 한국어 설명을 보완합니다. 이미지 내부 글자를 모두 교체한다는 기존 목표를 이 방식으로 변경했습니다.
-- phase7: 글자 둘러싸기와 관련 설정 및 코드 색상 설정 문구를 번역했습니다. 위치 정보 오류와 지도 새 노트 및 확대 비율과 AI 대화 기본 제목도 수정했습니다. 총 11개 치환 규칙을 적용했습니다.
-- phase8: 래스터 이미지 286개를 OCR로 점검했습니다. 영문이 감지된 206개 모두가 본문에서 참조됨을 확인했습니다. 해당 도움말 92개에 이미지 순서별 한국어 설명과 주요 영문 메뉴의 한국어 뜻을 덧붙였습니다. GIF는 첫 프레임을 검사했습니다. OCR 결과는 모든 글자를 정확하게 판독했다는 의미가 아닙니다.
-- 메뉴 대응은 영어와 한국어 UI 사전을 대조해 생성했습니다. 대응 메뉴가 없는 이미지 25개에는 개별 기능 설명을 작성했습니다. 원본 이미지와 링크 및 이미지 경로를 보존했습니다.
-- Trilium 도움말에 포함된 Grafana 대시보드 JSON의 제목과 설명 및 범례 60곳을 번역했습니다. 범례와 일치해야 하는 표시 재정의 조건도 함께 수정했습니다. 실제 Grafana 서비스는 수정하지 않았습니다.
-- 운영 검증: phase7의 layout_commons.js SHA-256은 39f4a0f5854e52ad221f872a9a50671161a3de2a4835eda044d9db537e010b2a입니다. phase8의 수정 도움말 92개와 대시보드 JSON 1개의 HTTP 응답 해시가 모두 배포본과 일치했습니다. 브라우저에서 측정 지표 도움말의 한국어 이미지 설명 표시를 확인했습니다.
-- 현재 자산 버전: v0.95.0-ko-20260913-r7. 현재 앱 파일은 deployed에 있습니다. 도움말의 현재 내용은 phase3/doc_notes/en에 phase8/doc_notes/en을 덮어 적용한 구성입니다.
-- 백업: /www/dk_project/dk_app/trilium/backups/before-korean-phase7-20260913-172503
-- 백업: /www/dk_project/dk_app/trilium/backups/before-korean-phase8-20260913-173210
+- 외부 ETAPI 명세: 경로 24개. 제목과 설명 154개 필드에 원문 중복을 제외한 번역 118개를 적용했습니다.
+- 내부 API 명세: 경로 37개. 제목과 설명 198개 필드에 원문 중복을 제외한 번역 166개를 적용했습니다.
+- 스크립트 참고 자료: 프런트엔드 API와 FNote 및 백엔드 API의 한국어 사본을 만들었습니다. 설명 문구와 반환값 및 매개변수 설명을 번역했습니다. 최종 변환된 텍스트 노드는 각각 170개와 179개 및 213개입니다. 식별자와 코드 형식은 유지했습니다.
+- 기본 도움말 노트 3개의 webViewSrc를 한국어 사본으로 연결했습니다. 원문 링크와 연결된 다른 형식의 공식 문서 링크는 보존했습니다. 개인 노트는 수정하지 않았습니다.
+- Swagger 화면의 인증 설정과 직접 실행 및 매개변수와 응답 등 조작 문구를 번역했습니다. 예제 오류 메시지 3개도 번역했습니다. ETAPI 예제 서버 주소는 브라우저에서 현재 서버를 사용할 수 있도록 /etapi로 지정했습니다.
+- 실제 화면 검증 중 기존 번들에서 Swagger 정적 파일이 빠져 문서가 비어 보이는 문제를 발견했습니다. 공식 npm swagger-ui-dist 5.21.0의 배포 무결성을 검증한 뒤 필요한 파일만 추가했습니다. LICENSE와 NOTICE를 보존했습니다. 번들 내부 정적 경로도 해당 위치로 연결했습니다.
+- 새 정적 파일의 읽기 권한을 컨테이너에 맞췄습니다. 초기 검증의 일반 문구 검사 조건은 문서별 실제 제목 검사로 수정했습니다. 최종 검증은 모두 통과했습니다.
+- 검증: API 호출 방식과 매개변수 및 스키마의 구조를 원본과 비교했습니다. 번역 대상 설명과 예제 메시지 및 문서용 서버 주소 외에는 일치합니다. 스크립트 문서의 미번역 일반 영문 문장 검사 결과는 0개입니다. 코드와 이름 및 URL은 이 검사에서 번역 대상으로 보지 않습니다.
+- 운영 검증: 정적 응답 8개 해시 일치. Swagger 경로 2개 정상. 기본 노트 연결 3개 일치. 브라우저에서 외부 API 검색 항목을 펼쳐 한국어 설명과 매개변수를 확인했습니다. 내부 API 목록과 프런트엔드 한국어 사본도 실제로 열어 확인했습니다. API 실행 요청으로 사용자 데이터를 생성하거나 삭제하지 않았습니다.
+- 현재 자산 버전: v0.95.0-ko-20260913-r8
+- 현재 main.cjs SHA-256: 5209c39355837fb21714c1b61d8569d3eee71f620a8e8c1a3755ccc38aa92616
+- 최초 백업: /www/dk_project/dk_app/trilium/backups/before-korean-phase9-20260913-181647
+- 최종 보완 전 백업: /www/dk_project/dk_app/trilium/backups/before-api-final-20260913-182417
 
-### 미완료 범위
+### 적용 범위와 유지한 원문
 
-API 참고 웹 보기 5개가 남았습니다. 내부 주소 /etapi/docs 및 /api/docs와 외부 스크립트 API 문서 3개입니다. 이들 페이지의 본문 번역은 아직 완료하지 않았습니다. 도움말 173개 및 목록 제목 181개와 이번 이미지 설명 206개가 완료됐다는 수치를 전체 100%로 해석하지 않습니다. 이미지 설명 보완 선택은 외부 API 원문을 번역한 것으로 간주하는 허가가 아닙니다.
+앞서 남겨 둔 API 참고 화면 5개는 이번에 모두 처리했습니다. 기존 이미지를 유지하고 한국어 설명을 추가한다는 사용자 선택을 따릅니다. 코드 문법과 함수·매개변수 이름 및 제품 이름과 URL은 원문을 유지합니다. 한국어 사본에서 다시 연결되는 외부 사이트 전체를 번역하거나 수정한 것은 아닙니다. 외부 스크립트 문서는 공식 연결 주소의 사본이므로 현재 운영 버전 0.95.0과 API 지원 범위가 다를 수 있음을 화면에 명시했습니다.
+
+현재 도움말 구성은 phase3/doc_notes/en에 phase8/doc_notes/en을 덮고 phase9/doc_notes/en을 덮은 결과입니다. 현재 앱 파일은 deployed에 있습니다. 초기 빌드 산출물과 단계별 파일을 현재 운영본으로 오인하지 마세요.