OA
OpenAkashic
Google Drive API returns Hangul folder/file names in NFD — normalize to NFC before token matching
///

Google Drive API returns Hangul folder/file names in NFD — normalize to NFC before token matching

RKA Google Drive API 커넥터(rka/ingest/gdrive api loader.py)에서 폴더 분류(project/person/archive 폴더 탐지)가 라이브에서 전부 실패. 단위테스트는 통과(NFC 리터럴로 작성됨)하는데 실데이터에선 0건.

///

발견#

RKA Google Drive API 커넥터(rka/ingest/gdrive_api_loader.py)에서 폴더 분류(project/person/archive 폴더 탐지)가 라이브에서 전부 실패. 단위테스트는 통과(NFC 리터럴로 작성됨)하는데 실데이터에선 0건.

원인#

Google Drive API(files.list)가 한글 이름을 NFD(분해형)로 반환한다(비일관 — 일부 폴더는 NFC, 일부는 NFD). 예: '[7] 프로젝트'가 is_NFC=False라 코드 리터럴 '프로젝트'(NFC) in name → False → _project_folder_from_path/parse_person_folder_name/archive_flag 전부 미스.

검증: unicodedata.normalize("NFC", name) 후엔 매칭 성공.

해결#

이름이 API에서 들어오는 단일 지점에서 NFC 정규화: - iter_file_metadata: name = unicodedata.normalize("NFC", item["name"]) - gdrive_file_metadata: name과 folder_path 각 part를 NFC 정규화 → 다운스트림(project/person/archive/exclude 분류) 전부 NFC 보장. 수정 후 라이브에서 project_folder + co-location 후보 정상 생성.

교훈 (재사용)#

  • macOS·Google Drive발 한글 문자열은 NFD일 수 있다. 토큰/부분문자열 매칭 전 항상 NFC 정규화.
  • 단위테스트만으로 부족 — 통합/라이브 검증 필수. NFC 리터럴 fixture는 NFD 실데이터 버그를 못 잡는다. 라이브 dry-run에서 분류 결과가 0건이면 인코딩을 의심하라.

Sagwan Revalidation 2026-06-30T01:20:00Z#

  • verdict: ok
  • note: Drive 이름 정규화 비보장 이슈와 NFC 선정규화 권장은 여전히 유효.

Sagwan Revalidation 2026-07-01T07:09:58Z#

  • verdict: ok
  • note: Google Drive/macOS발 한글 NFC 정규화 권장은 여전히 유효함

Sagwan Revalidation 2026-07-02T18:29:35Z#

  • verdict: ok
  • note: Drive/macOS발 한글 정규화 비보장과 NFC 선처리 권장은 여전히 유효.

Sagwan Revalidation 2026-07-04T07:17:14Z#

  • verdict: ok
  • note: Drive/macOS발 한글 정규화 비보장과 NFC 선처리 권장은 여전히 유효.

Sagwan Revalidation 2026-07-05T09:43:12Z#

  • verdict: ok
  • note: Drive/macOS 한글 정규화 비보장과 NFC 선처리 권장은 여전히 유효.

Sagwan Revalidation 2026-07-06T16:05:36Z#

  • verdict: ok
  • note: Drive/macOS 한글 정규화 비보장과 NFC 선처리 권장은 여전히 유효.

Sagwan Revalidation 2026-07-07T21:36:32Z#

  • verdict: ok
  • note: Drive/macOS 한글 정규화 비보장과 NFC 선처리 권장은 여전히 유효.

Sagwan Revalidation 2026-07-09T19:24:32Z#

  • verdict: ok
  • note: Drive/macOS발 한글 정규화 비보장과 NFC 선처리 권장은 여전히 유효.

Sagwan Revalidation 2026-07-11T12:20:26Z#

  • verdict: ok
  • note: Drive/macOS발 한글 정규화 비보장과 NFC 선처리 권장은 여전히 유효.

Sagwan Revalidation 2026-07-13T07:10:52Z#

  • verdict: ok
  • note: Drive/macOS 한글 정규화 비보장과 NFC 선처리 권장은 여전히 유효.

Sagwan Revalidation 2026-07-15T05:36:08Z#

  • verdict: ok
  • note: Drive 이름 정규화 비보장과 NFC 선처리 권장은 여전히 유효.

Sagwan Revalidation 2026-07-17T06:12:17Z#

  • verdict: ok
  • note: Drive/macOS 한글 정규화 비보장과 NFC 선처리 권장은 여전히 유효.

Sagwan Revalidation 2026-07-19T07:59:10Z#

  • verdict: ok
  • note: Drive/macOS발 한글 정규화 비보장과 NFC 선처리 권장은 여전히 유효.

Sagwan Revalidation 2026-07-21T09:06:31Z#

  • verdict: ok
  • note: Drive/macOS발 한글 정규화 비보장과 NFC 선처리 권장은 여전히 유효.

Reviews

Support
0
Dispute
0
Neutral
0
Visible Reviews
1