https://habit-docs-dev.getto.systems/2.2.3/docs/ Recent content in ドキュメント on げっと Habit Hugo -- gohugo.io https://habit-docs-dev.getto.systems/2.2.3/docs/project/inception-deck/ Mon, 01 Jan 0001 00:00:00 +0000 https://habit-docs-dev.getto.systems/2.2.3/docs/project/inception-deck/ <h2 id="heading">我々はなぜここにいるのか</h2> <ul> <li>システムが強化されたことを確認できるようにする</li> <li>システムの強化が継続していることを確認できるようにする</li> </ul> <h2 id="heading1">エレベーターピッチ</h2> <ul> <li>システムを強化するためのアイデアをストック</li> <li>ストックしたアイデアの中から重要なものを選択して着手</li> <li>着手したアイデアの目的が達成されたかを追跡</li> <li>目的を達成したアイデアの価値を評価</li> </ul> <p>評価されたアイデアの価値によって、システムが強化されたことを確認できる。</p> <h2 id="heading2">関係者</h2> <ul> <li>ドメインエキスパート <ul> <li>アイデアの提供</li> <li>目的に対する指標が適切か評価</li> <li>アイデアの価値の評価</li> </ul> </li> <li>開発者 <ul> <li>アイデアの提供</li> <li>目的に対する指標の提供</li> <li>アイデアの価値の評価</li> </ul> </li> </ul> <h2 id="heading3">夜も眠れない問題</h2> <ul> <li>アイデアの価値を評価する方法が見つからないかも</li> </ul> <h2 id="heading4">やること、やらないこと、あとで決めること</h2> <h3 id="heading5">やること</h3> <ul> <li>アイデアの価値を評価できるようにする <ul> <li>着手するアイデアの選択</li> <li>目的達成を測る指標の計測</li> <li>達成されたアイデアから価値を評価</li> </ul> </li> <li>アイデアの所属先を定義できるようにする <ul> <li>クライアント</li> <li>プロジェクト</li> </ul> </li> <li>ユーザーの所属するチームを定義できるようにする <ul> <li>ユーザーの所属していないチームのアイデアは参照不可能</li> <li>ユーザーは複数のチームに所属できる</li> </ul> </li> </ul> <h3 id="heading6">やらないこと</h3> <ul> <li>継続して価値が生み出されているか確認すること</li> </ul> <h3 id="heading7">あとで決めること</h3> <ul> <li>アイデアの価値を評価する方法</li> </ul> <h2 id="heading8">システムアーキテクチャ</h2> <ul> <li>認証サービス : Keycloak</li> <li>WEB アプリケーション <ul> <li>UI : Elm</li> <li>ドメインサービスアダプタ : TypeScript + Elm ports</li> <li>HTTP サーバー : Go</li> </ul> </li> <li>ドメイン <ul> <li>コア : Rust</li> <li>データベースアクセス : Ruby</li> </ul> </li> </ul> <h2 id="heading9">タイムライン</h2> <table> <thead> <tr> <th>日付</th> <th>マイルストーン</th> </tr> </thead> <tbody> <tr> <td>2019/10/04</td> <td>ドキュメント作成開始</td> </tr> <tr> <td>2019/10/20</td> <td>ドキュメント作成完了</td> </tr> <tr> <td>2019/10/w3</td> <td>認証サービスデプロイ : 開発</td> </tr> <tr> <td>2019/10/w3</td> <td>UI実装 : ドメインサービスアダプタ Mock</td> </tr> <tr> <td>2019/10/w3</td> <td>コアドメイン実装 : データベースアクセス Mock</td> </tr> <tr> <td>2019/10/w3</td> <td>データベースアクセス実装 : コアドメイン統合</td> </tr> <tr> <td>2019/10/w4</td> <td>ドメインサービスアダプタ実装 : HTTP サーバー実装 : UI 統合</td> </tr> <tr> <td>2019/10/w4</td> <td>認証サービスデプロイ : 本番</td> </tr> <tr> <td>2019/10/w4</td> <td>リリース</td> </tr> </tbody> </table> <h2 id="heading10">トレードオフスライダー</h2> <h3 id="heading11">基本</h3> <ul> <li><code>###-------</code> : 機能</li> <li><code>##########</code> : 予算</li> <li><code>##########</code> : 時間</li> <li><code>######----</code> : 品質</li> </ul> <h3 id="heading12">機能</h3> <ul> <li><code>###-------</code> : アイデアのストック</li> <li><code>##########</code> : トロフィーの獲得</li> <li><code>######----</code> : 価値の評価</li> </ul> https://habit-docs-dev.getto.systems/2.2.3/docs/aquarium/detail/ Mon, 01 Jan 0001 00:00:00 +0000 https://habit-docs-dev.getto.systems/2.2.3/docs/aquarium/detail/ <p><img src="abstract.png" alt="概要"></p> <h2 id="heading">サービス</h2> <h3 id="heading1">コア</h3> <ul> <li>ToImportant : 重要度を「大」に変更</li> <li>ToMiddle : 重要度を「中」に変更</li> <li>ToTrivial : 重要度を「小」に変更</li> <li>Attach : アイデアの着手</li> <li>Undo : アイデアの着手の取り消し</li> <li>ListFloating : 未着手アイデアを重要度の大きい順に列挙</li> </ul> <h3 id="heading2">詳細</h3> <h4 id="idea-">Idea に関するサービス</h4> <ul> <li>Register : アイデアの登録</li> <li>Unregister : アイデアの削除</li> <li>ChangeContent : アイデアの内容の変更</li> <li>ChangeProject : アイデアの所属するプロジェクトの変更</li> </ul> <h4 id="project-">Project に関するサービス</h4> <ul> <li>Register : プロジェクトの登録</li> <li>Unregister : プロジェクトの削除</li> <li>ChangeName : プロジェクト名の変更</li> <li>ChangeTeam : プロジェクトのチーム割り当ての変更</li> <li>ChangeClient : プロジェクトのクライアントの変更</li> </ul> <h4 id="client-">Client に関するサービス</h4> <ul> <li>Register : クライアントの登録</li> <li>Unregister : クライアントの削除</li> <li>ChangeName : クライアント名の変更</li> <li>ChangeColor : クライアントカラーの変更</li> </ul> <h2 id="heading3">モデルオブジェクト</h2> <h3 id="idea">Idea</h3> <p><code>entity</code></p> <p>以下の要素の集約ルート。</p> <ul> <li>Importance : 重要度（大・中・小）</li> <li>State <ul> <li>attached（着手済）</li> <li>floating（未着手）</li> </ul> </li> <li>Content : 内容（タイトル・概要・詳細）</li> <li>ContentLog : 内容の変更ログ</li> </ul> <p>以下のリポジトリでデータを取得、変更する。</p> <ul> <li>Book : Idea を記録する</li> </ul> <p>以下の要素への参照を持つ。</p> <ul> <li>Project : このアイデアが属するプロジェクト</li> </ul> <p>大まかな挙動については<a href="https://habit-docs-dev.getto.systems/2.2.3/2.2.3/docs/aquarium/">概要</a>参照。</p> <h4 id="importance">Importance</h4> <p><code>value</code></p> <p>以下の属性を持つ。</p> <ul> <li>importance : 重要度（大・中・小）</li> </ul> <h4 id="state">State</h4> <p><code>value</code></p> <p>以下の属性を持つ。</p> <ul> <li>is_attached : 着手済みか</li> </ul> <h4 id="content">Content</h4> <p><code>entity</code></p> <p>以下の属性を持つ。</p> <ul> <li>title : タイトル</li> <li>summary : 概要</li> <li>detail : 詳細</li> </ul> <h4 id="contentlog">ContentLog</h4> <p><code>entity</code></p> <p>以下の属性を持つ。</p> <ul> <li>changed_at : 変更日時</li> <li>moment : 変更後の Content データ</li> </ul> <h4 id="book">Book</h4> <ul> <li>Idea データのリポジトリ</li> </ul> <h3 id="project">Project</h3> <p><code>entity</code></p> <p>以下の要素の集約ルート。</p> <ul> <li>Client : クライアント</li> <li>ProjectTeam : プロジェクトを担当するチーム</li> </ul> <p>以下の属性を持つ。</p> <ul> <li>project_name : プロジェクト名</li> </ul> <p>以下のリポジトリでデータを取得、変更する。</p> <ul> <li>Work : Project を記録する</li> </ul> <p>以下の要素への参照を持つ。</p> <ul> <li>Client : このプロジェクトが属するクライアント</li> </ul> <h4 id="client">Client</h4> <p><code>entity</code></p> <p>以下の属性を持つ。</p> <ul> <li>client_name : クライアント名</li> <li>client_color : クライアントカラー</li> </ul> <h4 id="projectteam">ProjectTeam</h4> <p><code>value</code></p> <p>以下の属性を持つ。</p> <ul> <li>project : プロジェクト</li> <li>team : チーム</li> </ul> <h4 id="work">Work</h4> <ul> <li>Project データのリポジトリ</li> </ul> https://habit-docs-dev.getto.systems/2.2.3/docs/cockpit/detail/ Mon, 01 Jan 0001 00:00:00 +0000 https://habit-docs-dev.getto.systems/2.2.3/docs/cockpit/detail/ <p><img src="abstract.png" alt="概要"></p> <h2 id="heading">サービス</h2> <p><a href="https://habit-docs-dev.getto.systems/2.2.3/2.2.3/docs/trophy/detail/#cockpit-%E3%81%AB%E9%96%8B%E7%A4%BA%E3%81%99%E3%82%8B%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9">Trophy</a> のサービスにアクセスする。</p> <p>大まかな挙動については<a href="https://habit-docs-dev.getto.systems/2.2.3/2.2.3/docs/cockpit/">概要</a>参照。</p> https://habit-docs-dev.getto.systems/2.2.3/docs/trophy/detail/ Mon, 01 Jan 0001 00:00:00 +0000 https://habit-docs-dev.getto.systems/2.2.3/docs/trophy/detail/ <p><img src="abstract.png" alt="概要"></p> <h2 id="heading">サービス</h2> <h3 id="heading1">コア</h3> <ul> <li>Pending : attached を pending にして理由を設定</li> <li>Block : attached を blocked にして理由を設定</li> <li>Restart : pending / blocked を attached に変更</li> <li>Done : attached を measuring に変更</li> <li>Complete : measuring を completed に変更</li> <li>Close : attached / pending / blocked / measuring を closed に変更</li> <li>ListTask : 特定の状態の Task を価値の大きい順に列挙</li> </ul> <h3 id="heading2">詳細</h3> <h4 id="aquarium-">Aquarium に開示するサービス</h4> <ul> <li>Register : Attach した時 Task を登録する</li> <li>Unregister : Undo した時 Task を削除する</li> </ul> <h4 id="cockpit-">Cockpit に開示するサービス</h4> <ul> <li>ListAttached : attached な Task を着手順に列挙する</li> <li>ListMeasuring : measuring な Task を完了順に列挙する</li> <li>ListPending : pending な Task を着手順に列挙する</li> <li>SumUpCompleted : completed な Task を期間ごとに集計する</li> </ul> <h2 id="heading3">モデルオブジェクト</h2> <h3 id="task">Task</h3> <p><code>entity</code></p> <p>以下の要素の集約ルート。</p> <ul> <li>Trophy : タスクの価値</li> <li>State : attached / pending / blocked / measuring / completed / closed</li> <li>StateLog : 状態の変更ログ</li> </ul> <p>以下のリポジトリでデータを取得、変更する。</p> <ul> <li>Rack : Task を記録する</li> </ul> <p>以下の要素への参照を持つ。</p> <ul> <li>Idea : Aquarium の Idea データ</li> </ul> <p>大まかな挙動については<a href="https://habit-docs-dev.getto.systems/2.2.3/2.2.3/docs/trophy/">概要</a>参照。</p> <h4 id="trophy">Trophy</h4> <p><code>value</code></p> <p>以下の属性を持つ。</p> <ul> <li>name : 名称</li> <li>number : 順列</li> </ul> <h5 id="-trophy">定義する Trophy</h5> <ul> <li>bronze : 1</li> <li>silver : 2</li> <li>gold : 3</li> <li>platinum : 4</li> </ul> <h4 id="state">State</h4> <p><code>value</code></p> <p>以下の属性を持つ。</p> <ul> <li>state <ul> <li>attached（着手済）</li> <li>pending（保留）</li> <li>blocked（中断）</li> <li>measuring（計測中）</li> <li>completed（完了）</li> <li>closed（終了）</li> </ul> </li> </ul> <h4 id="statelog">StateLog</h4> <p><code>entity</code></p> <p>以下の属性を持つ。</p> <ul> <li>changed_at : 変更日時</li> <li>state : 変更後の状態</li> <li>reason : 変更理由</li> </ul> <h4 id="rack">Rack</h4> <ul> <li>Task データのリポジトリ</li> </ul> https://habit-docs-dev.getto.systems/2.2.3/docs/project/context-map/ Mon, 01 Jan 0001 00:00:00 +0000 https://habit-docs-dev.getto.systems/2.2.3/docs/project/context-map/ <h2 id="heading">概要</h2> <p><img src="abstract.png" alt="コンテキストマップ"></p> <h3 id="auth">Auth</h3> <ul> <li>User の管理</li> <li>Team の管理</li> <li>コアドメインへの User、Team データの提供</li> </ul> <h3 id="team">Team</h3> <ul> <li>Auth からの User、Team データは Aquarium、Trophy、Cockpit で共有する</li> </ul> <h3 id="aquarium">Aquarium</h3> <ul> <li>Idea のストック</li> <li>Trophy への Idea データの提供</li> </ul> <h3 id="trophy">Trophy</h3> <ul> <li>タスクの価値の評価</li> <li>Cockpit への Task データの提供</li> </ul> <h3 id="cockpit">Cockpit</h3> <ul> <li>タスクの価値の概観</li> </ul> https://habit-docs-dev.getto.systems/2.2.3/docs/auth/detail/ Mon, 01 Jan 0001 00:00:00 +0000 https://habit-docs-dev.getto.systems/2.2.3/docs/auth/detail/ <p><img src="abstract.png" alt="概要"></p> <h2 id="heading">サービス</h2> <h3 id="heading1">コア</h3> <ul> <li>GetUser : ユーザーの情報を取得</li> </ul> <h2 id="heading2">モデルオブジェクト</h2> <h3 id="user">User</h3> <p><code>entity</code></p> <p>以下の属性を持つ。</p> <ul> <li>token : API の通信に使用するトークン</li> <li>user_id : 全ユーザーで一意な識別子（作成後変更されない）</li> <li>user_name : ユーザー名</li> <li>user_email : ユーザーのメールアドレス（アイコンの表示）</li> <li>teams : ユーザーの所属するチーム</li> </ul> <h4 id="team">Team</h4> <p><code>entity</code></p> <p>以下の属性を持つ。</p> <ul> <li>team_id : 全チームで一意な識別子（作成後変更されない）</li> <li>team_name : チーム名</li> </ul>