Private / PM Only

Access Protected

TATEKANOS Foundations

This page keeps the philosophy, responsibility boundary, commercial architecture, and Google Workspace integration guidance for TATEKANOS inside the PM portal.

Quick Map

00. Foundations

This is the PM-first reading entrance for TATEKANOS itself before the app-by-app references.

  • docs/Tatekan/tatekan_industry_os_vision.mdIndustry OS Vision
  • docs/Tatekan/tatekan_responsibility_boundary_memo_20260310.mdResponsibility Boundary Memo
  • docs/Tatekan/tatekanos_canonical_commercial_architecture.mdCanonical Commercial Architecture
  • docs/Tatekan/gws_workspace_integration.mdgws Workspace Integration

1. Definition

This is the PM-first reading entrance for TATEKANOS itself before the app-by-app references.

2. Industry OS Vision

Source

docs/Tatekan/tatekan_industry_os_vision.md

TATEKAN Industry OS Vision — ビルメン業界OS構想

Date: 2026-03-10 JST Status: PM Approved — 正式採用 Origin: PM + ChatGPT 会話 → ClaudeCode 調査・考察 → Codex / GeminiCLI レビュー反映済み


1. Executive Summary

TATEKAN は「ビルメンテナンス業界(清掃・設備管理・警備)の業界OS」になりうる。

既存の 3 アプリ(Core / Toriteki / Mitsumori)+ TATEKAN Control の設計が、ビルメン業界の多層下請け構造・人手不足・低利益率という構造的課題を解くためにそのまま活用できる。

TATEKANOS の理念は NOS = AI-native operating system とする。

  • AI との chat を主入口にする
  • 音声入力を強く活用する
  • 最終確認、監査、承認、例外処理のために最小限の structured console を残す
  • 従来 ERP の大量入力画面を再現すること自体は目的にしない

さらに NFT ドメインと Dmail(Web3 分散型メール)は、MVP 前提ではなく将来の optional trust layer として段階的に統合することで、従来の Vertical SaaS では到達しにくい「信頼のプラットフォーム」へ発展しうる。


2. ビルメン業界の構造と痛点

2.1 業界の数字

指標 出典
人手不足認識 92% の事業者が不足と回答 ザイマックス総研 2024
警備員の60歳以上 52.7% 全国ビルメンテナンス協会 2025
清掃員の60歳以上 46.7% 同上
営業利益率 0.5%(他業界平均 5%以上) 業界実態調査
人件費率 57.7% 同上
IT/DX人材不足 47% が「いない」 同上
政府目標 2029年までに労働生産性 25%向上 厚生労働省 省力化投資促進プラン

2.2 多層下請け構造

ビルオーナー / PM会社
    │
    ├── 元請けビルメン会社(大手)
    │       │
    │       ├── 清掃(協力会社 A, B, C...)
    │       ├── 設備管理(協力会社 D, E...)
    │       ├── 警備(協力会社 F, G...)
    │       └── 衛生管理(協力会社 H...)
    │
    └── 各層で中間マージンが発生
        → 末端の作業員は最低賃金近辺
        → 元請けも利益率 0.5%

2.3 主要業務

  • 清掃管理: 日常清掃、定期清掃、特別清掃(面積×単価×頻度で積算)
  • 設備管理: 電気・空調・給排水・エレベーター等の点検・監視・保全
  • 警備防災: 常駐警備、巡回警備、防火管理、入退館管理
  • 衛生管理: 空気環境測定、水質検査、害虫防除

2.4 核心的な痛点

  1. 元請け〜協力会社の情報断絶: FAX/Excel/電話。同一プラットフォームに乗っていない
  2. 利益率 0.5%: 物件別の収支が見えず、赤字物件を放置
  3. 人手不足 92%: 事務作業に人手を取られ、現場に人が足りない
  4. 取適法対応: 発注条件の記録・保管が人手頼り
  5. 見積の属人化: 積算ロジックが担当者の頭の中

3. TATEKAN 3アプリのビルメンへの当てはめ

3.1 アプリ×ビルメン業務マッピング

TATEKAN アプリ ビルメンでの役割 整合性
Core 物件(案件)管理 / 年間契約管理 / 月次請求・入金 / 物件別損益 案件=物件。契約=保守契約。売上=月額+スポット
Mitsumori 清掃/設備/警備の積算・見積書・帳票出力・提出 面積×単価×頻度 = Mitsumori のテンプレート出力
Toriteki 協力会社への発注・作業報告受領・検収・受託側請求進行 元請け→協力会社 = vendor estimate → ordering → inspection
Control 元請け=full_linked / 協力会社=standalone(Toriteki only or Toriteki + Mitsumori) テナント構成管理がそのまま使える

3.2 典型フロー

1. ビルオーナーから年間契約 or スポット依頼
   → Core: 物件(案件)登録 + 契約管理

2. 見積作成(清掃: 面積×単価×頻度、設備: 点検項目×人工)
   → Mitsumori: 積算 + 帳票出力 + 提出

3. 協力会社への発注(清掃A社、警備B社...)
   → Toriteki: 見積依頼 → 回収 → 発注 → 作業完了報告

4. 検収・月次請求
   → Toriteki: 検収 → Core: 請求 + 入金

5. 原価管理(利益率 0.5% の世界で致命的に重要)
   → Core: 物件別損益 = 売上 - Σ(協力会社発注額)

4. NFTドメイン × Dmail の将来統合

4.1 NFTドメインとは

  • ブロックチェーン上に記録される所有権証明付きドメイン
  • 一度購入すれば永久所有、売却可能
  • Web3 ログイン認証として機能(Login with Unstoppable)
  • 主要プロバイダー: Unstoppable Domains, ENS

4.2 Dmail とは

  • Web3 分散型暗号化メール + 従来メールとの相互運用
  • AI 搭載アシスタント、Drive/Meeting/Chat 統合の Web3 ワークスペース
  • エンタープライズ向けマーケティングハブ
  • 2025年1億ユーザー目標、独自チェーン構築中

4.3 ビルメンでの活用

痛点 将来の NFTドメイン/Dmail による解決可能性
協力会社の実態が不透明 NFTドメインでオンチェーン企業認証
発注書がFAX/メールで改ざんリスク Dmail で暗号化送信 + オンチェーン証跡
作業完了の証拠が写真のみ 作業報告のハッシュをチェーンに記録
取適法対応が人手頼り 発注条件・支払条件がオンチェーンで自動検証

現時点の方針:

  • MVP の本線は 通常メール + 監査ログ + 添付証跡
  • NFT ドメインは Phase A ではブランド保護を主目的とする
  • Dmail は即時全面導入ではなく、PM pilot と限定的な実運用検証から入る
  • Web3 は optional trust layer であり、Core / Toriteki / Mitsumori の必須前提にはしない

5. 5層アーキテクチャ

