37 lines
1.6 KiB
Markdown
37 lines
1.6 KiB
Markdown
|
# 프로젝트 코딩 가이드라인 (Java Backend)
|
||
|
|
|
||
|
|
AI 에디터(Agent)는 다음 규칙을 항상 준수하여 코드를 작성하고 수정해야 합니다.
|
||
|
|
|
||
|
|
## 0. 기본 소통 규칙 (Communication)
|
||
|
|
- **언어**: 사용자에 대한 모든 답변과 코드 설명은 항상 **한글(Korean)**로만 작성해야 합니다.
|
||
|
|
|
||
|
|
## 1. 패키지 구성 (Package Structure)
|
||
|
|
- **컨트롤러 (Controller)**: `ctrl`
|
||
|
|
- **서비스 (Service)**: `svc`
|
||
|
|
- **DTO (Data Transfer Object)**: `dto`
|
||
|
|
- **매퍼 (Mapper)**: `mapper`
|
||
|
|
|
||
|
|
## 2. 파일 명명 규칙 및 구성 (File Naming Conventions)
|
||
|
|
- **컨트롤러 (Controller)**: `[도메인명]Controller.java` (예: `ABCDController.java`)
|
||
|
|
- **서비스 (Service)**: `[도메인명]Service.java` (인터페이스와 구현체(impl)를 분리하지 않고 Service 클래스 파일 하나로만 구현, 예: `ABCDService.java`)
|
||
|
|
- **DTO**: `[도메인명]DTO.java` (예: `ABCDDTO.java`)
|
||
|
|
- **매퍼 (Mapper)**: `[도메인명]Mapper.java` (예: `ABCDMapper.java`)
|
||
|
|
|
||
|
|
## 3. URL 및 메소드 명명 규칙 (RequestMapping & Method Naming)
|
||
|
|
|
||
|
|
### 1) RequestMapping (URL) 및 컨트롤러 메소드명
|
||
|
|
- 페이지 이동하는 url : `moveXXXX.do`
|
||
|
|
- 팝업 오픈하는 url : `openXXXX.do`
|
||
|
|
- 조회 url : `getXXXX.do`
|
||
|
|
- 저장 url : `putXXXX.do`
|
||
|
|
- 수정 url : `modXXXX.do`
|
||
|
|
- 삭제 url : `delXXXX.do`
|
||
|
|
- **단, 컨트롤러 메소드명은 위 url에서 `.do`를 제외한 이름과 동일하게 명명합니다.**
|
||
|
|
|
||
|
|
### 2) 서비스 메소드명
|
||
|
|
- 단일조회 : `selectXXXX`
|
||
|
|
- 리스트조회 : `selectListXXXX`
|
||
|
|
- insert : `insertXXXX`
|
||
|
|
- update : `updateXXXX`
|
||
|
|
- delete : `deleteXXXX`
|