[Refactor/#18] 용어 사전 도입 및 rental → bililge 네이밍 통일 - #19
Closed
xeoxxn wants to merge 2 commits into
Closed
Conversation
백엔드 엔드포인트 네이밍과 프론트 도메인 용어(라우트 경로, features 폴더명 등)를 통일하기 위한 용어 사전을 만들고, coding-style.md 네이밍 규칙에서 참조하게 한다
용어 사전(docs/conventions/terminology.md)에 맞춰 '빌릴게' 도메인의 rental 네이밍을 bililge로 전부 바꾼다: features/rental → features/bililge, 컴포넌트/타입/상수명(RentalXxx → BililgeXxx), 라우트 경로(/rental → /bililge), BottomNavValue의 'rental' → 'bililge', asset 폴더/파일명까지. Figma 노드 실제 이름을 그대로 옮긴 주석(예: 'Rental Item Card')은 용어 사전 규칙대로 그대로 둔다
github-actions
Bot
requested review from
jjunh33,
leegain1,
sangrae2325 and
tnals0924
September 9, 2026 07:50
Collaborator
Author
|
빌릴게 리네이밍은 아직 PR 올릴 단계가 아니라서 일단 닫습니다. 커밋은 refactor/#18-bililge-naming 브랜치에 그대로 남아있고, 용어 사전(docs)만 별도 PR로 분리해서 다시 올립니다. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
#️⃣연관된 이슈
🎯 해결하려는 문제가 무엇인가요?
프론트에서 "빌릴게" 기능을 만들면서
rental이라는 이름을 임의로 붙였는데, 백엔드는 같은 도메인을bililge라는 엔드포인트 이름으로 쓰고 있었다. 이런 식으로 프론트·백엔드가 도메인 이름을 각자 임의로 지으면 나중에 API 연동할 때마다 헷갈린다.❓ 왜 해결해야 하나요?
요청자가 제공한 백엔드 엔드포인트 네이밍 표를 기준으로 프론트 도메인 용어를 통일하고, 이후에도 같은 실수가 반복되지 않도록 컨벤션 문서로 남겨야 한다.
⭐ 어떻게 해결했나요?
docs/conventions/terminology.md신설 — 요청자가 준 한글 도메인명 ↔ 백엔드 엔드포인트 네이밍 표(공통/auth, 사용자/users, 빌릴게/bililge 등 12개) 그대로 옮기고, 적용 범위(라우트 경로·features/폴더명·컴포넌트 접두사)를 정리했다.docs/conventions/coding-style.md의 "네이밍" 절에 이 사전을 참조하는 규칙 한 줄 추가.rental네이밍을 전부bililge로 리네이밍:src/features/rental/→src/features/bililge/RentalListScreen/RentalItemCard/RentalCategoryFilter/RentalItem/RENTAL_ITEMS/RENTAL_CATEGORIES→Bililge*계열로 전부 변경/rental→/bililgeBottomNavValue의'rental'→'bililge'rental-items/,rental-selected.svg)도bililge-items/,bililge-selected.svg로 변경// Figma: Rental Item Card (nodeId ...), Bottom Nav의Selected=...Rentalvariant명)은 용어 사전 규칙대로 번역하지 않고 그대로 뒀다 — 디자인 파일과 대조할 때 실제 Figma 이름과 달라지면 안 되기 때문.🧩 이 PR의 한계 & 트레이드오프
docs/conventions/component-convention.md,wds-component-usage.md에RentalItemCard.tsx등 옛 경로를 언급한 부분이 있는데, 이 두 문서는main에는 있지만 이 브랜치(→ 공통 레이아웃(375x812) + Bottom Nav 뼈대 구현 #11 → 라우팅 도입 및 빌릴게 화면 라우트 연결 #13 스택)의 히스토리에는 없어서 지금 여기서 고치질 못했다. 이 스택이main에 머지되고 나면 별도로 경로 언급을 갱신해야 한다.feat/#13-router-rental-page위에 쌓은 브랜치라,feat/#13이 먼저 머지돼야 온전히 리뷰/머지된다.⛓️ 기존 기능에 미치는 영향
이름만 바꾼 리네이밍이라 동작 변화는 없다.
/rental경로로 들어오는 북마크/링크가 있다면/bililge로 바뀌어서 깨지지만, 아직 배포 전이라 실질 영향 없음.🔀 Edge Case & 실패 시나리오
없음 (리네이밍).
📋 검토한 대안과 선택 이유
/bililge로 바꾸는 것도 검토했으나, 코드 전체에서 용어가 일관되지 않으면 다음에 또 헷갈릴 수 있어서 폴더명부터 변수명까지 전부 통일했다.💬 리뷰 포인트
[c]용어 사전(terminology.md)의 "적용 범위" 정의가 앞으로 다른 도메인(사물함, 챗봇 등) 붙일 때도 충분한지