Skip to content

docs: 코드 주석 정합화 — "추모"를 노출명 "추억 노트"로 통일 + 스테일 Figma 링크 3건 #1119

Closed

Description

@1hyok

📜 Overview (Required)

MEMORIAL 카테고리를 가리키는 한글 산문이 코드 주석 전반에서 "추모" 로 적혀 있다. 사용자 노출명은 "추억 노트" 다.

afternote_category_memorial          = 추억 노트
afternote_editor_category_memorial   = 추억 노트
receiver_afternote_item_memorial_guideline = 추억 노트

"추모" 는 이 앱에서 SOCIAL 카테고리 문구에 쓰는 다른 말이다 — 추모 게시물 올리기, 추모 계정으로 전환하기. 두 카테고리가 같은 낱말을 쓰고 있어, 주석만 읽으면 어느 축을 말하는지 갈리지 않는다.

28개 파일 39건 (grep -rn 추모 --include='*.kt' --include='*.java', develop 기준). 상위:

건수 파일
4 author/editor/state/AfternoteEditorState.kt
3 author/editor/state/AfternoteSaveState.kt
2 receiver/.../MemorialReceivedDetailScreen.kt, .../SocialNetworkReceivedDetailScreen.kt, author/editor/AfternoteEditorContent.kt, author/detail/account/AccountDetailScreen.kt, core/ui/Route.kt, receiver/data/.../ReceivedAfternoteDetailMapperTest.kt
1 도메인·데이터 계층 10여 개 (MediaInput.kt, MediaKind.kt, MemorialMediaUploadRepository.kt, ResolveMemorialMediaForSaveUseCase.kt 등)

🚀 해야할 일

  • MEMORIAL 축을 가리키는 "추모" 를 "추억 노트" 로 교체
  • 개별 슬롯을 가리키는 자리는 슬롯 이름으로 — "추모 사진" → 영정사진, "추모 영상" → 장례식에 남길 영상 (afternote_editor_memorial_photo_label, afternote_editor_funeral_video_label 기준)
  • SOCIAL 쪽 "추모" 는 건드리지 않는다 — 추모 게시물 올리기·추모 계정으로 전환하기 는 올바른 용법이다. SocialNetworkReceivedDetailScreen.kt 의 2건이 어느 쪽인지 개별 판정 필요
  • 심볼명(Memorial*)은 그대로 둔다 — 서버 enum·네비 키가 MEMORIAL 이라 코드 축은 일관되어 있다. 바꾸면 남의 모듈까지 끌고 들어간다
  • 사용자 노출 문자열(strings.xml)에는 잘못된 "추모" 가 없음을 확인함 — 주석 전용 작업이다

곁들여 — 스테일 Figma 링크 3건

같은 "주석이 사실과 어긋난다" 부류라 한 PR 로 묶는다. 코드의 Figma 참조가 전부 파일의 back up 페이지(옛 사본) 를 가리킨다. 현행은 정리 Screen Design(4327:43064) 이다. 두 노드가 다 살아 있고 렌더도 같아 깨진 티가 안 나는데, 디자이너가 손대는 쪽은 현행이라 옛 노드를 보고 있으면 변경을 놓친다.

위치 현재 고칠 값
mindrecord/.../component/MediaSelectBottomSheet.kt:38 Figma 노드 495:16938 4327:72281
afternote/.../shared/util/AfternoteDisplayRes.kt:40 node-id=34-3342 현행 대응 노드 확인 후 교체
afternote/.../shared/detail/MessageSection.kt:24 node-id=3628-17591 현행 대응 노드 확인 후 교체
  • 위 3건 현행 노드로 교체
  • MediaSelectBottomSheet.kt:38 은 마크다운 링크가 아니라 맨텍스트(Figma 노드 495:16938)라 figma.com grep 에 안 잡힌다 — 노드 번호로 찾을 것
  • mindrecord 는 다른 담당 모듈이다. 주석 1줄이라 같이 가도 되지만, 리뷰어에 담당자를 넣을 것

📍 Note (Optional)

곁들여 — 코드 주석의 Claude 메모리 슬러그 2건

같은 "주석이 레포 밖을 가리킨다" 부류라 함께 묶는다. feedback_use_theme_colors 는 레포에 없는 파일(작업자 개인 메모리)이라 팀원이 주석의 근거를 확인할 방법이 없다. PR #304(이슈 #303, 2026-05-27 "Hero 그라데이션 정당화")에서 토큰화 예외 사유를 적으며 유입됐다.

위치 현재 주석 고칠 방향
feature/receiver/.../summary/HeroCard.kt 디자인 시스템 룰 (feedback_use_theme_colors) 의 예외로 본 한 곳에 고정. 슬러그 없이 사유가 자체 완결되는 문장으로
feature/receiver/.../home/component/SenderMessageHeroCard.kt 위와 동일 위와 동일
  • 슬러그 참조 제거 — develop 기준 이 2건이 전부다(전수 확인함)
  • 예외 사유 자체는 유효하므로 문장만 자립시킨다. 그라데이션을 토큰화하는 변경이 아니다

Activity

  1. self-assigned this
    on Aug 25, 2026
  2. changed the title [-]docs(afternote): 코드 주석의 "추모" 를 노출명 "추억 노트" 로 통일 — SOCIAL 의 "추모" 와 같은 낱말이라 축이 갈리지 않는다[/-] [+]docs: 코드 주석 정합화 — "추모"를 노출명 "추억 노트"로 통일 + 스테일 Figma 링크 3건[/+] on Aug 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentation

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions