관리자 화면 한국어 용어집
FileStore 관리자 화면(/admin, admin-web/src/main.tsx 의 messages.ko)의 한국어 문구 기준이다. 라벨·버튼·토스트·모달 제목·표 열 이름까지 같은 기준을 쓴다. 자동 점검은 아래 감사 스크립트로 한다.
1. 원칙
- 화면에 보이는 문구는 한국어로 쓴다. AntD 기본 문구도 예외가 아니다 —
ConfigProvider locale(ko_KR)을 걸고, 정적Modal.confirm처럼 context 를 읽지 않는 자리에는okText·cancelText를 직접 준다. - 기술 용어·식별자·제품명은 원문을 유지한다. 값을 한국어로 바꾸면 사용자가 콘솔·API 응답·로그와 대조할 수 없다(아래 §3).
- 그 밖의 일반 명사·서술은 한국어로 옮긴다(아래 §2).
- 조사는 앞말에 붙여 쓴다. 라틴 문자·식별자 뒤에서도 같다 —
MIME을,state가,URI를,consent로,리프레시 토큰을. - 문체는
~합니다/~하세요로 통일한다(버튼은 명사형:저장·취소·삭제·추가).
2. 한국어로 옮기는 말 (이전 → 지금)
| 이전 | 지금 |
|---|---|
backend / backends | 백엔드 |
consumer별 | 소비 포털별 |
credential | 자격증명 |
refresh token / Refresh token | 리프레시 토큰 |
Secret namespace | 시크릿 접두(secretRef) |
locator 발급 | 링크 발급 |
lifecycle | 수명주기 |
owner | 소유자 |
content type | 형식 |
CDC seq | CDC 순번 |
스테이징 key | 스테이징 키 |
Tenant ID | 테넌트 ID |
OneDrive | 원드라이브 |
provider | 프로바이더 |
write | 쓰기 |
Storage backends | 스토리지 백엔드 |
Consumer policies | 소비 정책 |
Endpoint / Bucket / Region | 엔드포인트 / 버킷 / 리전 |
Action / Actor | 동작 / 수행자 |
Portal / Owner · Portal / File | 포탈 / 소유자 · 포탈 / 파일 |
3. 그대로 두는 말 (식별자·제품명)
- 자격증명 이름:
Access Key ID·Secret Access Key·Client ID·Client Secret·secretRef - 형식·약어:
MIME·URL·URI·JSON·CSV·PDF·PPT·TXT·PNG/JPEG/JPG·GIF·WEBP·ZIP·doc/docx/xls/xlsx - 환경변수·코드:
FILE_STORE_*·PORTAL_*·redirect_uri_mismatch·invalid_request·access_denied·invalid_grant - 상태·지표:
ACTIVE·CDC·UTC·Base64·REST·GB - 제품·벤더:
FileStore·PortalConsole·DirectoryService·RAG·Data Feed·R2/S3·Databricks·Snowflake·OAuth - 사용자 입력을 그대로 보여 주는 값(예: OAuth 공급자 오류 코드,
{id}플레이스홀더)
5. PortalConsole 온톨로지·용어집과의 관계
용어 표기의 정본은 PortalConsole 의 온톨로지 데스크(DirectoryAdmin 의 ontology 탭, 기준 문서 UiPlatform/docs/ONTOLOGY_SCOPE.md)다 — 개념·용어와 표준 번역(preferredTranslation)·이형(aliases)을 승인 상태로 관리하고, 승인된 것만 색인·검색·AI 문맥에 쓴다(테이블 directoryGlossaryTerms, scope = 포털 ID 또는 platform).
역할은 이렇게 나눈다.
| 무엇 | 정본 | 이 문서가 하는 일 |
|---|---|---|
| 도메인 용어·표준 번역·동의어(검색·AI 문맥) | PortalConsole 온톨로지 데스크 | 온톨로지에 등록된 표준 번역을 화면 문구에 그대로 쓴다 |
| 화면 문구(i18n)의 배치·문체·조사·식별자 유지 규칙 | 이 문서 + admin-web/src/main.tsx | 감사 스크립트로 어긋난 문구를 찾아낸다 |
- FileStore 서버는 온톨로지를 읽지 않는다(현재
src/에 참조 없음) — 용어 표기를 온톨로지에서 내려받는 연동은 아직 없다. 필요해지면PORTAL_CONSOLE_URL·PORTAL_CONSOLE_SYNC_TOKEN배선을 재사용해 조회 캐시를 두는 방식이 맞다. - 새 용어의 표기를 정할 때는 온톨로지에 먼저 등록(
scope=file-store,status=approved)하고 화면 문구를 맞춘다. 급할 때는 이 문서 §2 표를 먼저 고치고 온톨로지 등록이 뒤따르게 한다. - 등록 경로(2026-10-11): §2 의 표준 표기는 이미 원장 시드에 들어 있다 —
PortalConsole/docs/glossary-seed-terms.json(플랫폼scope=platform, ko↔en) 이고, 넣는 명령은pnpm seed:glossary(PortalConsole/scripts/seed-glossary-terms.mjs,glossary:write스코프 키 필요, 멱등). 표기를 바꿀 때는 시드 파일과 이 문서를 함께 고친다.
6. 감사 스크립트
bash
node scripts/audit-admin-i18n.mjs # 또는 pnpm audit:admin-i18n출력은 세 부분이다.
ko/en키 개수(다르면 종료코드 1 — 번역 누락)- 한국어 블록인데 값에 한글이 없는 키 — §3 의 식별자·제품명이면 정상, 그 밖이면 누락
- 한국어 문장에 영어 낱말이 섞인 키 — 낱말 목록을 함께 보여 주므로 §3 인지 §2 대상인지 바로 판단한다