Software Design 2024年10月号

https://gihyo.jp/magazine/SD/archive/2024/202410

ドメイン解体新書 【9】ドメインと電子メールの切っても切れない関係

最近特にGmailのガイドライン変更で, DKIMとかDMARCとかのワードは聞くようになったが, 詳しい仕組みそのものはわかってなかったので助かる. そもそもメールのプロトコルをちゃんと理解しないとダメだな.

ハピネスチームビルディング 【31】データを基に各自で改善点を考えよう(前編)

「あるタスクで手戻りが多くて非効率だった」というときに、その手戻りにかかった時間を共有せずに議論していました。あとでデータを確認すると「4週間の開発期間の中で、議論していた手戻りはたったの2時間」であることがわかりました。

わかりみが深い. とはいえなかなかデータを集めるのも工数を消費してしまうので, うまくスケールする仕組みを作らないといけないんだろうな.

第1特集 再考 設計ドキュメントの課題 二重管理しない，陳腐化させない

とてもありがたい特集. 最近だと Design Docs や Architecture Decision Record(ADR) が取り上げられることが増えてきたが, あまり深掘りされることがないのでとてもありがたい.

全体を通じて OpenAPI Specification やドキュメンテーションコメントを活用するといった話題が多く, やはりエンジニア目線でドキュメントを腐らせないということがテーマになっていそう. また各章ごとに違ったアプローチが挙げられており, やはりドキュメントというのは組織に依存するものだというのがよくわかる. とくにドキュメントに問題があるというのは, ビジネス側とエンジニア側が分断してしまっているなど, そもそも組織のコミュニケーション自体に問題があるということに気づいてしまった. つらい.

個人的には「第2章：ADRを活用してドキュメントとコードの一致を実践 Gitでの管理と承認フローが成功の秘訣」がありがたかった. ADRはとくにいつ書くかなどのプロセスが重要になるので, それが挙げられているのはとてもうれしい.

「第5章：OSS開発のドキュメント事情 設計思想や実装の意図をどうやって伝えているか」で, Java のJEPとかはADRに近しいものなのかもしれないと思った.

第2特集 オンライン個人認証・本人確認 安全性と信頼性を担保する技術のしくみ

免許証の厚みを確認するあれって, ちゃんと決まってたんだ...

レガシーシステム攻略のプロセス 【6】ZOZOTOWNにおけるBFFアーキテクチャ実装

めちゃくちゃ濃い内容だった. BFFを運用した上での課題とかの話はあまり見かけないので, とても良い. 扱われている内容はかなり専門性が高いので真似できるとは限らないが, 考え方は実直で参考になる部分も多いはず.

実践データベースリファクタリング 【10】状態遷移の爆発を防ぐ

フラグが大量なるというめちゃくちゃありがちな例で参考になる.

魅惑の自作シェルの世界 【23】ブレース展開の実装

Lispのインタプリタとか, HTMLのパーサとかでも似たようなことを考えた気がする. けっきょくステートマシンなのかもしれない.