KCL（初心者向けハッカソン運営）のための Slack 中心・AI 一次対応・進捗可視化システム
KCL Support Hub は、ハッカソン参加者が「質問しやすく」「詰まりにくく」なるための、 Slack を主入口とした AI 支援・進捗管理・メンターエスカレーションシステムです。
既存の progress-checker の設計思想を継承しつつ、
Bonsai-8B をローカル推論エンジンとして活用し、運営コストを最小化しながら初心者支援を実現します。
| ファイル | 内容 |
|---|---|
| 01_product-definition.md | プロダクト定義・課題・MVP・非スコープ |
| 02_architecture.md | システム構成・データフロー・非同期処理フロー |
| 03_ai-flow.md | AI フロー・Bonsai/AI SDK/Onyx の責務分離 |
| 04_data-models.md | 主要データモデル・ERD |
| 05_implementation-phases.md | 実装フェーズ計画 |
| 06_directory.md | ディレクトリ構成案 |
| 07_env-vars.md | 必要な環境変数一覧 |
| 08_implementation-tasks.md | 具体的な実装タスク一覧 |
| 09_first-pr.md | 着手すべき最初の PR 案 |
| 継承する | 継承しない（今回は不要） |
|---|---|
| Slack を主入口とする UX 設計 | GitHub Issue 自動起票（Phase 3 以降） |
/question コマンドの導線 |
高度な分析ダッシュボード |
| 3秒 ACK + 非同期ジョブ パターン | GitHub連携の複雑なフロー |
| SQS + Lambda の非同期アーキテクチャ | Slack 議論の自動 Issue 化（Phase 3） |
| PostgreSQL でのデータ管理 | |
| Vercel AI SDK の活用 | |
| Web ダッシュボードによる俯瞰 | |
| メンターチャンネルへの転送 |
| 継承する | 継承しない |
|---|---|
| ロール分離設計（Organizer / Mentor / Hacker） | マルチテナント・スポンサー・スカウト機能 |
features/container 構造のフロントエンド |
複雑な権限スコープ管理 |
handler / service / repository の3層バックエンド |
企業向け招待フロー |
| Zod + React Hook Form の組み合わせ |
Slack から質問するだけで、Bonsai が一次整理し、運営・メンターが俯瞰できる、KCL 専用の「質問受付係 + 進捗ボード」