Mitsumori Canonical Integration Spec

Date: 2026-03-16 JST Status: DRAFT — ClaudeCode review pending Related Issue: #335

1. Purpose

Mitsumori が canonical master をどう扱うかを、Phase 1 library 導入から Phase 2 Core 連携まで整理する。

2. Scope

対象:

• department
• building
• business_code
• 将来の customer
• 将来の supplier

非対象:

• 見積本文の UI 詳細
• Toriteki 向け API 契約の詳細

3. Phase 1 Integration Policy

3.1 Authority

• Phase 1 の Mitsumori は tatekanos_shared の model class を library として使う
• Datastore は Mitsumori 自身が保持する
• この時点では Core authority を前提にしない

3.2 Expected Local Kinds

3.3 Required Alignment

• department.code を tenant 内の安定キーにする
• building.code を tenant 内の安定キーにする
• building.department_code を明示保持する
• default_quotation_expiry と approval_route_default を canonical field 名で揃える

4. Master-by-Master Notes

4.1 Department

• Mitsumori は現行の department 機能を canonical schema に寄せる
• 承認実績ではなく、承認デフォルト設定元として扱う
• 見積既定値と承認既定値を分離して持つ

4.2 Building

• 現行 facility UI は維持してよい
• ただし論理モデルは building として扱う
• toriteki_facility_id は Phase 1 では補助リンクとして残してよい

4.3 Business Code

• Mitsumori は見積明細で business_code を参照可能にする前提で設計する
• ただし Phase 1 では full CRUD を必須にしない
• UI 未実装でも model / validation / field contract は先に揃える

5. Quotation-side Integration Points

Mitsumori 実装で最低限必要な参照点:

• quotation.department_code
• quotation_line.building_code
• quotation_line.business_code
• commercial_context と customer の責務分離

原則:

• customer の役割情報は pure master へ戻さず、案件固有は commercial_context に置く
• building は pure master として保ち、請求先/契約先は持たせない

6. Future Core Integration Points (Phase 2)

Core master-only 起動後、Mitsumori は次の integration point を持つ。

6.1 Read Path

• master 一覧取得
• 個別 master 取得
• tenant scoped search

6.2 Write Path

• Mitsumori からの master 直接更新は原則停止
• 必要時は Core API を介して更新
• ローカル Datastore は cache / mirror / migration buffer に限定する

6.3 Sync Timing

• 見積作成画面の選択肢は Core master を優先参照
• 既存案件の表示は snapshot を許容
• archive / inactive の扱いは Core 判定を優先する

7. Open Items for ClaudeCode Review

• business_code を Phase 1 で read-only placeholder にするか、最初から local CRUD を持つか
• customer を Mitsumori 先行で持つか、Core master-only 起動まで待つか
• toriteki_facility_id を残す期間と削除条件

Mitsumori 画面設計文書

作成日: 2026-03-14 作成者: ClaudeCode ステータス: v0.2 — Phase 1 実装完了・Prod デプロイ済み（2026-03-14） 関連Issue: #248 準拠ガイドライン: - docs/Tatekan/toriteki/TATEKAN_toriteki_WebUI_UX.md（UX心理学原則） - ~/.claude/skills/frontend-design/SKILL.md（デザイン美学） - fredy_complete_screen_map.md（Fredy実機調査）

0. 設計原則サマリー

1. 全体レイアウト

┌─────────────────────────────────────────────────────────────┐
│ 🔴 TATEKAN Mitsumori   [ユーザー名▼] [ログアウト]            │ ← ヘッダー（赤）
├──────────────┬──────────────────────────────────────────────┤
│              │                                              │
│ サイドナビ   │  メインコンテンツエリア                        │
│              │                                              │
│ ▶ 見積一覧  │                                              │
│ ▶ 承認一覧  │                                              │
│ ▶ マスター  │                                              │
│   管理      │                                              │
│             │                                              │
└─────────────┴──────────────────────────────────────────────┘

カラーパレット: - プライマリ: #C0392B（赤 — Fredy踏襲・ブランド継続性） - セカンダリ: #2C3E50（濃紺） - アクセント: #E74C3C（明るい赤 — CTAボタン） - 背景: #F5F5F5 - カード: #FFFFFF - テキスト: #2C3E50 / #7F8C8D（補助） - 成功: #27AE60 / 警告: #F39C12 / エラー: #E74C3C

2. 見積一覧（/quotations）

2.1 ワイヤーフレーム

┌─ 見積一覧 ────────────────────────────────── [+ 新規見積の追加] ─┐
│                                                                   │
│ ┌── 検索フィルター ──────────────────────────────────────────┐   │
│ │ 部門[ドロップダウン▼] 得意先[テキスト___] 作成日[期間▼]    │   │
│ │ □ アーカイブも含める  □ 削除も含める    [検索] [クリア]    │   │
│ └──────────────────────────────────────────────────────────┘   │
│                                                                   │
│ 件数: 42件  表示: [10▼]件                      [CSVダウンロード] │
│                                                                   │
│ ┌─────┬────────┬────────┬─────────┬──────────┬──────┬───────┐  │
│ │部門  │作成日  │決定日  │見積No   │得意先    │件名  │承認状態│  │
│ ├─────┼────────┼────────┼─────────┼──────────┼──────┼───────┤  │
│ │G103 │03/14  │ ─      │MITQ-... │豊洲ビル  │電気工│未依頼 │  │  ← スケルトン → データ行
│ │ ... │ ...   │ ...    │ ...     │ ...      │...   │...    │  │
│ └─────┴────────┴────────┴─────────┴──────────┴──────┴───────┘  │
│                                             ← 1 2 3 ... →       │
└────────────────────────────────────────────────────────────────┘

