Pulse / System Overview

構成図・ER図・フロー図・使い方

このページは、現時点のPulseをドッグフーディングするための共有資料です。 実装済みの境界、主要データ、自然言語入力から保存・レビューまでの流れ、 週次レビューでの使い方を1枚で確認できます。

1. 現時点の構成

通常URLのWeb UI、Auth.js、事業コンテキスト、tRPC/API Routes、Drizzle DB、AI推奨境界を分ける。 現在事業はまず pulse.current_business_id を localStorage に保持し、 後でユーザー設定DBへ移行しやすい形にする。LLMは提案を担い、制約満足や スケジュール判断はSolver境界へ寄せる方針。

編集用Draw.io: system-architecture.drawio / 画像: PNG ・ SVG

利用者 CTO / PdM / PM ロードマップ確認 事業コンテキスト embedded switcher localStorage current apps/web Next.js App Router /roadmap /settings /intake/milestones/new /intake/epics/new /tasks/new tRPC / API Routes businesses / settings milestones / epics / tasks registration suggestions audit / drafts / versions packages/db Drizzle schema business_id 境界 Milestone / Epic / Task Dependency / Audit / Settings packages/contracts Zod schema / types AI input / output Graph / Solver contracts AI / Solver 境界 Claude補完 / 根拠生成 FastAPI / Pydantic sidecar CP-SATは将来の判定境界 セキュリティ境界 WebSearchなし / schema検証 / 人間レビュー

2. ER図

主要テーブルは org_id と business_id を境界に持つ。 事業ごとに Roadmap、Milestone、Epic、Task、依存、設定、監査ログを切り替えて読む。

編集用Draw.io: erd.drawio / 画像: PNG ・ SVG

organizations id / name users org_id / email businesses org_id / code / status owner_id / metadata roadmaps business_id / title milestones roadmap_id / business_id epics business_id / milestone_id display_id / effort / uncertainty progress override / rationale tasks epic_id / display_id / effort constraints source / target type / strength / certainty bottleneck_category dependencies business_id blocker / blocked constraint_id / status dependency_type_links dependency_id / type certainty / rationale registration_drafts business_id / target_layer milestone_id / parent_epic_id payload / ai_rationale stakeholders business_id / name is_external / metadata stakeholder_rules stakeholder_id / rule priority owner_profiles business_id / user_id capacity / lanes recommendation_rules business_id / priority owners / stakeholders business_metrics business_id / type / name epic_metric_links epic_id / metric_id audit_logs business_id / target / diff epic_versions epic_id / snapshot

3. 現在事業での登録・レビューのフロー

事業を選ぶと pulse.current_business_id が更新され、Roadmap、Intake、Settings が同じ事業を読む。登録は対象ごとの専用ページで行い、AI補完、登録前差分、最終確認を通して保存する。

事業選択 current_business_id 専用Intake Milestone / Epic / Task AI補完 依存 / KPI / 工数 / 根拠 登録前差分 Before / After / Diff 最終確認 下書き / 直接保存 Roadmap反映 DB由来で再描画 監査/版管理 audit / versions / decisions 採用候補 影響確認

4. 使い方

通常登録

  1. 事業を選び、現在事業を確定する。
  2. Roadmapの登録メニューから Milestone または Epic の専用登録へ進む。
  3. Epic配下のTaskはEpic詳細から追加・編集・削除候補化する。
  4. AI補完で依存候補、KPI、ステークホルダー、工数、所用期間の根拠を確認する。
  5. 登録前差分と最終確認を見て、下書きまたはRoadmapへ反映する。

ドッグフーディング

  1. Pulse自身の改善テーマをEpicとして投入する。
  2. 読みにくい、迷う、保存できない、判断できない箇所を記録する。
  3. 週次レビューで未確定制約、AIレビュー待ち、Red/Yellow Bufferを見る。
  4. 改善点をGitHub Issueへ落とし、PRで閉じる。
  5. 改善後に同じ入力セットで再確認する。

5. セキュリティ・運用ガードレール

禁止

WebSearchを追加しない

プロンプトインジェクション対策として、プロダクト機能にWebSearchを持たせない。

禁止

.envを読まない

秘密情報をAI文脈へ載せない。必要な設定は別エディタで扱う。

禁止

AGPL/GPLを追加しない

新規OSS追加時はライセンスを確認し、一覧へ反映する。

原則

AIは提案に留める

制約満足、順序、スケジュールはSolver / ルール / 人間レビューで検証する。

原則

rationale必須

Epic、Task、Constraint、Dependency、AI候補には判断根拠を残す。

原則

org境界を守る

保存済みEpic、監査ログ、依存、KPI、リソースは組織境界で読む。

6. 実装済みと次に見るもの

領域 現時点 次に見る論点
事業スコープ 実装済み localStorage の pulse.current_business_id を使い、Roadmap / Intake / Settings を同じ事業で読む。 将来は user_preferences DB へ移行
専用登録 実装済み /intake/milestones/new、/intake/epics/new、/intake/tasks/new を追加。 登録フォームの責務分割とAI補完UIの軽量化
Roadmap Canvas 実装済み DB由来のMilestone / Epic / Taskを事業ごとに表示し、詳細モーダルから編集導線を持つ。 CCPM / bottleneck / impact simulation の実装
AI補完 発展中 依存候補、KPI、ステークホルダー、工数・所用期間、不確実性の根拠を提示。 Claude応答とfallbackの精度検証、Solver検証境界の実装
Governance 発展中 OWNER、Stakeholder、Recommendation Ruleを事業ごとに管理する。 削除/アーカイブ運用、優先度、推奨根拠の体験改善

参照