[release] FE v1.7.4

.github/workflows/pr-auto-label.yml

@@ -0,0 +1,75 @@
+name: PR Auto Label
+
+on:
+  pull_request:
+    types: [opened, edited, synchronize]
+    branches: [main, develop-fe, develop/be]
+
+jobs:
+  label:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+
+    steps:
+      - name: Auto Label PR
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const title = context.payload.pull_request.title.toLowerCase();
+            const prNumber = context.payload.pull_request.number;
+
+            // 1. PR 제목 기반 타입 라벨 (conventional commit)
+            const typeMap = [
+              { pattern: /^feat/,             label: '✨ Feature' },
+              { pattern: /^hotfix/,           label: '🚀 hotfix' },
+              { pattern: /^fix/,              label: '🛠Fix' },
+              { pattern: /^bug/,              label: '🐞 Bug' },
+              { pattern: /^refactor/,         label: '🔨 Refactor' },
+              { pattern: /^docs/,             label: '📃 Docs' },
+              { pattern: /^chore/,            label: '🚗 Chore' },
+              { pattern: /^style/,            label: '🎨 Design' },
+              { pattern: /^test/,             label: '✅ Test' },
+              { pattern: /^ci|^cd/,           label: '📦 CI/CD' },
+              { pattern: /^deploy|^release/,  label: '🌏 Deploy' },
+              { pattern: /^setup|^setting/,   label: '⚙ Setting' },
+              { pattern: /^api/,              label: '📬 API' },
+            ];
+
+            const labelsToAdd = [];
+
+            for (const { pattern, label } of typeMap) {
+              if (pattern.test(title)) {
+                labelsToAdd.push(label);
+                break;
+              }
+            }
+
+            // AB TEST
+            if (/experiment|ab.?test/i.test(title)) labelsToAdd.push('AB TEST');
+
+            // AI 활용 감지 (제목 또는 본문)
+            const body = context.payload.pull_request.body ?? '';
+            if (/claude|codex/i.test(title + body)) labelsToAdd.push('🚁AI');
+
+            // 2. 변경 파일 경로 기반 FE/BE 라벨
+            const { data: files } = await github.rest.pulls.listFiles({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: prNumber,
+            });
+
+            const filenames = files.map(f => f.filename);
+            if (filenames.some(f => f.startsWith('frontend/'))) labelsToAdd.push('💻 FE');
+            if (filenames.some(f => f.startsWith('backend/')))  labelsToAdd.push('💾 BE');
+
+            if (labelsToAdd.length > 0) {
+              await github.rest.issues.addLabels({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: prNumber,
+                labels: labelsToAdd,
+              });
+              core.info(`Added labels: ${labelsToAdd.join(', ')}`);
+            }

frontend/.claude/agents/RN에이전트.md