2.2 設計仕様

3. 見積書（サイドバータブ構造）

見積書の編集はサイドバータブで複数画面を構成する。Fredy踏襲。

┌── サイドバー ──┬───── メインコンテンツ ─────────────────────────┐
│               │                                               │
│ ■見積書       │  [ 基本情報 / 見積明細 / 工事情報 / 帳票 ]      │
│   基本情報 ←  │                                               │
│   見積明細    │                                               │
│               │                                               │
│ ■建設工事確認  │  ※ is_construction=False の場合は             │
│   工事情報1   │     「建設工事確認」セクション自体を非表示       │
│   工事情報2   │     （認知負荷の最小化）                        │
│   下請業者    │                                               │
│               │                                               │
│ ■帳票         │                                               │
│   フォルダ参照 │                                               │
│               │                                               │
│ ─────────── │                                               │
│ [保存]        │                                               │
│ [承認依頼]    │                                               │
│ [複写]        │                                               │
│ [削除]        │                                               │
└───────────────┴───────────────────────────────────────────────┘

4. 見積書＜基本情報＞（/quotations/new / /quotations/:id/basic）

4.1 ワイヤーフレーム

┌── 見積書 / 基本情報 ───────────────────────── [保存] [承認依頼] ─┐
│                                                                  │
│ 見積No: MITQ-20260314-000001   承認状態: [未依頼]               │
│                                                                  │
│ ┌── 発行元情報 ────────────────────────────────────────────┐   │
│ │ 部門コード*  [G103 ICT推進室▼]                           │   │
│ │ 発行元パターン [パターンA▼]   発行者名 [___________]    │   │
│ │ 郵便番号 [_______] 住所1 [_______________]              │   │
│ │ 住所2 [_______________]                                  │   │
│ │ 電話 [___________]  FAX [___________]                   │   │
│ └──────────────────────────────────────────────────────┘   │
│                                                                  │
│ ┌── 得意先・物件 ───────────────────────────────────────────┐   │
│ │ 得意先*  [___________________] [🔍検索]                  │   │
│ │ □ 見積表示用の宛名を指定する                              │   │
│ │   宛名 [___________________] [🔍検索]  ← チェック時のみ表示  │
│ │ 物件名*  [___________________] [🔍検索]                  │   │
│ └──────────────────────────────────────────────────────┘   │
│                                                                  │
│ ┌── 見積詳細 ────────────────────────────────────────────────┐  │
│ │ 件名  [_________________________________]                 │  │
│ │ 備考  [___________________________________]               │  │
│ │ 条件  [___________________________________]               │  │
│ │ 契約種別*  [固定▼]                                       │  │
│ │                                                           │  │
│ │ 合計:       ¥ 0      消費税額:  ¥ 0     税込: ¥ 0       │  │
│ └──────────────────────────────────────────────────────┘   │
│                                                                  │
│ ┌── 工期・日付 ─────────────────────────────────────────────┐   │
│ │ □ 工事以外     ← チェックすると工事情報タブを非表示          │   │
│ │ 予定工期* [2026/04/01] 〜 [2026/06/30]                   │   │
│ │ 完了予定日 [2026/06/30]                                   │   │
│ │ 見積作成日* [2026/03/14]  見積有効期限 [1ヶ月▼][___日]   │   │
│ │ 見積決定日 [___________]                                  │   │
│ └──────────────────────────────────────────────────────┘   │
│                                                                  │
│ グルーピングキーワード [_________________]                        │
│ 内部メモ [_________________________________]                     │
│                                                                  │
│ 見積作成者: [gems-staff@godosangyo.com] （自動入力）             │
└──────────────────────────────────────────────────────────────┘

4.2 設計仕様

5. 見積書＜見積明細＞（/quotations/:id/itemized-info）

5.1 ワイヤーフレーム