┌──────────────────────────────────────────────────┐
│  Layer 5: AI Agent Hub(AI 主導層)               │
│  - 積算 AI: 面積×単価×頻度から自動見積           │
│  - 原価 AI: 物件別損益リアルタイム監視            │
│  - シフト AI: 人員配置最適化                      │
│  - 点検 AI: IoT異常検知 → 作業指示自動生成       │
│  - 取適法 AI: 発注条件の自動コンプライアンス      │
├──────────────────────────────────────────────────┤
│  Layer 4: Web3 Trust(信頼・証跡層)              │
│  - NFTドメイン: 将来の協力会社認証・テナントID    │
│  - Dmail: 将来の暗号化送信 pilot                  │
│  - オンチェーン証跡: 将来の作業/検収証跡          │
├──────────────────────────────────────────────────┤
│  Layer 3: TATEKAN Control(制御層)               │
│  - 元請け: Core+Toriteki+Mitsumori (linked)      │
│  - 協力会社: Toriteki only / Toriteki+Mitsumori   │
│  - designated_parent_app で shared reference 制御 │
├──────────────────────────────────────────────────┤
│  Layer 2: Business Apps(業務アプリ層)            │
│  ┌──────────┬───────────┬────────────┐          │
│  │ Core     │ Toriteki  │ Mitsumori  │          │
│  │ 物件管理 │ 協力会社  │ 清掃積算   │          │
│  │ 契約管理 │ 発注管理  │ 設備積算   │          │
│  │ 請求入金 │ 作業報告  │ 警備積算   │          │
│  │ 物件損益 │ 検収管理  │ 帳票出力   │          │
│  └──────────┴───────────┴────────────┘          │
├──────────────────────────────────────────────────┤
│  Layer 1: Infrastructure                         │
│  Cloud Run / Cloud SQL / GCS / tatekan.app       │
└──────────────────────────────────────────────────┘

6. 競合との差別化

要素 既存ビルメンSaaS TATEKAN 業界OS
対象 元請け単独 元請け + 協力会社が同一プラットフォーム
構造 モノリシック 3アプリ composable
協力会社 外部扱い standalone テナントとして参加
見積 手動入力 AI 積算 + テンプレート + 過去実績学習
証跡 DB内記録のみ 通常監査ログを本線、将来オンチェーン証跡を追加
取適法 チェックリスト 発注条件の自動検証
利益率管理 後追い集計 リアルタイム物件別損益
人手不足対応 機能提供のみ AI Agent が業務を代行

7. ロードマップ案

Phase A: 基盤固め(現在 → 6ヶ月)

  • TATEKANOS の AI-native operating system 原則を固定
  • TATEKAN Control Phase 1 実装完了
  • ビルメン固有エンティティ(物件、区画、作業メニュー、単価テーブル)の設計
  • Mitsumori の AI-first 積算テンプレート設計
  • Toriteki の売り引き / pricing / workflow 境界の整理
  • tatekan.app NFTドメイン取得(ブランド保護)

Phase B: 業界OS MVP(6〜12ヶ月)

  • 元請けテナント(full_linked)+ 協力会社テナント(standalone)の実運用
  • 物件別損益の自動集計
  • AI 積算支援
  • Mitsumori の AI-first MVP 実装
  • Con の tenant composition 運用開始
  • Dmail pilot(限定的な暗号化送信検証)

Phase C: 信頼プラットフォーム(12〜24ヶ月)

  • TATEKAN Core の集中再開と AI-first UI 置換
  • NFTドメインベースの協力会社認証
  • オンチェーン作業証跡
  • AI Agent Hub(シフト最適化、点検AI、取適法AI)
  • テナント間連携(A社の発注 → B社の受注が直接流れる)

8. 設計論点と採用方針

  1. ビルメン固有エンティティ: - property/buildingCore 所有 - zone は共通大マスターにせず、Mitsumori は見積用、Toriteki は実行用で使い分ける - service menu / unit price tableMitsumori 所有、CoreToriteki には snapshot を渡す
  2. 協力会社 standalone tenant: - 第一候補は Toriteki only - 第二候補は Toriteki + Mitsumori - Core は元請けの販売本体であり、協力会社の必須前提にしない
  3. NFTドメイン / Dmail: - MVP の前提にしない - Phase A はブランド保護、Phase B は PM pilot、Phase C で trust layer 拡張を狙う
  4. SaaS pricing: - 高額 seat 課金ではなく、低い基本料 + 成果連動 add-on を基本線にする - 協力会社向けは free receive/respond か極小課金を優先する
  5. AI Agent 優先順位: - 第1優先: 積算 AI - 次点: 原価 AI、取適法 AI - シフト AI / 点検 AI は後段
  6. 既存文書との整合: - domain_entity_service_mapping.md は汎用の上位参照として維持 - ビルメン固有拡張は別紙 industry_os_building_maintenance_mapping.md で整理する

9. 結論(暫定)

TATEKAN は「ビルメン業界OS」になりうる構造を既に持っている。

  • TATEKAN Control = 業界OS の Control Plane
  • 3アプリの composable 設計 = 元請け/協力会社が必要な機能だけ使える
  • standalone/linked = 多層下請け構造にそのまま対応
  • AI 3体制 = 開発自体が AI 協働で進んでいる

核心は「元請けと協力会社が同じプラットフォームに乗ること」であり、これが利益率改善・人手不足解消・取適法対応のすべてを同時に解く。

NFTドメイン + Dmail は optional trust layer として段階的に統合し、「信頼のプラットフォーム」へ進化させる。


10. Codex レビュー結果(2026-03-10 16:35 JST)

Codex が vision 本文 + 既存責務境界 docs + 外部一次情報を突き合わせてレビュー。

Finding 1: 物件系エンティティの所有権を厳密に分けるべき

  • property/building → Core 所有(安定した物件参照 + 契約・損益)
  • zone(作業範囲ゾーン) → 共通大マスターにしない
  • Mitsumori: 見積用の作業範囲ゾーン
  • Toriteki: 発注・納品・検収用の実行ゾーン
  • service menu / unit price table → Mitsumori 所有が基本
  • Core: 契約成立時のスナップショットのみ
  • Toriteki: 発注時の service package / agreed vendor rate snapshot のみ
  • 問題: vision の「Layer 2」表現だけだと Toriteki 側まで pricing master を持つように読める → 危険
  • 参照: tatekan_industry_os_vision.md:147, tatekan_responsibility_boundary_memo_20260310.md:22, tatekan_control_basic_design.md:95

Finding 2: 協力会社の standalone tenant 設計

  • 第一候補: Toriteki only
  • 第二候補: Toriteki + Mitsumori
  • Core は元請けの販売本体 → 下請けに最初から要求すると参加障壁が高すぎる
  • vision の「designated_parent_app で正本管理」は言い過ぎ → 正しくは「standalone dual-app 時の shared reference host」
  • ビジネスモデル: 協力会社向けは free receive/respond + low-cost operate、元請け側に network fee を持たせる
  • 参照: tatekan_industry_os_vision.md:142, tatekan_control_basic_design.md:255, tatekan_control_requirements_draft.md:152

Finding 3: NFT domain / Dmail は将来の optional trust layer に下げるべき

  • ブランド保護として tatekan.app 系取得 → OK
  • 企業 KYC や発注先実在証明の代替としては未成熟
  • Dmail: wallet/DID ベースの Web3 通信が本体。Google/Telegram 対応は進んでいるが、日本のビルメン業界の FAX/メール慣行をそのまま置き換える段階ではない
  • 結論: 近未来は 通常メール + 監査ログ + 添付証跡 を本線、Web3 は pilot に留める
  • 参照: tatekan_industry_os_vision.md:99

