Skip to content

[Docs/#18] 용어 사전 컨벤션 추가 - #20

Merged
xeoxxn merged 1 commit into
mainfrom
docs/#18-terminology-dictionary
Sep 10, 2026
Merged

[Docs/#18] 용어 사전 컨벤션 추가#20
xeoxxn merged 1 commit into
mainfrom
docs/#18-terminology-dictionary

Conversation

@xeoxxn

@xeoxxn xeoxxn commented Sep 9, 2026

Copy link
Copy Markdown
Collaborator

#️⃣연관된 이슈

🎯 해결하려는 문제가 무엇인가요?

프론트에서 도메인 이름을 코드에 쓸 때(라우트, features/ 폴더명, 컴포넌트/타입 접두사) 임의로 번역·축약해서 붙이고 있었다. 예를 들어 "빌릴게" 기능을 rental로 이름 붙였는데, 백엔드는 실제로 bililge라는 엔드포인트 세그먼트를 쓴다.

❓ 왜 해결해야 하나요?

프론트/백엔드가 같은 도메인을 다른 이름으로 부르면 코드 읽을 때마다 매핑을 다시 떠올려야 하고, 새 기능을 추가할 때도 이름을 또 임의로 지을 위험이 있다. 백엔드 엔드포인트 네이밍과 프론트 코드 용어를 한 곳에서 맞춰두면 이런 불일치를 막을 수 있다.

⭐ 어떻게 해결했나요?

  • docs/conventions/terminology.md를 새로 만들어 한글 도메인명 ↔ 코드 용어(=백엔드 엔드포인트 세그먼트) 매핑표를 정리했다.
  • docs/conventions/coding-style.md의 네이밍 규칙에 이 사전을 참조하도록 한 줄 추가했다.

🧩 이 PR의 한계 & 트레이드오프

이 PR은 컨벤션 문서만 추가한다. 기존 코드(rental 등) 를 사전 기준으로 리네이밍하는 작업은 별도로 진행한다.

⛓️ 기존 기능에 미치는 영향

문서만 추가되므로 런타임 동작에는 영향이 없다.

🔀 Edge Case & 실패 시나리오

해당 없음 (문서 변경).

📋 검토한 대안과 선택 이유

coding-style.md에 매핑표를 바로 넣는 방안도 고려했으나, 표가 커질 수 있고 성격이 다른 정보(네이밍 규칙 vs 실제 매핑 데이터)라 별도 문서로 분리했다.

💬 리뷰 포인트

  • [c] 사전에 없는 새 도메인이 생겼을 때의 절차(백엔드와 협의 후 사전에 먼저 추가)가 실무에서 잘 지켜질지 확인 부탁드립니다.

@sangrae2325 sangrae2325 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

작성하신 컨벤션 확인했습니다. 새로운 도메인이 생기는 빈도가 적을것으로 예상되어 잘 지켜질수 있다고 생각합니다.

@xeoxxn
xeoxxn merged commit 977985b into main Sep 10, 2026
1 check passed
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.

도메인 용어를 백엔드 엔드포인트 네이밍에 맞춰 통일 (용어 사전 도입)

2 participants