┌── 見積書 / 見積明細 ───────────────────────────────────────────┐
│                                                               │
│ オプション: □合計から消費税計算 □消費税手入力 □見出し行のみ表示 │
│ 業務コード初期値: [清掃▼]                                    │
│                                                               │
│ ┌──┬──┬─────────────┬──────┬──┬───┬──────┬─────┬─────┐    │
│ │No│集│名称          │摘要  │数│単 │単価  │本体 │税込 │    │
│ ├──┼──┼─────────────┼──────┼──┼───┼──────┼─────┼─────┤    │
│ │1 │□│スライドラック│移設  │30│台 │2,800 │84,000│92,400│   │
│ │2 │□│上段ラック移設│      │1 │台 │6,000 │6,000│6,600│    │
│ │+ │  │[行追加]      │      │  │   │      │     │     │    │
│ └──┴──┴─────────────┴──────┴──┴───┴──────┴─────┴─────┘    │
│                                                               │
│ 合計: ¥ 200,000  消費税: ¥ 20,000  税込: ¥ 220,000           │
│                                                               │
│ ─────────────────────────────────────────────────────────   │
│ ⚠️ Marcury連携                                               │
│ [📋 マーキュリー用明細をクリップボードにコピー]  ← 必須機能   │
│                                                               │
│ フォーマット（タブ区切り）:                                   │
│ 品名[TAB]数量[TAB]単位[TAB][空][TAB][空][TAB]単価[TAB]金額[TAB]消費税│
│ ─────────────────────────────────────────────────────────   │
│                                                               │
│ [一覧へ貼付け]  [内訳を全てクリア]                           │
└───────────────────────────────────────────────────────────┘

5.2 行編集フォーム（行選択時にインライン展開）

┌── 行 #1 編集 ─────────────────────────────────────────┐
│ 集計項目□  名称[スライドラック解体・移設作業]           │
│ 摘要[_________________]  業務コード[電気▼]              │
│ 数量[30] 単位[台▼] 歩掛[__] 人数[__] 単価[2,800]       │
│ 定価[____]  本体金額: ¥84,000  消費税率[10%▼]          │
│ 税額: ¥8,400  税込額: ¥92,400  割合[____]              │
│ 備考[_________________]                                 │
│ □ この明細をG-Reportへ連携する                          │
│                           [保存] [キャンセル] [削除行]  │
└──────────────────────────────────────────────────────┘

5.3 設計仕様

6. 建設工事確認＜工事情報1＞（/quotations/:id/construction-info1）

⚠️ 表示条件: is_construction=True（基本情報で「工事以外」チェックがOFF）のみ表示

6.1 ワイヤーフレーム

┌── 建設工事確認 / 工事情報1 ──────────────────────────────────┐
│                                                              │
│ 建設工事契約確認書（[1]回目）   拠点名: G103 ICT推進室       │
│ 確認状態: [未依頼]                                           │
│                                                              │
│ ┌── 基本情報 ────────────────────────────────────────────┐  │
│ │ 工事No [K-2026-001]   作成日* [2026/03/14]             │  │
│ │ 作成者 [___________]                                   │  │
│ │ 工事現場名称 [_________________________________]        │  │
│ │ 工事現場所在地 [_________________________________]      │  │
│ │ 工事名称 [_________________________________]            │  │
│ └────────────────────────────────────────────────────┘  │
│                                                              │
│ ┌── 担当者・工期 ─────────────────────────────────────────┐  │
│ │ 工事担当者名 [___________]  配置技術者名 [___________] │  │
│ │ 予定工期 [2026/04/01] 〜 [2026/06/30]                  │  │
│ │ 工事種類（業種） [電気工事▼]                           │  │
│ │ 発注者からの請負順位 [___________]                     │  │
│ └────────────────────────────────────────────────────┘  │
│                                                              │
│ ┌── 建設産廃（元請の場合）────────────────────────────────┐  │
│ │ □ 廃棄物の発生有  □ 一時保管有  □ 電子マニフェスト使用有│  │
│ └────────────────────────────────────────────────────┘  │
│                                                              │
│ ┌── 工事概要・留意事項 ───────────────────────────────────┐  │
│ │ 工事概要 [_________________________________]            │  │
│ │ 工程・施工・安全衛生・品質管理上・その他留意            │  │
│ │ [_________________________________________]             │  │
│ └────────────────────────────────────────────────────┘  │
└──────────────────────────────────────────────────────────┘

7. 建設工事確認＜工事情報2＞（/quotations/:id/construction-info2）

┌── 建設工事確認 / 工事情報2 ──────────────────────────────────┐
│                                                              │
│ ┌── 採算情報 ────────────────────────────────────────────┐  │
│ │ 注文者（会社名/契約者名） [_________________________]  │  │
│ │ 請負金額（税別） [_______________] 円                  │  │
│ │ 支払い条件 [_________________________]                 │  │
│ │                                                        │  │
│ │ 発注金額合計: ¥ 3,500,000 （自動計算・下請業者タブ連動）│  │
│ │ 発注率: 70.0%   粗利: 30.0%                           │  │
│ │ 拠点管理率 [5.0] %   拠点利益 [__________] 円         │  │
│ └────────────────────────────────────────────────────┘  │
│                                                              │
│ ┌── 意見・コメント ───────────────────────────────────────┐  │
│ │ 建設統括部から [_________________________________]      │  │
│ │ 拠点の意見    [_________________________________]      │  │
│ └────────────────────────────────────────────────────┘  │
└──────────────────────────────────────────────────────────┘

設計仕様: - 発注金額合計は下請業者タブのデータから自動計算（リードオンリー表示） - 発注率・粗利は請負金額と発注金額合計から自動計算

8. 建設工事確認＜下請業者＞（/quotations/:id/supplier-info）