Finding 4: SaaS pricing — network-subsidized low-friction pricing が最適

  • 高額 seat 課金は不適(利益率 0.5% の業界)
  • 推奨モデル:
  • 元請け: Core + Toriteki + Mitsumori + Con の platform fee
  • 協力会社: Toriteki inbox/respond を 無料 or 極小課金、重い機能だけ有料化
  • 課金軸は field worker seat ではなく:
  • managed property / active vendor link / issued order / processed inspection / AI usage
  • 低い基本料 + 成果連動 add-on が推奨
  • 参照: tatekan_industry_os_vision.md:203

Finding 5: 最初の AI Agent は「積算 AI」

推奨順序: 1. 積算 AI(最優先 — 既存 pain に最も直結、Mitsumori 単独で価値を出せる) 2. 原価 AI(Core + Toriteki の原価実績がつながってから) 3. 取適法 AI 4. シフト AI / 点検 AI(workforce/attendance data、IoT/モバイル証跡が必要なため後段) - 参照: tatekan_industry_os_vision.md:130

Finding 6: domain_entity_service_mapping.md は拡張しすぎない

  • あれは横断の上位参照 → ビルメン固有エンティティを入れると汎用文書が vertical 専用化する
  • 推奨: domain_entity_service_mapping.md に短いリンク節だけ追加、別紙として industry_os_building_maintenance_mapping.md を起こす
  • 参照: domain_entity_service_mapping.md:27

Codex 総評

方向性自体は良い。修正すべき本質は 2 点: 1. ビルメン固有 master の所有権をもっと厳密に分けること 2. Web3 を MVP の前提ではなく将来レイヤーへ下げること

そこを直せば、Industry OS の主張はかなり筋が通る。

外部確認ソース(Codex)


11. ClaudeCode × Codex 合意事項(暫定)

論点 ClaudeCode 原案 Codex 修正 合意
物件エンティティ Core/Mitsumori/Toriteki に分散 所有権を厳密化: Core=物件参照、Mitsumori=作業ゾーン+単価、Toriteki=実行ゾーン+snapshot Codex 案を採用
協力会社モデル standalone テナント Toriteki only を第一候補、free receive/respond Codex 案を採用
NFT/Dmail Phase B で統合 MVP は通常メール+監査ログ、Web3は pilot Codex 案を採用(Phase C 以降に下げる)
SaaS pricing 未定 低基本料 + 成果連動 add-on、協力会社は無料/極小 Codex 案を採用
最初の AI Agent 未定 積算 AI → 原価 AI → 取適法 AI → シフト/点検 AI Codex 案を採用
既存文書との整合 未定 domain_entity にリンク節のみ、別紙で vertical mapping Codex 案を採用

12. 残る PM 判断待ち事項

  1. ビルメン業界OS を TATEKAN の正式なプロダクト方針として採用するか
  2. Phase A(基盤固め)の着手タイミング
  3. 合同産業以外の最初のターゲット顧客像
  4. NFT/Dmail の pilot 時期と対象
  5. 本構想を tatekan-ops PM ポータルに掲載するか

13. GeminiCLI レビュー結果(2026-03-10 17:00 JST)

GeminiCLI が NFT ドメインのオンボーディング設計と Dmail Chrome 拡張機能の実態を調査。

Finding A: NFTドメインの「2つの入口」設計

テナントに対して Web3 メール(NFTドメイン)の入口を 2 系統用意する。

