컨벤션 피드백 받습니다. (2025.12.24)

[bingle625]

컨벤션에 대해서 자유롭게 피드백해주세요.
모두 읽으신 분들은 '완료' 라고 댓글 달아주세요.

[sokft]

문서 잘 정리해주셔서 쉽게 읽혔습니다ㅎㅎ 그런데, Readme에 있는 제목이랑 페이지에 들어가서 보는 제목과 달라서 좀 헷갈렸습니다. 예를 들어 어노테이션 규칙 페이지를 들어가면 주석 규칙이 나오고 디자인 패턴 들어가면 설계 정책이 나와서 잘 들어왔는지 헷갈렸습니다!! 고생하셨습니다!!!!

[KEEKE132]

디자인 가이드 부분에 논의해야할 부분이 많아보입니다. 먼저 제 의견 몇 개 작성하겠습니다.

CAUSW_backend_docs/docs/design-guide.md

Lines 20 to 26 in 4f9ad82

	## 2. @Transactional 정책
	### 2-1. 선언 위치
	- Service 계층을 기본 관리 지점으로 한다.
	- 클래스 단위 관리 vs 메서드 단위 관리?
	- 현재 프로젝트에서는 섞여 있음.
	- ※ 정확한 기준 수립 필요

Transactional은 개인적으로 메서드레벨에 달아 명확성을 확보하는 걸 선호합니다.
또 이번 아키텍처에서 Service 계층과 Implementation 계층으로 나뉠텐데 두 계층 모두에 각각 다는 것이 좋다고 생각합니다. 단 기본 전파동작이 Required로 동작함을 명확히 인지해야 할 것 같습니다.

CAUSW_backend_docs/docs/design-guide.md

Lines 36 to 38 in 4f9ad82

	### 3-2. 불변 DTO (Record vs Static Class)
	- record를 기본으로 할지?
	- 빌더가 필요한 경우 static class로 전환할 기준?

Record + Builder를 사용하는게 좋다고 생각합니다.

CAUSW_backend_docs/docs/design-guide.md

Lines 51 to 53 in 4f9ad82

	## 5. 메서드 파라미터 설계
	- DTO 하나로 묶을지 vs 개별 파라미터로 전달할지
	- Service 계층에서 “입력 모델”을 어떻게 설계할지

저는 개별 인자로 넘기는 방식을 사용하긴 했는데 이번 아키텍처가 Service -> Implementation이니 Service까지는 DTO를 넘겨도 괜찮을 수 있겠다는 생각을 합니다.

CAUSW_backend_docs/docs/design-guide.md

Lines 57 to 59 in 4f9ad82

	## 6. import 규칙 변경 여부
	- 기존 import 순서(`java → javax → org → net → third → static`) 유지 여부 논의 필요
	- 내부 패키지가 net으로 시작하는 레거시 구조 반영 여부

코드 포매팅 기능에 import 순서도 직접 적용해주는 것 같습니다. naver 코딩 컨벤션 사용하였으니 그대로 사용해도 될 것 같습니다.

[bingle625]

완료

[GY102912]

완료

[glucosei]

완료

[yvngyeong]

완료

[hyungin0505]

완료

[hyoinkang]

완료