개발 규약
코드·Git·버전·보안·UI 공통 기준
| 커밋 메시지 규약「[type]: 공통 주제 - 개별 내용」 형식과, 한 작업을 여러 커밋으로 나눌 때 앞부분을 똑같이 유지하는 규칙. | 공개 | 1.0.0 | 2026-10-27 |
| 버전·태그·릴리스 규약SemVer A.B.C 판단 기준, 프로젝트별 태그 접두 유지, 릴리스 노트·라벨 관리 규칙. | 공개 | 1.0.0 | 2026-10-27 |
| 이슈 기반 개발 흐름개발 전에 이슈를 등록하고, 커밋에 이슈 번호를 남기고, 검증 결과를 코멘트한 뒤 닫는 흐름. | 공개 | 1.0.0 | 2026-10-27 |
| 브랜치 운영develop 을 통합 브랜치로 두고 기능 브랜치에서 작업해 develop 으로 PR 하는 흐름. | 공개 | 1.0.0 | 2026-10-27 |
| 코드 작성·변경 원칙과 모듈화가정을 밝히고 최소한으로 고치는 원칙, 파일 크기 기준(300/500줄), 수정 이력 기록 위치, 서버·클라이언트 동시 확인. | 공개 | 1.0.0 | 2026-10-27 |
| 문자 인코딩 — UTF-8 필수콘솔·파일·문서·설정·네트워크 전송 모두 UTF-8(BOM 없음). cp949 로 새지 않게 코드가 직접 막는다. | 공개 | 1.0.0 | 2026-10-27 |
| 로그 파일 정책날짜/카테고리 폴더 구조, 경로를 한 모듈에서만 만드는 규칙, 조사 순서대로 번호 매긴 카테고리, 보존 기간. | 공개 | 1.0.0 | 2026-10-27 |
| 보안 기본 규칙비밀값을 이슈·커밋·로그·문서에 남기지 않기, 로그인 화면 기본 계정 노출 금지, 서명 키 보관, 새 저장소는 비공개 기본. | 공개 | 1.0.0 | 2026-10-27 |
| DB 작업 규칙 — 저장 프로시저 금지새로 만드는 기능은 저장 프로시저 대신 파라미터 SQL·ORM·트랜잭션을 쓴다. 기존 프로시저는 그 표를 고칠 때 점진적으로 옮긴다. | 공개 | 1.0.0 | 2026-10-27 |
| UI 공통 기준 — 반응형·표 정렬·제목 버전 표기모든 화면은 모바일 반응형·넘침 0건, 모든 데이터 표는 컬럼 정렬, 프로그램 제목에 제품명·버전·빌드 시각을 표시한다. | 공개 | 1.0.0 | 2026-10-27 |
| .gitignore 기본개발 문서 폴더(docs/, **/docs/)·비밀값·빌드 산출물을 처음부터 저장소에서 제외한다. | 공개 | 1.0.0 | 2026-10-27 |