┌── 建設工事確認 / 下請業者 ───────────────────────────────────┐
│                                                              │
│ ┌────────────┬──────────┬──────┬──────────┬────────┬──────┐ │
│ │発注先      │発注金額  │税込  │支払い条件 │発注内容│備考  │ │
│ ├────────────┼──────────┼──────┼──────────┼────────┼──────┤ │
│ │関東電気保安│1,000,000│1,100K│月末翌月払 │電気工事│      │ │
│ │[+ 行追加]  │          │      │          │        │      │ │
│ └────────────┴──────────┴──────┴──────────┴────────┴──────┘ │
│                                                              │
│ 合計: ¥ 1,000,000  税込: ¥ 1,100,000                        │
└──────────────────────────────────────────────────────────┘

行追加フォーム（インライン展開）:

9. 承認一覧（/approvals）

┌── 承認一覧 ────────────────────────────────────────────────┐
│                                                            │
│ 絞り込み: 部門[▼] 依頼者[____] 承認状態[▼] 依頼日[___]  │
│                                                            │
│ ┌──────────┬──────┬──────┬──────┬──────┬──────┬──────┐   │
│ │依頼種別  │部門  │依頼者│依頼日│締切日│件名  │状態  │   │
│ ├──────────┼──────┼──────┼──────┼──────┼──────┼──────┤   │
│ │見積承認  │G103 │山田 │03/14│03/21│電気工│依頼中│   │
│ │工事確認  │G103 │佐藤 │03/13│03/20│空調工│未承認│   │
│ └──────────┴──────┴──────┴──────┴──────┴──────┴──────┘   │
└──────────────────────────────────────────────────────────┘

状態バッジ: 未依頼:グレー / 依頼中:オレンジ / 承認:緑 / 否認:赤 / 確認済:青

10. 承認詳細（/approvals/:id）

┌── 承認詳細 ──────────────────────────────────────────────────┐
│                                                              │
│ 依頼種別: [工事確認]    承認状態: [依頼中 🟠]               │
│ 依頼者: 山田太郎        依頼日: 2026/03/14                  │
│ 締切日: 2026/03/21                                          │
│                                                              │
│ ┌── 案件情報 ────────────────────────────────────────────┐  │
│ │ 部門: G103 ICT推進室                                   │  │
│ │ 得意先: 三井不動産商業マネジメント株式会社              │  │
│ │ 物件名: 豊洲ららぽーと                                  │  │
│ │ 件名: 電気設備更新工事                                  │  │
│ │ 画面: [表示する →]                                     │  │
│ │ フォルダ: [表示する →]    文書: [表示する →]           │  │
│ └────────────────────────────────────────────────────┘  │
│                                                              │
│ コメント: [_________________________________________]       │
│ 備考（表示のみ）: ___________                               │
│                                                              │
│ ─────────────────────────────────────────────────────────  │
│ [キャンセル]                    [確認]  [確認済にする]      │
│                                 ↑否認   ↑承認               │
└──────────────────────────────────────────────────────────┘

11. マスター管理

11.1 マスター管理メニュー（/master-menu）

┌── マスター管理 ──────────────────────────────────────────────┐
│                                                              │
│ ┌────────────────┐  ┌────────────────┐  ┌────────────────┐ │
│ │  👥 部門マスタ │  │  👤 ユーザマスタ│  │  🏢 得意先    │ │
│ │   /departments │  │   /users       │  │  /customers    │ │
│ └────────────────┘  └────────────────┘  └────────────────┘ │
│                                                              │
│ ┌────────────────┐  ┌────────────────┐                      │
│ │ 📋 発行元      │  │  🏗️ 建物マスタ │                      │
│ │ パターン       │  │  /buildings    │                      │
│ │ /order-src-    │  │                │                      │
│ │ patterns       │  │                │                      │
│ └────────────────┘  └────────────────┘                      │
└──────────────────────────────────────────────────────────┘

11.2 共通一覧パターン

すべてのマスター一覧は以下の共通パターンを踏襲:

┌── [マスター名] 一覧 ──────────────────── [+ 新規追加] [CSVダウンロード] ─┐
│                                                                        │
│ 検索: [____] □アーカイブも含める □削除も含める  [検索]                │
│                                                                        │
│ ┌──────────┬────────┬─────────────────────────────────────────────┐   │
│ │コード    │名称    │住所 / その他                                │   │
│ ├──────────┼────────┼─────────────────────────────────────────────┤   │
│ │G103      │ICT推進 │東京都...                                    │   │
│ └──────────┴────────┴─────────────────────────────────────────────┘   │
│                                             ← 1 2 3 →                 │
└──────────────────────────────────────────────────────────────────────┘

11.3 ユーザーマスタ新規作成（特記事項）

⚠️ 印鑑URL実装注意: Fredyで「合同産業社印の消失バグ」が報告済み（R-IMP-06）。Mitsumoriでは確実に実装すること。

11.4 部門マスタ（承認者設定）

部門マスタに承認依頼先メールアドレスを設定する（Fredy継承）:

12. 共通UIコンポーネント

12.1 検索ダイアログ（得意先・建物）

