# 유지보수 및 신규 기능 요청 (Maintenance & Features)

## 1. 개요
*   **작성일**: 2026-02-13
*   **요청자**: User
*   **상태**: 진행중

## 2. 요구사항 목록 (Todo)
- [x] **[버그]** 목차(TOC) 클릭 시 해당 위치로 스크롤 이동 안 됨 <!-- id: toc-bug -->
- [/] **[버그]** 문서 내용은 보이나 브라우저 탭 제목이 "문서를 찾을 수 없음"으로 표시됨 <!-- id: title-bug -->
    *   *원인*: Vercel 환경변수 누락 (`FIREBASE_SERVICE_ACCOUNT_KEY`)
    *   *상태*: **해결 가이드 제공 완료** (`docs/guides/vercel-env-setup-for-firebase-admin.md`)
    *   *조치*: 사용자가 가이드에 따라 Vercel 설정을 완료해야 함.
- [x] **[기능]** 구글 로그인 시 조직 내/외 사용자 구분 및 그룹 관리 기능 <!-- id: group-mgmt -->
    *   **구현 완료**: Firestore `users` 컬렉션 연동, `Guest` 차단 로직, 관리자 페이지.
- [x] **[기능]** Google Drive(5TB)를 파일 저장소로 활용하여 지식 카드에 파일 첨부 (완료) <!-- id: gdrive-attach -->
    *   *구현*: Firebase Auth 인증 후 Google Drive API로 파일 업로드.
    *   *기능*: 파일 첨부, 다운로드, 삭제 기능 구현 완료.
- [/] **[개선]** 목차(TOC) 깊이 제한 및 번호 표시 <!-- id: toc-improve -->
    *   *요청*: 2단계(H2)까지만 표시하고, 계층형 번호(1., 1.1.)를 붙여서 가독성 향상.
    *   *구현*: `TableOfContents.tsx` 수정 완료.
- [x] **[UX/Refactor]** App-Style Layout (독립 스크롤) 적용 (완료) <!-- id: layout-refactor -->
    *   *목표*: 헤더/목차 고정, 본문만 독립 스크롤 (Overlap/Disconnect 현상 제거)
    *   *상태*: `h-screen flex flex-col` 구조 적용, TOC `scrollIntoView` 개선. (`walkthrough.md` 참고)

## 3. 상세 분석 및 계획

### 3.1. 목차(TOC) 클릭 버그 (완료)
*   **해결**: `DocumentClient` - `MarkdownComponents`의 ID 생성 로직을 `TableOfContents`와 동일하게 수정.

### 3.2. 브라우저 타이틀 오류 (대기)
*   **조치**: Vercel 프로젝트 설정에서 환경변수 추가 필요.

### 3.3. 사용자 그룹 관리 (완료)
*   **Role**: `Guest` (가입 직후/차단), `Member` (정회원), `Admin` (관리자).
*   **Flow**: 가입 -> Guest (문서 열람 불가) -> Admin 승인 -> Member (열람 가능).
*   **Admin UI**: `/admin/users`에서 권한 변경.

### 3.4. 구글 드라이브 연동 (완료)
*   **구현**:
    *   Google Cloud Console 프로젝트 생성 및 Drive API 활성화.
    *   Service Account 키 생성 및 서버 연동.
    *   `src/app/api/upload/route.ts` 구현.
    *   `DocumentClient.tsx` UI 구현.
    *   - [x] Verify no other scroll conflicts (Done)
    - [ ] **[UI/Polish]** 스크린샷 피드백 반영 (진행 예정) <!-- id: ui-polish -->
        - [ ] Fix: TOC 이중 번호 제거 (Smart Numbering)
        - [ ] Fix: 긴 URL 줄바꿈 처리 (break-all)
        - [ ] Improve: 첨부파일 Empty State 축소