<p></p>
<h1 id="miketakoxy"><a class="header-anchor-link" href="#miketakoxy" aria-hidden="true"></a> miketakoxy</h1>
<h2 id="business-name"><a class="header-anchor-link" href="#business-name" aria-hidden="true"></a> Business Name</h2>
<p>蛭田 海斗 (Kaito Hiruta)</p>
<h2 id="career"><a class="header-anchor-link" href="#career" aria-hidden="true"></a> Career</h2>
<p>現在の所属はあり直接聴いてください。</p>
<table>
<thead>
<tr>
<th>時期</th>
<th>所属</th>
<th>経験</th>
</tr>
</thead>
<tbody>
<tr>
<td>2017/05 - 2017/12</td>
<td>スマートアプリ株式会社 (インターン)</td>
<td>Laravel, iOS</td>
</tr>
<tr>
<td>2018/01 - 2019/03</td>
<td>ヴァンテージIT株式会社 (インターン)</td>
<td>Firebase, Vue, Ansible</td>
</tr>
<tr>
<td>2019/04 - 2025/04</td>
<td>LINEヤフー株式会社</td>
<td>Spring Boot, RDB, NoSQL, DevOps, SRE</td>
</tr>
</tbody>
</table>
<h2 id="skills"><a class="header-anchor-link" href="#skills" aria-hidden="true"></a> Skills</h2>
<table>
<thead>
<tr>
<th>スキル</th>
<th>経験度</th>
<th>説明</th>
</tr>
</thead>
<tbody>
<tr>
<td>Java</td>
<td>⭐︎⭐︎⭐︎⭐︎⭐︎︎︎</td>
<td>実務で主に使用しています。</td>
</tr>
<tr>
<td>Spring Boot</td>
<td>⭐︎⭐︎⭐︎⭐︎⭐︎︎︎</td>
<td>実務で主に使用しています。</td>
</tr>
<tr>
<td>SRE</td>
<td>⭐︎⭐︎⭐︎⭐︎</td>
<td>インフラではなく原義的なSREの知見があります。</td>
</tr>
<tr>
<td>DevOps</td>
<td>⭐︎⭐︎⭐︎⭐︎</td>
<td>CI/CDを整えるなど。</td>
</tr>
<tr>
<td>Kubernetes</td>
<td>⭐︎⭐︎⭐︎⭐︎</td>
<td>実務経験があります。</td>
</tr>
<tr>
<td>Cassandra</td>
<td>⭐︎⭐︎⭐︎⭐︎</td>
<td>実務経験があります。</td>
</tr>
<tr>
<td>Redis</td>
<td>⭐︎⭐︎⭐︎⭐︎</td>
<td>実務経験があります。</td>
</tr>
<tr>
<td>MySQL</td>
<td>⭐︎⭐︎⭐︎⭐︎</td>
<td>実務経験があります。</td>
</tr>
<tr>
<td>Cassandra</td>
<td>⭐︎⭐︎⭐︎⭐︎</td>
<td>実務経験があります。</td>
</tr>
<tr>
<td>Google Cloud</td>
<td>⭐︎⭐︎⭐︎</td>
<td>Professional Cloud Developerの資格を取得しています。</td>
</tr>
<tr>
<td>Next.js</td>
<td>⭐︎⭐︎⭐︎</td>
<td>SSGを中心にですがReact関連などを基本として実装可能です。</td>
</tr>
<tr>
<td>Remix</td>
<td>⭐︎⭐︎</td>
<td>実装可能です。</td>
</tr>
</tbody>
</table>
<h2 id="products"><a class="header-anchor-link" href="#products" aria-hidden="true"></a> Products</h2>
<p>個人プロダクトです。</p>
<table>
<thead>
<tr>
<th>プロダクト</th>
<th>説明</th>
<th>要素技術</th>
</tr>
</thead>
<tbody>
<tr>
<td><a href="https://miketako.xyz" target="_blank" rel="nofollow noopener noreferrer">miketako.xyz</a></td>
<td>このサイト</td>
<td>Next.js、Cloudflare Pages、Tailwind CSS、TypeScript、Github Actions</td>
</tr>
<tr>
<td><a href="https://niche.love" target="_blank" rel="nofollow noopener noreferrer">Niche Love</a></td>
<td>SNS</td>
<td>Remix、Cloudflare D1、Workers、R2、Grafana Cloud</td>
</tr>
<tr>
<td><a href="https://apps.apple.com/jp/app/blue-biscuit-%E8%A8%BA%E6%96%AD-%E3%83%A1%E3%83%B3%E3%82%BF%E3%83%AB%E3%82%B1%E3%82%A2%E3%82%B2%E3%83%BC%E3%83%A0/id6504722201" target="_blank" rel="nofollow noopener noreferrer">Blue Biscuit</a></td>
<td>メンタルケア iOSアプリ</td>
<td>Swift UI、Xcode Cloud</td>
</tr>
<tr>
<td><a href="https://apps.apple.com/jp/app/puppy-buddy-%E5%AD%90%E7%8A%AC%E3%81%AE%E9%A3%9F%E4%BA%8B-%E3%82%AB%E3%83%AD%E3%83%AA%E3%83%BC-%E4%BD%93%E9%87%8D%E7%AE%A1%E7%90%86%E3%82%A2%E3%83%97%E3%83%AA/id6744896003" target="_blank" rel="nofollow noopener noreferrer">Puppy Buddy</a></td>
<td>ペットの体重、食事管理</td>
<td>Swift UI、Xcode Cloud</td>
</tr>
</tbody>
</table>
<h2 id="%E3%81%8A%E4%BB%95%E4%BA%8B%E4%BE%9D%E9%A0%BC%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6"><a class="header-anchor-link" href="#%E3%81%8A%E4%BB%95%E4%BA%8B%E4%BE%9D%E9%A0%BC%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6" aria-hidden="true"></a> お仕事依頼について</h2>
<p>お仕事の依頼は<a href="mailto:contact@miketako.xyz">メール</a>にてお願いいたします。</p>
<h2 id="other-interests"><a class="header-anchor-link" href="#other-interests" aria-hidden="true"></a> Other Interests</h2>
<p>Look at <a href="/posts/likes">Likes</a>.</p>


みけたこ (miketakoxy) について

Magic: The Gatheringのカードを検索するMCPサーバーを建ててみた

Agent2Agent プロトコルを試して見えてきたGoogleの戦略

## 概要

オライリーの「プロダクションレディマイクロサービス」

https://www.oreilly.co.jp/books/9784873118154/

を読んだので、内容やノウハウをメモする。

## 全体感

UberのSREがプロダクションレディなマイクロサービスはどのようなものかについてチェックリスト的にまとめた書籍。

全体としては書籍の体は保っているものの、本当にチェックリストのようだった。

付録には本当にチェックリストという名目で箇条書きで掲載されており、確かにこれが網羅できていればプロダクションレディと言えそう。

一方で、これを全てやるのは至難の業。少なくとも日本国内だとこんなしっかりとしている企業は無いのではないかというレベル。

総じてイデア的に使うものであり、必要十分条件ではないと感じた。

(この書籍の内容が出来ていればプロダクションレディかもしれないが、プロダクションレディなサービスがこの書籍の内容を満たすとは限らない。)

## ノウハウ

本番対応の原則は以下の8つの項目である。

1. 安定性
2. 信頼性
3. スケーラビリティ
4. 耐障害性
5. 大惨事対応
6. パフォーマンス
7. 監視
8. ドキュメント