@@ -0,0 +1,121 @@
+# RN 에이전트 (React Native)
+
+모아동 React Native + Expo 프로젝트 전담 에이전트.
+WebView 브릿지, 딥링크/라우팅, Push 알림, API/인증 관련 코드를 분석하고 수정한다.
+
+## 프로젝트 경로
+
+/Users/seokyoung-won/Desktop/moadong-react-native/
+
+## 기술 스택
+
+- Expo SDK + Expo Router (파일 기반 라우팅)
+- React Native New Architecture (`newArchEnabled: true`)
+- React Compiler (실험적 기능)
+- Axios (`publicApi` / `authApi`) — `api` default export는 deprecated
+- React Context (Redux/Zustand 미사용)
+- Firebase (Remote Config, FCM)
+- Mixpanel 애널리틱스
+
+## 아키텍처
+
+### 라우팅 구조
+
+```
+app/
+  _layout.tsx          # 루트 레이아웃: 부트스트랩, 스플래시, 강제 업데이트, Context
+  (tabs)/
+    index.tsx          # 홈 탭
+    explore.tsx        # 탐색 탭
+    more.tsx           # 더보기 탭
+  club/[id].tsx        # 동아리 상세 (WebView)
+  clubDetail/[id].tsx  # 동아리 상세 (네이티브)
+  webview/[slug].tsx   # 범용 WebView 화면
+  modal.tsx            # 모달
+```
+
+### UI 레이어 패턴
+
+기능별 폴더 `ui/<feature>/` 하위 구조 (필요한 것만 생성):
+
+- `hook/` — 데이터 페칭 훅 (예: `useClubs`, `useSubscribedClubs`)
+- `model/` — 파생 상태 / 데이터 변환 (선택)
+- `components/` — UI 컴포넌트
+- `index.ts` — barrel export
+
+### 부트스트랩 순서 (`app/_layout.tsx`)
+
+1. Firebase Remote Config 강제 업데이트 체크
+2. iOS ATT 권한 요청
+3. 액세스 토큰 조회/생성
+4. FCM 토큰 등록
+5. 서버에서 구독 동아리 목록 동기화
+6. Mixpanel 초기화
+
+### API 클라이언트 (`services/api.ts`)
+
+- `publicApi` — 인증 없는 요청
+- `authApi` — Bearer 토큰 자동 첨부, 401 시 `/auth/student`로 자동 갱신
+- ⚠️ `api` (default export) 는 deprecated — 신규 코드에 사용 금지
+
+### 상태 관리 (Context)
+
+- `SubscribedClubsProvider` (`contexts/subscribed-clubs-context.tsx`) — 구독 동아리 목록, 토글, 서버 동기화
+- `MixpanelProvider` (`contexts/mixpanel-context.tsx`) — 애널리틱스
+
+## 시나리오별 핵심 파일
+
+### WebView 브릿지
+
+웹 ↔ RN 메시지 통신 관련 파일:
+
+- `app/club/[id].tsx` — WebView 컴포넌트, `onMessage` 핸들러
+- `app/webview/[slug].tsx` — 범용 WebView, postMessage 처리
+- 프론트엔드 쪽: `src/utils/webviewBridge.ts` (참조용, 수정 불가)
+
+### 딥링크 / 라우팅
+
+- `app/_layout.tsx` — Linking 설정, 초기 라우트 처리
+- `app.json` — 딥링크 스킴(`moadongapp://`), associated domain(`www.moadong.com`)
+- Expo Router 파일 기반 라우팅: `app/` 디렉토리에 파일 추가 = 라우트 자동 등록
+
+### Push 알림
+
+- `app/_layout.tsx` 4번째 부트스트랩 단계에서 FCM 토큰 등록
+- `services/api.ts` — 토큰 등록 API 호출
+- `google-services.json` / `GoogleService-Info.plist` — Firebase 설정 파일
+
+### API / 인증
+
+- `services/api.ts` — Axios 인스턴스 정의
+- `contexts/subscribed-clubs-context.tsx` — `authApi` 사용 예시
+- 환경 변수: `EXPO_PUBLIC_BASE_URL` (`.env` 파일)
+
+## 디자인 시스템 (`constants/theme.ts`)
+
+- `MainColors` — 오렌지 계열 (`main` = `#FF5414`)
+- `TagColors` — 카테고리별 색상 (봉사/학술/종교/취미교양/운동/공연)
+- `Spacing` — 4px 기준: `xs`(4) `sm`(8) `md`(16) `lg`(24) `xl`(32) `xxl`(40) `xxxl`(48)
+- `BorderRadius` — `xs`(4) `sm`(8) `md`(12) `lg`(16) `xl`(20) `full`(9999)
+- 폰트: Pretendard. RN `Text` 대신 `@/components/moa-text`의 `<MoaText type="...">` 사용
+
+## 네이밍 컨벤션
+
+- 파일명: `kebab-case.tsx`
+- 컴포넌트: `PascalCase`
+- 훅: `use` 접두사 + `camelCase`
+- **named export 선호** — default export는 `app/` 화면 컴포넌트에만 허용
+- 경로 별칭: `@/` → 프로젝트 루트
+- 플랫폼별 파일: `.ios.tsx` / `.web.ts` 접미사
+
+## 수정 체크리스트
+
+코드 수정 시 반드시 확인:
+
+- [ ] `authApi` / `publicApi` 구분 올바른가? (`api` default 사용 금지)
+- [ ] 파일명이 `kebab-case`인가?
+- [ ] named export를 사용했는가? (`app/` 화면 제외)
+- [ ] `@/` 경로 별칭을 사용했는가? (상대 경로 지양)
+- [ ] TypeScript 타입이 명시적인가? (`any` 금지)
+- [ ] 디자인 토큰을 `constants/theme.ts`에서 가져왔는가?
+- [ ] 텍스트에 RN `<Text>` 대신 `<MoaText type="...">` (`@/components/moa-text`)를 사용했는가?

frontend/.claude/commands/RN.md

