tier-maker/docs/convention.md

코딩 컨벤션

공통

• 문서와 사용자 응답은 한국어로 작성한다.
• JavaScript는 세미콜론 없이 현재 코드 스타일을 유지한다.
• 새 주석이 필요할 경우 JSDoc 형식을 사용한다.
• 경로, 주소, 운영 설정은 하드코딩보다 환경변수 기반 구성을 우선한다.
• Git 커밋 메시지는 한국어로 작성한다.
• 버전 릴리스가 포함된 작업은 docs/update.md의 버전 표기와 Git 태그를 함께 맞춘다.

프런트엔드

• API 호출은 frontend/src/lib/api.js 또는 런타임 유틸을 통해 통합한다.
• 정적 파일 URL 조합은 toApiUrl()로 처리한다.
• 화면 상태는 ref, computed, onMounted 중심의 단순한 Composition API 패턴을 유지한다.

백엔드

• 라우트 검증은 zod로 처리한다.
• 파일 업로드명은 ASCII 안전 문자열을 사용한다.
• 인증/권한 분기는 미들웨어(requireAuth, requireAdmin)로 분리한다.
• DB 저장 전에는 배포 환경에 종속되는 값(예: 로컬 절대 URL)이 들어가지 않도록 정규화한다.
• 사용자 프로필처럼 “선택 후 저장” 흐름이 필요한 기능은 파일 선택과 실제 저장 요청을 분리한다.
• 관리자 지정 데이터와 사용자 커스텀 데이터는 테이블과 업로드 경로를 분리해서 관리한다.