DATA & VERIFICATION

단어 데이터와 닉네임 검증 방식

Rarenick의 198,647개 원단어가 검수·중복 제거되는 과정과 Nexon Open API 조회, D1 캐시, 상태별 만료 정책을 공개합니다.

작성·검수: Rarenick 운영팀최종 수정: 2026년 9월 27일

1. 공개 단어풀은 실시간 크롤링 결과가 아닙니다

2026년 10월 10일 기준 공개 버전에는 32개 분야, 198,647개 원단어가 들어 있습니다. 신화, 인물 이름, 꽃, 천문학, 과학 용어, 음식처럼 닉네임의 소재가 될 수 있는 분야를 각각 CSV 원본으로 관리합니다. 서비스 방문 중에 인터넷을 즉시 긁거나 사용자의 검색어를 자동으로 사전에 추가하지 않습니다.

각 행에는 분야, 한글 라벨, 가능한 경우 영문 라벨, 설명과 원천 식별자가 들어갑니다. 공개 전에 데이터 빌드가 문자 규칙, 빈 설명, 중복 라벨, 잘못된 영문 표기를 검사합니다. 현재 빌드는 영문 라벨 검수 오류가 0건일 때만 배포할 수 있도록 막혀 있습니다.

2. 한글과 영문은 번역 버튼 하나로 만들지 않습니다

같은 개념이라도 한국어 번역어와 음역어가 다를 수 있습니다. ‘보라’와 ‘바이올렛’처럼 뜻은 가까워도 실제 이름으로는 서로 다르게 읽히는 경우에는 별도 후보로 유지합니다. 반대로 같은 철자와 같은 개념이 여러 원천에서 반복되면 하나의 공개 항목으로 합칩니다.

빌드는 영문 라벨 누락, 한글 혼입, 한영 동일 표기와 근거 URL 유무를 검사합니다. 이는 형식 검사이며 번역이나 뜻풀이의 사실성을 전부 입증하는 검수는 아닙니다. 현재 사전에는 반복된 일반 설명과 다른 표제어를 가리키는 참조형 설명이 남아 있습니다. 이를 별도 검수 목록으로 모으고, 자료를 확인한 항목부터 구체적인 설명으로 교정합니다.

  • 같은 normalized 한글 라벨은 전체 통합에서 한 번만 노출합니다.
  • 한 개념이 여러 분야와 관련되면 각 분야에서는 노출할 수 있습니다.
  • 한글 별칭의 철자가 다르면 독립된 닉네임 후보로 유지합니다.
  • 영문 근거를 확인하지 못한 항목은 한글 전용으로 남기거나 공개에서 제외합니다.

3. 랜덤 추천은 데이터베이스를 무작위로 정렬하지 않습니다

공개 단어는 버전이 붙은 정적 JSON shard로 나누어 Cloudflare의 정적 자산에서 제공합니다. 분야별 shard 순서를 세션 안에서 섞고, 한 번 사용한 shard는 가능한 한 전체 순환이 끝나기 전까지 다시 선택하지 않습니다. 전체 통합은 여러 분야를 고르게 골라 교차 배치하므로 한 분야만 계속 나오는 현상을 줄입니다.

이 구조에서는 사용자가 랜덤 버튼을 누를 때마다 D1에서 ORDER BY RANDOM() 같은 고비용 쿼리를 실행하지 않습니다. 단어 파일은 CDN 캐시를 사용할 수 있고, D1은 닉네임 조회 상태와 요청 제한 카운터만 담당합니다. 랜덤 한글은 가능한 조합이 매우 크기 때문에 사전에 저장하지 않고 브라우저에서 즉석 생성합니다.

4. Nexon 조회는 cache-first로 수행합니다

‘메이플 닉네임용’은 기본으로 켜져 있으며 선택은 브라우저에 저장됩니다. 끄면 첫 화면, 추천, 검색, 한영 전환, 복사에서 중복 확인 API를 호출하지 않습니다. 원단어와 뜻풀이는 정적 사전에서 가져오고, 랜덤 한글은 브라우저에서 생성합니다. 이때 조회 상태와 색상은 표시하지 않으며, 다시 켜면 현재 표시된 후보부터 확인합니다.

분야나 필터를 바꾸는 것만으로는 D1 또는 Nexon API 검증을 시작하지 않습니다. 원단어 모드에서는 현재 분야의 정적 후보 파일만 브라우저 캐시에 미리 받아둡니다. 메이플 모드의 첫 화면에서는 원단어 최대 18개를 목표로 현재 후보를 확인하며, 사용 중인 이름이 많으면 정해진 조회 한도 안에서 예비 후보를 확인합니다. 브라우저 캐시가 살아 있는 후보는 다시 호출하지 않습니다. 추천 버튼을 누르면 원단어는 CDN의 정적 shard에서 가져오고, 랜덤 한글은 브라우저에서 즉석 생성합니다. 다음 클릭을 위한 백그라운드 실시간 검증은 하지 않습니다.

