はじめに データベース設計のER図について、VSCodeなどで作成する以下３つの方法を比較した記事です。 Draw.io PlantUML Mermaid 以前、Webアプリケーションを作成した際には、 Draw.io を使用して、作図しました。 （そのアプリのER図を今回サンプル図としています） 最近、 PlantUML を利用するようになり、ER図や、シーケンス図、クラス図の作図に利用しているのですが、とても編集しやすいと感じています。 ただ、どのツールにも、一長一短あるかと思いますので、それぞれ以下目次の内容を書いて、ご紹介したいと思います。 目次 1. Draw.io 1-1. VSCodeでの使い方 1-2. ER図 1-3. 感想 2. PlantUML 2-1. VSCodeでの使い方 2-2. ER図 2-3. 感想 3. Mermaid 3-1. VSCodeでの使い方

PlantUMLで図を描いていて、こんな感じの図になってしまいテンションが下がってしまうことがあるのではないでしょうか。 このような残念な図にならないためのコツを書いてみようと思います。 クラス図を例に説明しますが、ユースケース図も基本的に同じです。 -- と - を使い分ける 図で表現したい領域において、関連性の高いものは - で結び、高くないもの（以降「普通の関連」と表記します）は -- で結ぶ。 同じアルファベットで始まる要素が関連性の高い要素で、A1, B1, C1を普通の関連 -- で結んだ例:

ネタが無いときのスライド回顧録のコーナーです。 speakerdeck.com 論理削除と呼ばれるものはたくさんあり、delete_flgカラム作るとか、paranoiaみたいなgemを使うとかいろいろありますが、そういうことが話題にあがったときに「その削除フラグは本当に必要なのか？」と振り替えるために見ると良い資料です。 削除フラグは設計における脳内停止というのはこのスライドが発表された勉強会と同じ発表で和田さんがされているので、モデリングの観点でもインプットしておくとよいです。削除に対する構えかたがいろいろ変わります。 関連リンク SQLアンチパターン 幻の第26章「とりあえず削除フラグ」 論理削除Casual Talksでの議論を見て、削除フラグの採用を全力で阻止して本当に良かったと思った - valid,invalid 27. 論理削除とは何か？どのような解法があるのか？ w/ t

PlantUMLとは次に、PlantUMLについて簡単に説明します。PlantUMLは、テキストベースでシーケンス図を書くことのできる、UMLの一種です。シーケンス図を書く方法はいくつかありますが、この記事ではPlantUMLでシーケンス図を書く方法を解説していきます。 前提条件この記事では、すでにPlantUMLが動作する環境がある前提で解説していきます。もしまだ環境を構築していない場合は、インターネットで「PlantUML 環境構築」などで検索して準備してください。 あるいは、次のようなオンライン上でPlantUMLを実行できるサービスもあります。こちらを利用しても問題ありません。 PlantUML EditorPlantTextPlantUML Web Server メッセージメッセージの例メッセージは、システムの構成要素（分類子）同士のやりとりを表現します。シーケンス図は、このメッ

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert

技術4課の多田です. AWS 環境の構成図を書く機会で PowerPoint や Cacoo 等のサービスを使うことがあると思います.作図もコードで制御する方法もないかと思い調べてみたら,「AWS-PlantUML」というツールがありました.今回はこのツールを使って作図する方法と所感を書いていきます. milo-minderbinder/AWS-PlantUML 「AWS-PlantUML」とは 「AWS-PlantUML」とは,PlantUML 形式で AWS 構成図を書くためのツールになります.PlantUML の実行環境は調べればたくさん出てきますが,僕は普段 Visual Studio Code(以下,vscode)を使うため vscode で使う環境をセットアップしました. 参考URL PlantUML qjebbs/vscode-plantuml 「AWS-PlantUML」を