@@ -0,0 +1,22 @@
+---
+description: React Native 프로젝트 분석 및 수정을 RN 에이전트에게 위임
+allowed-tools: Agent
+---
+
+RN(React Native) 프로젝트 작업을 RN에이전트 서브에이전트에게 위임합니다.
+
+## 작업 내용
+
+$ARGUMENTS
+
+## 지시사항
+
+`$ARGUMENTS`가 비어 있으면, 사용자에게 어떤 RN 관련 작업이 필요한지 물어본 뒤 RN에이전트를 호출하세요.
+
+Agent 툴로 `RN에이전트` 서브에이전트를 호출하여 위 작업을 처리하세요.
+
+다음 컨텍스트를 에이전트에게 전달하세요:
+
+- RN 프로젝트 경로: `/Users/seokyoung-won/Desktop/moadong-react-native/`
+- 현재 프론트엔드 프로젝트 경로: `/Users/seokyoung-won/Desktop/moadong/frontend/`
+- 두 프로젝트가 WebView로 연동되어 있음 (프론트엔드 웹 → RN WebView)

frontend/.claude/commands/check-tracking.md

@@ -0,0 +1,90 @@
+# 이벤트 트래킹 감사 (Event Tracking Audit)
+
+`src/constants/eventName.ts`의 정의와 실제 코드베이스 사용 현황을 비교해 Mixpanel 트래킹 누락을 점검합니다.
+
+> **실행 위치**: 아래 모든 명령은 **`frontend/` 디렉터리**에서 실행해야 합니다.
+> 모노레포 루트에서 실행하면 `src/` 경로를 찾지 못해 결과가 0건으로 나옵니다.
+
+## 분석 순서
+
+아래 bash 명령을 순서대로 실행하고 결과를 수집하세요.
+
+### Step 1: 정의된 이벤트 목록 추출
+
+```bash
+grep -E "^\s+[A-Z_]+:" src/constants/eventName.ts
+```
+
+`USER_EVENT` 안의 키만 수집합니다 (`ADMIN_EVENT`, `PAGE_VIEW`는 제외).
+
+### Step 2: 실제 trackEvent 호출 현황
+
+```bash
+grep -rn "trackEvent(USER_EVENT\." src/ --include="*.tsx" --include="*.ts"
+```
+
+어떤 파일의 몇 번째 줄에서 어떤 이벤트를 호출하는지 수집합니다.
+
+### Step 3: 트래킹 미적용 인터랙션 탐지
+
+```bash
+grep -rn "onClick\|onSubmit" src/pages/ src/components/ --include="*.tsx" -l
+```
+
+위 파일 목록 중 `trackEvent`를 import하는 파일:
+
+```bash
+grep -rln "trackEvent\|useMixpanelTrack" src/pages/ src/components/ --include="*.tsx"
+```
+
+두 목록의 **교집합 파일** — 즉, onClick/onSubmit이 있고 trackEvent도 쓰는 파일 — 에서 trackEvent 없이 onClick만 있는 핸들러를 탐지합니다:
+
+```bash
+grep -n "onClick\|onSubmit" <파일경로>
+```
+
+각 핸들러 주변 5줄을 읽어 trackEvent 호출이 없으면 누락 의심으로 분류합니다.
+
+### Step 4: 미사용 이벤트 탐지
+
+Step 1에서 수집한 USER_EVENT 키 각각에 대해 Step 2 결과에서 사용 여부를 확인합니다.
+한 번도 등장하지 않는 키는 미사용 이벤트입니다.
+
+---
+
+## 출력 형식
+
+분석 결과를 아래 3개 표로 요약합니다.
+
+### ✅ 트래킹 중인 이벤트
+
+| 이벤트명           | 사용 파일            |
+| ------------------ | -------------------- |
+| `CLUB_MAP_CLICKED` | `ClubDetailPage.tsx` |
+| …                  | …                    |
+
+### ⚠️ 트래킹 누락 의심 인터랙션
+
+onClick/onSubmit이 있으나 trackEvent 호출이 없는 핸들러. **사용자 의도가 담긴 주요 액션**(버튼 클릭, 폼 제출 등)에 한해 나열하고, 단순 상태 토글이나 내부 UI 제어는 제외합니다.
+
+| 파일                     | 핸들러       | 비고           |
+| ------------------------ | ------------ | -------------- |
+| `ClubDetailPage.tsx:157` | `onMapClick` | 지도 모달 열기 |
+| …                        | …            | …              |
+
+### 🗑️ 정의만 되고 미사용 이벤트 (USER_EVENT 기준)
+
+코드 어디서도 `trackEvent`로 호출되지 않는 이벤트.
+
+| 키           | 이벤트명       |
+| ------------ | -------------- |
+| `SOME_EVENT` | `'Some Event'` |
+| …            | …              |
+
+---
+
+## 주의사항
+
+- `ADMIN_EVENT`와 `PAGE_VIEW`는 별도 트래킹 체계(useTrackPageView 등)를 사용하므로 이번 감사 대상에서 제외합니다.
+- 누락 의심은 **사용자 행동 추적 가치가 있는** 인터랙션에 집중합니다. 드롭다운 토글, 입력 포커스 등 세부 UI 이벤트는 판단이 필요한 경우 별도로 언급합니다.
+- 결과 출력 후 실제 추가가 필요한 항목이 있으면 이어서 작업할지 물어봅니다.

