# 전체 에이전트 미팅: Phase 5 완료 후 향후 전략 수립

> **일시**: 2026-02-10 20:53
> **참석자**: PM(Jay 부장), FE 에이전트, BE 에이전트, UX 에이전트, QA 에이전트, Data 에이전트
> **안건**: Phase 5 거의 완료 — 남은 작업 정리 및 Phase 6 진입 전략

---

## 1. 현재 상태 요약

| Phase | 상태 | 비고 |
|-------|------|------|
| Phase 1~4 | ✅ 완료 | 환경, CRUD, 검색, 데일리, 백링크, Rename 동기화 |
| Phase 5 | 🟢 거의 완료 | 5탭 필터, 허브 섹션, 서버사이드 집계 모두 구현 |
| Firebase Emulator | 🟡 코드 완료 / 미검증 | `lib/firebase.ts`에 연결 코드 있으나 실운영 미확인 |
| Phase 6 (배포) | 🔴 대기 | 미착수 |

---

## 2. 에이전트별 의견

### 🛡️ BE 에이전트
- "서버사이드 백링크 집계(`aggregateBacklinks.ts`)가 구현되었으나, **실제 Cloud Functions 배포가 아직 안 됐습니다**. 배포 전 `scripts/aggregate-backlinks.ts`로 기존 데이터 초기 집계를 먼저 해야 합니다."
- "Firebase Emulator 설정이 코드에는 반영되어 있지만, **실제 `firebase init emulators`가 실행된 적이 없어서** 에뮬레이터 설정 파일(`firebase.json`)이 없습니다. Quota 이슈가 계속될 수 있습니다."
- "`noUnusedLocals` tsconfig 옵션 때문에 Cloud Functions 빌드가 까다로울 수 있으니 배포 전 `npm run build` 확인 필수입니다."

### 🎨 FE 에이전트
- "현재 UI는 기능적으로 완성되어 있습니다. 하지만 **반응형(모바일) 대응이 미검증** 상태입니다."
- "카테고리 탭이 5개인데, 모바일에서 좁은 화면에 어떻게 표시될지 확인이 필요합니다 (`overflow-x-auto`가 있지만 실기기 테스트는 안 함)."
- "Firebase Hosting으로 배포하면 **성능 최적화(이미지, 번들 크기)** 점검도 필요합니다."

### 🔍 UX 에이전트
- "Phase 5 허브 섹션은 직관적이지만, **문서가 5개 미만일 때 허브 섹션이 비어 보이는 문제**가 있을 수 있습니다. 빈 상태(empty state) UX를 확인해야 합니다."
- "카테고리 '일반(general)'이 기본값인데, 사용자가 '미분류'로 혼동할 수 있습니다. UI 레이블을 점검할 필요가 있습니다."

### 🧪 QA 에이전트
- "**공식 QA가 한 번도 진행되지 않았습니다.** Phase 1~5 전체 기능에 대한 통합 테스트가 필요합니다."
- "특히 다음 시나리오를 반드시 테스트해야 합니다:"
  1. 문서 생성 → 카테고리 설정 → 카테고리 탭에서 필터링
  2. 문서 A에서 `[[문서B]]` 링크 추가 → 허브 섹션에 문서B 표시
  3. 문서 제목 변경 → 백링크 자동 갱신 확인
  4. 다수 문서(10+) 상태에서 검색, 필터, 허브 섹션 동시 동작
- "현재 자동화된 테스트(unit/e2e)가 **전무하므로**, 최소한 수동 테스트 체크리스트라도 만들어야 합니다."

### 📊 Data 에이전트
- "초기 집계 스크립트(`aggregate-backlinks.ts`)를 **배포 전 반드시 1회 실행**해야 합니다. 그렇지 않으면 기존 문서의 `incomingLinkCount`가 전부 0이어서 허브 섹션이 폴백 모드로만 동작합니다."
- "마이그레이션 체크리스트를 명확히 해야 합니다:"
  1. 기존 문서에 `category: 'general'` 미설정 → 필터링 시 `doc.category || 'general'`로 폴백하고 있지만, 데이터 일관성을 위해 명시적 설정 권장
  2. `incomingLinkCount` 초기값 설정

### 🏗️ PM (Jay 부장)
- "Phase 5까지 핵심 기능은 모두 잘 왔습니다. 이제 **'쓸 수 있는 앱'에서 '믿고 쓸 수 있는 앱'**으로 가야 합니다."
- "순서를 정리하면 이렇습니다:"

---

## 3. 의사결정: 향후 작업 우선순위

### 🔴 즉시 (이번 세션)
| # | 작업 | 담당 | 예상 시간 | 비고 |
|---|------|------|----------|------|
| ~~1~~ | ~~Firebase Emulator 설정~~ | — | — | ⚠️ 아래 Jay 부장 리뷰 참고 |
| ~~2~~ | ~~Cloud Functions 배포~~ | — | — | ⚠️ Blaze 플랜 확인 필요 |
| ~~3~~ | ~~초기 집계 스크립트 실행~~ | — | — | ⚠️ serviceAccountKey 필요 |