버튼을 누르면 원단어 18개 또는 랜덤 한글 24개를 먼저 표시한 뒤 cache-first 방식으로 점진 확인합니다. 브라우저 로컬 캐시에 유효한 결과가 있으면 먼저 사용하고, 공개 원단어는 D1의 사용 중·휴먼닉·중복 미확인 캐시도 확인합니다. 서버가 사전 소속을 확인한 원단어만 캐시에 저장하며, 랜덤 한글과 임의 검색어는 D1 캐시에 저장하지 않습니다. 필요한 이름에 한해서만 Nexon Open API를 호출합니다. 사용 중 닉네임 줄이기로 빈자리가 생기면 현재 화면을 채울 예비 후보부터 추가 확인합니다.

메이플 모드에서는 생성불가·휴먼닉으로 확인된 후보를 제외하고 예비 후보로 빈자리를 채웁니다. 필요한 수가 모이면 확인을 멈추며, 후보 검사 상한은 모드와 필터에 따라 다릅니다. 2글자 무받침 랜덤 한글은 최대 72개를 확인하고, 원단어는 일반적으로 최대 300개, 앞뒤 고정·글자 제외가 없는 2글자 사전 탐색은 최대 900개의 후보를 검사할 수 있습니다. 이는 모두 Nexon 실시간 호출 횟수를 뜻하지 않으며 캐시·로컬 판정으로 건너뛴 후보도 포함합니다. 서버는 요청별 실시간 조회량과 전체 사용량을 별도로 제한합니다. 상한 뒤의 미확인 예비 후보는 새 카드로 올리지 않습니다. 복사는 확인 완료를 기다리지 않고 먼저 처리합니다.

5. 상태별 캐시 시간과 표시 의미

상태기본 캐시의미
가능성 높음15분조회 시점에 동일 캐릭터를 확인하지 못함
생성불가30일동일 이름의 캐릭터 식별자가 조회됨
휴먼닉30일식별자는 있으나 기본 정보 분류가 제한됨
확인 실패3분외부 API 오류·점검·네트워크 문제
규칙상 불가30일서비스 내부 문자·길이 검사에서 제외됨

표의 시간은 브라우저 로컬 캐시 기준입니다. 서버 D1은 공개 원단어의 생성불가·휴먼닉을 30일, 중복 미확인을 15분 저장합니다. 랜덤 한글·임의 검색·복사 재검사 결과는 새로 저장하지 않습니다. 캐시 시간은 비용과 최신성 사이의 운영 기준이며 게임의 공식 보장 기간이 아닙니다.

6. 재현 가능성과 오류 수정

데이터 빌드와 검증 로직은 자동 테스트와 배포 전 감사를 거쳐 관리합니다. 공개 shard에는 API 키, 원본 IP, 사용자별 조회 이력을 넣지 않습니다. 애플리케이션은 원본 IP나 IP 해시를 D1에 저장하지 않으며, Cloudflare의 요청 제한과 Turnstile 봇 확인을 통과한 브라우저에 짧은 서명 세션만 발급합니다.

뜻풀이 교정은 원본 CSV를 보존한 상태에서 대상 식별자, 이전 설명, 수정 설명, 근거 URL과 검토 날짜를 별도로 기록합니다. 원본이 바뀌면 기존 교정이 엉뚱한 항목에 적용되지 않도록 빌드를 중단합니다. 설명이 같다는 이유만으로 동의어나 별칭을 삭제하지 않으며, 참조형 설명의 동음이의어 번호도 임의로 지우지 않습니다. 설명 근거가 추가된 항목은 결과 카드에서 자료 링크를 확인할 수 있습니다.

‘→ 표제어’ 하나로 끝나는 설명은 국립국어원 표준국어대사전 검색으로 연결합니다. 검색 링크는 뜻풀이를 찾는 경로일 뿐, 해당 표제어나 뜻 번호가 맞는지 검수를 끝냈다는 표시가 아닙니다. 여러 뜻이 섞이거나 원천 태그가 남은 설명은 자동으로 다른 정의를 덮어쓰지 않고 별도 검수 대상으로 남깁니다.

공개 문의 창구는 아직 준비되어 있지 않습니다. 이용할 수 없는 비공개 저장소를 제보 경로로 안내하지 않으며, 별도 접수 수단이 마련되면 사이트 소개에 게시하겠습니다.

7. 설명 교정 이력

2026년 9월 27일 기준 근거를 대조해 교정한 설명은 23건입니다. 이는 전체 사전 검수가 완료됐다는 의미가 아닙니다. 꽃 분야에서 로즈마리·마스터워트의 분류 오류를 고치고, 미모사·아카시아·아가판서스처럼 통용명과 분류명이 혼동될 수 있는 항목을 구체적으로 설명했습니다.

해당 꽃 설명은 RHS, 노스캐롤라이나주립대학교 Extension, 국립생물자원관 자료에서 특징과 분류를 확인해 짧게 다시 작성했습니다. 자료의 문장 전체나 사진을 옮기지 않았으며, 항목마다 확인한 자료 링크를 붙였습니다. 같은 설명이 반복되는 나머지 항목은 계속 검토가 필요합니다.

사전 검색에 사용하는 표준국어대사전은 국립국어원이 제공합니다. 그 자료를 재사용할 때는 공식 저작권 정책의 저작자 표시와 동일조건변경허락 등 이용 조건을 확인해야 합니다. 사이트 전체 자료의 이용허락을 하나의 출처 고지로 대신하지 않으며, 분야별 원천과 재사용 조건 확인은 별도의 점검 과제로 남아 있습니다.