高級中古品販売のための統合型フルフィルメント管理システム
- Next.js 14 (App Router)
- React 18
- TypeScript
- Tailwind CSS + カスタムNexus Design System
- リアルタイムデータ更新
- Next.js API Routes
- Prisma ORM
- PostgreSQL (本番環境)
- SQLite (開発環境)
- JWT認証 (実装準備済み)
- 📊 ダッシュボード(売上・在庫統計)
- 📦 在庫管理(商品登録・編集・削除)
- 🚚 納品管理
- 💰 売上管理
- 🔄 返品管理
- 📈 月次レポート生成
- 👷 タスク管理(優先度・進捗管理)
- 🔍 検品・出荷管理
- 📍 ロケーション管理(バーコードスキャン対応)
- 📸 商品撮影
- 🚛 配送管理
- 📋 業務レポート
- 🎨 Nexus Design System(6地域カラーリング)
- 🌓 ダークモード対応
- 📱 レスポンシブデザイン
- 🔔 リアルタイム通知(概念実装)
- 📊 高度なKPIダッシュボード
- 🏷️ バーコード生成・印刷
- 🖼️ 画像アップロード(最大20枚)
- Node.js 18以上
- PostgreSQL(本番環境)または SQLite(開発環境)
- リポジトリのクローン
git clone https://github.com/your-org/the-world-door.git
cd the-world-door- 依存関係のインストール
npm install- 環境変数の設定
.env.localファイルを作成し、以下を設定:
DATABASE_URL="your-database-url"
JWT_SECRET="your-secret-key"詳細は 環境変数設定ガイド を参照してください。
- データベースのセットアップ
npm run db:generate
npm run db:push
npm run db:seed # 初期データの投入(オプション)- 開発サーバーの起動
npm run devhttp://localhost:3001 でアプリケーションにアクセスできます。
fbt-v1/
├── app/ # Next.js App Router
│ ├── api/ # APIルート(バックエンド)
│ ├── components/ # Reactコンポーネント
│ ├── (pages)/ # ページコンポーネント
│ └── globals.css # グローバルスタイル
├── lib/ # 共通ライブラリ
│ ├── auth.ts # 認証サービス
│ ├── api-config.ts # API設定
│ └── hooks/ # カスタムフック
├── prisma/ # データベース設定
│ └── schema.prisma # Prismaスキーマ
├── public/ # 静的ファイル
├── types/ # TypeScript型定義
└── docs/ # ドキュメント
主要なAPIエンドポイント(すべて /api/ 配下):
- 認証:
/auth/login,/auth/logout,/auth/session - 在庫:
/inventory,/inventory/stats - 商品:
/products,/products/[id]/history - タスク:
/tasks - レポート:
/reports/analytics,/reports/monthly
# E2Eテストの実行
npm run test
# UIモードでのテスト
npm run test:ui
# テストレポートの表示
npm run test:reportプルリクエストを歓迎します。大きな変更の場合は、まずissueを作成して変更内容を議論してください。