frontend/.claude/commands/cross-review.md

@@ -0,0 +1,13 @@
+크로스 에이전트 코드 리뷰를 실행합니다. 코드를 작성한 AI와 다른 AI가 리뷰합니다.
+
+사용법:
+
+- `/cross-review claude` — Claude로 작성 → Codex가 리뷰
+- `/cross-review codex` — Codex로 작성 → Claude가 리뷰
+- `/cross-review` — 기본값: claude로 간주 (Codex가 리뷰)
+
+아래 명령을 실행하고 결과를 그대로 출력합니다:
+
+```bash
+./scripts/cross-review.sh --writer ${ARGUMENTS:-claude}
+```

frontend/.claude/commands/jira-story.md

@@ -0,0 +1,44 @@
+Jira 스토리를 대화형으로 생성합니다.
+
+다음 순서로 사용자에게 질문하세요:
+
+1. **제목**: "스토리 제목을 입력해주세요. (예: 사용자는 동아리 카드를 클릭하여 상세 페이지로 이동할 수 있다)"
+2. **설명**: "스토리 설명을 입력해주세요. (없으면 Enter)" — 선택사항
+3. **인수 조건**: "인수 조건(Acceptance Criteria)을 입력해주세요. (없으면 Enter)" — 선택사항
+
+모든 입력이 완료되면 아래 명령을 실행하세요:
+
+```bash
+./scripts/jira-story.sh "제목" "설명" "인수조건"
+```
+
+- 설명이나 인수 조건이 없으면 빈 문자열("")로 전달합니다.
+- 실행 후 생성된 스토리 키와 링크를 그대로 출력합니다.
+- `JIRA_EMAIL` 또는 `JIRA_API_TOKEN` 환경 변수가 없으면 설정 방법을 안내합니다.
+
+---
+
+## GitHub 이슈 (하위 작업 + 브랜치) 연동
+
+스토리 생성 후 바로 이어서 물어보세요:
+
+"GitHub 이슈(Jira 하위 작업 + 브랜치)도 함께 생성할까요?"
+
+**Yes인 경우** 아래 순서로 추가 질문:
+
+4. **담당자**: "담당자를 선택해주세요." — seongwon030 / oesnuj / Zepelown / PororoAndFriends / lepitaaar / suhyun113 / alsdddk / yw6938 / seongje973 중 선택
+5. **브랜치명**: "브랜치명을 입력해주세요. (예: feature/add-login-page)"
+6. **분기 브랜치**: "분기할 브랜치를 입력해주세요. (기본값: develop-fe)" — 선택사항
+7. **태스크**: "체크리스트를 입력해주세요. (없으면 Enter)" — 선택사항, 기본값 `- [ ] Task1`
+
+모든 입력이 완료되면:
+
+```bash
+./scripts/jira-task.sh "제목" "담당자" "MOA-xxx" "브랜치명" "분기브랜치" "" "태스크"
+```
+
+- `MOA-xxx`는 앞서 생성된 스토리 키를 그대로 사용합니다.
+- 분기 브랜치 미입력 시 `develop-fe` 사용합니다.
+- 태스크 미입력 시 `- [ ] Task1` 기본값 사용합니다.
+- 실행 후 GitHub 이슈 URL을 출력합니다.
+- GitHub Actions이 자동으로 Jira 하위 작업과 브랜치를 생성합니다.