コンテンツにスキップ

Ritsubi BtoB ECサイト改修仕様書

プロジェクト概要

🏢 リツビ BtoB ECサイト改修プロジェクト仕様ポータル¶

リポジトリ内の仕様書・設計書・運用資料を横断的にナビゲートするためのハブです。目的別のカードから最短距離で必要な情報にアクセスできます。

🌐 プロジェクトサマリーを表示

- **公開予定日**: 2024年12月1日 - **プロジェクト期間**: 2024年9月3日〜11月30日（89日間） - **対象業界**: BtoB美容・医療機器 - **人日規模**: 約187人日

flowchart TD
  portal["docs/index.md<br>リツビ仕様ポータル"] --> req["01 要件定義" ]
  portal --> design["02 設計仕様"]
  portal --> impl["03 実装仕様"]
  portal --> pm["04 プロジェクト管理"]
  portal --> ops["05 納品・運用"]
  portal --> opt["06 追加開発オプション"]

  req -->|原資料| reqOriginal["original/"
    <br>Single Source of Truth]
  req -->|統合要件| reqSpec["consolidated/requirements-specification.md"]
  impl --> implInfra["infrastructure/index.md"]
  impl --> implFrontend["frontend/index.md"]
  impl --> implPlugins["vendure-plugins/index.md"]
  pm --> pmSchedule["schedule/index.md"]
  pm --> pmProgress["progress/index.md"]
  ops --> opsManual["manual/admin-manual.md"]
  ops --> opsMaintenance["maintenance/system-maintenance.md"]

主要セクションと代表ドキュメントの関係を図示しています。必要な情報へ整理された経路で移動してください。

🚀 クイックスタート¶

📅 スケジュール&マイルストーン	🧭 プロジェクト全体像	📊 経営層向け要約
12/1公開スケジュール公開までのタスクと責務を一覧化	プロジェクト管理ハブ進捗・会議録・リスクの集約ページ	エグゼクティブサマリー ROIと主要意思決定ポイント

🧑‍💻 開発セットアップ	🧱 実装リファレンス	📚 納品ドキュメント
開発環境ガイド DevContainerとローカル環境手順	Vendure機能リファレンスコア機能・APIの確認	管理者マニュアル運用チーム向け手引き

🔍 セクション別ポータル¶

01. 要件定義 — ビジネス要件と原資料¶

📁 入口	🔗 ショートカット	📝 利用シーン
要件ハブ	統合質問票（Googleスプレッドシート）	顧客要件の確認・差分管理
requirements-specification.md	原資料フォルダ	Single Source of Truthの参照

02. 設計仕様書 — 構成設計と業務ロジック¶

🔧 ドメイン	🔗 代表ドキュメント	🗂️ 備考
システムアーキテクチャ	インフラ構成ガイド	Fly.io ＋ Upstash Redis 基盤
UI/UX	Storefrontスタイルガイド	Next.js フロントデザイン標準
旧システム分析	旧価格計算法	移行時のロジック差分確認

03. 実装仕様書 — Vendure & Next.js¶

🧩 カテゴリ	🔗 ハイライト	✅ 主な内容
Vendureプラグイン	プラグイン実装ガイド	掛率・割戻金・キャンペーン拡張
フロントエンド	Storefront実装ポータル	UI構造・状態管理・ルーティング
インフラ運用	インフラハブ	デプロイ、監視、DevContainer
実装サンプル	Implementation Examples	GraphQL呼び出し、E2E例

04. プロジェクト管理 — スケジュールと合意事項¶

🗂️ トピック	🔗 代表資料	📌 用途
スケジュール	Launch Schedule	マイルストーン・担当一覧
進捗・報告	Progress Reports	ステータスサマリー閲覧
会議記録	Meetings Hub	議事録・アクション整理
コスト&支援	保守・サポート計画	運用フェーズの合意事項

05. 納品・運用 — 利用者のための資料¶

🎯 ペルソナ	🔗 最重要ドキュメント	💡 補足
システム管理者	管理者マニュアル	障害対応・権限管理
一般ユーザー	ユーザーマニュアル	受注〜発注フロー
保守担当	バックアップ手順	DR計画と監視設定
引き継ぎ担当	技術引き継ぎ書	運用チーム移管準備

06. 追加開発オプション¶

⚡ カテゴリ	🔗 ドキュメント	📈 価値提案
アナリティクス	GA4 / GTM 連携	計測基盤の高度化
マーケティング	近日公開	将来のOMO施策対応
業務拡張	近日公開	追加要件の積み上げ

📚 リファレンス & ルール¶

📘 ドキュメント	📌 目的
開発ガイド	作業開始前に確認する工程・ツール集
プラットフォーム選定統合資料	技術選定の意思決定履歴
参考資料リンク集	外部サービス・決済・監視のリンク集
専門用語集	プロジェクト固有用語の統一
ドキュメント運用ルール	MkDocs＋ディレクトリ管理方針

🧭 更新ポリシー¶

原資料との整合性を第一に、変更時は /docs/01-requirements/original/ を起点に確認する。
仕様書の更新後は pnpm docs:build と pnpm docs:spec を実行し、リンク切れと警告の有無をチェックする。
セクション追加時は対応する index.md にカードを増やして導線を維持する。