UML図とMermaid記法 — 図はすぐ嘘になる
設計図を描いても、3週間後には嘘になっています。画像で描いた図は誰も直さないからです。この記事では「テキストで書けて、Gitで差分が見えて、コードと突き合わせられる図」だけを扱います。クラス図・シーケンス図・ER図の3つを、アスキー図とMermaid記法の両方で書きます。ER図はCREATE TABLEを読んで関係を機械で出し、多対多に中間テーブルが要ることを確かめます。最後にステートマシン図を状態遷移表としてコードに落とし、node --test で「図に描いていない矢印は1本も通れない」ことをテストします。図がそのままテストになると、図は腐りません。