┌── 得意先検索 ─────────────────────────────┐
│ 検索語 [___________________________] [検索] │
│                                            │
│ ┌────────────┬─────────────────────────┐  │
│ │コード      │名称                     │  │
│ ├────────────┼─────────────────────────┤  │
│ │C0001       │三井不動産商業マネジメント│  │ ← クリックで選択・ダイアログ閉じる
│ └────────────┴─────────────────────────┘  │
│                                  [閉じる]  │
└────────────────────────────────────────────┘

12.2 トースト通知

12.3 確認ダイアログ（破壊的操作）

┌── 確認 ──────────────────────────────┐
│                                      │
│ 見積書を削除しますか？               │
│ この操作は元に戻せません。           │
│                                      │
│          [キャンセル]  [削除 🗑️]    │
│                         ↑ 赤ボタン   │
└──────────────────────────────────────┘

13. レスポンシブ対応方針

Fredyの課題「スマートフォン対応なし」を解消する。

14. 未決定事項（実装前確認）

• [ ] 「複写」機能のUI: 見積一覧の行アクションか、詳細画面のサイドバーボタンか
• [ ] 帳票出力（フォルダ参照）: Google Drive連携の実装方針
• [ ] 承認メール通知: 承認依頼時に承認者へメール送信するか（Fredy同様）
• [ ] 見積番号プレフィックス: MITQ- で確定か

本文書はClaudeCodeが fredy_complete_screen_map.md（Playwright実機調査）・TATEKAN_toriteki_WebUI_UX.md・mitsumori_requirements.md を統合して作成。2026-03-14

Mitsumori Cloud Datastore エンティティ設計

作成日: 2026-03-12 更新日: 2026-03-14 作成者: ClaudeCode ステータス: Draft v0.2 — PostgreSQL設計をCloud Datastore設計に全面改訂（2026-03-14 PM決定） 関連Issue: #248

DB方針決定（2026-03-13 PM） - Cloud SQL PostgreSQL → Cloud Datastore（Datastoreモード） - Toriteki（gobms-465809）と同一プロジェクト・同一Datastoreインスタンスを使用 - 環境分離: Namespaceで実施（Toriteki同様）

1. 設計方針

• Kind命名: mitsumori_<entity> （Toriteki同様のプレフィックス方式）
• Namespace分離:
• Production: mitsumori
• Staging: mitsumori-staging
• Dev: mitsumori-dev
• Key設計: auto-generated integer ID（基本）/ 文字列名キー（マスター系）
• 大型フィールド: exclude_from_indexes=["line_items", "notes", "raw_payload"]（Toriteki同様）
• マルチテナント: 全エンティティに tenant_id プロパティを付与
• 監査: created_at / updated_at / created_by / updated_by を全エンティティに付与
• Phase 1スコープ: 見積書作成・承認フロー・Marcury提出支援に必要なKindのみ定義

2. エンティティ関係図（概念）

[mitsumori_tenants]
    ↓ 1:N
[mitsumori_users] --- [mitsumori_departments]
    ↓
[mitsumori_quotations]  ←── line_items（プロパティとして埋め込み）
    ↓ 1:N
[mitsumori_approvals]

[mitsumori_customers]   ←── 見積書の得意先参照
[mitsumori_facilities]  ←── 見積書の物件参照
[mitsumori_order_source_patterns] ←── 見積書の発行元参照
[mitsumori_attachments] ←── GCS参照（見積書・承認添付）

--- Phase 2以降 ---
[mitsumori_agreements]  ←── quotation_key参照
[mitsumori_orders]      ←── Marcury発注受領
[mitsumori_rfq_triggers] ←── Toriteki RFQ起票ログ

3. Namespace設定

# app.py 初期化（Toriteki同様パターン）
import os
from google.cloud import datastore

_env = os.environ.get("ENV", "dev")
if _env == "production":
    DATASTORE_NAMESPACE = "mitsumori"
elif _env == "staging":
    DATASTORE_NAMESPACE = "mitsumori-staging"
else:
    DATASTORE_NAMESPACE = "mitsumori-dev"

# 起動時ガード（Toriteki同様）
if _env == "staging" and DATASTORE_NAMESPACE != "mitsumori-staging":
    raise RuntimeError("Refusing to start: staging must use mitsumori-staging namespace.")
if _env == "production" and DATASTORE_NAMESPACE != "mitsumori":
    raise RuntimeError("Refusing to start: production must use mitsumori namespace.")

ds_client = datastore.Client(namespace=DATASTORE_NAMESPACE)

4. マスターKind（Phase 1）

4.1 mitsumori_tenants（テナント）

Key: 文字列名キー（例: godosangyo）

key = ds_client.key("mitsumori_tenants", "godosangyo")
ent = datastore.Entity(key=key, exclude_from_indexes=["features"])
ent.update({
    "code": "godosangyo",
    "name": "合同産業株式会社",
    "is_active": True,
    "features": {"commercial_facility": True, "construction_approval": True},
    "created_at": now,
    "updated_at": now,
})

4.2 mitsumori_departments（部門）

Key: 文字列名キー（例: godosangyo_G103）

4.3 mitsumori_users（ユーザー）

Key: auto-generated integer ID

