feat: MOIM V1 서비스 공식 런칭 및 UX/UI 고도화 통합 반영

.agents/docs/1_DOMAIN_CONTEXT.md

@@ -0,0 +1,18 @@
+# 1. Domain Context
+**프로젝트 명**: AI 캠퍼스 모임 (MVP 1차)
+**핵심 목표**: 에브리타임 시간표와 캘린더 연동을 통해 대학생들의 공통적인 빈 시간을 자동으로 탐색하고 일정을 잡아주는 프론트엔드 환경 구축
+**핵심 스택**: `Next.js 14`, `React`, `TypeScript`, `Tailwind CSS v3`, `shadcn/ui`, `Vitest`, `Playwright`
+
+### 주요 도메인
+
+| 도메인 | 설명 | 핵심 파일 |
+|--------|------|-----------|
+| 스케줄링 | 가용시간 교집합, .ics 파싱, 시간 슬롯 관리 | `src/lib/scheduling/` |
+| 인증 | 카카오/구글 소셜 로그인, Supabase Auth | `src/app/(auth)/`, `src/lib/supabase/` |
+| UI 컴포넌트 | TimeGrid, ParticipantList 등 도메인 전용 | `src/components/schedule/` |
+
+### 주요 변경 사항
+- Next.js 14버전 초기화 및 App 라우터 아키텍처 스캐폴딩 구성 완료 (2026.04.14)
+- TDD 기반 프로젝트 구조 수립: Vitest + RTL + Playwright 도입, PRD 기반 폴더 스켈레톤 생성 (2026.04.15)
+- Tailwind v3 + shadcn/ui HSL 디자인 토큰 체계 정립 (2026.04.15)
+- CI 파이프라인에 lint → test → build 검증 단계 추가 (2026.04.15)

.agents/docs/2_EXECUTION_PLAN.md

@@ -0,0 +1,33 @@
+# 2. Execution Plan
+**진행 상태**: `Phase 3 (TDD 기반 프로젝트 구조 수립 완료)`
+
+### 완료된 작업 (Done)
+- [x] PRD 구조 분석 및 핵심 기술 스택(14분기점) 추출
+- [x] Next.js 14 + Tailwind + TypeScript 보일러플레이트 적용 (MOIM 리포지토리)
+- [x] Socratic Auto-sync 기본 컨텍스트 1,2,3 초기화
+- [x] shadcn/ui 기반 설정(components.json, utils, css var 등) 디폴트 구성 완료
+- [x] GitHub Action CI/CD (lint & build test) 배포 구축 
+- [x] GitHub PR/이슈 템플릿 양식 추가 완료
+- [x] 커밋 및 브랜치 규칙 강제화 시스템 세팅 (Husky, commitlint, lint-staged)
+- [x] 초보자 친화적 `convention.md` 문서와 `.env.example` 작성 완료
+- [x] 시스템적 방어벽(GitHub Actions): PR 및 이슈 템플릿 준수율 자동 검증기 추가
+- [x] 테스트 프레임워크 설치 (Vitest + React Testing Library + Playwright)
+- [x] PRD 기반 폴더 스켈레톤 생성 (라우팅, 컴포넌트, 비즈니스 로직, 타입)
+- [x] 핵심 알고리즘 샘플 테스트 작성 (findCommonSlots — 6개 케이스 통과)
+- [x] CI에 테스트 실행 단계 추가 (lint → test → build)
+- [x] ARCHITECTURE.md 프로젝트 구조 가이드 작성
+- [x] Tailwind v3 + shadcn HSL 디자인 토큰 호환 수정
+- [x] ESLint underscore prefix 허용 규칙 추가
+- [x] 보안 문제 해결 (GitHub Actions Script Injection 조치 완료)
+- [x] 스켈레톤 컴포넌트 시맨틱 HTML(WAI-ARIA) 속성 사전 반영
+- [x] 테스트 엣지 케이스 추가 및 Next.js 14 최신 보안 패치 적용
+- [x] 랜딩 페이지(page.tsx) 기본 템플릿 제거 및 MOIM Placeholder 적용
+
+### 향후 작업 (To-Do)
+- [ ] UI 컴포넌트 실제 구현 (TimeGrid, ParticipantList, AvailabilityResult)
+- [ ] Supabase 백엔드 연동 및 OAuth 기본 환경 연결
+- [ ] 로그인 페이지 UI + 카카오/구글 소셜 로그인 구현
+- [ ] 일정 생성 페이지 폼 UI 구현
+- [ ] 참여자 입력 페이지 (캘린더 연동 / 수동 입력) 구현
+- [ ] .ics 파서 TDD 구현
+- [ ] E2E 테스트 작성 (호스트/참여자 플로우)

