図 (ダイアグラム)¶
waste-link の設計を視覚的に把握するための図を集約するセクションです。各図の内容は
実コード (apps/** / packages/** / supabase/migrations/** / scripts/**) を典拠に
しています。
図の一覧¶
| 図 | 内容 | ページ |
|---|---|---|
| シーケンス図 | 認証・公開オンボーディング・配車生成/編集・運行ログ・メンバー管理の処理フロー | シーケンス図 |
| 状態遷移図 | 案件 / アサインメント / 配車ストップ / 招待コード / サブスクリプションのステータス遷移 | 状態遷移図 |
| 概念モデル (ER) | tenants・profiles・factories・vehicles・dispatch_* など主要エンティティの関連 | 概念モデル (ER) |
| アーキテクチャ (C4) | システムコンテキスト〜コンテナ構成 (Structurizr DSL + Mermaid 補助図) | アーキテクチャ (C4 / Structurizr) |
描画方法 (Mermaid)¶
Markdown 内に ```mermaid コードフェンスを書くと、GitHub 上 (private リポジトリの
ファイル表示) や mkdocs serve のローカルプレビューでそのまま図として描画されます
(この設計書は公開 Pages では配信しません。詳細はトップページ参照)。追加プラグインは不要です。
下は描画確認用の最小サンプルです。
flowchart LR
A[Markdown の mermaid フェンス] --> B[GitHub / mkdocs-material]
B --> C[図として描画]C4 図は Structurizr DSL (workspace.dsl) を正準とし、Mermaid の補助図でも
概観できます。レンダリング手順は
アーキテクチャ (C4 / Structurizr) を参照してください。