4.4 mitsumori_customers（得意先）

Key: 文字列名キー（例: godosangyo_C0001）

4.5 mitsumori_facilities（建物/施設）

Key: 文字列名キー（例: godosangyo_B001）

4.6 mitsumori_order_source_patterns（発行元パターン）

Key: 文字列名キー（例: godosangyo_OSP001）

5. 見積Kind（Phase 1 中核）

5.1 mitsumori_quotations（見積）

Key: auto-generated integer ID

key = ds_client.key("mitsumori_quotations")
ent = datastore.Entity(
    key=key,
    exclude_from_indexes=["line_items", "construction_info", "remarks", "conditions", "internal_note"]
)

line_items プロパティ構造（JSON）

[
  {
    "line_no": 1,
    "is_summary": false,
    "name": "スライド式ラック解体・移設作業",
    "outline": "",
    "business_code": "E01",
    "quantity": 30,
    "unit": "台",
    "step_factor": null,
    "headcount": null,
    "unit_price": 2800,
    "list_price": null,
    "amount": 84000,
    "tax_rate": 10,
    "tax_amount": 8400,
    "tax_included_amount": 92400,
    "ratio": null,
    "remarks": "",
    "link_to_g_report": false
  }
]

Marcuryクリップボード出力フォーマット（タブ区切り）:

品名[TAB]数量[TAB]単位[TAB][空][TAB][空][TAB]単価[TAB]金額[TAB]消費税[TAB]

⚠️ 実装必須: このフォーマットはMarcury側仕様に完全依存（変更不可）。

construction_info プロパティ構造（JSON）

{
  "info1": {
    "confirmation_no": 1,
    "construction_no": "K-2026-001",
    "created_date": "2026-03-14",
    "author": "担当者名",
    "site_name": "工事現場名称",
    "site_address": "工事現場所在地",
    "construction_name": "工事名称",
    "construction_manager": "工事担当者名",
    "technical_supervisor": "配置技術者名",
    "planned_start_date": "2026-04-01",
    "planned_end_date": "2026-06-30",
    "construction_type": "electrical",
    "order_rank": "一次",
    "waste_generated": false,
    "waste_stored": false,
    "waste_electronic_manifest": false,
    "outline": "工事概要テキスト",
    "notes": "留意事項テキスト"
  },
  "info2": {
    "client_name": "注文者会社名",
    "contract_amount_excl_tax": 5000000,
    "payment_terms": "月末締め翌月払い",
    "order_amount_total": 3500000,
    "order_rate": 70.0,
    "gross_profit_rate": 30.0,
    "branch_management_rate": 5.0,
    "branch_profit": 250000,
    "construction_dept_comment": "",
    "branch_opinion": ""
  },
  "subcontractors": [
    {
      "name": "下請業者名",
      "amount": 1000000,
      "tax_rate": 10,
      "tax_included_amount": 1100000,
      "payment_terms": "月末締め翌月払い",
      "work_content": "電気工事",
      "business_code": "E01",
      "remarks": ""
    }
  ]
}

6. 承認Kind（Phase 1）

6.1 mitsumori_approvals（承認）

Key: auto-generated integer ID

key = ds_client.key("mitsumori_approvals")
ent = datastore.Entity(key=key, exclude_from_indexes=["comment", "requester_note"])

7. 添付資料Kind（Phase 1）

7.1 mitsumori_attachments（添付資料）

Key: auto-generated integer ID

8. 採番設計

Datastoreにはシーケンス機能がないため、アプリ層で採番する。

8.1 見積番号（quotation_no）

# フォーマット: MITQ-YYYYMMDD-NNNNNN
# カウンターはDatastoreで管理
COUNTER_KEY = ds_client.key("mitsumori_counters", "quotation_no")

def generate_quotation_no():
    with ds_client.transaction():
        counter = ds_client.get(COUNTER_KEY) or datastore.Entity(key=COUNTER_KEY)
        n = counter.get("value", 0) + 1
        counter["value"] = n
        ds_client.put(counter)
    today = datetime.now(JST).strftime("%Y%m%d")
    return f"MITQ-{today}-{str(n).zfill(6)}"

9. Phase 2以降のKind（参考）

10. Open Questions（Phase 1着手前確認事項）

• [x] DB: Cloud Datastore確定（2026-03-14 PM決定）
• [x] Namespace: mitsumori / mitsumori-staging / mitsumori-dev
• [ ] 見積番号プレフィックス: MITQ- でよいか、Fredy既存番号との衝突回避が必要か
• [ ] 建物マスタとToriteki施設マスタのマッピング方針（Phase 1では独立、Phase 2でAPI連携）
• [ ] 工事確認の承認者設定: 部門マスタの approval_email_construction で一律管理か、施設ごとに個別設定か

本文書はClaudeCodeが2026-03-14にPostgreSQL設計をDatastore設計に全面改訂。Fredy実機調査・機能要件定義・インフラ設計・Toriteki実装パターンを統合。

TATEKAN Mitsumori — 機能要件定義