### 安定性

安定して動く、バグがない、のようなものではない。

CI/CDが整っているか、開発プロセスはわかりやすいか、など開発者目線での安定感が要点。

### 信頼性

テストは十分か、完璧なステージング環境があるか、カナリアリリースが行われているか、など。

### スケーラビリティとパフォーマンス

その名の通り。これらはまとめて語られていた。ボトルネックの明確化やキャパシティプランニングが適切に行われているかなど。

### 耐障害性と大惨事対応

これらもまとめて語られていた。単一障害点が無いこと、起こりうる大惨事が明確になっていること、障害対応手順の標準化など。

### 監視

ロギング、アラーティング、オンコールなどが適切に行われていること。ダッシュボードが整備されていること。

面白かったのは以下。

> オンコールランブックは、半分寝ている開発者でも難なくたどれるように書かれていなければなりません。

Susan J. Fowler. プロダクションレディマイクロサービス (p.233). Kindle 版. 

確かにその通りなのだが、「半分寝ている」という表現がちょっと面白かった。そんなランブックを書くことが果たしてできるのかという疑問は残るものの、やはり理想としては間違いない。

### ドキュメント

> 本番対応のよいドキュメントの目標は、サービスについての知識を一元的に管理するリポジトリを作って、メンテナンスすることです。共有すべき知識は、サービスについてのありのままの事実と、サービスが何を行い、組織全体でどのような位置を占めるかについての組織的な理解の両方です。そのため、ドキュメントが貧弱だという問題は、ドキュメント（事実）の欠如と理解の欠如の2つの下位問題に分けることができます。これら2つの下位問題を解決するには、すべてのマイクロサービスを通じてドキュメントを標準化するとともに、マイクロサービスについての理解を共有するための組織的な構造を用意する必要があります。

Susan J. Fowler. プロダクションレディマイクロサービス (p.224). Kindle 版. 

ドキュメントに関する項目があるのが非常に意外だった。他の項目は当たり前な部分が多いが、この項目に関しては新たな示唆が得られた気がする。

他にも引用しておくと以下のようにも書かれていた。

> 多くの開発者は、リポジトリ内にREADMEファイルを置くかコードにコメントをばらまいておけば、ドキュメントとして十分だと思っています。READMEファイルは必要不可欠であり、すべてのマイクロサービスのコードには適切なコメントが含まれていなければなりませんが、READMEは本番対応のドキュメントではなく、コメントはチェックアウトしてコード中を探し回らなければならなければ役に立ちません。

Susan J. Fowler. プロダクションレディマイクロサービス (p.226). Kindle 版. 

ドキュメントの有無は本当に大きい。「コードを読めばわかる」なんて表現は、個人的には場当たり的にコードを書く能力、時間しかありませんと言っているようなものだと思う。

例えばマイクロサービスとして利用している他チームのAPIを呼ぶ際に適切なタイムアウト値が知りたいとする。そんなとき「コードを読んでください」なんて言えない。API仕様書などの明示できるドキュメントが無ければ、利用者全員に対して個別に回答しなければいけないかもしれない。

全体として大規模なサービスになればなるほどマイクロサービスの利用者も増えるので、大手ほどこの問題が発生する可能性が高いはず。この書籍は全体的にそういう対象について議論しているように見える。

## まとめ

「プロダクションレディマイクロサービス」について感想やノウハウをまとめた。

誰かの参考になれば幸いです。

「プロダクションレディマイクロサービス」を読んだ


## 概要

中村昇著の「ウィトゲンシュタイン『哲学探究』入門」をAudibleで読んだので感想をまとめる。

https://www.audible.co.jp/pd/%E3%82%A6%E3%82%A3%E3%83%88%E3%82%B2%E3%83%B3%E3%82%B7%E3%83%A5%E3%82%BF%E3%82%A4%E3%83%B3%E3%80%8E%E5%93%B2%E5%AD%A6%E6%8E%A2%E7%A9%B6%E3%80%8F%E5%85%A5%E9%96%80-%E3%82%AA%E3%83%BC%E3%83%87%E3%82%A3%E3%82%AA%E3%83%96%E3%83%83%E3%82%AF/B0BTLR8BNQ

## 感想

### ウィトゲンシュタインの思想

ウィトゲンシュタインというと、

> 語り得ぬものについては沈黙せねばならない

とか、

> 語の意味とはその使用である

とかが有名だが、全体的に「答えが出ない問題を考えても仕方なくね？ワロタ」みたいな感じがあって、それは考え方が似ていて共感があった。

### 自分との比較

ただ「語り得ぬもの」とか「語の意味」とかそういうものへの諦観が強いように見えた。

自分は広義の意味では決定論者で、所詮有限なこの世の全要素を記述すれば全てを記述可能なはず、という立場。

したがって、この世のatomicな要素を全て物理的に記述すれば確率的に「語り得ぬもの」は無くなるはず、と思っている。この点では少し見解が違った。

まあその上での有限なステートマシン的なものとして人間を見ている自分の方が、諦観が強い可能性もあるが……。

### 書籍自体の感想

また、解説者の思想が（入門書なので当然だが）出過ぎていたので、原著を読みたくなった。

自分の思想とウィトゲンシュタインの思想が似ていたのか、ウィトゲンシュタインから引用された文は全て非常にしっくり来たので、こういう変なやつはきっと入門書のターゲットではないんだろう。

そのせいで、途中で聴く気が無くなってきてしまった。

とはいえ解説自体はとても良いもので、英語とドイツ語の違いについての解説などの補足情報が非常に丁寧だった。

普段そういうことを考えてない人にはとても良い。 

自分も非常に参考になったことは明記しておく。

### Audibleについて

散歩中に本を読みたくてAudibleを使ってみたが、非常に良かった。

まず画面を目の前に持っていなくても良い。これだけで要件としては満たされていた。

倍速にできるのも個人的には非常にマッチしていたし、読み手の声も聞き取りやすい。

ラインナップが変な自己啓発本やビジネス書ばかりなのが残念で、もう少しちゃんとした本が増えるともっと使いやすいのにもったいないサービス。

## まとめ

総じてもう少しウィトゲンシュタインに踏み込みたくはなった。

厨二病のまま大真面目に成長してしまった自分としては、似た思想の人間を常に探している節があって、ウィトゲンシュタインは比較的近いかもしれない。

次は哲学論考かな。

「ウィトゲンシュタイン『哲学探究』入門」を読んだ

## 概要

技術書典にいい加減参加したく、こんなものを作った。

https://github.com/miketako3/teckbook-template

TechBoosterのRe:VIEWテンプレートを改変したものになる。Webエンジニア目線では使いやすいかもしれない。

## 技術スタック

- Re:VIEW
  - 誤解を恐れずにいえばLaTexのラッパー
  - 技術書を描きやすいらしい
  - markdownっぽい形式の.reファイルを書いてPDFに変換できる
- VSCode
  - Re:VIEWの補完ができる拡張機能がある
  - 本当はIntelliJが良かったが…流石にプラグインを作りたくは無い
  - devcontainerは便利ではある
- Dev Containers
  - VSCodeの機能
  - Dockerを使って開発環境を構築する
  - Re:VIEWのDockerイメージが公式に配布されているのでそれをベースにすれば楽ちん
  - ということで元々のテンプレートからそのまま持ってきた