A系統: BYOD(Bring Your Own Domain)— 上級者向けオプション

  • テナントが独自に NFT ドメインを用意(例: tenant-company.eth, tenant.crypto
  • メリット: テナント完全コントロール、ブランド一貫性、TATEKAN 側のコスト負担なし
  • デメリット: ウォレット管理リテラシーが必要 → 導入ハードルが高い

B系統: SaaS Managed — 標準オプション(推奨)

  • TATEKAN が親ドメイン(例: tatekan.eth)を取得
  • テナント登録時に tenant-a.tatekan.eth のようなサブドメインを自動発行
  • メリット: テナント側は Web3 知識不要、「エンタープライズ機能」申込だけで利用開始 → UX が劇的に向上
  • デメリット: ガス代を TATEKAN が負担、親ドメインの管理権限セキュリティが重要

GeminiCLI 推奨

  • まず B(TATEKAN サブドメイン自動発行)を標準の「監査・セキュア通信オプション」として提供
  • A(独自ドメイン持ち込み)は上級者向けオプション設定として開放

Finding B: Dmail Chrome 拡張機能による Web2/Web3 統合

Dmail は「既存の Web2(Gmail 等)と Web3 のシームレスな統合」を戦略の核としている。

Chrome 拡張機能でできること

  1. Gmail 画面での Web3 機能統合 - Gmail の画面上に Dmail 機能(暗号化送信、送信取り消し等)を統合
  2. Web2 ↔ Web3 双方向リレー通信 - Web2→Web3: Gmail 等から Dmail アドレス(xxx@dmail.ai)宛に送信可能 - Web3→Web2: Dmail から通常の Gmail / 企業メール宛に送信可能
  3. Wallet 接続ログイン - MetaMask 等のウォレット接続でパスワード不要の Web3 メール利用

TATEKAN テナントの利用イメージ

  • 通常業務: 今まで通り Gmail / Outlook でメールを見る
  • セキュア通信(Dmail 経由): Chrome 拡張機能 or TATEKAN 画面から送信ボタン → ブロックチェーン + 分散型ストレージ経由で改ざん防止・完全暗号化メッセージとして送達

GeminiCLI 総評

「2つの入口でテナントの導入ハードルを下げる」アプローチと、「Dmail の Web2/Web3 ゲートウェイ・Chrome 拡張機能で既存 Gmail の延長線上でセキュア通信を実現する」アプローチは、TATEKAN のプロダクト価値(言った・言わないをなくす、改ざん不可能な証跡を残す)を最大化する非常に現実的で強力な組み合わせ。


14. 3 AI Agent 統合見解

論点 ClaudeCode Codex GeminiCLI 統合結論
NFT/Dmail の位置づけ Phase B で統合 MVP 前提から外し将来 pilot 2入口設計 + Chrome拡張で現実的に統合可能 Phase A: ブランド保護取得のみ。Phase B: B系統(SaaS Managed)で pilot。通常メール+監査ログは本線維持
導入ハードル 段階的導入 FAX文化との橋渡しが課題 Gmail延長でUXを維持 Chrome拡張 + Gmail統合で「見えないWeb3」がベスト
プロダクト価値の核 信頼のプラットフォーム 物件master所有権 + 原価可視化 言った言わないの排除 + 改ざん不能証跡 「改ざん不能な取引証跡」が業界OS の差別化の核

15. PM 決定事項(2026-03-10 17:10 JST)

# 事項 PM 決定
1 ビルメン業界OS を正式プロダクト方針として採用 正式採用
2 NFT ドメイン親ドメイン取得 早期取得(Phase A でブランド保護)
3 Dmail pilot PM 自身がまず試す → 社内展開は PM 評価後に判断
4 PM ポータル掲載 掲載する

15.2 TATEKANOS 命名決定(2026-03-10 17:15 JST)

# 事項 PM 決定
5 プラットフォーム全体の呼称 TATEKANOS(タテカノス)に変更(旧称: TATEKAN Platform)
  • 「TATEKAN Platform」という表現は今後 TATEKANOS(タテカノス)に統一する
  • TATEKANOS = TATEKAN + OS(業界OS としてのポジショニングを名称に反映)
  • 読み: タテカノス(一語として読む。「タテカン・オーエス」ではない)
  • 略称: NOS(ノス)
  • 個別アプリ名(TATEKAN Core / Toriteki / Mitsumori / TATEKAN Control)は変更なし

15.3 TATEKANOS UI 原則(2026-03-10 17:20 JST)

  • NOS = AI-native operating system を採用する
  • CoreToritekiMitsumori の UI は最終的に AI-first を目指す
  • 主入口は chat + voice
  • ただし、監査、承認、差分確認、例外処理のための最小限の structured UI は残す
  • GLOVIA 型の大量入力画面をそのまま再現することは目的にしない

15.4 TATEKAN Core 再開方針(2026-03-10 17:25 JST)

  • TATEKAN Core は現行 GLOVIA 運用中の本体であるため、薄く並行実装しない
  • NOSConMitsumoriToriteki の前提整理を先に進める
  • Core の本実装再開は、最後に 集中フェーズ として扱う
  • 再開時は AI-first UI への置換を前提にする
  • それまでは再開準備、責務境界、参照キー、番号体系、監査要件の整理を優先する

未決定(継続検討)

  • Phase A 着手タイミング
  • 合同産業以外の最初のターゲット顧客像

16. Next Actions

  1. [ ] industry_os_building_maintenance_mapping.md を別紙として起草
  2. [ ] domain_entity_service_mapping.md にリンク節を追加
  3. [ ] Con Phase 1 の実装 scope を freeze する
  4. [ ] Mitsumori の AI-first MVP issue を分解する
  5. [ ] Toriteki の売り引き / pricing / workflow 境界を詰める
  6. [ ] TATEKAN Core 集中再開の前提条件を checklist 化する
  7. [ ] tatekan.eth / tatekan.crypto 等の NFT ドメイン取得調査 + 取得実行
  8. [ ] PM が Dmail Chrome 拡張機能を個人で試用

本文書は PM + ChatGPT → ClaudeCode → Codex → GeminiCLI の 4者討議プロセスを経た working document です。 ClaudeCode 調査・起草: 2026-03-10 14:00 JST Codex レビュー完了: 2026-03-10 16:35 JST GeminiCLI レビュー追記: 2026-03-10 17:00 JST PM 決定: 2026-03-10 17:10 JST — 正式採用 TATEKANOS 命名決定: 2026-03-10 17:15 JST

3. Responsibility Boundary Memo

Source

docs/Tatekan/tatekan_responsibility_boundary_memo_20260310.md

TATEKAN Responsibility Boundary Memo

Date: 2026-03-10 JST
Status: Working memo
Purpose: TATEKAN Core / Mitsumori / Toriteki / 一般購買 の責務境界を固定するための整理メモ

Related: - docs/Tatekan/tatekanos_canonical_commercial_architecture.md(2026-03-15 時点の canonical schema / master / 連携主線の整理)


1. 結論

TATEKAN 全体の責務分担は、次の前提で整理する。

  • TATEKAN Core は販売本体であり、案件の正本を持つ
  • Mitsumori は見積作成の正本を持つ
  • Toriteki は受発注、納品、検収、受託側請求などの進行管理を担う
  • 社内消耗品や事務用品などの一般購買は、顧客案件とは分けて扱う

2. 3システムの責務

2.1 TATEKAN Core

GLOVIA販売 が現状担っている販売本体機能の置換先として扱う。

主な責務:

  • 案件管理
  • 契約管理
  • 売上管理
  • 請求管理
  • 入金 / 消込
  • 会計連携
  • 販売本体系の顧客 / 物件 / 契約系マスタ

補足:

  • 案件の正本TATEKAN Core に置く
  • 顧客に紐づく業務案件の受注後商流正本は TATEKAN Core に置く
  • 見積起点案件では、受注前の起点は Mitsumori になり得る

2.2 Mitsumori

見積作成システムとして位置づける。

主な責務:

  • 見積作成
  • 見積明細編集
  • 見積一覧 / 検索
  • 見積複写
  • paste ベース入力
  • テンプレート帳票出力
  • 出力履歴
  • 見積提出補助

補足:

  • 見積書の正本Mitsumori に置く
  • Mitsumori は案件管理の正本を持たない
  • Mitsumori は本格的な受発注進行管理を持たない
  • ただし canonical architecture では、受注前の commercial_context 作成と Core への受注昇格起点を担う

2.3 Toriteki

受発注と履行進行のワークフローシステムとして位置づける。

主な責務:

  • 受託先への見積依頼
  • 見積回収
  • 発注
  • 納品
  • 検収
  • 受託側請求
  • 通知 / 督促 / メール起点ワークフロー
  • 取適法対応の進行管理

補足:

  • 受発注進行の正本Toriteki に置く
  • Toriteki は案件の親台帳そのものを持ちすぎない
  • Toriteki は契約 / 売上 / 入金 / 会計連携の正本を持たない
  • canonical architecture では、受注前の仮案件、execution_unit 単位の履行、請求候補化も担う

3. 入口の分岐

3.1 顧客案件

顧客に紐づく案件は、受注前後で起点を分けて扱う。

例:

  • 商マネ社案件
  • 商マネ社以外の顧客案件
  • 役務提供案件
  • 工事案件
  • 顧客請求対象となる物品購入

基本フロー:

  1. 見積起点案件では Mitsumori で見積と商流前段情報を作成
  2. 顧客受注/契約確定で TATEKAN Core に受注昇格する
  3. 必要なら Toriteki で受託先へ見積依頼・発注・納品・検収を行う
  4. 契約 / 売上 / 請求 / 入金 / 会計連携の正本は TATEKAN Core

補足:

  • 2026-03-15 時点の canonical は Mitsumori-first -> Core を標準とする
  • 本文書の Core-first 読みは、旧整理ではなく上記フローで読む

3.2 一般購買

社内消耗品や事務用品など、顧客案件に紐づかない購買は TATEKAN Core の案件起点とは分けて扱う。

例:

  • Amazon Business での事務用品購入
  • 社内使用の消耗品購入
  • 顧客請求対象ではない備品購入

補足:

  • これは 販売案件 ではない
  • 必要に応じて Toriteki を購買ワークフローに流用する余地はある
  • ただし 案件の正本 として TATEKAN Core に載せる前提ではない

4. 商マネ社案件とその他案件

4.1 商マネ社案件

商マネ社案件は、顧客案件として受注後商流正本を TATEKAN Core に置く。

特徴:

  • Mitsumori で商マネ社向け見積書を作成する
  • 承認や受発注進行は Toriteki で扱う
  • MARCURY への copy / 提出補助は Mitsumori UI が担う
  • MARCURY は外部 legacy であり、正本ではない

4.2 商マネ社以外の案件

商マネ社以外でも、顧客案件である限り基本構造は同じとする。

特徴:

  • Mitsumori で見積作成
  • 顧客受注確定で TATEKAN Core に受注昇格
  • Toriteki で受発注進行
  • MARCURY は関与しない

整理:

  • 商マネ社案件だけ MARCURY 分岐が追加される
  • システムの中心構造自体は商マネ社案件と共通である

5. 物品と役務の違い

5.1 役務 / 工事

役務や工事は、原則 顧客案件 として扱う。

したがって:

  • 見積起点なら Mitsumori
  • 受注後商流正本は TATEKAN Core
  • 外注や履行進行が必要なら Toriteki

5.2 物品

物品は、顧客案件に乗るかどうか で分岐する。

顧客案件に乗る物品

例:

  • 商マネ社案件の 建物管理費 として扱う物品

扱い:

  • 必要なら Mitsumori で見積 / 帳票作成
  • 受注後商流正本は TATEKAN Core
  • 必要なら Toriteki で受発注進行
  • 商マネ社案件なら MARCURY 入力が後続で発生しうる

顧客案件に乗らない物品

例:

  • 合同産業の社内消耗品
  • 事務用品

扱い:

  • 一般購買
  • TATEKAN Core の案件起点とは分ける

6. AIへの最初の指示

6.1 顧客案件

AIへの最初の指示は、案件段階に応じて起点を分けて考える。

例:

  • 見積を作成する
  • この案件は商マネ社案件である
  • この案件は物品案件である
  • この案件は役務案件である
  • 顧客受注が確定したので Core に昇格する

6.2 一般購買

一般購買は、TATEKAN Core ではなく購買フロー起点で指示する。

例:

  • 社内消耗品の購入を進める
  • Amazon Business での購買処理を進める

7. 重複させない原則

  • TATEKAN Core は案件・契約・売上・請求・入金・会計の正本を持つ
  • Mitsumori は見積作成に集中する
  • Toriteki は受発注と履行進行に集中する
  • MARCURY は商マネ社案件で必要な外部 legacy として扱う
  • 一般購買は顧客案件と混ぜない

8. 現時点の結論

GLOVIA販売 の置換本体は TATEKAN Core である。
Mitsumori は見積作成サブシステム、Toriteki は受発注・納品・検収の進行システムとして位置づける。 ただし、社内消耗品や事務用品などの一般購買は、顧客案件とは別フローとして扱う。


9. ClaudeCode レビュー(2026-03-15 19:30 JST)

9.1 本文書の位置付け

本文書は 2026-03-10 時点の責務境界の初期整理であり、その後 tatekanos_canonical_commercial_architecture.md(2026-03-15)で canonical schema・pure master・商流コンテキスト等を伴う再設計に発展している。本文書の基本方針(Core=案件正本、Mitsumori=見積正本、Toriteki=受発注進行正本)は canonical architecture でも維持されている。

9.2 本文へ反映済みの更新点

  • 見積起点案件の標準フローを Mitsumori-first -> Core に更新
  • Mitsumori の commercial_context 前段責務と Core 昇格起点を追記
  • Toriteki の仮案件 / 履行 / 請求候補責務を追記
  • MARCURY の copy / 提出補助を Mitsumori UI responsibility と明記

9.3 本文書で引き続き有効な整理

以下は canonical architecture でも変更されておらず、引き続き有効:

  • 一般購買と顧客案件の分離(§3.2)— canonical architecture ではスコープ外として扱われているが、本文書の整理が唯一の記述
  • 商マネ社案件と一般案件の MARCURY 分岐(§4)— canonical architecture では MARCURY を「商流属性」として抽象化しているが、本文書の具体的な分岐記述は実務参照として有用
  • 物品と役務の分岐ルール(§5)— canonical architecture では直接扱われていないため、本文書が唯一の参照
  • 重複させない原則(§7)— canonical architecture の pure master / 運用拡張分離と整合

9.4 Fredy 調査からの補足

2026-03-15 の Fredy マスター調査で以下を確認:

  • Fredy は department(部門)+ building(建物) ベースの組織構造を採用
  • 本文書で言及されていない business_code(業務コード)マスター が Fredy に存在し、GLOVIA 販売連携用のコード変換・会計属性付き master として機能
  • Toriteki の branch/facility は Fredy の department/building に移行予定(canonical architecture §11 Phase 1)

詳細: docs/architecture/tatekanos_family_integration.md

4. Canonical Commercial Architecture

Source

docs/Tatekan/tatekanos_canonical_commercial_architecture.md

TATEKANOS Canonical Commercial Architecture

Date: 2026-03-15 JST
Status: Working draft
Purpose: Mitsumori / Toriteki / TATEKAN Core の責務、canonical schema、共通 master、標準連携フローを固定し、個別最適を避けた再設計の正本たたき台とする


1. Architecture Decision (PM-approved 2026-03-16)

master management strategy は次の 3-phase で確定した。

  • Phase 1 (NOW): tatekanos_shared に canonical master model を library として追加する
  • Phase 2 (post-Toriteki + Mitsumori beta): Core を master-only scope で先行起動し、department / building / business_code / customer / supplier の単一正本とする
  • Phase 3 (long-term): 必要なら tatekanos_shared の service 化を検討する

補足:

  • Con (TATEKAN Control) は master authority にしない
  • Core は beta 後までは pure master authority ではなく、Phase 1 中は各サービスが shared schema + local Datastore で運用する
  • 本文書でいう Core = pure master authorityPhase 2 以降の責務 として読む

2. 結論

TATEKANOS の標準形は、次の 3 層構造とする。

  • Mitsumori
  • 見積正本
  • 商流コンテキスト正本(受注前)
  • 顧客受注確定まで
  • Toriteki
  • 仮案件
  • 発注
  • 履行
  • 検収
  • 発注/履行進行の正本
  • TATEKAN Core
  • 共通 pure master 正本
  • 受注後商流正本
  • 請求 / 入金 / 会計IF 正本
  • change set 正式確定

MARCURY は起票元ではなく、商流属性 / 外部連携属性 として扱う。
標準連携フローは次の通り。

Mitsumori
  -> Core
    -> Toriteki
      -> Core
        -> Accounting Adapter

ただしこれは単純な直列ではなく、役割分担は次のように固定する。

  • Mitsumori: 顧客向け見積と商流前段
  • Toriteki: 協力会社発注と履行実績
  • Core: 受注後商流と共通 master と請求/入金/会計

3. 設計原則

3.1 canonical schema 先行

  • Core の現行物理DBや GLOVIA販売 テーブルに全体設計を従属させない
  • 先に TATEKANOS canonical schema を定義し、その後に Core/GLOVIA へマッピングする
  • 物理実装は現行 Core を活かしてよいが、論理設計はそこに縛られない

3.2 pure master と運用拡張の分離

pure master は Core に寄せる。

  • department
  • building
  • business_code
  • customer
  • supplier

運用拡張は App 側または tenant adapter 側に分ける。

  • customer 運用拡張
  • 見積段階では Mitsumori
  • 受注後は Core
  • supplier 運用拡張
  • Toriteki

3.3 pure building / pure customer / pure supplier

  • building は pure master に保つ
  • customer は pure master に保つ
  • supplier は pure master に保つ
  • 請求先 / 契約先 / 管理会社 / 元請商流先 のような役割情報は master に持たせず、commercial_context に寄せる

3.4 標準形と例外形

  • 標準形は Core 併用
  • Mitsumori単独 は正式にあり得る
  • Toriteki単独 は標準外オプションとして保留する

4. canonical schema の主要 entity

4.1 共通 master

  • department
  • 組織所属
  • 承認系既定値
  • 見積既定値
  • building
  • 基本属性
  • 所属 department
  • 建物種別
  • business_code
  • 業務分類
  • 会計/売上区分
  • 工事分類
  • 集計区分
  • customer
  • pure customer master
  • supplier
  • pure supplier master

4.2 前段商流

  • quotation
  • quotation_line
  • commercial_context
  • quotation_line_execution_map

補足:

  • commercial_contextMitsumori でも正式 entity として持つ
  • Mitsumori 見積ヘッダ は複数の commercial_context を持てる
  • 見積明細commercial_context に明示リンクする
  • quotation_lineexecution_unit は多対多とし、quotation_line_execution_map
  • 按分数量
  • 按分金額
  • 補足メモ を持つ

4.3 受注後商流

  • sales_order
  • execution_unit
  • procurement_order
  • inspection_event
  • invoice
  • invoice_line
  • receipt
  • payment
  • accounting_export_batch
  • accounting_export_line
  • change_set
  • approval_event

4.4 粒度ルール

  • Core受注1件sales_order 1 件
  • sales_order 配下に複数の execution_unit を持てる
  • execution_unit の標準粒度は 建物 × 業務コード
  • execution_unit に対して複数の procurement_order を持てる
  • 請求は固定粒度ではなく invoice header + invoice lines

5. アプリ責務

5.1 Mitsumori

責務:

  • 見積作成
  • 見積承認
  • 顧客提示
  • commercial_context 前段編集
  • 顧客受注確定
  • Core への受注昇格起点

補足:

  • Mitsumori単独 テナントでは
  • 見積作成
  • 承認
  • 出力/提出
  • 受注確度/失注管理
  • 簡易受注管理 を標準機能として持つ
  • Core 導入テナントでは、簡易受注管理は read-only / 補助表示に留める
  • 既存の orders / delegations 相当機能は、Core 併用テナントでは正本機能として維持しない
  • orders: Coresales_order 参照または補助表示へ縮退
  • delegations: 見積承認 / 依頼補助へ再定義するか、不要なら整理対象とする

5.2 Toriteki

責務:

  • 受注前の仮案件
  • 原価見積/RFQ
  • 協力会社発注
  • 履行
  • 検収
  • 請求候補化

補足:

  • commercial_context は参照のみ
  • supplier 運用拡張は Toriteki 主編集
  • Toriteki は最終請求正本や最終会計IF正本を持たない

5.3 Core

責務:

  • pure master 正本
  • sales_order 正本
  • 請求対象確定
  • 請求確定
  • 入金確認
  • 会計 export
  • change_set 正式確定

UI 方針:

  • Core は基幹/管理ハブ寄り
  • 主に扱うのは
  • master 管理
  • 請求確定
  • 入金確認
  • change set 確定

6. 商流コンテキスト

6.1 定義

commercial_context は、案件上の相手先関係を保持する entity とする。

最低限含むもの:

  • 契約先
  • 請求先
  • 管理会社 / 元請商流先

6.2 配置原則

  • building は pure master のまま保つ
  • 相手先役割は buildingcustomer に持たせず、commercial_context に寄せ切る
  • execution_unit はどの commercial_context に属するかを明示リンクする

6.3 Mitsumori / Core / Toriteki での扱い

  • Mitsumori
  • 見積段階の正式 entity
  • 作成・編集を行う
  • Core
  • 受注後の正本
  • 継続編集を行う
  • Toriteki
  • 参照のみ

6.4 MARCURY との関係

  • MARCURYcommercial_context の一属性または外部連携条件として扱う
  • MARCURY への copy-paste / 提出補助の UI 責務は Mitsumori に置く
  • 手動運用が残る場合でも、どの画面がそれを補助するかは Mitsumori 側で明確に持つ

7. 標準ライフサイクル

7.1 顧客受注前

  1. Mitsumoriquotationcommercial_context を作成
  2. 必要なら quotation_line をもとに execution_unit 候補を判定
  3. 次の OR 条件を満たす場合、Toriteki に仮案件を起票 - 外注あり - 工事案件 - MARCURY 連動必要
  4. Toriteki では 建物 × 業務コード 粒度で仮案件を持つ

7.2 顧客受注確定

  1. 顧客受注/契約が確定した時点で Mitsumori -> Core
  2. Core に - quotation - quotation_line - commercial_context - sales_order を作成
  3. 条件に応じて execution_unit を正式生成

7.3 履行・検収

  1. Toritekiprocurement_order を作成
  2. 発注・履行・納品・検収を行う
  3. inspection_eventToriteki -> Core へ即時反映

7.4 請求対象化

  1. Toriteki が請求候補を作成
  2. Core が請求対象化を最終確定
  3. invoice / invoice_line を確定
  4. receipt / paymentaccounting_export へ接続

8. 変更管理

8.1 change_set

  • MitsumoriToriteki の両方から起票可
  • 正式確定は Core
  • Core 確定後は Mitsumori / Toriteki へ即時反映

8.2 change_set の対象

  • 見積明細
  • execution_unit
  • 受注増減額
  • 追加工事
  • 差替
  • 減額

9. 承認モデル

承認正本は単一システムに寄せず、業務段階ごとに分散する。

  • Mitsumori
  • 見積承認
  • Toriteki
  • 発注承認
  • Core
  • 請求承認
  • change set 承認

department が持つ 承認系既定値 は、承認ルートや承認候補者のデフォルト設定を指す。
承認実績そのものの正本は department に持たせず、各業務段階のシステムと approval_event に記録する。

横断監査用に approval_event を共通記録として持つ。

最低限持つ項目:

  • 対象ID
  • 承認者
  • 結果
  • 時刻
  • コメント
  • 承認段階 / ルート情報

10. 3システム横断連携表

領域 Mitsumori Toriteki Core 標準正本
department 参照 将来参照 管理 Core
building 参照 履行紐付け参照 管理 Core
business_code 見積で使用 発注/履行で使用 管理 Core
customer pure 参照 原則不要 管理 Core
supplier pure 原則不要 参照 管理 Core
customer運用拡張 前段編集 不要 後段編集 Mitsumori前段 / Core後段
supplier運用拡張 不要 主編集 必要時参照 Toriteki
commercial_context 作成/編集 参照のみ 受注後正本 Mitsumori前段 / Core後段
quotation 正本 参照起点になり得る スナップショット保持 Mitsumori
quotation_line 正本 原価/RFQ起点参照 スナップショット保持 Mitsumori
quotation_line_execution_map 前段作成 実行側参照 正式保持 Mitsumori前段 / Core後段
sales_order 顧客受注確定で昇格 参照 正本 Core
execution_unit 条件付き生成元 仮案件/履行実体 正式保持 Core + Toriteki実行
procurement_order 不要 正本 同期保持 Toriteki
inspection_event 不要 正本 即時反映保持 Toriteki
invoice / invoice_line 単独時は簡易受注まで 候補生成まで 正本 Core
receipt / payment 不要 支払予定入力元になり得る 正本 Core
accounting_export 不要 候補元になり得る batch + line 正本 Core
approval_event 見積承認 発注承認 請求/変更承認 分散正本 + 横断記録
change_set 起票可 起票可 正式確定 Core

11. Mitsumori / Toriteki の不足・過剰

11.1 Mitsumori に足りないもの

  • commercial_context の正式 entity 化
  • quotation_line -> execution_unit 多対多マッピング
  • business_code 前提の見積構造
  • customer pure / 運用拡張分離
  • 顧客受注確定から sales_order へ昇格する設計/実装
  • change_set 起票モデル
  • Core ありテナントでの簡易受注 read-only 化

11.2 Toriteki に足りないもの

  • branch / facility から department / building への完全移行
  • execution_unit = 建物 × 業務コード 粒度への統一
  • commercial_context 参照前提の設計
  • procurement_order -> inspection_event -> invoice candidate の canonical 接続
  • supplier pure / 運用拡張分離
  • change_set 起票モデル

11.3 Mitsumori に余計なもの

  • 受注後商流の本格正本化
  • 請求/会計まで持つ方向
  • agreements / orders を Mitsumori 内部正本として持つ発想

11.4 Toriteki に余計なもの

  • 最終請求正本
  • 最終会計 export 正本
  • branch / facility を family 共通 master として維持すること
  • commercial_context 自前正本化

12. 本書のスコープ外

本書は顧客案件に紐づく商流と履行の canonical architecture を対象とする。
次は本書の直接スコープ外とする。

  • 一般購買
  • 社内消耗品や事務用品の購買フロー
  • Toriteki単独 を正式標準形として扱う配備モデル

一般購買は tatekan_responsibility_boundary_memo_20260310.md の整理を参照し、必要に応じて別アーキテクチャで定義する。


13. 実装フェーズ

Phase 1: 共通 master 再編

先行:

  • department
  • building
  • business_code

実装方針:

  • tatekanos_shared に canonical master model を library として追加する
  • Mitsumori / Toriteki は shared schema を採用するが、この phase では各サービスの local Datastore を使う
  • Core はまだ master authority としては起動しない

後段:

  • customer
  • supplier

Phase 2: Mitsumori -> Core 主線

最小実装で次を一気に通す。

  • quotation
  • quotation_line
  • commercial_context
  • 顧客受注確定で sales_order 作成
  • 条件付き execution_unit 生成
  • これと並行して Core master-only scope を先行起動し、5 master の単一正本を持たせる

Phase 3: Toriteki -> Core 主線

最小実装で次を一気に通す。

  • procurement_order
  • inspection_event 即時反映
  • 請求候補化

Phase 4: 後段統制 / optional shared service 検討

  • customer / supplier 再編
  • change_set
  • receipt / payment
  • accounting_export adapter
  • 必要なら tatekanos_shared service 化の再評価

14. 保留事項

  • Toriteki単独テナント を正式な標準配備モデルにするか
  • tenant ごとの adapter 範囲の詳細
  • 現行 Core/GLOVIA 物理DBへの具体的マッピング方式
  • customer / supplier 後段移行の優先順

15. ClaudeCode レビュー(2026-03-15 19:30 JST)

15.1 全体評価

本文書は responsibility_boundary_memo(2026-03-10)を大幅に発展させた次段の設計文書として十分成立している。canonical schema の定義、pure master vs 運用拡張の分離、commercial_context の first-class entity 化は、Fredy 調査結果とも整合しており設計品質は高い。

15.2 同意する設計判断

  • pure master を Core に寄せる判断(department, building, business_code, customer, supplier)
  • commercial_context を building/customer に埋め込まず独立 entity とした判断
  • execution_unit の標準粒度 = building × business_code
  • change_set の分散起票 + Core 確定モデル
  • approval_event による横断監査記録
  • Mitsumori 単独テナントを正式な標準配備モデルとして認めた判断

15.3 要確認・要明確化の論点

論点1: Mitsumori-first vs Core-first の矛盾解消

responsibility_boundary_memo §3.1 では「Core で案件作成 → Mitsumori で見積作成」としているが、本文書 §6.1 では「Mitsumori で quotation/commercial_context を作成 → 顧客受注確定で Core に sales_order 化」としている。これは逆方向のフローである。

本文書の Mitsumori-first が canonical であるなら、responsibility_boundary_memo の該当箇所を明示的に「旧前提・更新済み」とマークすべき。曖昧なまま残すと実装者が Core-first と Mitsumori-first を混同する。

論点2: department と承認経路のデフォルト設定

Fredy 調査で department に approval_group1-4 が埋め込まれていることを確認した。本文書 §8 では承認を業務段階ごとに分散(Mitsumori=見積承認, Toriteki=発注承認, Core=請求/変更承認)としている。この設計は Fredy パターンより優れている。

ただし明文化が必要: department は「承認のデフォルト設定元」であって「承認実績の正本」ではない。Fredy の承認埋め込みをそのまま継承しないことを明示すべき。

論点3: Mitsumori 既存の /orders, /delegations の扱い

§10.3 で「agreements/orders を Mitsumori 内部正本として持つ発想」を excess と指摘しているが、現在の Mitsumori には既に /orders, /delegations ルートが存在する。移行方針の明確化が必要:

  • Core ありテナント: read-only 参照 or Core 昇格前後の補助 UI に縮退
  • Mitsumori 単独テナント: 簡易受注管理として限定維持
  • delegations: 見積承認/依頼補助へ再定義 or 整理対象

論点4: MARCURY 連携の実務責任

§1 で MARCURY を「商流属性/外部連携属性」として位置付けているのは正しい。ただし、実務的に誰が copy-paste ワークフローを維持するかが未定義。推奨: Mitsumori UI が MARCURY 連携対象案件の提出補助を担う(手動ではあるが UI 責任は Mitsumori 側)。

論点5: 一般購買のスコープ

本文書は顧客案件商流に集中しており、一般購買(社内消耗品・事務用品等)が扱われていない。推奨: §12 保留事項に「一般購買は本 canonical architecture のスコープ外。別アーキテクチャとして扱い、Toriteki を購買ワークフローに流用する余地あり」と明記する。

15.4 追加の設計観察

  1. schema と deployment model の分離: Mitsumori 単独可/Toriteki 単独は標準外/Core 標準は「配備モデル」であり、canonical schema とは別の関心事。将来的には別節に分離した方が読みやすい。

  2. commercial_context と customer 運用拡張の境界: commercial_context を first-class にした結果、customer 運用拡張との境界を厳密にしないと責務が逆流する。特に請求先/契約先/管理会社は customer 側へ戻さず commercial_context に留めるべき。

  3. execution_unit の例外: building × business_code は強い標準粒度だが、time-based recurring services や building をまたがる一括業務が将来出る可能性がある。標準粒度の注記として「例外時は execution_unit を建物横断で束ねる上位 entity を導入する余地あり」程度の escape hatch を記載しておくと安全。

  4. Fredy 業務マスターとの関係: 本文書の business_code は Fredy の businesses master に対応する。Fredy 調査で business_code が GLOVIA 連携用コード変換・集計・会計属性付き master であることを確認済み。本文書 §3.1 の business_code 定義(業務分類/会計・売上区分/工事分類/集計区分)は Fredy 実態と整合しており、そのまま採用可能。

5. gws Workspace Integration

Source

docs/Tatekan/gws_workspace_integration.md

Google Workspace CLI (gws) — TATEKANOSファミリー横断活用方針

作成日: 2026-03-12 作成者: ClaudeCode(GeminiCLI調査結果を統合・文書化) ステータス: Draft v0.1 参照記事: https://dev.classmethod.jp/articles/google-workspace-cli-release/


1. gws 概要

Google Workspace CLI(gws)は、GoogleのDiscovery Serviceを利用してGoogleの各種Workspace API(Gmail / Drive / Sheets / Chat等)をCLIコマンドから直接操作できるツール。

特徴 説明
動的API構築 Discovery Serviceで実行時にコマンドを構成。APIバージョンアップを自動吸収
構造化JSON出力 全レスポンスがJSONで返却 → スクリプト・AI解析が容易
セキュアな認証 Service Account / Domain-Wide Delegation を標準サポート
AI親和性 MCP(Model Context Protocol)経由でAIエージェントが直接操作可能
Agent Skills同梱 よく使われるワークフロー向けレシピ・スキルが付属

2. TATEKANOSファミリーにおける位置づけ

[TATEKANOS AI Agent Hub]
    ↓ MCP / CLIコマンド
[gws(Google Workspace CLI)]
    ↓
[Gmail]  [Google Drive]  [Google Sheets]  [Google Chat]
    ↑          ↑               ↑                ↑
  Mitsumori  Toriteki    TATEKAN Core       全システム
 (発注メール) (証跡保存)  (経営ダッシュ)     (通知・アラート)

設計原則: gws は「GCPインフラ(Cloud Run / Pub/Sub等)とGoogle Workspace(社内ツール)をつなぐ糊(のり)」として活用する。イベント駆動のコアアーキテクチャ(Push通知 / Pub/Sub)は各システムの設計を維持し、gws はその内部処理・補助ツールとして組み込む。


3. Mitsumori(見積管理)への応用

詳細: docs/Tatekan/mitsumori/mitsumori_infra_design.md §12

シナリオ gws コマンド 優先度
Marcury発注メール 本文・添付取得 gws gmail users messages get {messageId} Phase 1
処理済みラベル付与 gws gmail users messages modify --add-labels=MARCURY_PROCESSED Phase 1
エスカレーション転送 gws gmail users messages send Phase 2

アーキテクチャ上の注意: Gmail API Push + Pub/Sub(常時待ち受け)は引き続き必要。gws はイベント発火後の処理ロジック(Cloud Run worker内)で使用する。


4. Toriteki(受発注・納品・検収進行)への応用

4.1 下請け業者からの成果物(納品書・報告書)自動回収

シナリオ: 下請け業者がToriteki画面を使わずメールに納品書PDFを添付して送信してきた場合。

# Cloud Run内でのイメージ
gws gmail users messages get --userId=me --id={messageId} \
  --format=full | jq '.payload.parts[] | select(.mimeType=="application/pdf")'
# → 添付抽出 → GCS保存 → Toriteki納品ステータス自動更新

優先度: 高

4.2 やり直し依頼・エスカレーション自動化

シナリオ: 検収で不備があった場合、下請け業者へ修正依頼を送信。一定期間返信がない場合、社内マネージャーへエスカレーション。

# やり直し依頼メール送信
gws gmail users messages send --userId=me \
  --subject="【要対応】検収不備について" --to={vendor_email}

# 返信チェック(定期バッチ)
gws gmail users messages list --userId=me \
  --q="from:{vendor_email} after:{sent_date}" | jq '.resultSizeEstimate'
# → 0件なら Google Chat / メールでマネージャーへアラート

優先度: 中

4.3 発注書・検収書のセキュアな証跡保存(取適法・フリーランス新法対応)

シナリオ: 取引適正化法・フリーランス保護新法に対応するため、交付した書面をGoogle Driveに改ざん防止状態で長期保管。

# 指定フォルダへ保存(編集不可権限)
gws drive files create --name="発注書_{order_no}.pdf" \
  --parents={ORDER_ARCHIVE_FOLDER_ID} --uploadType=multipart

# 閲覧のみ権限付与(改ざん防止)
gws drive permissions create --fileId={file_id} \
  --role=reader --type=domain

優先度: 高(法令対応)


5. TATEKAN Core(案件・契約・売上・請求・会計連携)への応用

5.1 売上・請求データの経営ダッシュボード連携

シナリオ: 経営層・営業部門がBigQueryを直接叩かずにリアルタイムな売上実績をスプレッドシートで確認。

# BigQuery集計結果をスプレッドシートに日次出力
gws sheets spreadsheets values update \
  --spreadsheetId={DASHBOARD_SHEET_ID} \
  --range="売上実績!A1" --valueInputOption=RAW \
  --values="$(bq query --format=json '...' | jq '[...]')"

優先度: 中(BIツール導入前の軽量ダッシュボードとして有効)

5.2 契約・請求アラートの自動化

シナリオ: 未入金の請求が一定日数経過 / 高額契約が発生した際、担当者・経理に自動通知。

gws gmail users messages send --userId=me \
  --to={accountant_email} \
  --subject="【未入金アラート】{client_name} {amount}円 {due_date}超過"

優先度: 低(TATEKAN Core実装後に検討)

5.3 請求書PDFのDrive自動分類・権限管理

シナリオ: 顧客に発行した請求書の控えを顧客別・年月別フォルダに自動整理し、経理担当者のみアクセス可能にする。

# 年月・顧客フォルダを動的作成
gws drive folders create --name="{YYYY-MM}_{client_code}" \
  --parents={INVOICE_ROOT_FOLDER_ID}

# 請求書PDF保存
gws drive files create --name="請求書_{invoice_no}.pdf" \
  --parents={folder_id}

# 経理グループにのみ閲覧権限
gws drive permissions create --fileId={file_id} \
  --role=reader --type=group --emailAddress=keiri@godosangyo.com

優先度: 中


6. 実装優先度ロードマップ

優先度 システム シナリオ 対応Issue
P1 Toriteki 発注書・検収書 Drive証跡保存(取適法対応) 本Issue
P1 Mitsumori Marcury発注メール 本文・添付取得 + ラベル #248
P2 Toriteki 下請け業者からの成果物自動回収 本Issue
P2 TATEKAN Core 売上・請求データ → 経営スプレッドシート 本Issue
P3 Toriteki やり直し依頼・エスカレーション自動化 本Issue
P3 TATEKAN Core 請求書PDF Drive自動分類・権限管理 本Issue

7. 技術的共通事項

7.1 認証設計

Service Account: gws-automation-sa@gobms-465809.iam.gserviceaccount.com
→ Domain-Wide Delegation 設定(Google Workspace 管理コンソール)
→ Impersonation: gems-admin@godosangyo.com

7.2 Cloud Run 内での使用方法

# Dockerfile への追加
RUN curl -sSL https://github.com/nicholasgasior/gws-cli/releases/latest/download/gws-linux-amd64 \
    -o /usr/local/bin/gws && chmod +x /usr/local/bin/gws
# ※ 正式インストール方法は公式ドキュメントを参照

7.3 AIエージェント(ClaudeCode)との連携

MCP Server 経由で gws を直接操作可能: - 開発・テスト時: ClaudeCodeがメール取得テスト・ラベル付与テストを自律実行 - QA自動化: Playwright MCP + gws を組み合わせたE2Eテスト


8. 未解決事項

  • [ ] gws の正式インストール方法・Cloud Run対応バイナリの確認
  • [ ] Domain-Wide Delegation の設定(Google Workspace 管理者権限が必要)
  • [ ] 取適法対応 Drive フォルダ構造の詳細設計(保存期間・アクセス権限の法令要件確認)
  • [ ] TATEKAN Core の実装スコープ確定後に優先度を見直し

本文書はGeminiCLI調査(2026-03-12)結果をClaudeCodeが統合・構造化して作成。