Private / PM Only

Access Protected

dMemo References

dMemo references for architecture, design, specification, and requirements inside the PM portal.

Quick Map

0. References

Source documents rendered inside the PM portal.

  • docs/Tatekan/dMemo/dmemo_architecture.mdArchitecture
  • docs/Tatekan/dMemo/dmemo_appsheet_design.mdAppSheet Design
  • docs/Tatekan/dMemo/dmemo_ai_analysis_spec.mdAI Analysis Spec
  • docs/Tatekan/dMemo/README.mdOverview

1. Definition

dMemo is part of TATEKANOS. This page keeps the current canonical source documents inside the PM portal.

Architecture

Source

docs/Tatekan/dMemo/dmemo_architecture.md

dMemo システムアーキテクチャ

概要

TODO: アーキテクチャ全体図(AppSheet → Cloud Run → BQ → Looker Studio)

コンポーネント構成

コンポーネント 役割
AppSheet 現場スタッフ日報入力 UI
Cloud Run (dmemo-service) AI 解析バックエンド
BigQuery データウェアハウス(work_logs / ai_tasks / ai_pain_points)
Vertex AI Gemini 日報テキスト解析
GCS 標準バケット 添付ファイル一時保存(365日)
GCS 保全バケット 法的保全用(3年保持)
Looker Studio 管理者ダッシュボード

データフロー

TODO: 1. 現場スタッフが AppSheet で日報入力 2. AppSheet → Cloud Run /analyze POST 3. Cloud Run → Vertex AI Gemini でタスク分解 + 困り事抽出 4. 解析結果を BigQuery に書き込み 5. Looker Studio が BQ をクエリしてダッシュボード表示

セキュリティ設計

TODO: IAM 設計、Cloud Run 認証設定

スケーラビリティ設計

TODO: Cloud Run 自動スケール設定、BQ パーティション設計の根拠

Design

Source

docs/Tatekan/dMemo/dmemo_appsheet_design.md

dMemo UI 設計(Phase 2: Web UI)

方針変更 (2026-02-28): Phase 2 の UI 実装を AppSheet(GUI手動作業)から、 FastAPI + Jinja2 によるコード実装に変更。 AppSheet は Phase 5 以降で検討を継続する。


Phase 2 実装: Web UI 概要

現場スタッフが日報を入力するモバイル対応 Web アプリ。 Cloud Run 上の FastAPI + Jinja2 テンプレートで提供。

対象ユーザー

  • スタッフ: 日報入力・自分の日報履歴確認
  • 管理者 (admin): 上記 + 部署別ダッシュボード閲覧

認証

環境 認証方式
Dev フォームログイン(メール + 部署選択)※認証なし
Staging/Production Google Cloud IAP(Phase 5 以降)

画面一覧

パス 画面 ロール
/login ログイン 全員
/worklogs 日報一覧(自分) 全員
/worklogs/new 日報入力フォーム 全員
/dashboard 管理者ダッシュボード admin のみ

テンプレート構成

scripts/dmemo_service/
├── templates/
│   ├── base.html          ベースレイアウト(モバイル対応 viewport + nav)
│   ├── login.html         ログイン画面
│   ├── worklog_form.html  日報入力フォーム
│   ├── worklog_list.html  日報一覧
│   └── dashboard.html     管理者ダッシュボード
└── static/css/
    └── style.css          レスポンシブ CSS(モバイルファースト)

日報入力フィールド

フィールド 必須 備考
日付 date デフォルト: 今日
作業内容 textarea Phase 3 で AI 解析対象
作業時間 number 単位: 時間、0.5 刻み
タグ text カンマ区切り

AppSheet(将来検討)

Phase 5 以降で以下を検討: - モバイルアプリとしての AppSheet 提供 - オフライン入力対応 - Push通知

Spec

Source

docs/Tatekan/dMemo/dmemo_ai_analysis_spec.md

dMemo AI 解析仕様

実装: scripts/dmemo_service/vertex_analyzer.py

概要

Vertex AI Gemini(gemini-2.0-flash)を使用して日報テキストを解析する。

解析処理

タスク分解(ai_tasks)

TODO: プロンプト設計 - 入力: 日報テキスト(work_logs.content) - 出力: タスクリスト(category / task_description / estimated_minutes / is_digital / is_paper_excel) - category 値域: TODO(デジタル業務 / 紙・Excel業務 / 移動 / 会議 等)

困り事抽出(ai_pain_points)

TODO: プロンプト設計 - 入力: 日報テキスト(work_logs.content) - 出力: 困り事リスト(severity / description / suggested_solution) - severity 値域: high / medium / low

API エンドポイント

POST /analyze
{
  "log_id": "...",
  "log_date": "2026-02-28",
  "user_email": "...",
  "department": "...",
  "content": "今日の業務内容..."
}

TODO: レスポンス形式の詳細定義

Vertex AI 設定

項目
モデル gemini-2.0-flash
ロケーション asia-northeast1
認証 google.auth.default()
タイムアウト 60秒

エラーハンドリング

TODO: Gemini API エラー時の挙動設計

コスト見積もり

TODO: 想定リクエスト数 × トークン数 × 単価

Requirements

Source

docs/Tatekan/dMemo/README.md

This overview is currently the closest requirement entry point.

dMemo (DailyMemo) — プロダクト概要

TATEKAN プラットフォームの新オプション「dMemo」。 日報 AI 解析・業務可視化・法的保全を一体化したサービス。

ドキュメント構成

ファイル 内容
dmemo_architecture.md システムアーキテクチャ設計
dmemo_bigquery_schema.md BigQuery スキーマ定義
dmemo_appsheet_design.md AppSheet UI 設計
dmemo_ai_analysis_spec.md AI 解析仕様
dmemo_legal_hold_spec.md 法的保全仕様
dmemo_deployment_runbook.md デプロイ手順書
Docs/ ユーザー向け・管理者向けドキュメント
faq/ よくある質問

フェーズ計画

Phase 内容 状態
1 GCPリソース + フォルダ構成 + スケルトン ✅ 完了
2 AppSheet 構築(手動) 🔜 未着手
3 Vertex AI 解析ロジック実装 🔜 未着手
4 保全自動化ロジック実装 🔜 未着手
5 Looker Studio 構築(手動) 🔜 未着手
6 ドキュメント整備 🔜 未着手

GCP リソース

リソース
GCP Project gobms-465809
BQ Dataset (dev) dmemo_dev
BQ Dataset (staging) dmemo_staging
BQ Dataset (prod) dmemo
GCS 標準 gobms-dmemo-standard
GCS 保全 gobms-dmemo-legalhold
Cloud Run (dev) dmemo-service-dev
Cloud Run (staging) dmemo-service-staging
Cloud Run (prod) dmemo-service