[{"data":1,"prerenderedAt":382},["ShallowReactive",2],{"content-\u002Fcontents\u002Fsoftware-dev":3,"surroundPost-\u002Fcontents\u002Fsoftware-dev":373},{"id":4,"title":5,"body":6,"createdAt":361,"description":346,"draft":362,"extension":363,"meta":364,"navigation":365,"path":366,"seo":367,"stem":368,"tags":369,"thumbnail":371,"updatedAt":361,"__hash__":372},"contents\u002Fcontents\u002Fsoftware-dev.md","ソフトウェア開発に関する書籍をいくつか読んだのでまとめてみる",{"type":7,"value":8,"toc":345},"minimark",[9,13,16,50,53,57,60,63,66,69,72,80,83,86,94,97,100,103,106,109,112,117,120,123,127,130,133,136,139,142,145,148,151,185,188,191,194,197,200,203,206,210,213,216,219,222,225,228,231,234,311,314,317,320,323,326,329,333,336,339,342],[10,11,12],"p",{},"ソフトウェア開発に関して復習もかねてちょっと広い視点からの整理と感想をまとめてみました。",[10,14,15],{},"以下が今回読んだ（参考にした）書籍たちです。全部を詳細に読みこんだわけではなく、過去に一度読んだものも含みます。",[17,18,19,29,36,43],"ul",{},[20,21,22],"li",{},[23,24,28],"a",{"href":25,"rel":26},"https:\u002F\u002Famzn.to\u002F3Ucgmof",[27],"nofollow","ソフトウェアアーキテクチャの基礎",[20,30,31],{},[23,32,35],{"href":33,"rel":34},"https:\u002F\u002Famzn.to\u002F3GU2coO",[27],"セキュア・バイ・デザイン",[20,37,38],{},[23,39,42],{"href":40,"rel":41},"https:\u002F\u002Famzn.to\u002F3Vubrjx",[27],"ドメイン駆動設計入門",[20,44,45],{},[23,46,49],{"href":47,"rel":48},"https:\u002F\u002Famzn.to\u002F3VoBlpa",[27],"いちばんやさしいアジャイル開発の教本",[10,51,52],{},"本記事はオレオレまとめなのであくまで参考程度と考えてください。",[54,55,56],"h2",{"id":56},"そもそもソフトウェア開発はどう行われるか",[10,58,59],{},"ソフトウェアには当然ソフトウェアを使う人がいます。その人たちは何らかの目的・要求があり、それらの目的・要求を実現するためにソフトウェアを使いたいと考えています。",[10,61,62],{},"ここでは簡単のためソフトウェアを使いたい人を顧客と表記します。",[10,64,65],{},"顧客は自分たちではソフトウェアを作れないので、ソフトウェア開発専門の人たちにソフトウェア開発を依頼します。",[10,67,68],{},"ここにきてソフトウェア開発者が出てきます",[10,70,71],{},"ここからは開発者がどのように顧客の要望するソフトウェアを開発するかになります。",[10,73,74,75,79],{},"まず開発者は顧客が要望するソフトウェアが、どのようなものか具体化していく必要があります。この作業がいわゆる",[76,77,78],"strong",{},"要件定義","です。",[10,81,82],{},"要件定義では、顧客が要求する事項を実現するために必要な機能や性能（機能要件、非機能要件）を定義します。\n顧客はソフトウェアの専門家ではないので、顧客の要求は開発者にとっては抽象的すぎる、そして顧客自身も本当に自分たちが欲しいものを言語化できてない可能性が高いです。\n要件定義で顧客が本当に欲しいものを聞き出す、そしてそれを実現するために必要な機能、非機能を正しく洗い出せるかが重要です。",[10,84,85],{},"例：",[17,87,88,91],{},[20,89,90],{},"顧客：家計簿アプリが欲しい",[20,92,93],{},"開発者：スマホアプリ、ブラウザ？、外部との連携（銀行やカード）はある？、家計簿への入力方法はどんなものが必要？、通知やグラフはどんなものが必要か、etc...",[10,95,96],{},"要件定義ができたらが次は設計・実装・テストに移っていきます。",[10,98,99],{},"この要件がある程度固まった後にどのように開発を進めていくかは開発チームが採用している開発プロセスに依存します。",[10,101,102],{},"要件定義で行う内容・呼称・成果物に多少の違いはあるかもしれませんが、どんな開発プロセスでも似たようなことは行うはずです。",[54,104,105],{"id":105},"開発プロセスたち",[10,107,108],{},"どのように開発を進めていくか、つまり最終的に顧客が望むソフトウェアを作るためにどのような手順を踏むか考える必要があります。",[10,110,111],{},"パッと思いつくのはウォーターフォール（WF）開発とアジャイル開発でしょう。",[113,114,116],"h3",{"id":115},"wf-開発とアジャイル開発の違い","WF 開発とアジャイル開発の違い",[10,118,119],{},"いくつか書籍を読んでみてわかったのは、 WF 開発とアジャイル開発の対比で重要なのは開発の進め方であるということです。",[10,121,122],{},"言いたいのは、アジャイル開発であっても WF で実施した工程は必要になることもあり、成果物に関しても同様のものが必要になる可能性があることです。\nWF では最終成果物（つまり完成したソフトウェア）を 100%完全に予測・設計ができたとして実装・テストをしますが、\nアジャイル開発では全体の 1%（100 個機能があるうちの 1 個）を設計・実装・テストまでやってしまい、フィードバックをもらい必要があれば改善し、できたらまた次の 1 機能というように細かく WF のサイクル回しているようなイメージです。",[113,124,126],{"id":125},"アジャイル開発の方がいいのか","アジャイル開発の方がいいのか？",[10,128,129],{},"一概には言えませんが、多くの場合アジャイル開発の方が開発者には現実的なのかなと思います。\n理由として、WF 開発で事前の要件定義と設計で漏れなくいけるとは考えにくいからです。\n実装・テストをやってみてひっくり返ることは十分考えられます。",[10,131,132],{},"それであれば、最初からソフトウェア開発は不確実性の高い作業だということを認め、ちょっとずつ確認しながら進めていきましょうよ、とした方が開発者としては現実的だと思ってしまいます。",[10,134,135],{},"逆に大きな不確実性はないとある程度自信を持って言える状況、似たような要件で過去に何度か開発した、期間が短すぎてできることがそもそも少ない、などの場合であれば WF でもいいかもしれません。",[10,137,138],{},"いずれにせよ両者の違いとトレードオフを理解し、適した方を採用するという判断力が必要です。",[54,140,141],{"id":141},"要件定義から設計へ",[10,143,144],{},"必要な機能がわかれば次はいよいよ設計です。",[10,146,147],{},"設計で考えることはソフトウェアアーキテクチャです。",[10,149,150],{},"ソフトウェアアーキテクチャの定義は以下の通りです（「ソフトウェアアーキテクチャの基礎」より引用）",[17,152,153,161,169,177],{},[20,154,155,156],{},"システムの構造\n",[17,157,158],{},[20,159,160],{},"マイクロサービス、レイヤードなど",[20,162,163,164],{},"アーキテクチャ特性\n",[17,165,166],{},[20,167,168],{},"可用性、スケーラビリティなど",[20,170,171,172],{},"アーキテクチャ決定\n",[17,173,174],{},[20,175,176],{},"システムをどのように構築するかのルール",[20,178,179,180],{},"設計指針\n",[17,181,182],{},[20,183,184],{},"どう実装を進めいてくかのガイドライン",[10,186,187],{},"定義が箇条書きになってるのに違和感を覚えるかもですが、ソフトウェアアーキテクチャの定義はそれだけ人によって解釈が多岐にわたっているのです。\n（この定義の詳しい背景と内容は「ソフトウェアアーキテクチャの基礎」の第 1 章に記載されています）",[10,189,190],{},"アーキテクトと呼ばれる人が上記 4 つをどのように選択していくかを考える必要があります。",[113,192,193],{"id":193},"設計を考えるのは難しい",[10,195,196],{},"個人的にここが一番ハードルが高いです。",[10,198,199],{},"設計するアーキテクトは顧客要求（要件）の理解、実装に関する技術的な理解、対象ドメインの理解など多くの事柄を理解し、総合的にベストな決定を行う必要があります。",[10,201,202],{},"「ソフトウェアアーキテクチャの基礎」でも書かれてましたが、アーキテクトはかなり広範な知識が要求されます。",[10,204,205],{},"システムの構造一つとってもそんなにたくさん候補が出てきませんし、経験もないです。",[113,207,209],{"id":208},"ドメイン駆動設計dddはどう位置付けられるか","ドメイン駆動設計（DDD）はどう位置付けられるか",[10,211,212],{},"「セキュア・バイ・デザイン」や「ソフトウェアアーキテクチャの基礎」でも頻繁に言及されるのがドメイン駆動設計（DDD）です。",[10,214,215],{},"ここでは DDD に関して細かく説明しないので、詳しい定義は書籍等を参考にしてください。\nドメイン駆動設計は、端的にいうとソフトウェアで解決したい問題領域をどう実装に落とし込むかという設計手法です。",[10,217,218],{},"DDD がソフトウェア開発の中でどう位置付けられるかですが、おそらく要件定義から実装に入る手前（設計）のドメインエキスパートとドメインモデルを定義するところと、得られたドメインモデルをどう実装に落とし込んでいくかの 2 箇所に大別されそうです。",[10,220,221],{},"調べてみると DDD 自体はわりといろんな要件に適用できそうです。\nそう考えると DDD はソフトウェアアーキテクチャにおいて比較的幅広く使えるテクニックと言えます。",[54,223,224],{"id":224},"ソフトウェア開発におけるテスト",[10,226,227],{},"ソフトウェア開発に携わっているとテストに関する話題は事欠きません。",[10,229,230],{},"では実際にどのようなテストが存在し、開発全体の中でどうテストを取り入れていくべきかを考えたいと思います。",[10,232,233],{},"テストには以下のようなものがあると思います。思います、という言い方にしたのは、書籍によって名称が違ったりするので正確な表記、内容に自信がないからです。",[17,235,236,244,255,287,295,303],{},[20,237,238,239],{},"単体テスト（ユニットテスト）\n",[17,240,241],{},[20,242,243],{},"関数やクラス単位ですのテスト",[20,245,246,247],{},"結合テスト（統合テスト）\n",[17,248,249,252],{},[20,250,251],{},"複数の関数にわたる動作のテスト",[20,253,254],{},"データベースなどが絡むと結合テストに該当すると思ってる",[20,256,257,258],{},"システムテスト（総合テスト）\n",[17,259,260,263,266],{},[20,261,262],{},"実際の使われ方を想定したテスト",[20,264,265],{},"要件定義で書かれた内容が正しく実行できるかを確かめる",[20,267,268,269],{},"システムテストの中に以下のようなテストも含まれる\n",[17,270,271,279],{},[20,272,273,274],{},"パフォーマンステスト\n",[17,275,276],{},[20,277,278],{},"レスポンス時間や処理速度が想定通りの範囲で推移するか、もしくは許容オーバーの際に正しくハンドリングされているかをみるテスト",[20,280,281,282],{},"セキュリティテスト\n",[17,283,284],{},[20,285,286],{},"文字通り",[20,288,289,290],{},"受け入れテスト\n",[17,291,292],{},[20,293,294],{},"顧客側が要求仕様通りのシステムができたかチェックするテスト",[20,296,297,298],{},"回帰テスト\n",[17,299,300],{},[20,301,302],{},"新しい機能や修正が追加された際に既存機能が正常か確かめるテスト",[20,304,305,306],{},"探索的テスト\n",[17,307,308],{},[20,309,310],{},"人が探索的にソフトウェアの穴となりそうなところをテストする",[10,312,313],{},"上記は WF 開発で実施されるテストがベースになっています。",[10,315,316],{},"アジャイルでは一つのバックログ（ユーザーストーリー）単位で単体テストからシステムテストに近い内容を実施し、顧客にみてもらう（受け入れテスト）をサイクルの中で実施することになると思います。\nアジャイル開発で行う場合は、アジャイルテストの 4 象限なるものがあり、それを参考に実行されることが多いようです。",[10,318,319],{},"アジャイル開発の場合はテストの自動化が結構大事になるはず。なぜなら、完成した機能に対してどんどん新しい機能を追加していくことになるので、受け入れ済みのところが壊れていないことを担保する必要があります。\nまた明示的なシステムテストフェーズなどを設けない場合は、セキュリティやパフォーマンステストも随時やらねばなりません。",[10,321,322],{},"じゃあどこからどこまで自動化するのかということを考えます。まず単体テストレベルは間違いなく自動化の対象です。実行も簡単で他との依存関係がほぼないはずなので簡単に実行できます。",[10,324,325],{},"問題は結合テストレベルですが、これもアジャイルでやるなら自動化対象かなと個人的には思います。理由は先ほど述べたとおりで DB や他モジュールとの関連した動作も合わせてテストで保証しておかないと追加の機能を実装しづらいからです。\nただ、UI テストレベルの自動化ではなく、あくまでバックエンドの機能レベルの自動化です（UI テストは保守性が悪く、書くのも大変なため）",[10,327,328],{},"ただここで問題になるのは、DB や他システムが絡むような複雑なテストは書くのに時間がかかり、開発生産性を落としたり、保守性が悪くなったりしがちです。うーんここに関して具体的に書籍で言及してるのをまだ探せてないです。",[54,330,332],{"id":331},"感想まとめ","感想・まとめ",[10,334,335],{},"大枠の整理はとても良い勉強になった。実際、書きながらわからないことがボロボロ出てきたので、書籍を見直したりネットで検索したりをずいぶん繰り返した。",[10,337,338],{},"一方で、アジャイル開発におけるテストのやり方についてはまだ理解しきれていない。\nテストの厚さはぱっと見だと WF の方がしっかりしてる気がする。システムテストに含まれるセキュリティとかパファーマンス観点のテストがアジャイルだと軽視されているように見える（暗黙的にやることになってる？）\nおそらくアジャイルでも随時そういったセキュリティとかのテストもやらなきゃいけない。つらそう。",[10,340,341],{},"アジャイルのテストはもう少し文献調査の必要がありますね。",[10,343,344],{},"あと用語の定義ってめちゃめちゃ大事だということを感じた。テスト周りが整理されてなさすぎる。",{"title":346,"searchDepth":347,"depth":347,"links":348},"",2,[349,350,355,359,360],{"id":56,"depth":347,"text":56},{"id":105,"depth":347,"text":105,"children":351},[352,354],{"id":115,"depth":353,"text":116},3,{"id":125,"depth":353,"text":126},{"id":141,"depth":347,"text":141,"children":356},[357,358],{"id":193,"depth":353,"text":193},{"id":208,"depth":353,"text":209},{"id":224,"depth":347,"text":224},{"id":331,"depth":347,"text":332},"2022-11-23",false,"md",{},true,"\u002Fcontents\u002Fsoftware-dev",{"title":5,"description":346},"contents\u002Fsoftware-dev",[370],"2022","\u002Fimg\u002Ftwitter-card.png","lkh8PBedRRfZsXqMM7IYts2S4S9E6Ktr9CJJAInjYKg",[374,378],{"title":375,"path":376,"stem":377,"children":-1},"Socratic-SWE: Self-Evolving Coding Agents via Trace-Derived Agent Skills","\u002Fcontents\u002Fsocratic-swe","contents\u002Fsocratic-swe",{"title":379,"path":380,"stem":381,"children":-1},"STALE Paper Summary","\u002Fcontents\u002Fstale-memory","contents\u002Fstale-memory",1784936718623]