# Kord Documentation Index

이 루트 색인 문서는 프로젝트 내의 모든 구조화된 문서를 ATP 카테고리별로 모아 탐색을 돕기 위해 작성되었습니다.

---

## ADR — 아키텍처·기술 결정 기록

되돌리기 어려운 기술 선택·아키텍처 원칙의 불변 레코드. → [adr/index.md](./adr/index.md)

- [결정 사항: 대시보드-봇 통신 아키텍처 (gRPC Proxy)](./adr/Dashboard_Architecture_gRPC.md)

---

## Analysis — 코드/흐름/성능/리스크 분석

→ [analysis/index.md](./analysis/index.md)

(현재 문서 없음)

---

## Architecture — 시스템 경계 / 레이어 / 설계

시스템 구조, 기능 기획서, DB 스키마 등 오래 유지될 구조 설명. → [architecture/index.md](./architecture/index.md)

- [프로젝트 구조 (Project Structure)](./architecture/Project_Structure.md)
- [데이터베이스 테이블 구조](./architecture/database-schema.md)
- [Kord - 임시 음성 채널 제어 (Temp Voice Channels)](./architecture/temp_voice_channels.md)
- [감사 채널 기획서 (Audit Log Channel Plan)](./architecture/Audit_Channel_Plan.md)
- [Kord - 봇 상태 메시지 기획 (Bot Presence / Activity)](./architecture/Bot_Presence_Plan.md)
- [Kord - 에러 안내 기능 기획 (Error Guidance UX)](./architecture/Error_Guidance_Plan.md)
- [Kord - 서버 이벤트 일정 관리 기능 기획안 (Event Schedule Management)](./architecture/Event_Schedule_Management_Plan.md)
- [낚시 미니게임 구현 기획안](./architecture/Fishing_MiniGame_Plan.md)
- [Refinement Mini-Game Implementation Plan](./architecture/MiniGame_Refinement_Plan.md)
- [권한 감사 기능 기획서 (Permission Audit Plan)](./architecture/Permission_Audit_Plan.md)
- [봇 설정 도우미 (Setup Wizard) 기획서](./architecture/Setup_Wizard_Plan.md)
- [Kord - 임시 음성 채널 기능 기획 (Temporary Voice Channels)](./architecture/Temp_Voice_Channel_Plan.md)
- [Kord - YouTube 음악 재생 기능 기획안 (YouTube Music Playback)](./architecture/YouTube_Music_Playback_Plan.md)
- [Kord - 다국어 지원 기획 (i18n / Internationalization)](./architecture/i18n_Plan.md)

---

## Backlog — 미채택 아이디어 / 재검토 예정

→ [backlog/index.md](./backlog/index.md)

- [Kord - 기능 로드맵 (Feature Roadmap)](./backlog/Feature_Roadmap.md)

---

## Changes — 런타임 동작 변경 이력

→ [changes/index.md](./changes/index.md)

(현재 문서 없음)

---

## Contracts — 외부/내부 계약 스펙

→ [contracts/index.md](./contracts/index.md)

(현재 문서 없음)

---

## Development — 개발 규칙 / 절차 / 툴 운영

반복 재사용할 규칙·워크플로우·툴 사용법. → [development/index.md](./development/index.md)

- [Graphify Setup & Guide](./development/Graphify_Setup_Guide.md)
- [i18n (다국어 지원) 개발 가이드라인](./development/i18n_guidelines.md)
- [Kord 디자인 원칙 (Design Principles)](./development/Design_Principles.md)
- [Verification Strategies Registry](./development/verification-strategies.md)
- [문서 카테고리 분류 기준](./development/document-category-classification.md)

---

## Domain — 도메인 지식

→ [domain/index.md](./domain/index.md)

- [구독 티어 시스템 (Subscription Tiers)](./domain/subscription_tiers.md)

---

## Issues — 운영 장애/이슈 대응 기록

→ [issues/index.md](./issues/index.md)

- [50013 Missing Permissions (Voice Channel Creation)](./issues/50013_Missing_Permissions.md)
- [임시 음성 채널 미삭제 및 유령 방 버그 (handleLeave)](./issues/handleLeave_ghost_channel.md)

---

## Maintenance — 수동 운영 절차 (마이그레이션/복구/배치)

→ [maintenance/index.md](./maintenance/index.md)

(현재 문서 없음)

---

## Security — 인증/인가 / 입력 검증 / 비밀 값 관리

→ [security/index.md](./security/index.md)

- [보안 개발 가이드라인 (Security Rules)](./security/security_guidelines.md)

---

## Usage — 이식자/운영자 사용 가이드

→ [usage/index.md](./usage/index.md)

(현재 문서 없음)

---

## Work Log — 세션 간 handoff / 시점성 작업 메모

→ [work-log/index.md](./work-log/index.md)