作成日: 2026-03-12 更新日: 2026-03-14 作成者: ClaudeCode（Codex設計レビュー結果を文書化） ステータス: v0.5 — Phase 1 実装完了・Dev/Staging/Prod デプロイ済み（2026-03-14） 関連Issue: #248

1. ユーザーロールと権限

1.1 設計方針（Fredy踏襲 — PM設計）

Fredyのユーザーマスタで実装済みの機能 × CRUD チェックボックス方式をMitsumoriに継承する。 固定ロールによる一律制限ではなく、ユーザーごとに機能・操作単位で個別設定可能とする。

この設計はPMが考案しFredyで実装した方式。Mitsumoriでも踏襲する。

1.2 アカウント種別

1.3 機能 × CRUD 権限マトリクス（ユーザーごとに個別設定）

売上／検収はMitsumoriスコープ外のため権限マトリクスから除外

1.4 ユーザーごとの追加設定

印鑑URLについて: Fredyでは合同産業社印の消失バグが報告されている（R-IMP-06）。Mitsumoriでは印鑑URLの管理とPDF埋め込みを確実に実装する。

1.5 見積り初期値（ユーザープロファイル）

新規見積作成時に自動入力される初期値をユーザーマスタに格納する。入力省力化のための設計。

1.6 承認フロー向けロール（別途管理）

チェックボックス権限とは独立して、承認フロー上の役割を別途設定する：

承認者マスタ（approval_confirmers）で経路を設定。Fredyの設計を継承。

2. 業務フロー別機能要件

2.1 概算見積フェーズ

2.2 実施見積フェーズ

R-IMPL-06 補足: 画面表示（UI）とクリップボード出力は別フォーマット。Marcuryが受け付ける固定タブ区切り形式（品名\t数量\t単位\t\t\t単価\t金額\t消費税）でなければ貼り付け不可。この機能がなければMarcuryへの見積提出業務が成立しない。列構成はMarcury側仕様に完全依存のため変更不可。（2026-03-14 PM実機確認）

2.3 発注受領フェーズ

2.4 役務実行フェーズ

2.5 臨時発注（建物管理費）

3. 承認ワークフロー要件

3.1 承認状態定義

未依頼 → 依頼中 → 承認 / 否認 → 確認済

3.2 承認種別

3.3 工事系判定基準

• work_type が electrical / hvac / plumbing / repair の場合 → 工事確認（建設統括部）が必須
• cleaning / security / other の場合 → Manager承認のみ

注: 金額基準（例: XX万円以上は工事確認必須）はOpen Questionとして未確定。PMに要確認。

3.4 承認フロー

【工事系案件】
Staff: 承認申請起票
    ↓
建設統括部: 工事確認（approval_type=2）
    ↓ 確認済
Manager / 拠点長: 見積承認（approval_type=1）
    ↓ 承認
Marcury 提出

【非工事系案件】
Staff: 承認申請起票
    ↓
Manager / 拠点長: 見積承認（approval_type=1）
    ↓ 承認
Marcury 提出

3.5 承認者設定

• 承認者マスタ（approval_confirmers）で経路を設定
• 並列承認か段階承認かは Open Question（Fredy運用を要確認）

4. Marcury 連携要件

4.1 発注メール解析

注: Marcury発注メールの厳密なフォーマットは Open Question。実メールのサンプルを入手して確認必要。

4.2 技術方式（GeminiCLIアドバイス）

Gmail API Push通知（発注メール受信時）
    ↓ Pub/Sub トピックへイベント発火
Cloud Run (mitsumori-mail-worker)
    ↓ Gmail APIでメール本文・添付取得
GCS（添付PDF保管） + PostgreSQL（発注レコード登録）
    ↓
担当者通知 + Toriteki RFQ起票トリガー

5. Fredy現場ユーザーヒアリングから得た要件（2026-03-13）

5.1 必ず引き継ぐ機能（Fredyで評価されているもの）

5.2 Mitsumoriで改善する機能（Fredyの課題）

5.3 スコープ外（別システム）

5.4 Fredy分析から得た暗黙的要件

7. TATEKANファミリー連携アーキテクチャ（2026-03-13 PM確認）

7.1 エンドツーエンド業務フロー

【フェーズ1: 仮見積〜受注】
Mitsumori: 仮見積作成（基本情報・見積明細・工事情報1・2）
    ↕ 下請け見積依頼（API連携）
  Toriteki: 下請けへ見積依頼 → 受領 → Mitsumoriへ金額反映
    ↓
Mitsumori: 見積完成 → 社内承認フロー（工事確認→見積承認）
    ↓ 承認OK
  Marcury: 見積書貼り付け（得意先への送付）← 貼付行為をMitsumoriが記録
    ↓
  Marcury: 得意先から発注メール受信
    ↓
Mitsumori: ステータス「受注」に変更
    ↓
  Core: 受注伝票自動起票（受注時点で即時。ガバナンス上当然）
  Toriteki: 取引先（下請け）への発注実行

【フェーズ2: 実施〜検収〜請求】
  Toriteki: 下請けから納品 → 検収 → 担当者通知
    ↓
  Marcury: 検収書投入
    ↓
  Core: 請求書生成 → 前受金との相殺処理 → 会計システムへ連携（月次15日頃）
  Toriteki: 下請け請求書受領 → Core仕訳 → 会計システムへ連携（月次15日頃）