- GitHub Actions
  - 元々のテンプレートではCircleCIで校閲、Github ActionsでPDF作成としていたが、慣れや使い勝手もあり全てGitHub Actionsに変更した
  - Github前提となるので、GitLabなど用のファイルは全て削除した
- textlint
  - 文章の校閲ツール
  - スタンダードな技術だと思っているので採用した
  - PR時に自動的に実行される
- reviewdog
  - textlintの結果をPRコメントに表示してくれる
  - さすがにコメントが無いと使いづらいので採用した

## 感想

これでやっと書けるわけだが、書くまでに手間がかかりすぎる……。

もっと楽に書ける環境があると参入障壁が下がるのになーとなる。

自動校閲とか自動バージョニングとかをいい感じに入れたSaaSがあって、技術書典とか印刷会社とかとシームレスに連携できたら最強な気がする。

## 参考

https://reviewml.org/ja/

https://review-knowledge-ja.readthedocs.io/ja/latest/

https://github.com/TechBooster/ReVIEW-Template

https://zenn.dev/karaage0703/articles/52be7d25f7d76b

https://zenn.dev/b0b/articles/reviewdog_textlint_ga_tested

技術書典に向けて執筆環境を整えた

## 概要

オライリーから出ている 「ソフトウェアアーキテクチャ・ハードパーツ」

https://www.oreilly.co.jp/books/9784814400065/

を読んだので、重要な章を抜き出してノウハウをメモする。

と言いたいところだが、重要な部分が多すぎるのでこの記事では書きやすい部分だけを抜き出している。

書籍の内容を拾いきれているとは到底言えないので、是非読んでもらいたい。

ある程度システム設計に明るく、アーキテクチャに課題を抱えている人にはぴったりな内容になっていると感じた。

## 1章 「ベストプラクティス」がないとどうなる？

全ての解決策はトレードオフである。

> アーキテクトは、自分の問題に対する「銀の弾丸」を探し求めてはならない。

アーキテクトの問題はそれぞれユニークなため、ベストプラクティスが存在しない。

だからこそ「ハード」パーツである。

- 難しい問題
- 堅い、システムの土台となる部分

> 決して最善のアーキテクチャを狙ってはいけない。むしろ、少なくとも最悪でないトレードオフの組み合わせを狙おう。

多くのアーキテクチャにおいて、データこそが全てである。

アーキテクチャデシジョンレコード（Architecture Decision Records：ADR）（https://adr.github.io）を記入せよ。

アーキテクチャ統制のため、アーキテクチャ適応度関数を設計、運用せよ。

## 2章 ソフトウェアアーキテクチャにおける結合の見分け方

結合の定義

> 一方の変更が他方の変更を引き起こす可能性がある場合、ソフトウェアシステムの2つの部分は結合している。

結合を発見、分析し、トレードオフを評価せよ。

アーキテクチャ量子の定義

> アーキテクチャ量子とは、高度な機能的凝集、高度な静的結合、同期／非同期による動的結合を持つ、独立してデプロイが可能なアーティファクトを指す。アーキテクチャ量子の一般的な例には、あるワークフロー内の整ったマイクロサービスなどがある。

これはすなわち、データベースを共有しているアプリケーションは全て1つのアーキテクチャ量子である。

## 4章 アーキテクチャの分解

モノリスからサービスベースアーキテクチャを経てマイクロサービスへ移行していく上で、2つのアプローチが紹介されている。

- コンポーネントベース分解
  - まずはリファクタリングし、モジュールを分けていく。
  - 分けられたモジュールをサービスに切り出す。
- 戦術的フォーク
  - まるっと別アプリケーションとしてコピーして立て、それぞれ1部の機能しか使っていない状態にする。
  - その後、不要な機能をリファクタリングによって削除していく。
  - コンポーネントベース分解と比べて
    - メリット
      - 事前の分析が不要なので作業開始が早い
      - コードは抽出するより消す方が簡単 (と書かれていたが本当か？)
    - デメリット
      - 不要なコードを消す努力が必要
      - ロジックは汚いまま

## 6章 業務データの分解

データベースを分けるか？分けないか？もトレードオフである。

データを分解する要因として以下のようなものがある。

- 変更制御
  - カラムの変更等の影響が多岐にわたる
- コネクション管理
  - 1つのデータベースだけを使うとコネクション数の管理が難しい
- スケーラビリティ
  - コネクション数
  - 容量
  - スループット
  - パフォーマンス
- 耐障害性
  - 1つのデータベースだけを使うとデータベースが単一障害点となってしまう
- アーキテクチャ量子
  - 1つのデータベースだけを使うと1つのアーキテクチャ量子となってしまう (つまり独立してデプロイできない、等)
- データベース種別の最適化
  - 1つのデータベースだけを使うと1つの保存方法だけしか使えない (つまりデータ特性ごとに最適な選択肢が取れない)

逆に、データを統合する要因としては以下のようなものがある。

- データ関係
  - 密結合な外部キー等があるか？
- トランザクション
  - 単一のトランザクション単位が必要か？

モノリスなデータベースを分解するには5段階のプロセスを踏むと良い。

1. 分析し、ドメインを特定する
2. ドメインごとにテーブルを割り当て、移動する
3. コネクションをドメインごとに分離する
4. スキーマをそれぞれのデータベースに移動する
5. コネクションを切り替える

## 7章 サービスの粒度

マイクロサービスの粒度を大きくするか？小さくするか？もトレードオフである。

粒度を小さくする要因としては以下のようなものがある。

- サービスの範囲と機能
  - 凝集性が高い状態になっているか？
- コード変動率
  - 一部のコードだけ変更頻度が高くないか？
- スケーラビリティとスループット
  - 一部だけスケールする必要があるか？
- 耐障害性
  - 一部の故障で全体が故障してしまわないか？
- セキュリティ
  - 一部だけ高いセキュリティが必要か？
- 拡張性
  - どの程度拡張されるか？

粒度を大きくする要因としては以下のようなものがある。

- トランザクション
  - サービスをまたいだトランザクションが必要か？
- ワークフローとコレオグラフィ
  - サービス同士がやりとりする必要はあるか？
- 共有コード
  - サービス同士がコード共有の必要はあるか？
- データ関係
  - データは分解できるか？

## 9章 データの所有権と分散トランザクション

サービス間で共有するデータが存在するとき、どちらのサービスが所有権を持つのか、どのように共有データを管理するのかをトレードオフによって決めなければならない。

分散トランザクションはACID特性をサポートしないため、代わりに結果整合性を検討せよ。

## 10章 分散データアクセス

所有していないデータにサービスが読み取りアクセスするためには様々な方法があり、その間にもトレードオフがある。

- サービス間通信パターン
  - サービス間がWEB API等で通信してDBを隠蔽する
- 列スキーマレプリケーションパターン
  - 非正規化する
- レプリケーションキャッシュパターン
  - 分散キャッシュする
- データドメインパターン
  - 愚直に一緒にDBを見てしまう

## 11章 分散ワークフローの管理

分散システムどうしを調整する方法については基本的には2種類あり、トレードオフがある。

- オーケストレーション
  - 調整役を別途立てる
- コレオグラフィ
  - 最初のサービスが調整役となる

## 12章 トランザクショナルサーガ

通信、整合性、調整についてそれぞれ2パターンあり、組み合わせると合計8パターンのサーガ (アーキテクチャの大別) がある。