- [Process Cleanup (2026-04-22)](./work-log/2026-04-22_ProcessCleanup.md)
- [Dashboard & Bot Stability Infrastructure Fix (2026-04-21)](./work-log/2026-04-21_fix_dashboard_panic.md)
- [인프라 치명적 오류 복구 및 안정화 (2026-04-21)](./work-log/2026-04-21_Infrastructure_Recovery_And_Stability.md)
- [gRPC Proto 파일 경로 인식 오류 수정 (2026-04-21)](./work-log/2026-04-21_gRPC_Proto_Path_Resolution_Fix.md)
- [Work Done: README 로컬 접속 정보 업데이트 (README Local Connection Info Update)](./work-log/2026-04-21_README_Local_Connection_Info_Update.md)
- [2026-04-20: 모노레포 전환 및 gRPC 통신 테스트 완료 (Monorepo & gRPC Test)](./work-log/2026-04-20_Monorepo_Migration_And_gRPC_Test.md)
- [2026-04-07: 낚시 크기 랭킹 구현](./work-log/2026-04-07_Fishing_Size_Ranking_Implementation.md)
- [2026-04-07 Fishing Dex and Size Implementation](./work-log/2026-04-07_Fishing_Dex_And_Size_Implementation.md)
- [2026-04-07 Fishing Mini-Game Phase 2 Implementation](./work-log/2026-04-07_Fishing_MiniGame_Phase2_Implementation.md)
- [2026-03-31 낚시 미니게임 Phase 1 완료](./work-log/2026-03-31_Fishing_MiniGame_Phase1_Completion.md)
- [2026-03-31 낚시 미니게임 Phase 1 구현](./work-log/2026-03-31_Fishing_MiniGame_Phase1_Implementation.md)
- [2026-03-31 - YouTube Music Playback Phase 3 Implementation](./work-log/2026-03-31_YouTube_Music_Playback_Phase3_Implementation.md)
- [Kord - YouTube 음악 재생 Phase 2 구현](./work-log/2026-03-31_YouTube_Music_Playback_Phase2_Implementation.md)
- [Kord - YouTube 음악 재생 Phase 1 구현](./work-log/2026-03-30_YouTube_Music_Playback_Phase1_Implementation.md)
- [2026-03-30: 이벤트 리마인더 분 단위 옵션 구현 (Event Reminder Offsets Implementation)](./work-log/2026-03-30_Event_Reminder_Offsets_Implementation.md)
- [2026-03-30: 서버 이벤트 시작 시점 공지 구현 (Event Schedule Start Announcement Implementation)](./work-log/2026-03-30_Event_Schedule_Start_Announcement_Implementation.md)
- [2026-03-30: 서버 이벤트 일정 관리 Phase 2 구현 (Event Schedule Phase 2 Implementation)](./work-log/2026-03-30_Event_Schedule_Phase2_Implementation.md)
- [2026-03-30: 서버 이벤트 일정 관리 Phase 1 구현 (Event Schedule Phase 1 Implementation)](./work-log/2026-03-30_Event_Schedule_Phase1_Implementation.md)
- [미니게임 시스템 및 재련(Refinement) 구현 완료 보고서](./work-log/2026-03-30_RefinementImplementation.md)
- [Gathered Command UI Refactoring (2026-03-30)](./work-log/2026-03-30_HierarchicalRefactor.md)
- [2026-03-27: 에러 안내 UX (Error Guidance) 개선 및 통합 Implementation](./work-log/2026-03-27_Error_Guidance_UX_Implementation.md)
- [2026-03-27: 권한 진단 (Permission Audit) 기능 구현 Implementation](./work-log/2026-03-27_Permission_Audit_Implementation.md)
- [2026-03-27: 감사 채널 (Audit Log Channel) 구현 Implementation](./work-log/2026-03-27_Audit_Log_Channel_Implementation.md)
- [2026-03-27: /config 명령어 구조 개선 및 기능 관리 리팩토링 (Config & Feature Refactoring)](./work-log/2026-03-27_Config_And_Feature_Refactoring.md)
- [2026-03-27: i18n 테스트 코드 검사 도구 구현 (i18n Check Tool Implementation)](./work-log/2026-03-27_i18n_Check_Tool_Implementation.md)
- [2026-03-27: 다국어 지원(i18n) 구현](./work-log/2026-03-27_i18n_Implementation.md)
- [2026-03-27: 임시 음성 채널 고도화 (서버별 설정 및 닉네임 폴백)](./work-log/2026-03-27_Voice_Channels_Improvements.md)
- [2026-03-27 작업 내역: 임시 음성 채널 기능 구현](./work-log/2026-03-27_Voice_Channels_Implementation.md)
- [2026-03-27: 봇 상태 메시지(Presence) 기능 구현](./work-log/2026-03-27_Presence_Implementation.md)
- [2026-03-27: Kord 프로젝트 초기 설정 및 파운데이션 구축 (Initial Setup)](./work-log/2026-03-27_Project_Initial_Setup.md)

---

## Graph — graphify 산출물 메타

graphify 자동 생성 영역 — 손대지 말 것. → [graph/index.md](./graph/index.md)