配置図とは？ UMLの配置図は、システムの物理的・ソフトウェア的側面からシステムの構成を図示化したダイアグラムになります。コンポーネント図に似ていますが、コンポーネント図がソフトウェア的側面から図示化されるのに対して、配置図ではどのシステムで成果物が作成され、利用されるのかも表現されます。 配置図によって、よりコンポーネント間の連携や関連性が分かりやすくなります。 配置図の目的 配置図はハードウェアや、その中で稼働するコンポーネントが可視化されます。それによってシステムの全体像が分かりやすくなります。また、成果物も図示化されるので、各コンポーネントで作成される成果物とその利用用途も明確になります。 現在、システムはハードウェアやコンポーネント含めて複雑に連携しています。あるシステムの修正が思わぬ場所で不具合を起こすことも少なくありません。全体像と関連性が明確になることで、そうした不具合の発

DDDではよく「モデリングが重要だ！」と言われますが、どのようにモデリングすればいいのかがわからず、一歩を踏み出せないことは多いのではないでしょうか。 そんな方のために、本記事ではDDDにおいてシンプルで成果が出しやすいモデリング手法について紹介します。 (本記事は、YouTube動画「10分でわかるドメインモデリング」の内容をもとにした解説記事です。) DDDの目的 DDDの目的から確認しましょう。 DDDの目的は2つ。 ①機能性を高めること これは、役に立つものを作ること、言い換えると「作ったけど使えない」を避けることです。 そのために、ドメインモデリングを行い、ソフトウェアを適用して役立てようとしている現実世界の領域(これの領域をDDDでは「ドメイン」と呼びます)について理解を深め、解決策を検討することを目指します。 ②保守性を高めること これは、長期間開発しても機能拡張が容易であり

この記事は、PlantUMLでシーケンス図を書くときに必要になる情報をまとめたものです。 PlantUMLとは 簡単なコードによる記述でUMLの様々な図が作成できるツールです。 UMLを活用する上での課題である「メンテナンスしていくのが困難」という点を、コードで記述するという手法によって解決することを試みています。 シーケンス図とは 一連の処理の実現方法を参加者間の相互作用で表すことができます。 設計時にどのクラスにどういうメッセージ（責務）を割り当てるかの検討や、既存の実装がどういう相互作用で実現されているかを整理するためなど、 色々な使い方ができる図です。 例インターネット記事投稿サービスの「記事を検索する」処理をどう実現させるかを設計する想定で図を作成してみました。 問題領域寄りの図 フレームワークなど、特定の技術要素に依存しない抽象的なシーケンス図です。 @startuml /'

ロバストネス分析の目的 ロバストネス分析は、詳細設計の前に実施する予備設計です。予備設計をすることによってシーケンス図やクラス図を作成するときに仕様の詳細について調べたり考えたりする時間を省略することができます。ロバストネス図作成時に、ユースケース記述上の足りない観点や疑問点を洗い出し、完全なユースケース記述に近づけます。 ユースケース記述の不足を発見する 仕様の抜け漏れを発見する 代替コースの処理が考えられているか確認する ユースケース記述にフィードバックし記述を完全なものにする ロバストネス図が影響を与える詳細設計 ロバストネス図で表現されている、バウンダリとエンティティはクラス図のクラス、シーケンス図のオブジェクトとなり、コントロールはクラスのメソッド(振舞い)になる。 ロバストネス図のルール バウンダリー 名詞 コントロール 動詞 エンティティ 名詞 名詞 → 動詞 → 名詞という

Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article?

＜フロー図を書くツールがほしい＞ 以前から、ゲームブックのフロー図を描く良いツールは無いかな、と探していました。 ゲームブック界隈だと ・The GameBook Authoring Tool (GBAT) 辺りが有名なんですが、頻繁にマウス操作が求められるし、よくバグるしで、どうも自分には合わなかったんですよね。良いツールではあるのですが、１００パラグラフ以上のものを作ろうとすると5000円以上払わないといけないのも痛い。 そんな折、 というツイートを見かけました。 どうやらテキストだけで図が書けるツールみたいです。これはよさそうかも。 という訳で『PlantUML』を調べてみたところ下記のサイトがヒットしたのですが。 プログラマーズ雑記帳：http://yohshiy.blog.fc2.com/blog-entry-152.html ……CUIで使うものなのかorz いや、CUIでもい

