# task-1756.1 완료 보고서

## SCQA

**S**: InsuWiki BacklinksPanel 컴포넌트가 문서 간 역링크를 Firestore 쿼리로 조회하여 표시하고 있다.

**C**: qLinkedIds 쿼리에 `where('isDeleted', '==', false)` 조건이 포함되어 있어, `isDeleted` 필드가 아예 존재하지 않는 wiki__ 계열 문서들이 쿼리에서 제외됨. Firestore의 `== false`는 명시적으로 `false` 값인 문서만 매칭하므로, 필드 부재 = 조건 미매칭 → Backlinks 0건 표시.

**Q**: isDeleted 필드가 없는 문서도 Backlinks에 정상 표시되도록 쿼리를 수정할 수 있는가?

**A**: qLinkedIds 쿼리에서 `where('isDeleted', '==', false)` 조건을 제거하여 해결. 삭제된 문서는 별도 soft-delete 로직으로 처리되므로 쿼리 단 중복 필터 불필요. Next.js 빌드 성공(에러 0건), git push 완료(커밋 4c4bc3c), dev 서버 재시작 완료.

## 수정 내역

- **파일**: `/home/jay/projects/insuwiki/nextapp/src/components/BacklinksPanel.tsx`
- **변경**: 라인 37-48 qLinkedIds 쿼리에서 `where('isDeleted', '==', false)` 조건 제거 (2줄 삭제, 1줄 수정 — 콤마 제거)
- **커밋**: `4c4bc3c` — `fix: backlinks isDeleted filter excludes docs without field`
- **빌드**: `npm run build` 성공 (에러 0건)
- **배포**: `git push origin master` 완료

## 산출물

- `/home/jay/projects/insuwiki/nextapp/src/components/BacklinksPanel.tsx`

## 발견 이슈 및 해결

### 자체 해결 (1건)
1. **isDeleted 필드 부재 문서 쿼리 제외** — `where('isDeleted', '==', false)` 조건 제거로 해결

### 범위 외 미해결 (2건)
1. **useRouter import 미사용 경고** (BacklinksPanel.tsx:5) — 기존 코드의 pre-existing issue. 본 작업 범위(isDeleted 필터 수정)와 무관
2. **wiki__ 문서에 isDeleted 필드 일괄 추가 여부** — 데이터 마이그레이션은 별도 작업 필요. DB 스키마 변경은 본 작업 범위 외

## 셀프 QC

- [x] 1. 영향 파일: BacklinksPanel.tsx 1개만 수정
- [x] 2. 엣지 케이스: isDeleted:true 문서 → soft-delete 로직에서 별도 처리
- [x] 3. 작업 지시 일치: isDeleted 조건 제거만 수행
- [x] 4. 에러 처리/보안: 변경 없음
- [x] 5. 테스트: 빌드 성공으로 컴파일 검증 (프론트 컴포넌트 유닛 테스트 없음)
- [x] 6. 이슈 해결: 1건 해결, 2건 범위 외
- [x] 7. 아키텍처 원칙: 단순 조건 제거, SOLID/DRY 위반 없음
- [x] 8. 인터페이스 변경: 없음

## 증거

- Next.js 빌드 성공 (에러 0건, 전체 페이지 정상 빌드)
- git diff: 1 file changed, 1 insertion(+), 2 deletions(-)
- git push 성공: `9e38fd8..4c4bc3c master -> master`

## 모델 사용 기록

- 팀원: 이리스 / 작업 내용: BacklinksPanel.tsx isDeleted 필터 제거 / 사용 모델: sonnet / 정당성: -

## 세션 통계
- 총 도구 호출: 5회

### 수정 파일 목록
- bash_cmd: 2회 (Bash)
- /home/jay/projects/insuwiki/nextapp/src/components/BacklinksPanel.tsx: 1회 (Edit)
- /home/jay/workspace/memory/reports/task-1756.1.md: 1회 (Write)
- /home/jay/workspace/memory/tasks/task-1756.1.md: 1회 (dispatch)

### 도구 사용 현황
- Bash: 2회
- Edit: 1회
- Write: 1회
- dispatch: 1회