| パターン名       | 通信  | 整合性   | 調整         | 結合度   | 複雑さ   | 応答性/可用性 | スケーラビリティ |
|-------------|-----|-------|------------|-------|-------|---------|----------|
| エピックサーガ     | 同期  | アトミック | オーケストレーション | とても高い | 低い    | 低い      | とても低い    |
| 伝言ゲームサーガ    | 同期  | アトミック | コレオグラフィ    | 高い    | 高い    | 低い      | 低い       |
| おとぎ話サーガ     | 同期  | 結果整合性 | オーケストレーション | 高い    | とても低い | 中程度     | 高い       |
| 時間旅行サーガ     | 同期  | 結果整合性 | コレオグラフィ    | 中程度   | 低い    | 中程度     | 低い       |
| ファンタジーサーガ   | 非同期 | アトミック | オーケストレーション | 高い    | 高い    | 低い      | 低い       |
| ホラーストーリーサーガ | 非同期 | アトミック | コレオグラフィ    | 中程度   | とても高い | 低い      | 中程度      |
| パラレルサーガ     | 非同期 | 結果整合性 | オーケストレーション | 低い    | 低い    | 高い      | 高い       |
| アンソロジーサーガ   | 非同期 | 結果整合性 | コレオグラフィ    | とても低い | 高い    | 高い      | とても高い    |

## 13章 コントラクト

ハードパーツとしてのコントラクトの定義は以下である。

> アーキテクチャの部品が情報や依存関係を伝えるために使用するフォーマット。

コントラクトとして例えば以下の様なものがあり、トレードオフがある。

- 堅い
  - 例
    - gRPC
  - メリット
    - 型
    - バージョニング
    - 検証が用意
    - ドキュメント
  - デメリット
    - 密結合
- 緩い
  - 例
    - JSON
  - メリット
    - 疎結合
    - 進化しやすさ
  - デメリット
    - 型がない
    - コンシューマ駆動契約等の適応度関数が必要

帯域幅は無限だと思うな。

## 15章 独自のトレードオフ分析を構築する

MECEに分析せよ。

技術の過度な売り込みを避けよ。

> 何かを伝道する立場をとってはいけない。トレードオフに立ち返ろう。

> 銀の弾丸を追い求めるのではなく、トレードオフを分析するスキルに磨きをかけることで、アーキテクトは組織に真の価値を提供できるのだ。

## まとめ

アーキテクトというふわっとした分野において地に足ついた良い本だった様に感じた。

全てはトレードオフである、というのは自分も読む前から感じていたことではあったため、裏付けが取れて嬉しい気持ちになった。

そして、そのトレードオフをこれでもかと投げつけてくる本書は実際にアーキテクチャを考える上で非常に参考になるだろう。

最近「マイクロサービスって間違いだったんじゃね？」等が話題になったりもしたが、そういうことに振り回されず淡々とトレードオフを分析できるエンジニアになりたい。

「ソフトウェアアーキテクチャ・ハードパーツ」を読んだ

「Googleのソフトウェアエンジニアリング」でわかるリファクタリングと自動テスト

## 概要

「ソフトウェアテストをカイゼンする50のアイデア」

http://www.eijipress.co.jp/book/book.php?epcode=2085

という本を読んだので感想についてメモする。

なお、かなり斜め読みしてしまったので内容が気になる方は自分で読んでみるのをおすすめします。テストに詳しく無いのであれば読む価値はあると思います。

## 得られたノウハウ

- 抜け漏れを防ぐために他者とテストについて考えよ
- 定量化に努めよう
- Given-When-Thenの順序は必ず守ろう
- BDDでは以下の3つが重要となる
  - 仕様
  - 受け入れテスト
  - ドキュメント
- そのために、以下の3つを均衡させなければならない
  - 仕様の簡潔さ
  - カバレッジの完全性
  - ドキュメントの統一性
- テストの優先順位をつけるにはAttribute Component Capabilityマトリクスが便利
  - 理想的なACCマトリクスは「時間とお金があればどんな人でもテストできる」程度で抽象化する
- テストコードは書くためではなく読むために最適化せよ


## 感想

正直抽象的なことが多くて読むのが苦痛だった。良い内容は書いてあると思うが、当たり前というか既知の内容も多く、それが抽象度高く書かれているという印象。なかなか実行可能で具体的なノウハウまでもっていくのは難しかった。

ただし、テストで思い悩むことがあった際にこの本に立ち返ると答えが書いてあるかもしれないので、薄く内容を覚えておいて読み返せるようにするのも手かもしれない。

「ソフトウェアテストをカイゼンする50のアイデア」を読んだ

## 概要

![キーボードの写真](/make-keyboard/img.jpg)

https://shop.yushakobo.jp/products/corne-cherry-v3

Corne Cherry V3というキーボードを作ったので、制作した感想と使い心地について語る。

なお、この記事も同キーボードで書いている。

## Corne Cherry V3

column staggeredで親指３キーの４０％キーボード。左右分割になっている。

何故このキーボードにしたかというと、実機を触った際のフィット感に加えて以下の要素が決め手だった。

- 遊舎工房のキャンペーンでキースイッチが無料だった
- 数字キーが遠いと感じていた

このキーの少なさは挑戦的だったが、すでに６０％を使っていたのでまあ慣れるだろうくらいの気持ちだった。

## 組み立て

１５年振りくらいに半田付けをした。なんとかうまくできたと思う。

キースイッチのピンがよく曲がってしまったのが辛かった。

組み立ては遊舎工房のレンタル作業場を利用させてもらった。

光らせる気はなかったのでキットについてくるLEDはつけなかったが、それでも3時間かかった。レンタル代だけで３０００円かかった。

## 使用感

すばらしい。何がすばらしいかというと、数字キーや矢印キー、記号キーのためにホームポジションが崩れることがなくなりそうということ。

また、左右分割というのもすばらしい。まったく窮屈感がなく快適にタイピングできている。

記号などを打つのに複数キーの入力が必要で配列に慣れるまでまだだいぶかかるとは思うが、慣れたら今まで以上の速度で疲れず入力できそう。

## まとめ

雑な記事になってしまったが取り急ぎこのキーボードの入力に慣れたかったので書いてみた。

自作キーボードは沼だとよく言われているが、1人でも沼に引き摺り込めたら幸いである。

Corne Cherry V3を組んだ

## 概要

「SOFT SKILLS ソフトウェア開発者の人生マニュアル」

https://www.amazon.co.jp/SOFT-SKILLS-E3-82-BD-E3-83-95-E3-83-88-E3-82-A6-E3-82-A7-E3-82-A2-E9-96-8B-E7-99-BA-E8-80-85-E3-81/dp/4296000500/

という自己啓発本を読んだので、感想とノウハウをメモする。

## ノウハウ

- エンジニアもセルフプロデュースをせよ。
- セルフプロデュースに最も良いのはブログである。ブログをやれ。
- 給与は全て投資し、帰ってくるお金のみで生活せよ。そうすれば投資が終わった時にはリタイアできる。

## 感想
YouTubeやブログで著名になり不動産投資でも成功したソフトウェアエンジニアである著者の体験が元になった本。

正直あまり参考になる部分はなかった。セルフプロデュースが重要なのは初めからわかっていたし、それ以外についてもよくある自己啓発本の域を出ない。

例えば「お金に働かせてFIREしよう」といった内容で不動産投資を勧めている章もあった。ソフトウェア開発者に向けた本としては珍しいトピックだし間違ってはないのかもしれないが、そんなことを言われても行動に移せるノウハウとしてはほぼ無いに等しかった。

