Skip to content

fix: 운전 목표·후기 내용 길이를 사용자 기준 글자 수로 계산 - #72

Merged
20210699 merged 2 commits into
developfrom
fix/#71-text-length-grapheme
Aug 21, 2026
Merged

20210699 merged 2 commits into
developfrom
fix/#71-text-length-grapheme

Conversation

@20210699

@20210699 20210699 commented Aug 21, 2026 •

Copy link
Copy Markdown
Collaborator

요약

운전 목표·후기 내용의 길이 제한을 사용자가 화면에서 세는 글자 수(grapheme cluster) 기준으로 바꾼다.

기존 @Size는 String.length() — UTF-16 코드유닛을 센다. BMP 밖 이모지는 서로게이트 페어라 한 글자가 2로, 피부톤은 4로, ZWJ 가족(👨‍👩‍👧‍👦)은 11로 계산돼 앱이 세는 수와 어긋났다. 그래서 30자 한도에 😀는 15개, 가족 이모지는 2개까지만 들어갔다. iOS String.count·안드로이드 BreakIterator와 같은 단위로 맞춰 셋이 같은 수를 세게 한다.

프론트가 대안으로 제시한 "이모지 입력 차단"은 채택하지 않았다 — 판별 규칙(변이선택자·ZWJ·국기·피부톤)이 부정확하고 UX 손해가 크다.

변경 사항

  • @GraphemeSize + GraphemeSizeValidator 신규 (global/common/validation, 프로젝트 첫 커스텀 validator)
    • BreakIterator.getCharacterInstance(Locale.ROOT)로 문자 경계를 센다
    • grapheme cluster는 결합문자·ZWJ를 무한히 이을 수 있어 이론상 길이 제한이 없으므로, 저장 크기 방어용 코드유닛 상한(max × 20) 을 함께 검사한다
  • 운전 목표(30)·후기 내용(150)에 적용, 해당 @Size 제거
    • MemberUpdateRequest · OnboardingRequest · ReviewRequest
    • 상수는 Member.DRIVING_GOAL_MAX_LENGTH(신규) · Review.MAX_CONTENT_LENGTH(의미만 grapheme으로 변경)
  • V26 — member.driving_goal · review.content 를 TEXT로 확장
    • 검증만 넓히면 통과한 값이 저장 단계에서 터진다(grapheme 30자 = 코드포인트 210자까지 가능)
    • grapheme 하나의 코드포인트 수에 상한이 없어 안전한 VARCHAR(N)을 고를 수 없어 TEXT로 열고, 길이는 애플리케이션이 책임진다
    • 둘 다 확장 방향이라 데이터 손실·인덱스 영향 없음
  • 테스트 2종 — 카운트 규칙 단위 테스트, 4개 엔드포인트 + DB 실저장 통합 테스트

동작 변화는 통과/거절 기준뿐이고 엔드포인트·요청/응답 스키마는 그대로다. 한도 초과는 기존과 같이 400 COMMON_400으로 거절하며 잘라 저장하지 않는다.

관련 스펙 / 이슈

체크리스트

  • ./gradlew test 통과
  • 스펙의 완료 조건(Acceptance Criteria) 충족
  • 필요한 문서/스펙 갱신

참고

  • BreakIterator가 이모지 시퀀스를 한 덩어리로 묶는지 먼저 확인하고 설계했다. JDK 버전에 따라 ZWJ·국기·피부톤을 쪼개는 구현이 있어 전제였는데, 툴체인인 JDK 21.0.2에서 한글·😀·❤️·👍🏻·👨‍👩‍👧‍👦·🇰🇷·👩‍💻·결합 악센트 모두 1로 세는 것을 확인했다.
  • 통합 테스트는 flush()/clear() 후 DB에서 다시 읽는다 — 영속성 컨텍스트에서만 확인하면 컬럼 폭 문제를 못 잡는다.
  • 범위 밖: 후기 주의사항(제한 없음)·신고 상세·미방문 사유·최근검색 표시명·코스명/설명. 같은 문제를 갖고 있어 추후 애노테이션 교체로 확장한다.

Summary by CodeRabbit

  • 개선 사항
    • 운전 목표와 후기 내용의 글자 수를 사용자가 인식하는 문자 단위(그래핌 클러스터)로 정확하게 제한합니다.
    • 이모지, 한글 조합 문자, 피부톤·가족 이모지 등도 올바르게 한 글자로 계산합니다.
    • 제한을 초과한 입력은 기존과 동일하게 400 COMMON_400 오류로 거절됩니다.
  • 데이터 저장
    • 운전 목표와 후기 내용이 확장된 텍스트 형식으로 저장되어 문자 조합에 따른 저장 오류를 줄였습니다.
  • 문서
    • 관련 API 설명과 기능 사양이 새로운 글자 수 기준에 맞게 업데이트되었습니다.

20210699 and others added 2 commits August 21, 2026 17:51
@SiZe는 String.length() — UTF-16 코드유닛을 센다. BMP 밖 이모지는
서로게이트 페어라 한 글자가 2로, ZWJ 가족은 11로 계산돼 앱이 세는
글자 수와 어긋난다. iOS String.count·안드로이드 BreakIterator와
같은 단위로 맞추기 위해 grapheme cluster를 세는 제약을 추가한다.

