Repository navigation
docs: 코드 주석 정합화 — "추모"를 노출명 "추억 노트"로 통일 + 스테일 Figma 링크 3건 #1119
Copy link
Copy link
Closed
Labels
documentationImprovements or additions to documentationImprovements or additions to documentation
Description
📜 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.comgrep 에 안 잡힌다 — 노드 번호로 찾을 것 -
mindrecord는 다른 담당 모듈이다. 주석 1줄이라 같이 가도 되지만, 리뷰어에 담당자를 넣을 것
📍 Note (Optional)
- base: develop. 독립 작업. 주석만 바뀌므로 빌드·테스트 영향 없음.
- 계기: feat(afternote): 추억 노트 미디어 카메라/녹음 즉석 촬영 인텐트 추가 #369(PR feat(afternote): 추억 노트 사진·영상 즉석 촬영 인텐트 추가 (closes 369) [base: develop] #1112) 리뷰 중 지적. 그 PR 이 새로 넣은 주석은 이미 "추억 노트" 로 맞춰 두었다.
- 순수 문구 교체라 한 PR 로 끊는 게 낫다 — 여러 모듈에 걸치지만 로직 diff 가 0이라 리뷰 비용이 낮다.
곁들여 — 코드 주석의 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건이 전부다(전수 확인함) - 예외 사유 자체는 유효하므로 문장만 자립시킨다. 그라데이션을 토큰화하는 변경이 아니다
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
documentationImprovements or additions to documentationImprovements or additions to documentation
Activity
[-]docs(afternote): 코드 주석의 "추모" 를 노출명 "추억 노트" 로 통일 — SOCIAL 의 "추모" 와 같은 낱말이라 축이 갈리지 않는다[/-][+]docs: 코드 주석 정합화 — "추모"를 노출명 "추억 노트"로 통일 + 스테일 Figma 링크 3건[/+]