GoFのデザインパターンは23種類もあるので、PlantUMLでクラス図を書く練習にちょうどよい。 そういう訳で、PlantUMLでデザインパターンのクラス図を描く。 その前に、用語を整理しておこう。 UML では、用途に応じて図が何種類か定義されている。クラス図（Class Diagram）はそのうちの1つだ。 PlantUML はこれを書くためのツールで、jarとして端末から実行する。IntelliJ IDEA や Visual Studio Code といった IDE で使えるプラグインもあり、esa.io や Confluence のような情報共有ツール上でも利用できるので、好きな環境でやろう。 こういうテキストを書いておくと、 @startuml class ClassA { } class ClassB { } @enduml こういう図が出力される。 図を書く際は、ここから

フューチャーアーキテクト Advent Calendar 2017 の2日目です。 システム設計が大好きで大嫌いな皆さん、こんにちは。 突然ですが、皆さんはどのようにシステム設計における ドキュメント腐る問題 に立ち向かっていますか？ … ドキュメント腐る問題とは、設計時に作成した各種ドキュメントがGoogle Driveやファイルサーバ上で陳腐化してしまい、現状の正しい状態を指していないことです。せっかく新規参画者がキャッチアップしようとしてもドキュメントが真実を示していないという怖いやつですよね。 今まで出会った一番辛いドキュメントは、PJ初期に作成したホワイトボードに書かれたラフスケッチの画像しか無かったところですね。まず字が汚いし、内容も最新版と微妙に異なっていました。新規参画者殺しにもほどがあると、ほんのちょっとだけ恨みました。 いやいや、ちゃんとサボらず整合性を取れよって？サボ

Mermaid is a JavaScript-based diagramming and charting tool that uses Markdown-inspired text definitions and a renderer to create and modify complex diagrams. The main purpose of Mermaid is to help documentation catch up with development. Doc-Rot is a Catch-22 that Mermaid helps to solve. Diagramming and documentation costs precious developer time and gets outdated quickly. But not having diagrams

フューチャーアーキテクト Advent Calendar 2017の2日目です。 はじめに システム設計が大好きで大嫌いな皆さん、こんにちは。 突然ですが、皆さんはどのようにシステム設計における ドキュメント腐る問題 に立ち向かっていますか？ ドキュメント腐る問題とは、設計時に作成した各種ドキュメントがGoogle Driveやファイルサーバ上で陳腐化してしまい、現状の正しい状態を指していないことです。せっかく新規参画者がキャッチアップしようとしてもドキュメントが真実を示していないという怖いやつですよね。 解決策としては、各種ドキュメントを、MarkdownやAsciiDoc、UMLはPlantUMLやmermaid、ERDはPlantUMLやerd、画面遷移図はUI Flow、REST-API設計はSwaggerなど、なるべくテキストベースで管理し、GitHubなどのリポジトリで管理する

[Visual Studio Code][Windows] PlantUMLの環境を設定する（シンタックスハイライト+リアルタイムプレビュー）umlPlantUMLVisualStudioCode 最近、Atom から Visual Studio Code (以下 VS Codeと表記）に乗り換えたので、PlantUML環境の作成手順をメモしときます。 環境作成 1. エディタ本体の設定 1.1. VS Code をインストールする 公式ページか VS Code をインストールします。 Visual Studio Code - Code Editing. Redefined 2. PlantUML環境の準備 ※PlantUMLのバイナリは自前で準備する必要はありません（プラグインに同梱されているため） => 最新で任意の plantuml.jar を指定する機能が追加されました。 2.1.

2017年8月30日に開催されたDDDAlliance( https://ddd-alliance.connpass.com/event/64219/ ) のLTの資料です。 Read less