git: 원격 저장소 연결 및 초기 커밋

Made-with: Cursor

.cursor/rules/01-base.mdc

@@ -0,0 +1,15 @@
+---
+alwaysApply: true
+---
+- 모든 응답과 문서는 한국어로 작성한다.
+- 답변은 짧고 명확하게 작성한다.
+- 이모지 사용을 금지한다.
+- 추측성 답변을 하지 않는다.
+- 불확실한 내용은 반드시 명시한다.
+
+- 기존 코드 스타일을 우선 따른다.
+- 불필요한 리팩토링을 금지한다.
+- 요청되지 않은 구조 변경을 금지한다.
+
+- 파일 생성은 최소화한다.
+- 기존 코드에서 해결 가능한지 먼저 검토한다.

.cursor/rules/02-workflow.mdc

@@ -0,0 +1,14 @@
+---
+alwaysApply: true
+---
+모든 작업은 반드시 아래 순서를 따른다:
+
+1. docs 문서를 먼저 확인한다.
+2. 관련 코드 파일을 확인한다.
+3. 기존 구현 방식과 패턴을 파악한다.
+4. 최소 범위로 수정한다.
+5. 검증을 수행한다.
+6. 문서를 즉시 갱신한다.
+7. 누락 여부를 확인한다.
+
+이 순서를 생략하거나 변경하지 않는다.

.cursor/rules/03-docs.mdc

@@ -0,0 +1,15 @@
+---
+alwaysApply: true
+---
+작업 후 반드시 문서를 갱신한다.
+
+- update.md: 작업 내용을 항목형으로 기록 (~추가., ~수정.)
+- todo.md: 현재 유효한 작업만 유지
+- spec.md: API / 데이터 구조 변경 시 갱신
+- history.md: 구조 변경 + 이유 기록
+- map.md: 파일-기능 매핑 유지
+- deploy.md: 실행 및 배포 방법 최신화
+
+문서와 코드가 다르면:
+1. 코드를 기준으로 판단
+2. 문서를 수정한다

.cursor/rules/04-project.mdc

@@ -0,0 +1,11 @@
+---
+alwaysApply: true
+---
+- 이 프로젝트는 Vite + Vue 3(SPA) 기반이다.
+- 기존 구조, 네이밍, 패턴을 반드시 먼저 파악한다.
+- 기존 composables, utils, components를 우선 재사용한다.
+- 상태 관리는 기존 방식을 따른다.
+- 동일 데이터를 중복 관리하지 않는다.
+
+- Tailwind CSS를 사용한다.
+- 전역 폰트는 Pretendard를 유지한다.

.cursor/rules/05-frontend.mdc

@@ -0,0 +1,13 @@
+---
+alwaysApply: true
+---
+- API 호출은 기존 API 레이어를 사용한다.
+- 정적 URL은 toApiUrl()로 처리한다.
+
+- Composition API 패턴(ref, computed, onMounted)을 유지한다.
+
+- UI는 "요약 + 필요 시 모달" 구조를 우선한다.
+- 모달 활성화 시 body scroll lock을 적용한다.
+
+- 리스트 변경 시 깜빡임 없이 즉시 반영한다.
+- 애니메이션은 TransitionGroup을 사용한다.

.cursor/rules/06-backend.mdc

@@ -0,0 +1,11 @@
+---
+alwaysApply: true
+---
+- 입력 검증은 zod를 사용한다.
+- 인증/권한은 PocketBase 클라이언트 래퍼 또는 라우터 가드 등으로 분리한다.
+
+- 사용자 입력은 반드시 검증 후 저장한다.
+- 환경 의존 값(URL 등)은 저장 전에 정규화한다.
+
+- 업로드 파일명은 ASCII 안전 문자열을 사용한다.
+- 관리자/사용자 업로드 경로를 분리한다.

.cursor/rules/07-style.mdc

@@ -0,0 +1,12 @@
+---
+alwaysApply: true
+---
+- Tailwind CSS를 기본으로 사용한다.
+- Tailwind만으로 구조를 구성하지 않는다.
+- 주요 영역에는 고유 클래스명을 반드시 추가한다.
+
+- 클래스명은 의미 기반으로 작성한다.
+- 임시 이름 사용을 금지한다.
+
+- JavaScript는 세미콜론 없이 작성한다.
+- 주석은 필요한 경우에만 JSDoc 형식을 사용한다.

.cursor/rules/08-git.mdc

@@ -0,0 +1,22 @@
+---
+alwaysApply: true
+---
+- 커밋 메시지는 한국어로 작성한다.
+- 형식: "영역: 변경 내용"
+
+예:
+docs: 규칙 정리
+blog: 레이아웃 구현
+
+- 작성자 정보:
+  name: zenn
+  email: zenn.message@gmail.com
+
+- 작업 후 반드시:
+  git add -A
+  git commit
+  git push
+
+- 버전은 v0.0.1 형식으로 증가시킨다.
+
+- 푸시 전 민감 정보 포함 여부를 확인한다.

.cursor/rules/09-validation.mdc

@@ -0,0 +1,11 @@
+---
+alwaysApply: true
+---
+- 가능한 범위에서 기능 검증을 수행한다.
+- 주요 사용자 흐름을 확인한다.
+- null, undefined, 실패 응답을 점검한다.
+
+- console.log는 디버깅용으로만 사용한다.
+- 작업 완료 시 불필요한 로그는 제거한다.
+
+- 검증을 수행하지 못한 경우 사유를 명시한다.