ken1flanのブログ

自己紹介・最近やってることなどを書くつもりです。

Software Design 2024/10 メモ

Software Design 2024年10月号を読んで、ちょこっとずつ感想を書いてます。

gihyo.jp

表紙

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

第1章：受託開発における設計ドキュメントの課題と解決案 作成・管理のヒントを探る ......真野 隼記

  • あ…うーん…開発チームの状況が多様なのはめっちゃわかります…。
  • 昔のことを思い出す感じですが……孫請だったからなー。
  • ドキュメントは、チーム全体のスキルの下限を上に押し上げてくれる効果ありますよね。当時はわからなかったけど、今は想像がつくようになりました。
  • あ…うーん……OpaneAPI GeneratorのRubyジェネレータは……結構微妙なアウトプットを出してきて、手を入れないとちゃんと動かなかったので……どう管理したものでしょう……。
    • yamlはGMOPG製で、ライブラリがないんですよね……。 ‐ マークダウン形式にして、ソースコードと一緒に置いておく、かぁ…。みなさんどうしてます？
    • うちは……ないです><
    • 仕様書っぽいテストはあります。

第2章：ADRを活用してドキュメントとコードの一致を実践 Gitでの管理と承認フローが成功の秘訣 ......中島 剛

  • 直面する問題…「なぜ〜したかわからない」は…ウチはプルリクエストにいろいろ書くようにしてます。
    • 小さいサービスだから、URL→ソースコード→blame→プルリクエスト、みたいに辿ってます。
  • 変更フローを作るのはありですよね…。
  • github.com
    • こんなものがあるとは…φ(･･
  • 開発の経緯……自分が入る以前のものがないんですよねえ…。そういうフェーズでした。
    • …プルリクエスト、何も書いてないに等しかったです…。
    • まぁ、来月やってるかどうかわからん、的な状況であればそんなもんでしょう？

第3章：設計書なしでも各人が疎結合で開発できるために チーム分割と設計工程の見直しで実現 ......山本 祥平

‐ 書かない！…決めるのはスゴイかも。 - 改修時にコードを読めばわかるが崩れた……なるほど。 - チーム分割で対応するのは割とよさそうですね…。 - ケーキのように切ったあとに、責務で分割する感じですかね。更にバックエンドは細かいタスクに別れているようです。 - 各チーム、何人くらいなんでしょう…？ - 変更の背景的なものは…要件定義がキッチリあるなら、そこへの参照があれば十分かも。 - 境目があるがゆえに、キッチリとインターフェイスを定義する動機になって、これはこれでよさそうです :+1:

第4章：「コードがドキュメント」を地で行く開発スタイル 受託開発なのにドキュメントを書かずに済む秘訣 ......伊藤 淳一

  • 「納品のない受託開発」… 受諾だけど、内製している感じに近そうです。これだと、保守しつづけるドキュメントがないのもちょっとわかる気がします。
  • なるほど…。抱え込んだ開発チームだと、スプリントに割り込みが発生するだろうから、案外アリなのかも。ふーむ。
  • 仕様変更も締め切りがないなら、別に断る理由もなかろうし…。
  • …徹底してないと、担当開発チーム以外でコードレビューができないけど、こりゃスゴイな、かなりマッチョですね…。ここも敢えて外部にすることで、説明をちゃんとすることを求めてる…。
  • 必要なときにだけ必要なドキュメントを残すけど、それをメンテナンスし続けるわけではないところが、コツっぽく見えました。

第5章：OSS開発のドキュメント事情 設計思想や実装の意図をどうやって伝えているか ......濱野 賢一朗、藤井 雅雄、佐々木 徹、梶波 崇、末永 恭正

  • PostgreSQL
    • Commit Fest、おもしろい仕組みですね。
    • 30年続いている……ホントすごいですね……。 ‐ いずれのプロジェクトも変更理由をちゃんと書いて、それを承認して、実装、のようなプロセスを取っていて、あとからちゃんと追えるようにしているように思えました。
  • 人が流動的であることがわかっているからでしょうか。
  • プロジェクトも結構長く続くので、かなり重要な気がしました。

第2特集 今こそ知りたい オンライン個人認証・本人確認 安全性と信頼性を担保する技術のしくみ ......近藤 潤也、保科 秀之、秋田 潤

第1章：「本人確認」とは 集中整理！ 用語の定義と法的扱い

  • 本人確認 と 当人認証 、区別してませんでした。たしかにちょっと要件が違いそうですね。
  • 本人確認 、各法律で定められた方式があるのは知りませんでした…。なるほど…。
  • 郵便局による「本人限定受取郵便」というのがあるんですね…。
  • eKYC…ICチップだと重要な情報のときは少し物足りないような…。
    • モノによったら、オンライン面接付きのほうが……いや、VTuberの精巧なヤツが来たらどうなるんだろう……。

第2章：eKYCの4つの方式 メリット／デメリット、リスク対策のしくみ

  • ホ
    • AI、OCR、リアルタイム品質判定…前の章で気になったものに対して、やっぱり対応をがんばってますね…。 ‐ ヘ
    • マイナンバーや運転免許証のチップかぁ。こっちは偽造が難しそうです。
    • ただなぁ……登録とか更新時になんか穴がありそうで><

第3章：JPKIを活用した本人確認 電子証明書を利用した安全で確実な手続き

  • 改ざんされてないことはわかるけれども……正当な所有者であることを証明するには…？
  • 顔認証と組み合わせることが望ましい……ですよね。

連載：Column

万能IT技術研究所【29】全米を震撼させたゾディアック事件の暗号を解く！――日本が舞台の歌劇を好んだ、20世紀の未解決凶悪事件犯 ......万能IT技術研究所

  • ja.wikipedia.org
    • …なんかひどい事件ですね><
  • 2文字の連続だとちゃんと関連が見つかるんですね…。
  • こういうの、感情が入っちゃってダメかも><絶対解ける自信がないです><

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

  • データを元に振り返り……耳が痛いっす><
  • いろんなものを見えるようにしなきゃなー…と思いつつ、少しずつしかできない><
  • 手戻りたったの2時間……つい、こういうのを議論にしちゃうの、わかります…。
  • 工数の入力、アプリが使えるといいんだけどなぁ…。今Notionで、ただのテキストデータなんですよねえ…。
  • あー…「開発の生産性か品質への貢献がないマネジメント活動になってないか」…この指標、いいですね…。
  • どうやってチームみんなにデータを元に改善案を考えるようにしてくんでしょう…次回がかなり楽しみ！

エンジニアのためのやる気UPエクササイズ【最終回】生産性を最大化するエンジニア健康チェックリスト10選 ......えくろプロ

  • えー！！！マヂか、最終回……寂しすぎる…！！
  • この記事を読むと、何かしらやろうっていう気持ちになって、ちょっとだけやるようになったりしたんで…。 ‐ 背中を動かすのはよさそう…普段からやってみます。 ‐ いろいろと参考になりました！ありがとうございました！

あなたのスキルは社会に役立つ～エンジニアだからできる社会貢献～【154】テクノロジーで民主主義をアップデートする〜2024年東京都知事選から見えた可能性と課題〜　......関 治之

  • あ…気になった方だ…。
  • ブロードリスニング…？
    • みんなの声をダイジェストにして政治家が聴く…だと、マイノリティの声は聞こえるのかしら？
    • ダイジェストの作り方次第で、良くも悪くも変わってしまいそうではありますが…。
    • 一部目立つとかコネがあるところとかしか聴けないのとどっちがいいんだろう…？
  • 今まではマニフェストを更新するのが難しかったとは…。なるほど、コレは
  • いろんなシステムを公開していくのは…結構新しいかも。
  • なんか、いい感じなので…邪魔されず使われていくといいなぁ…。

連載：Development

ソフトウェアテスト探検隊【新連載】 ......Kuniwak

‐ おおお…テストの新連載！たのしみ！ - 計算機科学に登場するソフトウェアテストの明確な定義……難しそうですが…たのしみ…。 - 各言葉の定義をされてて、なるほど…という感じでした。 - 定義がわかってくると、テストケースの選び方がわかってくるような…予感がしました。

レガシーシステム攻略のプロセス【6】ZOZOTOWNにおけるBFFアーキテクチャ実装 ......三神 拓哉、藤本 拓也

  • Aggregation APIが入ると、線の複雑さが解消されて管理しやすそうですね。
  • ああ…きれいになるということは、そこがネックに……まぁ…わかります…。
  • キャッシュが上手に入ると、確かにマイクロサービスで障害が起きても、影響範囲を減らせそうです。
  • さすがに大きいから、まだ作業中なんですね。
  • なるほどですねぇ…。

Databricksで勝つデータ活用【7】Databricksとデータウェアハウス ......弥生 隆明

  • AI関数、おもしろいですね、結構使えそう…。

あなたの知らないChromeの世界【9】サードパーティCookieとPrivacy Sandbox ......小河 亮

  • これは保存版ですね…。
  • 次回で最終回なんですか…。楽しく読んでいたので、かなり寂しいです…！
  • FLoCの話、当時話題になってたのを思い出しました。その後が知れてよかったです！

ぼくらの「開発者体験」改善クエスト【10】顕在化されていない期待、デザインの灯台〜3年活動記 ......鳥居 大

  • 「デザイン」が本来のデザインになれるように…。
  • 顕在化されていない期待を見つけ定義すること、時間がかかっても着実にうごかしていくこと…めちゃくちゃいいこといってます…。見習わねば！
  • 「デザイン」が全体に関わるのは、見た目は企画からできるし、見た目ができてくると見る目の解像度も上がってくるからですよね。。。デザイナーほしいなぁ。。。
  • ゴールがどこにあるのか…は自分も大事にしてます。
  • うち、結構メンテナンスに時間がかかるんだよなぁ……。古いからか……。
  • 「灯台」のたとえ、いいですね。がんばるかー！

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

  • うわあ……リアルですね……。
  • この話が出てきたときに、忘れがちな退会と本人確認について、いつも厳し目にインタビューしてます…。
    • 退会も厳し目にしたいですねぇ…。
  • 状態が複数のカラムで管理されていればまだ……。
    • ビット演算でまとめて入ってたのを扱ったことがあって、これってどうだったんでしょう……。
      • パフォーマンスが求められるサービスのフレームワークをコピーして作った、みたいな経緯だったから…まぁ……。 ‐ 状態ごとにテーブルを分ける作戦はよく取りますが…状態遷移を管理するテーブルはあまりやったことがなかったかも。カードに加えておきます！

実践LLMアプリケーション開発【13】LangGraphのステートを永続化するチェックポイント機能 ......西見 公宏

  • ステートの永続化？
    • やりとりしたことを覚えていることみたい。
  • Google Colab、シークレットが設定できるんですね…。
  • 状態を保存できると、過去の再現ができるから、開発・テストがしやすくなるのもありがたいですね。
  • やりとりの記憶をAI側じゃなくて手元のデータベースに持ってこれるのはよかったです。

Cloudflare Workersへの招待【11】Durable Objectsが広げるCloudflare Workersの可能性 ......Monica（川村 空千）

  • パフォーマンスが要求される場所ではやっぱり用途によってストレージが細かくわかれてますね…。
  • websocketも使えるのか…というか、これじゃないと使えなかったのか…。（普段使わないので興味がなく、まったく気づいてなかったです…。）
  • サーバレス、未来があると思うんだけど…手元だけでは動かないですよねえ…。

AWS活用ジャーニー【25】Amazon S3 発展編 ......杉金 晋

‐ 一桁ミリ秒のレスポンス……かなり早そう……。 - どういうときの利用がオススメか知りたいです！

連載：OS/Network/Security

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

  • SPF、DKIM、DMARC、やったよー。
  • DNSを正しく所有していることが前提……たしかに。
  • BINI?
  • DNS、たしかにいろんなものを背負ってますね……。
  • せめて、DMARCの設定、強化しようかなぁ…。
    • 迷惑メールに分類される可能性が減る…と。
  • 突然の可愛いイラストが…！
    • 結構前からついていたのに気づけていなかったです><
    • epubで狭っ苦しくして見てるからかなぁ…。
    • 見直しておきます…！

インターネットの姿をとらえる【2】インターネットの正体をさぐる ......土屋 太二

  • ルーターの集まり…たしかにそうですねえ。
    • ハブだけだとたしかにネットワーク感はないですもん。
  • ASネットワーク…全然知りませんでした…。

基礎からわかるDetection Engineering【3】Detection as Code――YARA ......石川 朝久

  • 定義ファイル、こんな感じなんですね…。
  • ファイルを検査するだけのツールだから、ログに痕跡があるかも調べられるんですねえ…。
  • こんなふうにやってるんですね…。普段知らない話なので、大変おもしろいです…。

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

  • ブレース展開……あんま使ったことないヤツです…。
    • コピーとか移動とかでめっちゃ威力を発揮しそうだな…と思いつつ…手が覚えてないので使ってなかったです。
  • うわっ……むずかしそう><
    • ブレース展開
    • 変数名の途中でブレース展開
  • …スゴかった💦

アラカルト

ITエンジニア必須の最新用語解説【190】Skip ......杉山 貴章

  • skip.tools
  • swiftでandroid…？
  • やっぱりひとつの言語で書きたいですよね…。
  • Swift -> Kotlinのトランスパイラなんですね。
  • 有料だけど、無料枠もあるそうで…結構いいかも。

読者プレゼントのお知らせ

SD BOOK REVIEW　

‐ info.nikkeibp.co.jp - 2版かあ…。 - 仮想化の章が入ったのは…たしかにイマドキですね。 - うーん…よみたい…。 - https://www.maruzen-publishing.co.jp/item/b305690.html - プロダクトマネジメントのスキマ？気になる…。 - gihyo.jp - よく使われる技術に数学がどう使われているか解説してくれてるんですと…。 - 気になる…。 ‐ gihyo.jp - 結構いろんなことが書いてありそう…。 - 手に持っててもいいかも…。

  • 万能IT技術研究所へponさんのコメントで、 サイバーブラタモリ だって！なるほど、納得すぎますw

次号のお知らせ

  • AI駆動開発？？気になります〜
  • ランサムウェア対策のアプローチ…これも。多いですからね…。
  • PHP、今どんななのかな…これも面白そう。
  • 基本情報……オレ、大丈夫かなぁ💦

特別広報

Ruby でデザインする、挑戦と進化の未来へ！ Ruby biz Grand prix 2024 ......編集部

  • 2023年度
    • uuuo.co.jp
      • コンセプトを見たとき、これいいなって思ったとこでした。
    • www.pixiv.co.jp
      • ずっとRubyの会社のイメージ。RubyKaigiでもいろいろ
  • 2024年度エントリー
    • 前から知ってる会社、新たに知る会社とあって、案外おもしろいです…！
  • うちのも出してみたい感……。