Skip to content

図表スタイルガイド

docs/ 配下の全 Mermaid 図で配色を統一するためのルール。

beautiful-mermaid のテーマ色は docs/.vitepress/mermaid-plugin.ts で定義されている(VitePress のライト/ダーク色をハードコード)。Mermaid コードブロック自体には基本的に色指定を書かない。

ただし、classDefstyle ディレクティブで特定ノードに色を付けたい場合は、以下のカラーパレットを使うこと。


1. カラーパレット

1.1 領域カラー(9色)

各領域に固有の色体系を割り当てる。

領域メイン背景
代行#00838F#B2EBF2
組織#4472C4#D6E4F0
家族#548235#E2EFDA
申告#C55A11#FCE4CC
給与#7030A0#E8D5F5
アイデンティティ#546E7A#CFD8DC
国税#C62828#FFCDD2
地方税#795548#D7CCC8
サブスクリプション#AD1457#FCE4EC

1.2 アーキテクチャレイヤー(4色)

Clean Architecture の各層に対応する色。

レイヤーメイン背景
Domain#2E7D32#E8F5E9
Application#1565C0#E3F2FD
Infrastructure#E65100#FFF3E0
Presentation / BFF#6A1B9A#F3E5F5

1.3 セマンティックカラー

状態遷移図・フローチャートでの結果表現に使用する。

意味
成功 / 正常#4CAF50
エラー / 失敗#F44336
警告 / 注意#FF9800
情報 / 中立#2196F3

2. Mermaid での色の適用方法

classDef

ドメイン層アプリケーション層
ドメイン層アプリケーション層

style ディレクティブ

エンティティ
エンティティ

3. レイアウト原則

  • 情報の流れ: 左→右(flowchart LR)または 上→下(flowchart TD)で統一する
  • subgraph: 関連する要素のグループ化に使用する
  • 色指定が不要な場合は classDef/style を省略し、beautiful-mermaid のデフォルトテーマに任せる