Skip to content

Repository files navigation

カンバンボードアプリケーション

このプロジェクトはNext.jsを使用して構築された、モダンなカンバンボードアプリケーションです。タスク管理を効率化し、チームの生産性を向上させるための直感的なインターフェースを提供します。

機能概要

  • カンバンボード: タスクを「未着手」「進行中」「完了」の3つのステータスで管理
  • タスク管理: タスクの作成、編集、ステータス変更、担当者の割り当て
  • 優先度設定: タスクに優先度(低・中・高)を設定可能
  • チームメンバー管理: タスクにチームメンバーを割り当て可能
  • レスポンシブデザイン: モバイルからデスクトップまで様々なデバイスに対応
  • ダークモード対応: ライト/ダークモードの切り替えをサポート

技術スタック

  • フロントエンド: Next.js 15.x (App Router), React, TypeScript
  • UI: Shadcn UI, Tailwind CSS
  • バックエンド: Next.js Server Actions
  • データベース: PostgreSQL
  • ORM: Drizzle ORM
  • コンテナ化: Docker, Docker Compose
  • フォーム管理: React Hook Form, Zod

始め方

前提条件

  • Node.js 18.x以上
  • Docker および Docker Compose
  • npm または yarn

データベースのセットアップ

このプロジェクトはPostgreSQLとDrizzle ORMを使用しています。以下の手順でデータベースをセットアップしてください:

  1. Dockerを使用してPostgreSQLデータベースを起動:
docker-compose up -d
  1. データベースマイグレーションを生成:
npm run db:generate
  1. スキーマを直接データベースに適用する場合:
npm run db:push
  1. マイグレーションをデータベースに適用:
npm run db:migrate
  1. 初期データをデータベースに投入:
npm run db:seed

アプリケーションの実行

データベースのセットアップ後、開発サーバーを起動します:

npm run dev

ブラウザでhttp://localhost:3000を開くと、アプリケーションが表示されます。

使い方

タスクの作成

  1. カンバンボード画面右上の「新規タスク」ボタンをクリック
  2. タスクのタイトル、説明、ステータス、優先度を入力
  3. 必要に応じて担当者を選択
  4. 「保存」ボタンをクリックしてタスクを作成

タスクの編集

  1. 編集したいタスクカードをクリック
  2. 表示されたダイアログで情報を編集
  3. 「保存」ボタンをクリックして変更を適用

担当者の変更

  1. タスクカード上の担当者アイコンをクリック
  2. ドロップダウンメニューから担当者を選択
  3. 担当者の割り当てを解除する場合は「割り当て解除」を選択

タスクのステータス変更

タスクの編集ダイアログでステータスを変更することができます。

デバッグ方法

VSCodeでのデバッグ

  1. VSCodeの「実行とデバッグ」タブを開く
  2. 「Next.js: debug server-side」を選択して実行
  3. ブレークポイントを設定してデバッグ

Chrome DevToolsでのデバッグ

  1. debug.batを実行
  2. Chromeでchrome://inspectにアクセス
  3. 「Open dedicated DevTools for Node」をクリック

プロジェクト構造

src/
├── app/                  # Next.jsのアプリケーションルーター
│   ├── api/              # APIエンドポイント
│   └── page.tsx          # メインページ
├── components/           # Reactコンポーネント
│   ├── ui/               # 共通UIコンポーネント
│   └── kanban/           # カンバンボード関連コンポーネント
├── lib/                  # ユーティリティ関数とサーバーアクション
│   ├── actions/          # サーバーアクション
│   ├── db/               # データベース関連
│   └── utils.ts          # ユーティリティ関数
└── styles/               # グローバルスタイル

開発者向け情報

サーバーアクションのデバッグ

サーバーアクションのデバッグには以下の方法があります:

  1. VSCodeのデバッガーを使用
  2. debug.batを実行してNode.jsデバッガーを使用
  3. コンソールログを使用

データベーススキーマの変更

  1. src/lib/db/schema.tsファイルを編集
  2. npm run db:generateを実行して新しいマイグレーションを生成
  3. npm run db:pushまたはnpm run db:migrateを実行してデータベースに適用

デプロイ

このアプリケーションはVercelにデプロイすることができます。

  1. GitHubリポジトリをVercelにインポート
  2. 環境変数を設定(データベース接続情報など)
  3. デプロイを実行

詳細はNext.jsのデプロイドキュメントを参照してください。

ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages