投稿者: ￥552(税込)

行先ボード開発が脱線を続けています。

マークダウンで設計書が書きたい
というところから始まったmenDocですが
行先ボードのプログラミングも面倒くさくなってきました。

プログラミングするプログラムでも作ろうかというのが今回の趣旨です。
もちろんプログラミングするプログラムにはプログラミングが必要です。

何を言ってるのかわからない？
えぇ、僕もわかりません。

クラス図もmenDocを作成したので書き直します。

gRCPを使ってみた感じからすると、
gRPCを使用する部分はプロジェクトファイルを分けた方がよさそうです。
元々GUIアプリ(クライアント側)→GUIアプリ(サーバー側)→データベース
というような構成で考えていましたがちょっと方針転換します。

GUIアプリ(クライアント側) → 共通ライブラリ(gRPC) → コンソールアプリ(サーバー側)→データベース
こんな感じで行こうかと思います。

名前を付けておきます。

• 行先ボード(ユーザー操作用):Destinationboard
• 行先ボードサーバー(データベース操作用):DestinationboardServer
• 行先ボード通信ライブラリ(gRPC用):DestinationboardCommunicationLibrary

menDocを使用して設計していきます。

前回ER図を

• Draw.io Integration
• Markdown Preview Mermaid Support
• A5M2

で書いてみたのですが、どうも後一歩なんですよね。

何が後一歩かというと、以下の内容です。
まぁ、僕の使い方が悪いだけかもしれませんが・・・。

• 書き方に気を取られて設計に集中できない（Markdown Preview Mermaid Support）
• 差分が取れない(A5M2, Draw.io Integration)
• 設計した内容をソースコードに起こしたい
• 設計した内容からドキュメントを作りたい

で、menDocを作ったのでそっちでER図を作っていきます。

行先ボードを開発中ですが寄り道します。
やらないといけないことがあるとやらなくて良いことをやりたくなるのが人間の性。
試験期間中に部屋の掃除がしたくなるアレです。
寄り道してしまいました。所要時間13時間。

行先ボード開発の見積工数は118.5時間。
何と勿体ないことを・・・。

とりあえず、言い訳をしておきます。
普段はEnterprise Architectを使用しているので
そこまでは感じなかったのですがさすがにドキュメント作成がしんどい。
クラス図書いてるあたりで吐きそうになりました。

• 差分とれないしエクセルがイヤ(この点はEnterprise Architectも同じだけど)
• 設計書ごとにツールが色々分かれるのもイヤ
• マークダウンで図書けるけど、細かい説明が書けないのがイヤ
• 詳細をマークダウンで書けるけど表が絶望的に書きづらい

設計書作成ツール。menDoc。
自分が使える範囲で使えれば良いのでかなり適当です。

menDoc → 由来：めんどくさいドキュメント。
ネーミングセンス・・・。