Go to file

이정수 60520c81fa docs: document monorepo migration, gRPC architecture, and update agent routine guidelines		2026-04-20 11:41:36 +09:00
.agents/rules	docs: document monorepo migration, gRPC architecture, and update agent routine guidelines	2026-04-20 11:41:36 +09:00
.turbo/cache	chore: install and update project dependencies in node_modules	2026-04-20 11:39:22 +09:00
Docs	docs: document monorepo migration, gRPC architecture, and update agent routine guidelines	2026-04-20 11:41:36 +09:00
apps	chore: install and update project dependencies in node_modules	2026-04-20 11:39:22 +09:00
graphify-out	chore: update graphify analysis and configuration files	2026-04-09 17:43:01 +09:00
packages	chore: install and update project dependencies in node_modules	2026-04-20 11:39:22 +09:00
resource	Implement fishing progression features	2026-04-09 12:02:54 +09:00
.DS_Store	feat: generate graph visualization and cache files for project structure analysis	2026-04-09 17:36:44 +09:00
.cursorrules	docs: update project configuration and add Graphify setup documentation	2026-04-09 17:38:58 +09:00
.editorconfig	feat: Initialize Discord bot project with core client, event handlers, services, database, caching, and infrastructure.	2026-03-27 09:40:50 +09:00
.env.example	Merge branch 'origin/main' into feature/invite-role and resolve conflicts	2026-04-10 09:38:39 +09:00
.eslintrc.js	feat: Initialize Discord bot project with core client, event handlers, services, database, caching, and infrastructure.	2026-03-27 09:40:50 +09:00
.gitattributes	feat: Initialize Discord bot project with core client, event handlers, services, database, caching, and infrastructure.	2026-03-27 09:40:50 +09:00
.gitignore	Initial commit	2026-03-26 17:39:18 +09:00
.graphify_cached.json	feat: generate graph visualization and cache files for project structure analysis	2026-04-09 17:36:44 +09:00
.graphify_python	chore: update graphify analysis and configuration files	2026-04-09 17:43:01 +09:00
.prettierrc	feat: Initialize Discord bot project with core client, event handlers, services, database, caching, and infrastructure.	2026-03-27 09:40:50 +09:00
.windsurfrules	docs: update project configuration and add Graphify setup documentation	2026-04-09 17:38:58 +09:00
.yarnrc.yml	feat: Initialize Discord bot project with core client, event handlers, services, database, caching, and infrastructure.	2026-03-27 09:40:50 +09:00
CLAUDE.md	docs: update project configuration and add Graphify setup documentation	2026-04-09 17:38:58 +09:00
README.md	docs: document monorepo migration, gRPC architecture, and update agent routine guidelines	2026-04-20 11:41:36 +09:00
SKILL.md	feat: add graphify tool support with documentation and agent rules	2026-04-09 17:21:54 +09:00
docker-compose.yml	Remove Redis and replace with in-memory caches	2026-04-09 08:50:53 +09:00
package-lock.json	빌드성공	2026-03-31 10:49:35 +09:00
package.json	chore: install and update project dependencies in node_modules	2026-04-20 11:39:22 +09:00
package_feature.json	feat: initialize project structure with documentation and modular Prisma schemas	2026-03-31 10:16:07 +09:00
package_main.json	feat: initialize project structure with documentation and modular Prisma schemas	2026-03-31 10:16:07 +09:00
schema_base.prisma	feat: initialize project structure with documentation and modular Prisma schemas	2026-03-31 10:16:07 +09:00
schema_feature.prisma	feat: initialize project structure with documentation and modular Prisma schemas	2026-03-31 10:16:07 +09:00
schema_main.prisma	feat: initialize project structure with documentation and modular Prisma schemas	2026-03-31 10:16:07 +09:00
turbo.json	chore: install and update project dependencies in node_modules	2026-04-20 11:39:22 +09:00
yarn.lock	chore: install and update project dependencies in node_modules	2026-04-20 11:39:22 +09:00

README.md

Kord (Monorepo)

Kord는 Discord 서버 관리를 돕는 강력하고 유연한 다기능 봇 및 전용 웹 대시보드 프로젝트입니다. 현재 모노레포(Monorepo) 구조로 관리되고 있습니다.

1. 프로젝트 구조 (Structure)

본 프로젝트는 Turborepo와 Yarn Workspaces를 사용합니다.

apps/bot: Discord.js 기반의 봇 본체 (ShardingManager 적용)
apps/dashboard: Next.js 기반의 봇 관리 웹 대시보드
packages/db: Prisma 스키마 및 데이터베이스 데이터 접근 레이어 (공용)
packages/grpc-contracts: 봇과 대시보드 간의 gRPC 통신 규약 (공용)

2. 요구사항 (Requirements)

Runtime: Node.js v22 이상 (추천)
Package Manager: Yarn v4 (Berry)
Database: PostgreSQL (Prisma 사용)
Discord: Bot Token 및 Client ID

3. 시작하기 (Quick Start)

로컬 개발 환경 설정

의존성 설치:
```
yarn install
```
환경 변수 설정: 루트 및 각 앱 디렉토리의 .env 설정을 완료합니다.
데이터베이스 및 코드 생성:
```
yarn run generate
```

실행 방법

전체 프로젝트를 한꺼번에 실행하거나 개별 앱을 실행할 수 있습니다.

모든 앱 실행 (Bot + Dashboard):
```
yarn dev
```
봇만 실행:
```
yarn workspace @kord/bot dev
```
대시보드만 실행:
```
yarn workspace dashboard dev
```

4. 아키텍처 (Architecture)

Kord는 gRPC Proxy 아키텍처를 사용하여 대시보드와 샤딩된 봇 인스턴스 간의 실시간 통신을 처리합니다. 자세한 내용은 관련 문서를 참조하세요.

대시보드 통신 아키텍처 가이드

5. 문서 (Documentation)

모둔 상세 문서는 Docs/ 디렉토리에 위치합니다.