はじめに

みなさんPower Platformでアプリやフローを作るときに、何から始めていますか？いきなり作り始めて手探りでやって行くのも最高におもろいですよね。ただ、行き詰まったり後から修正したりするときに、何をどう考えて作ったのかよく分からなくなった経験はありませんか？

私は最近Mermaid記法を知り、フロー図・エンティティ図・シーケンス図などを思考の整理のために簡単に書いています。これは市民開発との相性がいいのでは？と感じています。

今回は、私の実体験をもとにMermaid記法を知ることによって、市民開発にどんな変化があったのかをご紹介します。

Mermaid記法とは？

テキストで図を描けるマークダウンベースの記法

Mermaidの公式サイトへのリンク

結論：Mermaid記法を知る前と後の変化

Before：今まではこうやっていました

フローや利用シーンの検討

　なんとなく頭の中に描いていたのがほとんどです。やるとしてもPower PointとかOneNoteに書き出して作っていました。レイアウトを考える必要もあるので、結構大変でした。

必要なデータの設計

　Excelで書き出すか、テキストエディタで書き出す。リレーションまで表現することができないので、その辺は結構適当にやっていました。

After：Mermaid記法を知ってからこう変わった

フローや利用シーンの検討

　flowchartやsequenceDiagramを使って爆速で整理しています。特にフローチャートは一番最初に覚えることをお勧めします。ぱっと見難しそうですが、中身は結構単純なので、思いつくままに書き出すだけでフローチャートが描けるのは結構感動します。

必要なデータの設計

　Mermaid記法ではエンティティ図が書けます。テーブル名・PK・データ型・カラム名を定義して、リレーションまで表現して整理しています。これはアプリを作成した後に、誰かにデータの繋がりはこうなっていると説明する時にも使えます。設計がそのまま説明資料にもなるのが良い。

なぜMermaid記法が良いのか

考えることに集中できる

GUIは便利だがレイアウトを整えるというタスクが１つ増えます。

テキストだと考えるというシンプルなことだけに集中できます。

生成AIと相性が良い

Mermaid記法で下書きをして生成AIに投入をする。そうするとテキストで返信が返ってくる。そのまま手元で編集を継続できる。画像として生成されるとそうはいかない。Mermaid記法は生成AIと伴走する相性も良い。

設計＝説明資料になる

設計段階からMermaid記法で作成しておけば、後から誰かにアプリやフローの仕組みを説明するときの簡単な資料とすることもできます。特にフローやデータの設計は説明しづらいと思うので、資料があるといいですね。

まとめ

Mermaid記法を使うことによって市民開発の設計スピードが格段に上がりました。

皆さんもまずは一番簡単なflowchartから試してみてはいかがでしょうか。

（あと、Mermaid記法をタイピングですらすら書いていると、デキる感が出て気持ちいです笑）

tantan_tech

淡々と改善している人

XContact

建設会社にて、現場の施工管理からDX推進、データ利活用や機械学習を経て、現在は社内の市民開発（Power Platform）を推進しています。