元仕様書（Primary Source）¶
このディレクトリには、リツビ BtoB ECサイト改修プロジェクトのSingle Source of Truth（唯一の情報源）となる元仕様書を格納しています。
⚠️ 重要事項¶
- 編集禁止: これらは顧客提供の原資料です。変更・削除は厳禁です。
- 参照専用: 要件確認時の最終的な拠り所として使用してください。
- 技術中立: これらの仕様書は技術選定（Vendure、Vite/TanStack Router など）に影響されない、純粋な業務要件を記載しています。
🧭 まずどこを見るか¶
| 確認したいこと | まず見る資料 | 補足 |
|---|---|---|
| プロジェクト全体の要件を確認したい | 基本仕様書.pdf | 業務要件と技術要件の全体像 |
| 現行業務フローを確認したい | 業務について.pdf | 現行運用・業務プロセスの理解 |
| 画面や機能の詳細要件を確認したい | BtoB発注システム要件 (最新).xlsx | 全 59 項目の要件マトリクス |
| キャンペーン要件を確認したい | キャンペーン.xlsx | 6 種類のキャンペーン仕様 |
| キャンペーン対象商品の選び方を確認したい | 2026-05-campaign-target-product-selection.md | ProductVariant 単位の対象選定・除外・変更管理 |
| 追加合意や補足仕様を確認したい | 下記「追加合意・補足仕様（業務テーマ別）」 | 2026-* の Markdown 群 |
| 添付資料やサンプルを確認したい | 下記「添付資料・見本」 | PDF / Excel / 画像サンプル |
📋 コア仕様書（最重要）¶
| ファイル名 | 内容 | 重要度 |
|---|---|---|
| 基本仕様書.pdf | プロジェクトの基本仕様と技術要件 | 🔴 最重要 |
| 業務について.pdf | 現行業務プロセスの詳細説明 | 🔴 最重要 |
| BtoB発注システム要件 (最新).xlsx | 全59項目の詳細機能要件マトリクス | 🔴 最重要 |
| キャンペーン.xlsx | 6種類のキャンペーン仕様（タイプ別ルール） | 🔴 最重要 |
| 要件概要 追加項目追記済み.pdf | 要件概要と追加項目の詳細 | 🟡 重要 |
📂 追加合意・補足仕様（業務テーマ別）¶
Storefront / UI¶
| ファイル名 | 内容 | 用途 |
|---|---|---|
| 2026-02-storefront-design-adjustment.md | Storefrontデザイン調整の追加合意事項 | 追加要件の正本補足 |
| 2026-03-storefront-price-breakdown-hover.md | 商品価格表示の通常価格併記と内訳表示仕様 | 追加要件の正本補足 |
| 2026-03-storefront-home-hero-ratio.md | ホームヒーローのPC/モバイル比率と表示モード | 追加要件の正本補足 |
| 2026-04-home-hero-campaign-linkage.md | ホームヒーローの campaignId 連動と scheduleMode | 追加要件の正本補足 |
| 2026-03-storefront-contract-brand-ratio.md | ホームのご契約ブランド画像比率の固定 | 追加要件の正本補足 |
| 2026-03-storefront-recently-viewed-products.md | 商品詳細の最近チェックした商品表示 | 追加要件の正本補足 |
| 2026-06-storefront-home-reorder-list.md | ホームの「もう一度買う」ProductVariant 商品カード表示 | 追加要件の正本補足 |
| 2026-03-storefront-default-font-size-16px.md | Storefront の既定フォントサイズを 16px に統一 | 追加要件の正本補足 |
| 2026-04-storefront-product-label-facet.md | Storefront 商品表示ラベルの facet 正本化 | 追加要件の正本補足 |
| 2026-04-storefront-product-card-square-ratio.md | Storefront 標準商品カード画像比率の正方形統一 | 追加要件の正本補足 |
| 2026-05-storefront-product-list-cards.md | 商品一覧 browse card の表示密度・価格・購入 CTA 仕様 | 追加要件の正本補足 |
| 2026-05-storefront-product-carousel-card-width.md | 商品カルーセルのカード幅を上限固定し画面幅で伸縮させない方針 | 追加要件の正本補足 |
| 2026-06-storefront-support-pages-cms-ssot.md | サポート関連ページ本文を WordPress 固定ページ正本にする方針 | 追加要件の正本補足 |
| 2026-06-custom-product-lists.md | Vendure 管理のカスタム商品リストと WordPress shortcode 呼び出し | 追加要件の正本補足 |
| 2026-04-storefront-cloudflare-image-delivery.md | Storefront の Cloudflare-first 配信と Dashboard の same-server 配信分離 | 追加要件の正本補足 |
| 2026-04-storefront-related-products-naming-and-fallback.md | 商品詳細の手動関連商品と購入共起レコメンドの名称方針 | 追加要件の正本補足 |
| 2026-04-storefront-local-cache-bypass.md | Storefront の local / mock で shared cache を無効化する方針 | 追加要件の正本補足 |
| 2026-04-storefront-free-shipping-progress.md | カート画面の送料無料進捗表示と backend 正本の換算ルール | 追加要件の正本補足 |
| 2026-04-storefront-variant-selector-option-group-semantics.md | Storefront の option group を当面同列に扱う variant selector 方針 | 追加要件の正本補足 |
| 2026-05-storefront-public-surface-hardening.md | Storefront の production 公開前 hardening | 追加要件の正本補足 |
商流 / 価格 / 決済 / 請求¶
| ファイル名 | 内容 | 用途 |
|---|---|---|
| キャンペーン-価格制御責務分離.md | キャンペーンと価格ポリシーの責務分離補足 | 実装判断の正本補足 |
| 2026-05-campaign-target-product-selection.md | キャンペーン対象商品の選定・指定・除外・変更管理ルール | 運用判断の正本補足 |
| 2026-03-dashboard-commercial-rule-price-flow.md | 価格・販促シミュレーターの価格遷移フロー化 | 追加要件の正本補足 |
| 2026-06-dashboard-commercial-rule-editor-simplification.md | キャンペーン/価格ルール編集 UI の簡素化設計（型テンプレ層 + 既存エディタ整理） | 追加要件の正本補足 |
| 2026-03-payment-method-restrictions-by-collection-method.md | 回収方法別決済制御と請求先継承の補足仕様 | 追加要件の正本補足 |
| 2026-04-order-confirmation-email-payment-method.md | 注文確認メールへ支払方法を表示し、銀行振込系では振込先も本文表示する | 追加要件の正本補足 |
| 2026-04-invoice-japanese-date-format.md | 請求書の日付表記を x年y月z日 に統一 |
追加要件の正本補足 |
| 2026-04-invoice-availability-regardless-of-payment-method.md | 請求書発行可否を決済方法ではなく注文所有者基準で扱う | 追加要件の正本補足 |
| 2026-05-invoice-pregeneration-on-order-placed.md | 注文確定時点で請求書 PDF を事前生成し、初回 DL のレイテンシを構造的に解消する | 追加要件の正本補足 |
| 2026-05-checkout-order-note-template-selection.md | checkout のご要望事項へ定型文複数選択を追加し specialInstructions へ統合保存する |
追加要件の正本補足 |
商品 / 在庫 / ルール境界¶
| ファイル名 | 内容 | 用途 |
|---|---|---|
| 2026-03-collection-facet-boundary.md | Collection / Facet / custom field の責務境界 | 追加要件の正本補足 |
| 2026-03-smile-product-field-responsibility.md | SMILE商品の Product / Variant 責務分離 | 追加要件の正本補足 |
| 2026-03-virtual-product-assignment-settings.md | 仮想商品割り当ての Dashboard 設定画面 | 追加要件の正本補足 |
| 2026-04-quantity-limit-scope-boundary.md | 数量制限の基本制限（Phase 1）と複合制限（Phase 2）の責務境界 | 追加要件の正本補足 |
| 2026-04-product-variant-out-of-stock-threshold.md | ProductVariant ごとの購入不可在庫しきい値 | 追加要件の正本補足 |
| 2026-04-low-stock-custom-message.md | 低在庫・購入不可在庫時の商品別案内テキスト | 追加要件の正本補足 |
| 2026-04-product-purchasable-period.md | 商品ごとの購入可能開始・終了日時による購入可否制御 | 追加要件の正本補足 |
| 2026-05-product-variant-role-and-customer-addability.md | ProductVariant の用途分類と通常カート追加可否 | 追加要件の正本補足 |
| 2026-06-product-tax-category-label.md | 商品の税率カテゴリ表示テキスト（価格直下の自由テキスト） | 追加要件の正本補足 |
| product-detail-product-scope.md | 商品リッチ説明を Product 単位で紐づける補足仕様 | 追加要件の正本補足 |
| SMILE商品インポート_ProductVariant割当補足仕様.md | SMILE商品CSVのProduct/Variant割当ルール補足 | 追加要件の正本補足 |
配送 / 運用フロー¶
| ファイル名 | 内容 | 用途 |
|---|---|---|
| 2026-04-carrier-delivery-date-and-time-slot-rules.md | 配送方法ごとのキャリア設定で配送希望日・時間帯候補を制御する | 追加要件の正本補足 |
| 2026-04-reservation-order-lane-and-shipping.md | 予約受注レーン分離と送料計算境界 | 追加要件の正本補足 |
| 2026-05-paper-consent-postcard-flow.md | 紙同意ハガキ必須商品の到着確認と発送保留フロー | 追加要件の正本補足 |
| 2026-06-checkout-only-shipping-address-registration.md | 注文時のみ新規配送先追加を許可し、注文完了後だけ顧客配送先へ登録する | 追加要件の正本補足 |
SMILE / 外部連携 / ポリシー¶
| ファイル名 | 内容 | 用途 |
|---|---|---|
| 2026-03-smile-order-export-tracking.md | SMILE注文エクスポート追跡仕様の追加合意事項 | 追加要件の正本補足 |
| 2026-03-smile-customer-import-upsert-rules.md | SMILE得意先CSVの更新キーと再インポート規則 | 追加要件の正本補足 |
| 2026-03-smile-billing-linkage-ssot.md | 請求先コードのSMILE正本運用（手動UIなし） | 追加要件の正本補足 |
| 2026-04-policy-subject-resource-reference-model.md | access policy の subject / resource selector 参照モデル | 追加要件の正本補足 |
| 2026-04-shipment-webhook-shadow-lane.md | 出荷Webhook の production/shadow 分離と副作用隔離 | 追加要件の正本補足 |
監視 / 公開面 / セキュリティ運用¶
| ファイル名 | 内容 | 用途 |
|---|---|---|
| 2026-03-maintenance-mode-kv-ssot.md | Storefront 表示 / Vendure 制御のメンテナンス正本を Cloudflare KV に統一 | 追加要件の正本補足 |
| 2026-03-github-actions-log-archive-and-structure.md | CI/CD ログの artifact 保管と構造化 | 追加要件の正本補足 |
| 2026-04-sentry-workflow-alert-automation.md | Sentry workflow alert の checked-in 自動化運用 | 追加要件の正本補足 |
| 2026-04-sentry-uptime-monitor-automation.md | Sentry Uptime monitor の checked-in 自動化運用 | 追加要件の正本補足 |
| 2026-04-vendure-sentry-event-policy.md | Vendure の Sentry event を例外 / 運用異常 / 業務エラーで分類する方針 | 追加要件の正本補足 |
| 2026-04-uptime-kuma-monitor-automation.md | Uptime Kuma monitor の checked-in 自動化運用 | 追加要件の正本補足 |
| 2026-04-staging-sentry-diagnostics-workflow.md | staging での Sentry 診断運用 | 追加要件の正本補足 |
| 2026-04-sentry-release-deploy-tracking.md | release / deploy tracking の運用 | 追加要件の正本補足 |
| 2026-04-wordpress-plugin-sentry-surface.md | WordPress plugin の Sentry surface | 追加要件の正本補足 |
| 2026-04-storefront-cloudflare-observability-export.md | Storefront observability export | 追加要件の正本補足 |
| 2026-04-production-shadow-synthetic-verification.md | production shadow synthetic verification | 追加要件の正本補足 |
- Sentry Web Vitals metrics によるページ表示速度監視: 2026-05-sentry-web-vitals-monitoring.md
📎 添付資料・見本¶
| ファイル名 | 内容 | 用途 |
|---|---|---|
| 添付①ユーザ直送モード利用ガイドページ.pdf | 直送モード利用ガイド | ユーザー向け説明 |
| 添付②商品購入単位グループ分け.xlsx | 33カテゴリの商品分類 | 商品マスタ設計 |
| 添付③請求書サンプル_0.jpg | 請求書サンプル画像 | 帳票設計参考 |
| 添付④グリコール酸同意_0.jpg | グリコール酸同意画面 | 同意フロー設計 |
| 添付⑤imeso同意.pdf | imeso同意フロー | 同意フロー設計 |
| 発注システム宿題_INFINITY消耗品購入カテゴリー登録.xlsx | INFINITY消耗品分類 | 機器別商品分類 |
| ｴｸｽﾋﾞｱﾝｽ新規導入提案書4割り戻し.pdf | エクスビアンス割戻金仕様 | 月次割戻金計算ロジック |
| BTOB販売現状の画面構成.pdf | 現行システムのUI/画面構成 | UI設計参考 |
| BtoB発注システム確認事項.pdf | システム要件の確認事項 | 開発チェックリスト |
| BtoB発注システム確認事項.docx | 同上（Word版） | 編集可能版 |
| MC導入条件22.5.17.pdf | MC導入条件（2022年5月版） | 履歴参考 |
| 最新 MC導入条件一覧.pdf | MC導入条件（最新版） | 導入基準 |
| pdf1リツビフォーマット.pdf | リツビフォーマット仕様 | デザイン参考 |
| SMILEマスタ.xlsx | SMILE各種マスタの列定義 | SMILE連携実装の正本 |
🔧 商品画像・参考画像¶
| ファイル名 | 内容 |
|---|---|
| ex_0.png | エクスビアンス商品画像サンプル |
| imeso_0.png | imeso商品画像サンプル |
| キャンペーン例_1.png | キャンペーン表現の見本 |
🔗 関連ドキュメント¶
技術中立な統合要件書¶
元仕様書を元に、技術プラットフォームに依存しない形で整理した統合要件書：
テーマ別補足要件¶
原資料単位ではなく、業務テーマごとに補足整理した要件文書：
実装ドキュメント¶
Vendure + Storefront 構成での実装詳細：
🎯 ドキュメント活用ガイド¶
新規参加者向け¶
- 基本仕様書.pdf を最初に読む
- BtoB発注システム要件 (最新).xlsx で詳細要件を確認
- 業務について.pdf で現行業務フローを理解
実装者向け¶
レビュアー向け¶
- 実装が元仕様書の要件を満たしているか確認
- 技術選定が要件に適合しているか検証
- Single Source of Truth 原則に基づく一貫性チェック
元仕様書ポータルの見方¶
- このページは 原本そのものを改変せずに探しやすくするための索引です。
- 業務要件の正否判断は、必ずこのページからリンクされた原本を起点に確認してください。
- 実装・設計へ進む場合は、原本確認後に
01-requirements/や03-implementation/へ進んでください。
最終更新: 2026-05-15
ドキュメント管理者: 開発チーム
注意: このディレクトリ内のファイルは変更禁止です。要件変更が必要な場合は、新しいドキュメントを別途作成してください。