Feature/main features

.claude/hooks/clear-marker-on-start.sh

@@ -3,4 +3,5 @@ PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.."
 rm -f "${PROJECT_ROOT}/.claude/.pending-doc-check"
 rm -f "${PROJECT_ROOT}/.claude/.pending-rust-check"
 rm -f "${PROJECT_ROOT}/.claude/.pending-spec-check"
+rm -f "${PROJECT_ROOT}/.claude/.pending-fe-check"
 rm -f "${PROJECT_ROOT}/.claude/.plan-exists"

.claude/hooks/coverage-check-fe.sh

@@ -1,5 +1,7 @@
 #!/bin/bash
 PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+# 프론트 소스가 실제로 변경됐을 때만 실행 (마커 게이트). 대화만 한 턴은 즉시 통과.
+[ ! -f "${PROJECT_ROOT}/.claude/.pending-fe-check" ] && exit 0
 FE_DIR="${PROJECT_ROOT}/frontend"
 [ ! -d "$FE_DIR" ] && exit 0
 [ ! -d "$FE_DIR/node_modules" ] && exit 0

.claude/hooks/mark-pending.sh

@@ -6,6 +6,7 @@ PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.."
 MARKER="${PROJECT_ROOT}/.claude/.pending-doc-check"
 RUST_MARKER="${PROJECT_ROOT}/.claude/.pending-rust-check"
 SPEC_MARKER="${PROJECT_ROOT}/.claude/.pending-spec-check"
+FE_MARKER="${PROJECT_ROOT}/.claude/.pending-fe-check"
 PLAN_MARKER="${PROJECT_ROOT}/.claude/.plan-exists"
 
 # docs/plans/ 작성 시 플랜 마커 생성
@@ -16,7 +17,7 @@ fi
 
 # docs/works/ 또는 specification/ 작성 시 마커 제거
 if echo "$FILE_PATH" | grep -qE '(docs/works/|specification/)'; then
-  rm -f "$MARKER" "$RUST_MARKER" "$SPEC_MARKER"
+  rm -f "$MARKER" "$RUST_MARKER" "$SPEC_MARKER" "$FE_MARKER"
   exit 0
 fi
 
@@ -31,6 +32,11 @@ if echo "$FILE_PATH" | grep -qE '(backend/src/|frontend/src/|frontend/app/|backe
   touch "$MARKER"
 fi
 
+# 프론트 소스 변경 시 fe-check 마커 생성 (Stop 훅의 커버리지 게이트용)
+if echo "$FILE_PATH" | grep -qE '(frontend/src/|frontend/app/)'; then
+  touch "$FE_MARKER"
+fi
+
 # .rs 변경 시 rust-check 마커 생성
 if echo "$FILE_PATH" | grep -qE 'backend/.*\.rs$'; then
   touch "$RUST_MARKER"

.claude/hooks/session-doc-on-stop.sh

@@ -4,6 +4,10 @@ STOP_HOOK_ACTIVE=$(echo "$INPUT" | jq -r '.stop_hook_active // false')
 if [ "$STOP_HOOK_ACTIVE" = "true" ]; then exit 0; fi
 PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
 
+# 코드 작업이 있었던 턴에서만 세션 문서를 생성 (마커 게이트).
+# 대화만 한 턴은 무거운 claude --print 호출 없이 즉시 통과.
+[ ! -f "${PROJECT_ROOT}/.claude/.pending-doc-check" ] && exit 0
+
 TRANSCRIPT=$(echo "$INPUT" | jq -r '.transcript_path // ""')
 [ -z "$TRANSCRIPT" ] || [ ! -f "$TRANSCRIPT" ] && exit 0
 

backend/.env.example

@@ -2,3 +2,11 @@ DATABASE_URL=postgres://postgres:password@localhost:5432/coupang_review_ai
 JWT_SECRET=your-secret-key-here
 JWT_EXPIRES_IN=86400
 SERVER_PORT=8080
+GEMINI_API_KEY=your-gemini-api-key-here
+GEMINI_MODEL=gemini-2.5-flash
+
+# 크롤러 모드: http(기본, 실제 쿠팡) | mock(픽스처 리뷰, 로컬 데모용)
+CRAWLER_MODE=http
+# 스크래핑 API 프록시(선택). {url} 에 타겟 URL 이 치환된다. 예: ScraperAPI/ZenRows
+# 설정 시 모든 크롤링이 프록시 경유(anti-bot/IP 로테이션을 벤더가 처리).
+# COUPANG_PROXY_URL=https://api.scraperapi.com/?api_key=YOUR_KEY&url={url}

backend/Cargo.toml

@@ -29,9 +29,9 @@ tower = "0.4"
 tower-http = { version = "0.5", features = ["cors", "trace"] }
 tracing = "0.1"
 tracing-subscriber = { version = "0.3", features = ["env-filter"] }
+reqwest = { version = "0.11", features = ["json"] }
 
 [dev-dependencies]
-reqwest = { version = "0.11", features = ["json"] }
 tokio = { version = "1", features = ["full"] }
 dotenvy = "0.15"
 testcontainers-modules = { version = "0.11", features = ["postgres"] }

backend/migrations/00002_users.sql

@@ -0,0 +1,7 @@
+CREATE TABLE users (
+    id            UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    email         TEXT NOT NULL UNIQUE,
+    password_hash TEXT NOT NULL,
+    plan          TEXT NOT NULL DEFAULT 'free',
+    created_at    TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);

backend/migrations/00003_analyses.sql

@@ -0,0 +1,12 @@
+CREATE TABLE analyses (
+    id           UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    user_id      UUID NOT NULL REFERENCES users(id),
+    urls         TEXT[] NOT NULL,
+    review_limit INT NOT NULL DEFAULT 100,
+    status       TEXT NOT NULL DEFAULT 'pending',
+    result       JSONB,
+    error        TEXT,
+    created_at   TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    completed_at TIMESTAMPTZ
+);
+CREATE INDEX idx_analyses_user_created ON analyses (user_id, created_at DESC);