.agents/docs/3_FILE_INDEX.md

@@ -0,0 +1,58 @@
+# 3. File Index Map
+**현재 디렉터리 위치**: `C:\Users\kksu1\Dev\MOIM`
+
+### 설정 파일 (루트)
+| 파일 | 역할 |
+|------|------|
+| `package.json` | 의존성 & 스크립트 (dev, build, test, lint) |
+| `tsconfig.json` | TypeScript 컴파일러 설정, `@/` 경로 별칭 |
+| `tailwind.config.ts` | Tailwind v3 + shadcn HSL 디자인 토큰 |
+| `vitest.config.ts` | 단위 테스트 러너 설정 (jsdom, 경로 별칭) |
+| `playwright.config.ts` | E2E 테스트 설정 (Chromium, localhost:3000) |
+| `.eslintrc.json` | ESLint 규칙 (underscore prefix 허용) |
+| `commitlint.config.js` | 커밋 메시지 검증 규칙 |
+| `components.json` | shadcn/ui CLI 설정 |
+
+### 소스 코드 (`src/`)
+| 경로 | 역할 |
+|------|------|
+| `src/app/layout.tsx` | 루트 레이아웃 (Geist 폰트, 메타데이터) |
+| `src/app/page.tsx` | `/` 랜딩 페이지 |
+| `src/app/globals.css` | 전역 CSS + 디자인 토큰 (HSL 변수) |
+| `src/app/(auth)/layout.tsx` | 인증 전용 레이아웃 (GNB 없음) |
+| `src/app/(auth)/login/page.tsx` | `/login` 소셜 로그인 페이지 |
+| `src/app/schedule/create/page.tsx` | `/schedule/create` 일정 생성 |
+| `src/app/schedule/[id]/page.tsx` | `/schedule/:id` 참여자 진입 |
+| `src/components/ui/` | shadcn 원시 컴포넌트 |
+| `src/components/schedule/TimeGrid.tsx` | When2meet 시간 그리드 (스켈레톤) |
+| `src/components/schedule/ParticipantList.tsx` | 참여자 현황 (스켈레톤) |
+| `src/components/schedule/AvailabilityResult.tsx` | 가용시간 결과 (스켈레톤) |
+| `src/lib/scheduling/availability.ts` | ⭐ 가용시간 교집합 알고리즘 (구현 완료) |
+| `src/lib/scheduling/ics-parser.ts` | .ics 파일 파서 (스켈레톤) |
+| `src/lib/scheduling/time-slot.ts` | 시간 슬롯 유틸 (스켈레톤) |
+| `src/lib/scheduling/__tests__/` | 단위 테스트 (availability 6개 통과) |
+| `src/lib/supabase/client.ts` | Supabase 브라우저 클라이언트 (스켈레톤) |
+| `src/lib/supabase/server.ts` | Supabase 서버 클라이언트 (스켈레톤) |
+| `src/lib/utils.ts` | 공용 유틸리티 (cn 함수) |
+| `src/types/schedule.ts` | 스케줄링 타입 (TimeSlot, ScheduleSession 등) |
+| `src/types/user.ts` | 사용자/인증 타입 |
+| `src/test-setup.ts` | Vitest 전역 설정 (jest-dom) |
+
+### E2E 테스트 (`e2e/`)
+| 파일 | 역할 |
+|------|------|
+| `e2e/host-flow.spec.ts` | 호스트 플로우 시나리오 (스켈레톤) |
+| `e2e/participant-flow.spec.ts` | 참여자 플로우 시나리오 (스켈레톤) |
+
+### CI/CD (`.github/`)
+| 파일 | 역할 |
+|------|------|
+| `.github/workflows/pr-compliance.yml` | PR 템플릿 검사 + 코드 품질 검증 (lint→test→build) |
+| `.github/workflows/issue-compliance.yml` | 이슈 템플릿 준수 검사 |
+
+### 문서
+| 파일 | 역할 |
+|------|------|
+| `ARCHITECTURE.md` | 프로젝트 구조 가이드 (팀원 공유용) |
+| `convention.md` | 협업 컨벤션 가이드 (커밋, 브랜치, PR, 이슈) |
+| `PRD.md` / `PRD.pdf` | 프로젝트 기획 및 요구사항 정의서 |