この本で得られたのはセルフプロデュースが重要ということのセカンドオピニオンを得たことくらいである。

「SOFT SKILLS ソフトウェア開発者の人生マニュアル」を読んだ

## はじめに
私は2月末ごろからうつ病で休職していました。現在も休職中ではありますが、だいぶ体調も回復し復職も近づいてきているので、このタイミングで記事を書こうと思います。

こうした内容を公言するかどうかは悩みました。周りの人にはうつ病になりそうに無い人と思われている感覚があって、それを破壊してしまうのが嫌だったというのもあります。

ただ、うつ病なんだよねと言うことの面倒臭さよりも言わないことによる不快感が大きかったというのもありますし、公開することで誰かの助けになるかもしれないというのもあってこの記事を書くことにしました。

## 周りの人に伝えたいこと

今まで公言していなかったので当然ですが、普段と変わらず接してもらえたのがとても良かったと思っています。

今後も配慮はいらないので特に変わらず接してください。うつ病に関することは聞かれたくないとかそういうことは特にないので、普通に話に上げてもらっても良いです。聞かれれば何でも答えます。

以下長文になるので気になる方だけ読んでください。

## 経緯
コロナ禍によるリモートワークや自粛の影響で体調を崩したりもしましたが、これまでなんとかやってきていました。

しかし、2021年後半くらいから徐々に無気力感や倦怠感、体の痛みが大きくなってきました。何をするにも入り込めていない感じというか、ストレスが発散できていない感覚がありました。

2022年1月末頃に産業医に相談しましたが、その時はまだ仕事が全くできないというほどでもなかったため相談のみで終わりました。

その直後、業務的にしんどい時期が続き、とどめを刺されたように体調が悪化していきました。そして産業医に二度目の相談をしたところ心療内科を勧められ、そのまま2月末には休職となりました。急に休職したのでいろんな人に迷惑をかけたと思います。

休職後１ヶ月はほぼ寝て過ごし、3ヶ月程度経ったときには、疲れやすさが残るものの日常生活をするだけなら問題ないレベルとなりました。

そこからさらに３ヶ月程度、仕事ができる集中力を取り戻すために使い、現在ではそれなりに仕事ができそうな体調まで回復しています。

## そもそもうつ病とは何なのか

情報ソースはほぼネットのみなので詳しくは専門のソースを見てほしいですが、ある程度は自分で調べて理解したつもりです。

### 概要

うつ病とは気分障害の一種で、うつ状態 (いわゆるうつ病っぽい状態) が2週間以上続いている場合につけられる診断です。原因はよくわかっていないようですが、脳内のセロトニン等が不足したことによって起きるという説がありますし、少なくとも脳に病的な何かが起きて発症したと考えられています。ただの精神的な問題ではないということです。

いわゆる新型うつ等と呼ばれることもある適応障害とは区別され、原因を切り離した時にうつ状態ではなくなるのが適応障害で、そもそも原因が定かではないのがうつ病という理解です。(なので、適応障害の場合は業務は無理でも休日は元気だったりするわけです)

### 症状

症状としては精神的なものとお肉体的なものがあり、例えば以下のようなものがあります。肉体的な症状があるということは知らない人には意外なんじゃないかなと思います。

- 精神的
  - 気分が落ち込む
  - 意欲が無くなる
  - 集中力が無くなる
  - 不安になる
- 肉体的
  - 頭痛
  - 腰痛
  - 肩こり
  - 睡眠障害
  - 食欲不振や過食

### 診断

うつ病や適応障害の診断は操作的診断というものによって行われます。わかりやすく言えば心理テストみたいなやつです。

いまのところそれらを正確に検査するのは難しく、症状によって診断するしかありません。そのため、医者によらない客観性のある診断をするために心理テストの規格を作っているみたいなことのようです。

以下の記事によれば、うつ病の9割弱がICDという診断基準、残りがDSMという診断基準で診断されています。

http://www.kokoronomori.jp/2014/05/21/post-53

つまり、ICDやDSMを覚えれば誰でもうつ病の診断を得られる可能性があるわけです。これは、本当にうつ病に悩む人にとってはあまり良いことではないと思います。自分の症状はただの甘えなんじゃないかという気持ちになってしまいます。まあ本当に患っている人はそんな勉強する余裕は無いわけですが、ライフハック的に使用する心無い人によって偏見に晒される可能性を考えると早く検査法が確立してほしいと願うばかりです。

### 治療

うつ病の治療で重要なのは以下の4つです。

- 休養
- 環境調整
- 薬物治療
- 精神療法

そのため、精神科や心療内科でうつ病と診断されると、休職の診断書が出たり薬が処方されたりするわけです。

なお、精神科や心療内科、クリニックはほぼ同じ意味です。名付けが自由なのでばらつきがあるというだけです。

精神科で薬物治療と聞くとなんだか怖いイメージがありますが、最近は副作用が比較的少ない薬もありますし、イメージほどのヤバい薬が処方されることはあまり無いんじゃないかなと思います。

また、治療の効果は徐々に現れていきます。風邪等と一緒である瞬間からいきなり全快とはならないので、最初は寝たきりだとしても徐々に活動量が上がっていくと思います。そのため、うつ病だからといって何もできないわけではないです。これも世間一般のイメージと乖離があるんじゃないかなと思います。

### お金周り
休職中は一般的には傷病手当金というものが健康保険から支給されます。金額としては月給の2/3程度です。 また、企業によってはさらに所得保障がある場合があり、月給の2/9程度が追加で支給されます。ボーナスはありませんし、支給までにかなりタイムラグがあるとはいえ、この期間は働かずにお金がもらえるわけですね。

働かずにお金がもらえるなんて最高じゃないかと私も休職以前は思っていたのですが、やってみるとそんなに良いものではありません。

そもそも大半の期間は遊んだり出来る余裕が体調的にありませんし、精神的にも遊んでいられるような状態ではありませんでした。本来感じる必要は無いのですが、ズル休みをしているような感覚になります。

かなりの図太さがないと悠々自適に過ごすのは難しいでしょうし、そのような人はうつ病にならなそうです。

さらに、治療が進んでいないと思われれば不要に薬が増やされるわけで、副作用があることを考えればあまりやりたくはありません。

結局は真面目に治療に専念するのが一番良いわけで、そういう意味では安心して休める傷病手当金という制度は良いものだと思います。

## 自分の場合
### 症状

私の休職直前の症状は以下のようなものでした。

- 食欲不振
  - 朝昼はほぼ抜き、晩も少量のみが多かったです。
- 睡眠障害
  - 寝付くのに数時間かかり、夜中に目が覚めるような状態でした。
  - うつ病が原因かはわかりませんが寝汗がひどかったです。
- 倦怠感
  - 頭が重いという表現がこんなにも適切なのかと感動するくらいには頭が重かったです。
  - 業務後の倦怠感は酷く、ほぼ寝ていました。
- 集中力の欠如
  - 集中できるのはせいぜい1日1時間程度でした。
- 気分の落ち込み
  - 死んだ方がマシ的な考えもありました。
  - よくわからなくなり涙が出たことも一度だけですがありました。
  - 何をしても気分がよくなる感じがしませんでした。