7.2 Mitsumori見積ステータス設計

Fredyには「仮見積」「受注」の明示的なステータスがなかった。Mitsumoriでは以下を新規設計する：

7.3 前受金フロー（確認中）

• 受領タイミング: 年度初め（商マネ社と年間予算合意後）に合同産業が一括受領
• 管理システム: GLOVIA会計（確認中。PMが経理に確認予定）
• Mitsumori責務: 前受金残高は持たない。受注情報をCoreへ渡すのみ
• 相殺処理: Core（またはGLOVIA会計）が請求書生成時に前受金と相殺

7.4 フロー整合性（Fredy調査との検算結果）

8. 工程管理ロードマップ（2026-03-13 PM確認）

8.1 現状の課題

• Fredyに工程フィールド（完成通知日・完成検査日・引渡日・完了日等）は存在する
• しかしどのシステムも工程の可視化・管理機能を持っていない
• 現場ユーザーヒアリングでも「フィールドはあるが工程が見えない」との声あり
• 情報を必要とするのは現場の人間ではなく、建設統括部メンバー＋技師長（建設系Pro）

8.2 ロードマップ

8.3 Phase 3設計方針（将来）

• 主ユーザー: 建設統括部メンバー、技師長（建設系Pro）
• 必要なUI: 入力画面ではなく俯瞰ダッシュボード（どの案件が今どの工程にいるか）
• データソース: Mitsumori（見積・工期）＋Toriteki（発注・検収）を集約
• 建設業法対応: 施工体制台帳・施工体系図・配置技術者管理も将来スコープ

9. マスター管理要件（Fredy実機調査反映 — 2026-03-13）

Fredy新規作成画面のスクリーンショット（#23〜#28）から確認したフィールドを基に、Mitsumoriで引き継ぐマスタと項目を定義する。

9.1 部門マスタ（DepartmentMaster）

9.2 ユーザマスタ（UserMaster）

§1.3〜§1.5 に定義済み。スクリーンショット24で実機確認完了。

9.3 得意先マスタ（CustomerMaster）

9.4 仕入先マスタ（SupplierMaster）

判断: Mitsumoriスコープ外。仕入先（下請業者）管理はToriteki担当。Fredyのデータ移行時はToriteki側へ移管する。

9.5 発行元パターンマスタ（OrderSrcPatternMaster）

用途: 見積書ヘッダーの発行元情報テンプレート。ユーザーマスタの見積り初期値でデフォルトパターンを設定する。

9.6 建物マスタ（BuildingMaster）

9.7 Mitsumoriで採用するマスタまとめ

6. Open Questions（要PM確認）

• [ ] 承認者の並列vs段階承認: 複数の建設統括部メンバーがいる場合、全員の承認が必要か、一人でよいか
• [ ] 工事確認の金額基準: 作業種別だけで判定するか、金額閾値（例: 50万円以上）も条件か
• [ ] Marcury発注メールの厳密フォーマット: 実メールサンプルの入手が必要
• [ ] 商マネ社以外の発注者: 合同産業が受注する商マネ社以外のクライアントへのMitsumori適用範囲
• [x] 前払い金/前受け金の実業務意味: 年度初め一括受領、GLOVIA会計で管理（確認中）。Mitsumoriは残高を持たずCoreへ受注情報を渡すのみ。相殺はCore/GLOVIA担当（2026-03-13確認）
• [x] 工事進捗管理: Mitsumoriスコープ外。Phase 3工程モジュールで建設統括部・技師長向けダッシュボードとして実装予定（2026-03-13確定）
• [x] 受注票起票タイミング: 受注時点で即時起票。ガバナンス上当然のため経理合意不要（2026-03-13確定）
• [x] 中間請求: 前受金があるため一括検収でOK。進行基準は対象外（2026-03-13確定）
• [x] 下請け支払いフロー: Toriteki請求書受領→Core仕訳→会計システム月次連携（15日頃）（2026-03-13確定）
• [ ] 前受金の管理システム: GLOVIA会計と推定。PMが経理に確認予定
• [ ] 承認者の並列vs段階承認: 複数の建設統括部メンバーがいる場合、全員の承認が必要か、一人でよいか
• [ ] 工事確認の金額基準: 作業種別だけで判定するか、金額閾値（例: 50万円以上）も条件か
• [ ] Marcury発注メールの厳密フォーマット: 実メールサンプルの入手が必要
• [ ] 商マネ社以外の発注者: 合同産業が受注する商マネ社以外のクライアントへのMitsumori適用範囲

本文書はCodexによる機能要件定義レビュー結果をClaudeCodeが文書化。2026-03-12作成。2026-03-13 Fredy現場ユーザーヒアリング反映・スコープ外明記。2026-03-13 PMとのビジネスフロー議論をもとにTATEKANファミリー連携アーキテクチャ・工程管理ロードマップ追加（v0.3）。2026-03-13 Fredy全マスタ新規作成画面実機調査（#23〜#28）をもとにマスター管理要件§9追加（v0.5）。