.agents/docs/4_API_RESPONSE_FORMATS.md

@@ -0,0 +1,280 @@
+# 4. API Response Formats
+
+캘린더 연동 3종(에브리타임, Google Calendar, iCloud CalDAV)의 요청/응답 형식을 정리한다.
+모든 API는 JSON을 기본 응답 형식으로 사용하며, 에러 응답은 `{ "error": string }` 형태로 통일된다.
+
+---
+
+## 공통 타입
+
+```typescript
+// 요일 코드 — 스케줄링 도메인 전반에서 사용
+type DayCode = "MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN";
+
+// 빈 시간 슬롯 — 세 연동 모두 최종적으로 이 형태로 변환됨
+interface TimeSlot {
+  day: DayCode;
+  startHour: number; // 0-23
+  endHour: number;   // 0-23, startHour보다 커야 함
+}
+```
+
+---
+
+## 1. 에브리타임 (Everytime)
+
+### `POST /api/everytime/timetable`
+
+에브리타임 공유 URL 또는 ICS 파일로 시간표를 받아 빈 시간(`TimeSlot[]`)으로 변환한다.
+
+#### 방법 A — 공유 URL
+
+**Request**
+```
+Content-Type: application/json
+
+{
+  "url": "https://everytime.kr/@XXXX"
+}
+```
+
+Query parameter (선택): `?days=MON,WED,FRI` (기본값: 월~금)
+
+#### 방법 B — ICS 파일 업로드
+
+**Request**
+```
+Content-Type: multipart/form-data
+
+file: <.ics 파일>
+```
+
+#### Response `200`
+
+```typescript
+{
+  timetable: {
+    lectures: Array<{
+      name: string;
+      times: Array<{
+        day: 0 | 1 | 2 | 3 | 4 | 5 | 6; // 0=월, 1=화, ..., 6=일
+        startMinute: number; // 자정 기준 분 (예: 540 = 09:00)
+        endMinute: number;   // 자정 기준 분 (예: 705 = 11:45)
+      }>;
+    }>;
+  };
+  freeSlots: TimeSlot[];
+}
+```
+
+> **시간 단위**: 에브리타임 API의 `starttime` / `endtime` 값 × 5 = 자정 기준 분  
+> 예) `starttime=108` → 108 × 5 = 540분 = 09:00
+
+#### 에러 응답
+
+| 상태코드 | 사유 |
+|---|---|
+| `400` | url 필드 누락, ICS 파일 미첨부, 파일 형식 오류 |
+| `415` | Content-Type이 json/multipart 외의 값 |
+| `422` | 유효하지 않은 에브리타임 URL, ICS 파싱 실패 |
+| `500` | 서버 내부 오류 |
+
+---
+
+## 2. Google Calendar
+
+### `GET /api/google/calendars`
+
+연결된 Google 계정의 캘린더 목록을 반환한다.
+
+#### Response `200`
+
+```typescript
+{
+  calendars: Array<{
+    id: string;
+    summary: string;
+    description?: string;
+    backgroundColor?: string;
+    primary?: boolean;
+    accessRole: string;
+  }>;
+}
+```
+
+---
+
+### `GET /api/google/events/query`
+
+특정 캘린더의 기간별 일정을 조회한다.
+
+**Query parameters**
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|---|---|---|---|
+| `calendarId` | string | ✅ | 캘린더 ID |
+| `startDate` | string | ✅ | ISO 8601 (예: `2026-05-01T00:00:00Z`) |
+| `endDate` | string | ✅ | ISO 8601, startDate보다 이후 |
+
+#### Response `200`
+
+```typescript
+{
+  events: Array<{
+    id: string;
+    summary: string;
+    description?: string;
+    location?: string;
+    start: {
+      dateTime?: string; // ISO 8601 (시간 있는 이벤트)
+      date?: string;     // YYYY-MM-DD (종일 이벤트)
+      timeZone?: string;
+    };
+    end: {
+      dateTime?: string;
+      date?: string;
+      timeZone?: string;
+    };
+    status: string;
+    htmlLink?: string;
+  }>;
+}
+```
+
+---
+
+### `POST /api/google/events/create`
+
+**Request**
+```typescript
+{
+  calendarId: string;
+  summary: string;        // 1-255자
+  startDateTime: string;  // ISO 8601 (예: "2026-05-14T10:00:00+09:00")
+  endDateTime: string;    // ISO 8601
+  timeZone?: string;      // 예: "Asia/Seoul"
+  location?: string;      // 최대 500자
+  description?: string;   // 최대 8000자
+}
+```
+
+#### Response `201`
+
+```typescript
+{
+  event: GoogleEvent; // events/query 응답의 단건 항목과 동일
+}
+```
+
+#### 에러 응답
+
+| 상태코드 | 사유 |
+|---|---|
+| `401` | Google 계정 미연결 또는 인증 만료 |
+| `400` | 필수 파라미터 누락, 날짜 형식 오류 |
+| `502` | Google Calendar API 오류 |
+
+---
+
+## 3. iCloud CalDAV
+
+### `GET /api/icloud/calendars`
+
+연결된 iCloud 계정의 캘린더 목록을 반환한다. DB 캐시 우선, 없으면 CalDAV 서버에서 조회한다.
+
+**Query parameter**: `?connectionId=<UUID>`
+
+#### Response `200`
+
+```typescript
+{
+  calendars: Array<{
+    id: string;          // DB UUID
+    displayName: string;
+    calendarUrl: string; // CalDAV 캘린더 URL
+    color: string | null;
+  }>;
+  cached: boolean; // true: DB 캐시, false: CalDAV 서버에서 새로 조회
+}
+```
+
+---
+
+### `POST /api/icloud/events/query`
+
+특정 캘린더의 기간별 일정을 조회한다.
+
+**Request**
+```typescript
+{
+  calendarId: string; // DB UUID
+  startDate: string;  // ISO 8601
+  endDate: string;    // ISO 8601
+}
+```
+
+#### Response `200`
+
+```typescript
+{
+  events: Array<{
+    uid: string;
+    title: string;
+    startAt: string;            // ISO 8601
+    endAt: string;              // ISO 8601
+    isAllDay: boolean;
+    location: string | null;
+    description: string | null;
+    etag: string;               // CalDAV ETag (캐시 검증용)
+  }>;
+}
+```
+
+---
+
+### `POST /api/icloud/events/create`
+
+**Request**
+```typescript
+{
+  calendarId: string; // DB UUID
+  title: string;      // 1-255자
+  startAt: string;    // ISO 8601
+  endAt: string;      // ISO 8601
+  location?: string;  // 최대 500자
+  description?: string; // 최대 2000자
+}
+```
+
+#### Response `201`
+
+```typescript
+{
+  uid: string;      // 생성된 이벤트 UID
+  eventUrl: string; // CalDAV href
+  etag: string;     // CalDAV ETag
+}
+```
+
+#### 에러 응답
+
+| 상태코드 | 사유 |
+|---|---|
+| `401` | 인증 필요 또는 iCloud 인증 만료 |
+| `403` | 캘린더 소유권 불일치 |
+| `404` | calendarId 없음 |
+| `400` | 입력값 검증 실패 (UUID 형식, 날짜 형식 등) |
+| `502` | CalDAV 서버 오류 |
+
+---
+
+## 연동별 비교 요약
+
+| 항목 | 에브리타임 | Google Calendar | iCloud CalDAV |
+|---|---|---|---|
+| **인증** | 없음 (공개 URL) | OAuth 2.0 (세션 토큰) | Apple ID + 앱 암호 (세션) |
+| **시간 형식** | 분 단위 정수 (자정 기준) | ISO 8601 문자열 | ISO 8601 문자열 |
+| **요일 표현** | 0~6 정수 (0=월) | 이벤트 날짜에 포함 | 이벤트 날짜에 포함 |
+| **종일 이벤트** | 없음 (수업 시간표) | `date` 필드로 구분 | `isAllDay` 플래그 |
+| **반복 일정** | 없음 (주간 고정) | recurrence 지원 | 없음 (개별 이벤트 확장) |
+| **최종 출력** | `TimeSlot[]` (자동 변환) | `GoogleEvent[]` | `ParsedEvent[]` |