- 体の痛み
  - 右上腹部の違和感や痛みが特にひどかったです。
    - これについては随分前からあって超音波検査もしましたが異常はありませんでした。
  - 右足の付け根の痛みもありました。
- 肩こり
  - これはデスクワークなら誰でも起こるのでうつ病によるものかどうかはわかりませんが、少なくとも現在はそこまで酷くはありません。

気分が悪くてやる気が出ないだけとかであれば個人的には休職するようなものではないのですが、集中したくてもできないという状態で流石に業務に支障がありました。

### 処方

私が処方された薬は主に抗うつ剤と睡眠導入剤です。

抗うつ剤はざっくり言えばセロトニンを増やすもので、長期間服用してじわじわ効果が出るものです。抗うつ剤は効果がない場合もあるようですが、私はそれなりには効いたような気がします。

睡眠導入剤はまあ睡眠薬です。これはかなり効果があり、寝つきもよくなり朝まで眠れるようになりました。酷かった寝汗もほぼなくなりました。

心療内科や精神科は話を聞いてもらう場所といったイメージを持っている方もいるかもしれませんが、実際にはほぼほぼ症状に応じた薬が処方されるだけです。

### 原因
少し上で書いたように原因を特定するのは難しいですが、これなんじゃないかというものはいくつかあります。詳細については書けない部分が多いですが以下に挙げます。

