Supabase 로그인 세션 문제 해결과 Cursor 개발 규칙 설정

# Supabase Configuration Rules

## Always Use Manual Client
- Use `createClient` from `@supabase/supabase-js`
- Never use `createBrowserClient` or `createServerClient` from `@supabase/ssr`
- Always include explicit auth configuration

## Required Auth Config
```javascript
{
  auth: {
    persistSession: true,
    autoRefreshToken: true,
    detectSessionInUrl: true,
  }
}

description: 현실적이고 실용적인 TDD 규칙 (부작용 방지 전략 포함)
globs: src/**/*.ts, src/**/*.tsx
alwaysApply: true
---

# 🎯 테스트 전략 가이드 - 현실성과 속도의 균형

## 테스트 우선순위

- 🔴 **Level 1 (반드시 테스트)**  
  - 인증, 결제, DB 저장 등 핵심 로직  
  - 외부 API 연동  
  - 사용자 데이터 변형/검증/삭제 등  
  → 테스트 누락 시 심각한 장애 발생 가능성

- 🟡 **Level 2 (테스트 권장)**  
  - 조건문 3개 이상  
  - 날짜/시간 처리, 배열/객체 조작  
  - 상태 관리 로직, 사용자 입력 처리  
  → 테스트 생략 시 디버깅 난이도 높음

- 🟢 **Level 3 (테스트 선택)**  
  - 단순 UI 컴포넌트 (버튼, 타이틀 등)  
  - 스타일 수정, 마크업만 변경  
  → 테스트 부담 없이 커밋 가능

---

## ✅ 판단 기준 체크리스트

- [ ] 돈/포인트/결제 관련인가?
- [ ] 사용자 데이터 저장/수정/삭제 관련인가?
- [ ] 외부 API 호출이 포함되어 있는가?
- [ ] 조건문 3개 이상이 있는가?
- [ ] 테스트 없이 커밋 시 추적이 어려운가?

---

## ✅ 코드 예시

```ts
// Level 1
export const saveEntry = async (entry: Entry) => {
  // DB 저장 + 권한 체크
};

// Level 2
export const formatDate = (date: Date) => {
  // 날짜 포맷 처리
};

// Level 3
export const Title = () => <h1>환영합니다</h1>;
````

---

## ✅ 개발 속도 최적화 전략

```ts
// 초안 테스트 예시
describe('analyzeJournal', () => {
  test.skip('복잡한 케이스', () => {
    // TODO: 나중에 구현
  });

  test('기본 에러 케이스', async () => {
    const result = await analyzeJournal('');
    expect(result.error).toBeDefined();
  });
});
```

```ts
// Mock 예시
jest.mock('../services/openai', () => ({
  analyzeJournalEntry: jest.fn().mockResolvedValue({
    emotions: ['행복'],
    summary: 'test summary'
  })
}));
```

---

## ✅ 점진적 도입 플랜

* 1단계: 새로 만든 파일은 테스트 필수
* 2단계: 기존 코드 수정 시, 수정된 함수만 테스트
* 3단계: 전체 적용 (6개월 이내 목표)

---

## ✅ 커버리지 목표

| 단계    | 목표     | 비고         |
| ----- | ------ | ---------- |
| MVP   | 40% 이상 | 핵심 로직 위주   |
| 베타    | 60% 이상 | 주요 사용자 플로우 |
| 정식 출시 | 80% 이상 | 전체 안정성 확보  |

```ts
const healthMetrics = {
  testSkipRatio: "< 30%",
  coreLogicCoverage: "> 80%",
  prTestRatio: "> 70%",
  bugReduction: "월 10% 감소"
};
```

---

## ✅ PR 체크리스트

* [ ] Level 1 코드는 반드시 테스트 작성
* [ ] test.skip 사용 시 `TODO` 주석 포함
* [ ] 기존 테스트가 모두 통과됨
* [ ] `--no-verify` 사용 시 사유 명시

---

**이 규칙은 개발 속도를 유지하면서도 품질을 점진적으로 높이는 데 목적이 있습니다.**