grapheme cluster는 결합문자·ZWJ를 무한히 이을 수 있어 이론상 길이
제한이 없으므로, 저장 크기 방어용으로 코드유닛 상한(max × 20)을
함께 둔다.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
이모지 30자를 입력해도 서버가 15자에서 거절하던 문제(QA 리포트).
@SiZe를 @GraphemeSize로 교체해 사용자가 화면에서 세는 글자 수와
서버 기준을 일치시킨다.

검증 기준이 넓어지면 통과한 값이 저장 단계에서 터지므로 컬럼도
함께 넓힌다 — grapheme 30자는 코드포인트로 210자(가족 이모지 30개)가
될 수 있고, grapheme 하나의 코드포인트 수에 상한이 없어 안전한
VARCHAR(N)을 고를 수 없어 TEXT로 연다(V26).

한도 초과는 기존과 같이 400으로 거절하며 잘라 저장하지 않는다.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Aug 21, 2026 •

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 10ca1e98-18f9-4a78-8ce4-4cdba93eac9b

📥 Commits

Reviewing files that changed from the base of the PR and between e031b8d and 17f6462.

📒 Files selected for processing (12)
  • docs/specs/018-text-length-grapheme.md
  • docs/specs/README.md
  • src/main/java/cmc/rodi/domain/member/dto/MemberUpdateRequest.java
  • src/main/java/cmc/rodi/domain/member/dto/OnboardingRequest.java
  • src/main/java/cmc/rodi/domain/member/entity/Member.java
  • src/main/java/cmc/rodi/domain/review/dto/ReviewRequest.java
  • src/main/java/cmc/rodi/domain/review/entity/Review.java
  • src/main/java/cmc/rodi/global/common/validation/GraphemeSize.java
  • src/main/java/cmc/rodi/global/common/validation/GraphemeSizeValidator.java
  • src/main/resources/db/migration/V26__widen_text_columns_for_graphemes.sql
  • src/test/java/cmc/rodi/global/common/validation/GraphemeSizeValidatorTest.java
  • src/test/java/cmc/rodi/global/common/validation/TextLengthGraphemeIntegrationTest.java

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.


📝 Walkthrough

Walkthrough

운전 목표와 후기 내용의 길이 검증을 UTF-16 길이에서 grapheme cluster 수로 변경했습니다. 새 검증기는 UTF-16 code unit 상한도 검사합니다. 관련 DB 컬럼을 TEXT로 변경하고 단위·통합 테스트를 추가했습니다.

Changes

Grapheme 텍스트 길이 제한

Layer / File(s) Summary
Grapheme 검증기와 단위 테스트
src/main/java/cmc/rodi/global/common/validation/*, src/test/java/cmc/rodi/global/common/validation/GraphemeSizeValidatorTest.java, docs/specs/018-text-length-grapheme.md
@GraphemeSize와 GraphemeSizeValidator가 grapheme cluster 수를 계산합니다. UTF-16 code unit 상한과 Unicode 경계값을 검증합니다.
도메인 적용과 저장 검증
src/main/java/cmc/rodi/domain/member/..., src/main/java/cmc/rodi/domain/review/..., src/main/resources/db/migration/V26__widen_text_columns_for_graphemes.sql, src/test/java/cmc/rodi/global/common/validation/TextLengthGraphemeIntegrationTest.java, docs/specs/README.md
운전 목표는 30 grapheme, 후기 내용은 150 grapheme 기준으로 검증합니다. 엔티티 컬럼을 TEXT로 변경하고, 허용 입력의 저장과 초과 입력의 400 COMMON_400 거부를 통합 테스트로 확인합니다.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Merge Risk: ⚪ Minimal · up to 17f64

This change aligns length validation and storage with user-perceived character counts for the affected fields; no actionable merge-blocking risk remains after normal checks and review.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 10.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 30 functions across 9 files. (3 skipped: 3 unsupported.) Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed 제목이 운전 목표와 후기 내용의 사용자 기준 글자 수 검증 변경을 정확히 요약합니다.
Linked Issues check ✅ Passed 운전 목표 30자와 후기 내용 150자에 grapheme 기준 검증과 컬럼 확장을 적용하여 이슈 #71의 요구 사항을 충족합니다.
Out of Scope Changes check ✅ Passed 변경 사항이 검증 로직, 대상 필드, 데이터베이스 마이그레이션, 관련 테스트와 문서 범위에 포함됩니다.
✨ Finishing Touches 💡 1
📝 Generate docstrings 💡
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/#71-text-length-grapheme

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@20210699 20210699 mentioned this pull request Aug 21, 2026
3 tasks done
@20210699
20210699 merged commit 56421f1 into develop Aug 21, 2026
2 checks passed
@20210699
20210699 deleted the fix/#71-text-length-grapheme branch October 15, 2026 13:41
@20210699 20210699 mentioned this pull request Nov 20, 2026
3 tasks done
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[fix] 이모지 입력 시 글자 수 제한이 사용자 기준과 다름

1 participant