- 業務系
    - 慢性的なシステム障害の対応
        - [ファントムバイブレーションシンドローム](https://ja.wikipedia.org/wiki/%E5%B9%BB%E6%83%B3%E6%8C%AF%E5%8B%95%E7%97%87%E5%80%99%E7%BE%A4)
    - 深夜待機
    - 業務上のプレッシャー
    - [燃え尽き症候群](https://ja.wikipedia.org/wiki/%E7%87%83%E3%81%88%E5%B0%BD%E3%81%8D%E7%97%87%E5%80%99%E7%BE%A4)
- 生活系
    - リモートワークによる運動不足
    - 睡眠の質の低下

私に関して言えば人間関係で困ったりしたことはなく、業務自体が嫌というわけでもありませんでした。また、見かけ上の残業時間もかなり少ない方でした。

一方で、残業時間では見えない負荷もあり、特に常にシステム障害の連絡が携帯に来るというのはかなり負担が大きかったんじゃないかなと思っています。

主治医の説明でも「医学的に疲れが溜まっている状態でしょう」という旨を言われていたので、疲労が溜まっていたことは間違いないです。

### 回復するまでにしたこと

#### ~ 1ヶ月
休職後１ヶ月はほぼ寝ていました。抗うつ剤は効くまでに少なくとも2週間から１ヶ月はかかるということもあり、死んだような生活をしていました。食欲も最初は全く無かったのですが、薬が朝食後だったのでゼリーだけ何とか食べるといった食生活をしていました。

#### 1 ~ 3ヶ月
2週間から１ヶ月すると多少は活動ができるようになりました。初めは1~2時間家事をしてまた寝るという過ごし方でしたが、だんだん体調が戻っていきました。最大MPが日に日に上がっていくような感覚でした。

この頃は活動が出来るようになってくるのもあって焦りが出てくる時期でした。いっそのこと転職してやろうとか思って色々やってはみましたが、予定を積むと目に見えて体調が悪化しました。そこで転職は止めてやっぱり回復に専念することにしました。

仕事もそうですが転職なんてものはかなりのエネルギーを使うもので、それが出来るほど回復はしていなかったということです。

体力もかなり落ちていたので、回復のためにネットでオススメされていた散歩等をしたりしていました。

また、多少なら遊んだりできる余裕は生まれたので、ゲームしたりもしていました。転職のようなプレッシャーはないのでマシではありましたが、結局集中力を使うので長時間するのは難しかったですが。

#### 3ヶ月 ~ 現在
ある程度日常生活は遅れるようになったので、この時期は仕事に戻ることを想定してリハビリ的なことをしました。

個人開発してみたいものは何個かあったのでそれを作ってみたりして、徐々に活動量を上げていきました。 このブログもその一つです。本題と逸れるので詳細は割愛しますが、Next.jsとReactとTailwindでゴリっと書いています。

また、体力をつけるためにラジオ体操とかリングフィットアドベンチャーをしていたり、集中力をつける的な意味合いもあってポーカー (ノーリミットテキサスホールデム) にハマりました。誰かやりましょう。

最初は長時間活動するのは難しかったですが、現在ではフルタイムの定時くらいまではなんとか作業できるようになりました。

## まとめ
うつ病で休職したことや自分のうつ病に対する理解について書いてみました。

うつ病に関する情報は色々なところにありますが、信用に足る情報なのかがいまいちわかりづらいです。

この記事も同様ではありますが、それでも誰かの役に立つことを願っています。

また、冒頭にも書きましたが、私には普通に接してください。特にうつ病関連がタブーであるということもないです。

よろしくお願いします。

WEBエンジニアがうつ病になった話

## 概要

有名な自己啓発本である 「イシューからはじめよ」

http://www.eijipress.co.jp/book/book.php?epcode=2085

を読んだので以下のような内容について章ごとにメモする。

- 得られたノウハウ、
- その他の感想。

## はじめに 優れた知的生産に共通すること
### ノウハウ

- 「悩まずに考える」 
  - 「悩む」とは、答えが**出ない**という前提 
  - 「考える」とは、答えが**出る**という前提

### 感想
仕事では答えが出ない問題は必要ないよねということでバッサリ切り捨てているが、これについてはかなり共感した。

オタクなので水槽の脳とかシミュレーション仮説とかが好きだが、こういうのも結局答えが出ないのでロマンを語る場面以外は考えるだけ無駄だよねという感覚でいる。それと似たようなことだと思った。

## 序章 この本の考え方
### ノウハウ

- 「仕事のバリューは、解の質とイシュー度で決まる」
- 「犬の道を避ける」
  - 「犬の道」とは、解の質を一心不乱に上げることでイシュー度を確保するアプローチのこと
  - まずイシュー度を高め、その上で解の質を高める方が時間効率が良い

### 感想
「斬新で革新的なものには名前をつけろ」という話が後々出てきたが、犬の道と名前をつけたのは確かに良かったんじゃないかなと思った。

言ってることは結局無駄な仕事を避けろということだが、そのためにはイシュー度を上げることが大事というのがこの本の本質だろう。
なので、第１章の内容は重要だが他の章は重要度が低い。

## 第１章　イシュードリブン
### ノウハウ
- 「スタンスを取れ」
  - 強引にでも具体的な仮説 (イシュー) を立てる
    - イシューに答えを出すため
    - 必要な情報が何か把握するため
    - 結果の解釈を明確にするため
  - とにかく言語化する
    - 言語化できない状態で明瞭な思考を行うことは難しい
- 「良いイシューとは以下の３条件を満たすもの」
  - 本質的である
  - 深い仮説がある
  - 答えを出せる
- 「一次情報を漁る」
- 「情報を集めすぎない」 
  - 集めすぎることで自分独自の視点が消える
- イシューを見つからない時は以下を行う
  - 変数を削る
  - 視覚化する
  - 最終系から辿る
  - so what?を繰り返す
  - 極端な事例を考える

### 感想
イシューを言語化すること、イシュー度が高いかどうかを定期的に見直すことが重要だと感じた。

「情報を集めすぎない」についてはエンジニア的には半分程度しか納得できなかった。確かに限界効用的に情報を集めすぎてもコスパが悪いというのはその通りだが、
独自の視点よりも車輪の再発明をしないことや仕様を見落とさないことの方が大事なのではないか？

## 第２章 仮説ドリブン①
### ノウハウ

- 「イシュー分析で解の質を高める」
  - ストーリーライン
  - 絵コンテ
- 「イシューをサブイシューに分解する」
- 「ストーリーラインを組み立てる」
  - ピラミッド構造の2つの型
    - whyの並び立て
    - 空・雨・傘

### 感想

エンジニア的には分割統治法になじみがあるのでサブイシュー云々に新鮮さはなかった。

ストーリーラインの2つの型についてはプレゼン時に使えそうなので覚えておきたい。

## 第３章 仮説ドリブン②
### ノウハウ

- 「ストーリーを絵コンテにする」
  - 絵コンテとは最終的なグラフや図表のイメージ
- 「分析とは比較すること」 
  - 定量比較の3つの型
    - 比較
    - 構成
    - 変化
- 「原因と結果から分析軸を考える」
- 「数字が入ったイメージを作る」
- 「意味合いを表現する」
  - 意味合いの本質
    - 差がある
    - 変化がある
    - パターンがある
- 「データの取得方法を明示する」

### 感想

これらもプレゼンの型として考えれば使えそうだった。
要するにプレゼン資料作りを想定して行動しろということで、いかにもコンサル出身らしい発想だなと感じた。

一方で、仕事では結局は誰かに話したり資料に残したりする必要はあるので、こういう意識は大事かもしれない。

## 第４章 アウトプットドリブン
### ノウハウ

- 「前提と洞察から取り組む」
  - ストーリーラインの中で絶対に崩れてはならない部分を潰しておく
- 「完成度を上げるよりも複数回取り組む」

### 感想

特に崩れて欲しくない実装には自動テストが欲しいよねというのと同じような感覚だった。

また、ある程度の完成度で誰かに見てもらいフィードバックをもらうというのもよく言われていることなので新鮮味は無かった。

## 第５章 メッセージドリブン
### ノウハウ

- 「ストーリーラインを磨き込む」
  - そのための3つのプロセス
    - 論理構造を確認する
    - 流れを磨く
    - エレベーターテストに備える
      - 偉い人とエレベーターで一緒になった時に説明できるか？
- 「チャートを磨き込む」
  - 優れたチャートの条件
    - イシューに沿ったメッセージがある
    - 軸の広がりに意味がある
    - 図表がメッセージを支えている

### 感想

このあたりもコンサル的だなと感じた。 プレゼン技術としては有用そう。

## まとめ

「イシューからはじめよ」のノウハウと感想をまとめた。

名著とされているイメージだったが内容が薄いように感じた。というか学者的なアプローチを期待していたらコンサル的なアプローチだったのでガッカリしたというような感想だった。

一方で、本文でも以下のように書かれている。

> 「僕は今、自分にできる限りの深いレベルまで、知的生産におけるシンプルな本質を伝えた。あとは、あなたが自分で経験する以外の方法はないはずだ」
> (中略)
> 「経験しないとわからない」と書くと「じゃあ、この本は何のためにあるのか？」と言われそうだが、
> この国では論理思考や問題解決において、新しいツールの紹介のようなものばかりが行われ、本質的な知的生産についての議論が足りないように思う。
> この本が共通の議論のベースと実践の手がかりとなればと願っている。

ということで、起こせる行動の変化としてはノウハウを意識に入れつつ自分で試行錯誤してみるくらいだろうし、それを目指しているようにも読めた。

時間が経ってこの本の内容を思い返した時に印象が変わるといいなという期待と共にレビューを終える。

「イシューからはじめよ」を読んだ

## 概要

「最高の脳で働く方法」

https://d21.co.jp/book/detail/978-4-7993-2470-7

という自己啓発本を読んだので、感想とノウハウをメモする。

## ノウハウ
- 演出家を育てる
  - 演出家とは、自分の脳内のタスクを管理するもう一人の自分のようなイメージ
  - そのためには自分のメンタルプロセスを自覚する力を高める必要がある
  - マインドフルネス的にこの瞬間に意識をじっと集中させることがトレーニングになる
- 自分の演出家を働かせる
  - 集中する必要があるときは他の物事を極力排除する
    - 携帯の電源を切る等
  - ひらめきが必要な場合は全てを舞台から排除し、脳の微弱な波長を感じられるようにする
  - 脳の情動は接近と回避の2種類がある
    - 接近は良い状態
    - 回避は悪い状態だが、野生本能的にこちらになりやすい
  - ストレスを感じている時は回避になるため演出家を働かせることは難しい
    - そのような状況では以下を行うと良い
      - ラベリング（端的な言葉への言い換え）
      - 再評価（プラス思考で考え直す）
  - 他者とうまく協調するためには他者に接近状態にさせると良い
    - 問題ではなく解決にフォーカスする
    - よくやられているフィードバックは効果が薄い
      - ステータスが上の人間にフィードバックをもらうというだけで脅威に感じる
    - 相手のメンタルプロセスに対して質問することで相手から閃きを引き出す

## 感想
脳のリソースを舞台と演出家というメタファーで伝えている本。

舞台とは脳のメモリを指し、舞台上の役者は脳が注意を向ける事柄を表す。

どの役者をどのように配置するかを管理するのが演出家で、演出家に素晴らしい働きをさせることが全てにおいて重要なことであるという主張がされている。

著者がコンサル出身らしくコンサル仕事術的な面があり、求めていた科学的アプローチとは違った。

一方で言わんとすることはわかるし、演出家というメタファーでイメージしやすくなっているのは良かった。

「最高の脳で働く方法」を読んだ

## 概要

オライリーから出ている 「レガシーコードからの脱却」

https://www.oreilly.co.jp/books/9784873118864/

を読んだので、重要な章を抜き出してノウハウをメモする。

## 第1部
### 1章 何かが間違っている

ほとんどのソフトウェアは作り方や保守の仕方を間違えている。

ウォーターフォールは最後にまとめてリリースするため一か八かの博打。

### 3章 賢人による新しいアイデア

アジャイルはウォーターフォールよりは良い。

一方で、アジャイルをしているチームも技術プラクティスを上手く使えていないために期待した利益が得られないでいる。

## 第2部
### 4章 9つのプラクティス

1. やり方より先に目的、理由、誰のためかを伝える
2. 小さなバッチで作る
3. 継続的に統合する
4. 協力し合う
5. 「CLEAN」コードを作る
6. まずテストを書く
7. テストでふるまいを明示する
8. 設計は最後に行う
9. レガシーコードをリファクタリングする

### 9章 プラクティス5 「CLEAN」コードを作る
うまくカプセル化されたソフトウェアはアウトサイドインで設計することによって得られる。

- アウトサイドインプログラミング
  - コンシューマの観点で機能を設計する
  - サービスが何をやっているかを示す名前をつける
  - どう動くかは隠す
- インサイドアウトプログラミング
  - 問題を小さな塊に分解し、それらを縫い合わせる
  - 最初に実装してしまうと全体が見えなくなる

「知らぬが仏」という言葉はソフトウェアにおいては常に真である。

CLEANなコードを作る。

- C: Cohesive (凝集性)
- L: Loosely coupled (疎結合)
- E: Encapsulated (カプセル化)
- A: Assertive (断定的)
- N: Nonredundant (非冗長)

名前は説明的、能動的、肯定的なものにし、結果的にシステムがどう変化するのかを反映する。

### 10章 プラクティス6 まずテストを書く

多くのテストを書きすぎたり、実装依存のテストを書いたりするとTDDは上手く行かない。

ふるまいを表すのに必要なテストだけを書く。

「ユニットテスト」のユニットとはふるまいの単位であり、メソッド、クラス、モジュール等ではない。

### 12章 プラクティス8 設計は最後に行う

最初のアーキテクチャレベルの設計というよりはコードの詳細設計的な話。

テストを書いた後にリファクタリングで設計を変えていく方が良い。

### 13章 プラクティス9 レガシーコードをリファクタリングする

コードを変更する場合は一緒にレガシーコードをリファクタリングする。

## 感想
プラクティスの大半はテストが必要というのもあって、上手いテストを書くことが非常に重要だと感じた。

Google本でも書かれていたが、やはりユニットテストだからといってメソッド単位でテストしたり、ホワイトボックステストを書くのは良くない。

最後に設計せよというプラクティスがあったが、そのためにはホワイトボックステストがあってはならないはずである。

この辺りの考えに対する後押しが得られたのが良かった。

「レガシーコードからの脱却」を読んだ

# Blue Biscuit Term

## 日本語

第三者に個人を特定できる情報を提供することはありません。
個人情報の管理には最新の注意を払い、以下に掲げた通りに扱います。

### はじめに

本利用規約（以下「本規約」）は、Kaito Hirutaが提供するiOSアプリケーション「Blue Biscuit」（以下「本アプリ」）の利用条件を定めるものです。本アプリをダウンロード、インストール、または使用することにより、ユーザーは本規約に同意したものとみなされます。

### アプリの目的

本アプリは、うつ病の症状を自己評価するためのツールとして設計されています。ただし、本アプリは医療専門家による診断や治療を代替するものではありません。

### PHQ-9の使用

本アプリはPHQ-9（Patient Health Questionnaire-9）を使用しています。PHQ-9の著作権はPfizer Inc.が所有しています。本アプリでのPHQ-9の使用は、Pfizer Inc.の利用規約に従っています。

### 医療免責事項

本アプリは情報提供のみを目的としており、医療アドバイスや診断を提供するものではありません。本アプリの使用結果に基づいて医療判断を行わないでください。常に資格を持つ医療専門家に相談してください。

### 責任の制限

Kaito Hirutaは、本アプリの動作に関して、いかなる保証も行いません。バグやエラーが発生する可能性があり、Kaito Hirutaはそれらに起因する損害について責任を負いません。

### プライバシーとデータの保護

ユーザーの個人情報とデータの取り扱いについては、別記したプライバシーポリシーに従います。

### 知的財産権

本アプリに関するすべての知的財産権はKaito Hirutaに帰属します。ユーザーは、個人的、非商業的な目的でのみ本アプリを使用することができます。

### 禁止事項

以下の行為を禁止します。

- 本アプリの不正な改変や複製
- 本アプリを通じて取得したデータの不正な使用や共有
- 本アプリの機能を妨害する行為

### 本規約の変更

Kaito Hirutaは、本規約を変更する権利を留保します。変更後の規約は、本アプリ内での通知もしくはアプリストアのリリースノートでの記載をもって効力を生じます。

### 準拠法と管轄裁判所

本規約は日本法に準拠し、日本の裁判所が第一審の専属的な管轄権を有します。

### お問い合わせ

本規約に関するお問い合わせは、以下のメールアドレスまでお願いいたします。

contact@miketako.xyz

## English

We will not provide personally identifiable information to third parties.
We take the utmost care in managing personal information and handle it as stated below.

### Introduction

These Terms of Service ("Terms") set forth the terms and conditions for the use of the iOS application "Blue Biscuit" ("App") provided by Kaito Hiruta. By downloading, installing, or using the App, users are deemed to have agreed to these Terms.

### Purpose of the App

The App is designed as a tool for self-assessment of depression symptoms. However, the App is not intended to replace diagnosis or treatment by medical professionals.

### Use of PHQ-9

The App uses the PHQ-9 (Patient Health Questionnaire-9). The copyright of PHQ-9 is owned by Pfizer Inc. The use of PHQ-9 in this App complies with Pfizer Inc.'s terms of use.

### Medical Disclaimer

The App is for informational purposes only and does not provide medical advice or diagnosis. Do not make medical decisions based on the results of using this App. Always consult with a qualified medical professional.

### Limitation of Liability

Kaito Hiruta makes no warranties regarding the operation of the App. Bugs or errors may occur, and Kaito Hiruta is not responsible for any damages resulting from them.

### Privacy and Data Protection

The handling of users' personal information and data is governed by the Privacy Policy stated separately.

### Intellectual Property Rights

All intellectual property rights related to the App belong to Kaito Hiruta. Users may use the App only for personal, non-commercial purposes.

### Prohibited Actions

The following actions are prohibited:

- Unauthorized modification or reproduction of the App
- Unauthorized use or sharing of data obtained through the App
- Actions that interfere with the functionality of the App

### Changes to These Terms

Kaito Hiruta reserves the right to change these Terms. The revised terms will take effect upon notification within the App or mention in the release notes on the app store.

### Governing Law and Jurisdiction

These Terms shall be governed by and construed in accordance with the laws of Japan, and the courts of Japan shall have exclusive jurisdiction of the first instance.

### Contact

For inquiries regarding these Terms, please contact us at the following email address:

contact@miketako.xyz

時期	所属	経験
2017/05 - 2017/12	スマートアプリ株式会社 (インターン)	Laravel, iOS
2018/01 - 2019/03	ヴァンテージIT株式会社 (インターン)	Firebase, Vue, Ansible
2019/04 - 2025/04	LINEヤフー株式会社	Spring Boot, RDB, NoSQL, DevOps, SRE

スキル	経験度	説明
Java	⭐︎⭐︎⭐︎⭐︎⭐︎︎︎	実務で主に使用しています。
Spring Boot	⭐︎⭐︎⭐︎⭐︎⭐︎︎︎	実務で主に使用しています。
SRE	⭐︎⭐︎⭐︎⭐︎	インフラではなく原義的なSREの知見があります。
DevOps	⭐︎⭐︎⭐︎⭐︎	CI/CDを整えるなど。
Kubernetes	⭐︎⭐︎⭐︎⭐︎	実務経験があります。
Cassandra	⭐︎⭐︎⭐︎⭐︎	実務経験があります。
Redis	⭐︎⭐︎⭐︎⭐︎	実務経験があります。
MySQL	⭐︎⭐︎⭐︎⭐︎	実務経験があります。
Cassandra	⭐︎⭐︎⭐︎⭐︎	実務経験があります。
Google Cloud	⭐︎⭐︎⭐︎	Professional Cloud Developerの資格を取得しています。
Next.js	⭐︎⭐︎⭐︎	SSGを中心にですがReact関連などを基本として実装可能です。
Remix	⭐︎⭐︎	実装可能です。

プロダクト	説明	要素技術
miketako.xyz	このサイト	Next.js、Cloudflare Pages、Tailwind CSS、TypeScript、Github Actions
Niche Love	SNS	Remix、Cloudflare D1、Workers、R2、Grafana Cloud
Blue Biscuit	メンタルケア iOSアプリ	Swift UI、Xcode Cloud
Puppy Buddy	ペットの体重、食事管理	Swift UI、Xcode Cloud