### 🟡 단기 (1~2일)
| # | 작업 | 담당 | 예상 시간 |
|---|------|------|----------|
| 4 | QA 통합 테스트 (수동 체크리스트 기반) | QA | 2시간 |
| 5 | 모바일 반응형 점검 및 수정 | FE/UX | 1시간 |
| 6 | 기존 문서 마이그레이션 (`category` 기본값 설정) | Data | 30분 |

### 🟢 중기 (Phase 6)
| # | 작업 | 담당 | 예상 시간 |
|---|------|------|----------|
| 7 | Firebase Hosting 배포 | BE | 1시간 |
| 8 | 커스텀 도메인 연결 | BE | 30분 |
| 9 | 운영 모니터링 설정 (Error tracking) | BE | 1시간 |
| 10 | 성능 최적화 (번들 크기, 이미지) | FE | 2시간 |

### ⚪ 장기 (선택)
| # | 작업 | 담당 | 비고 |
|---|------|------|------|
| 11 | 자동화 테스트 (Cypress/Playwright) | QA | 시간 투자 대비 효용 검토 필요 |
| 12 | Repository 패턴 도입 | BE | DB 교체 필요 시 |
| 13 | PWA 지원 (오프라인 모드) | FE | 모바일 앱 대용 |
| 14 | AI 기반 문서 추천/요약 | Data | 향후 킬러 기능 후보 |

---

## 3-1. 🏗️ Jay 부장 더블체크 리뷰 (20:58 추가)

> **결론**: 미팅 방향은 맞으나, "즉시" 3개 항목에 **선행 조건이 누락**되어 순서를 수정합니다.

### ⚠️ 수정 사항

**1. Firebase Emulator — 코드는 준비됐지만 실행 이력 없음**
- `lib/firebase.ts`에 에뮬레이터 연결 코드 ✅ 존재
- `firebase.json` ❌ 없음 → `firebase init emulators` 미실행 상태
- 이전 세션에서 시도했으나 **완료 안 됨**

**2. Cloud Functions 배포 — Blaze 플랜 필요**
- Cloud Functions는 **Spark(무료) 플랜에서 배포 불가**
- Blaze(종량제) 업그레이드가 선행되어야 함
- Spark이면: 클라이언트 폴백으로 유지하고 배포 보류

**3. 초기 집계 스크립트 — serviceAccountKey.json 필요**
- Firebase Admin SDK 직접 접근이므로 서비스 계정 키 필수
- Firebase Console > 프로젝트 설정 > 서비스 계정에서 다운로드

### ✅ 수정된 실행 순서

```
[오늘 가능한 것]
  1. Firebase 플랜 확인 (Spark vs Blaze)
  2. Firebase CLI 상태 확인 (firebase --version, firebase projects:list)
  3. QA 테스트 체크리스트 작성 (코드 없이 가능)

[다음 세션]
  4. Firebase Emulator 설정 완료 (firebase init emulators)
  5. 플랜에 따라 Cloud Functions 배포 or 보류 결정
  6. 초기 집계 스크립트 실행 (serviceAccountKey 준비 후)
  7. QA 수동 테스트 실행

[Phase 6]
  8. Firebase Hosting 배포
  9. 도메인 + 모니터링
```

---

## 4. 합의 사항

> **다음 행동**: Firebase 플랜 확인 → Emulator 완성 → Cloud Functions 배포 → QA 테스트 → Phase 6 배포

1. Phase 5는 **QA 테스트 완료 시 공식 완료 처리** (현재 '거의 완료')
2. Firebase Emulator는 **Quota 이슈 재발 방지를 위해 즉시 완성** 필요
3. Cloud Functions 배포는 **Blaze 플랜 확인 후 진행** (Spark이면 보류)
4. Phase 6(배포)는 **QA 통과 후 진입** — 불안정한 상태로 배포하지 않음
5. 자동화 테스트는 **배포 후 우선순위 검토** (현재는 수동 QA 집중)

---

## 5. 액션 아이템

- [x] PM: Firebase 플랜 확인 → ✅ Blaze 전환 완료 (무료 체험판 $300 크레딧 적용) — 21:17
- [x] BE: Firebase CLI 상태 확인 → ✅ v15.5.1, 프로젝트 `insuwiki-j2h` 연결 완료
- [x] BE: `firebase.json`, `.firebaserc` 수동 생성 → Emulator 포트 설정 포함 (Auth 9099, Firestore 8080, Functions 5001, UI 4000)
- [x] BE: Cloud Functions 배포 → ✅ 3개 함수 us-central1에 배포 성공 (Node.js 18→20 업그레이드)
  - `cleanupExpiredLocks` (스케줄)
  - `releaseDocumentLock` (onCall)
  - `aggregateBacklinks` (onWrite 트리거)
- [x] ~~Data: serviceAccountKey.json 준비 → 초기 집계 스크립트 실행~~ → ⏭️ **스킵** (Cloud Functions 배포 완료로 점진적 자동 갱신 가능, 폴백 로직 존재)
- [ ] QA: 수동 테스트 체크리스트 작성 → 테스트 실행
- [ ] FE: 모바일 반응형 브레이크포인트 확인
- [ ] PM: Phase 5 완료 리뷰 문서 작성 후 Phase 6 진입 승인

---
🤖 Generated with [Claude Code](https://claude.com/claude-code)