chzzk-server/.cursorrules

13 lines
1.1 KiB
Plaintext

# Cursor Project Rules (Cursor)
- 답변은 항상 한글(Korean)로 하되, 핵심 용어는 영어(English) 병기.
- 사용자가 원하는 목표 형태(architecture/shape)를 만들기 위한 작업이므로, 진행은 항상 "한 단계씩 질문(question) → 답변 반영" 방식.
- NestJS는 REST API 중심.
- Chzzk API는 외부 의존(external dependency)이므로, 호출은 서버 사이드(server-side)에서만 수행하고 브라우저(client)에서 직접 호출하지 않도록 설계.
- 에러 처리(error handling), 타임아웃(timeout), 재시도(retry) 정책을 명시적으로 둔다.
- 설정값(config)은 환경변수(env) 기반으로 모으고 코드에 하드코딩(hardcode)하지 않는다.
- 인증(authentication)은 미정이므로, "내부 서비스(internal services)" 호출 보호는 최소한 API key/API token 방식부터 쉽게 붙일 수 있게 구조화.
- DB는 PostgreSQL이지만 ORM/ODM은 사용하지 않음. (예: pg Pool 기반)
- 변경 후에는 빌드(build) 및 테스트(test) 가능한 최소 단위까지 맞춘다.
- git 커밋(commit)과 push는 사용자가 명시적으로 요청할 때만 수행.