「設計書」というのは、作るものの構造を抽象的に表現したものと言うことができます。 ただ、ソフトウェアの抽象化の仕組みはプログラミングコード自体に備わっているので、ソフトウェア生成可能な抽象的表現というのはコード表現ができるはずですね。コードで表現しておくと、整合性のチェックとかも行いやすいです。 でも、コードではない「詳細設計書」というものが一部業界には必要とされているので、その「詳細設計書」というのは実際はなんなのか考えてみます。 ※ 最初はタイトルは「設計書」としてましたが、話を限定するため「詳細設計書」に変更しました。 追記：納品物に関する記述を追加しました。 追記(2024/11/27)：「概略図」「物理設備の設計」を追記 表現を変えたコーディング ソフトウェア生成可能な抽象的表現というのはコード表現ができるわけですが、文字で表記する必要もなく、ダイアグラムで表現することもできます

いわゆる「ソフトウェア設計書」が設計ではなく、ソースコードが設計であるという話。 随筆です。考えマトメ中なので、ツッコミはそのあたり踏まえていただければ。 追記：ブコメに「設計の定義は？」とあったので末尾に追加しています。 追記(2024/8/15)：設計書ってなんだろう？というのも書いておきました。 ソフトウェアの「設計書」とはなんなのか - きしだのHatena このエントリで書いたのですけど、もうすこしちゃんと。 建築では多重下請けでやれてるのに業務システムでだめなのはなぜ？ - きしだのHatena このエントリでは次のように書いています。まあ、これで全てではあるのだけど。 「建築などの施工図面に相当するのはソースコードで、建築現場で多重下請けでやってる作業は、ソフトウェアだと(でも？)ビルドです」 あと「継続的デリバリーのソフトウェア工学」からの抜粋。 「継続的デリバリーのソフト

Akihiro Komori @comocc コーナンの作業台買ったんです。薄い鉄板で出来ててコストカットの鬼みたいな雰囲気。なんだけど、この脚のプレスの入れ方をみて驚いた。これどんな神が設計したんですか？この加工だけで強度と安定性爆上がりですよ。大学は機械系だったけど、こんなの授業じゃ習わなかったなあ。惚れ惚れする。 pic.twitter.com/vMDuBeXdJ6 2024-04-17 10:32:24

「チームトポロジー」や「エンジニアリングマネージャーのしごと」「スクラム実践者が知るべき97のこと」の著者や翻訳者などで知られる吉羽龍太郎氏が、「ソフトウェアに関わる人が知っておくといいかもしれない法則10個（勝手セレクション）」という興味深いポストをX（旧Twitter）で公開しています。 ソフトウェアに関わる人が知っておくといいかもしれない法則10個（勝手セレクション） コンウェイの法則 パレートの法則 グッドハートの法則 パーキンソンの法則 ブルックスの法則 リトルの法則 ピーターの法則 ハインリッヒの法則 ピーク・エンドの法則 ホフスタッターの法則 — Ryutaro YOSHIBA (@ryuzee) January 23, 2024 これらの法則の多くは経験則だったりもしますが、いずれにせよ知っておくと上司の説得に役立ったり、ソフトウェアの開発現場でチームの運営に役立ったり、物

PHPカンファレンス北海道2024 https://fortee.jp/phpcon-hokkaido-2024/proposal/7d223fcd-ecc8-4cfb-92b2-4987749463d8 Lについての補足記事 https://asumikam.com/entry/2024/0…

どうも、レコメンド商品のシステム開発をしている野川と申します。 私は、2021年にモノタロウに新卒入社し、2022年5月からレコメンド商品の開発に関わり始めました。 モノタロウのレコメンド商品は、下の図の①～④の流れでクライアントサイドで表示しています。大部分の処理はJavaScriptで構成しており、UIもそのHTML部分をjQuery(JavaScript)で作成しています。 図：レコメンド商品表の流れ 入社当時私は、ソフトウェアエンジニアとして、「可読性の低いコードは駆逐するべきだ」「読みやすいコードだけが正義である」「理解しやすいシステムだけが皆を幸せにする」と心の底から考えていました。加えて、「なぜ先輩たちは可読性の低いコードを放置して平気なのか？」と疑問を持つこともしばしばありました。 レコメンド商品周りのコードはまさに可読性の低いコードベースとなっていたため、当事者となった私

なんか雰囲気で使ってても問題ないStartとAwakeの使い分け。Awakeの方が先に処理される！ぐらいしか理解していないのなら、ここで覚えて行きましょう。 【AwakeとStartの違いを知る】 感覚的に使っていても割となんとかなることが多いですが、できればはっ...

ritouです。このしずかなインターネットにおける初投稿です。 おそらく、このしずかなインターネットのID連携では次のような設計になっていま「した」。問い合わせをさせていただき、対応いただきました。 これまでもQiitaなどで同様の実装例が紹介されていた際にはコメントさせていただいていたものですので、アンチパターンの紹介記事として読んでいただければと思います。 「Googleアカウントでログイン」ではじめると、ユーザーが作成され、Googleから受け取ったメールアドレス([email protected])が設定される 次回から「Googleアカウントでログイン」をすると、Googleから受け取ったメールアドレスでユーザーを参照 試しに、次のような流れで動作を確認してみます。 「Googleアカウントでログイン」でアカウント作成([email protected]) 「メールアドレス変更」

厚生労働省新型コロナウイルス感染症対策推進本部は、都道府県などに出した事務連絡（18日最終改正）で、新型コロナウイルス感染者等情報把握・管理支援システム（HER-SYS）での新型コロナウイルスワクチン接種歴の入力について、「現時点では4回目までしか入力できない仕様となっている」と伝えた。既に5回目接種が行われているが、接種回数を「不明」とするよう求めている。【新井哉】 事務連絡では、「今後、5回目以降の入力を可能とする改修を行う予定である」と説明。それまでの間、「新型コロナウイルスワクチン接種歴」の接種回数は「不明」とし、「感染経路分析」の「医師が必要と認める事項」に「ワクチン5回」と入力する。 HER-SYSを巡っては、入力作業に追われ、医療現場が逼迫した事態を踏まえ、入力する際、症状や診断方法などの項目をなくす改修を行っていたが、ワクチン接種歴に関しては、5回目以降に未対応だった。

ツイッターに度々寄せられるガラス張り図書館への批判。「まちなかリビング北千里」（大阪府吹田市）に対する2022年11月に発生した炎上を事例として、図書館をガラス張りで設計するのは本当にダメなのか、また、特定の個人ツイートに批判を浴びせる〈本好き〉達の行為への疑問を中心にまとめを作成した。

ひでぼー @rtsrc638 ほんとにデザインに優れているのは上っ面だけのガラス張りや絶対届かない本の展示だらけの見かけだけの図書館やないで 水戸の西武図書館のような、何十年経っても最新鋭で円周で動線もわかりやすく、全ての本が手に取れて、そして紫外線からも守れるところを指すんやで pic.twitter.com/D9or8skRfE 2022-11-14 11:50:43 ひでぼー @rtsrc638 さらにすごいのはここ、円周型になってるからほぼ死角も存在しない 司書さんが2階に上がれば戸棚の異常な箇所もすぐ見えるし、いたずらも難しい、ドーム型で響くから声も必然と小さくなる おまけに20以上前の設計でも古臭さがない、すべてが考慮されているデザインこそが優れているんやで 2022-11-14 11:54:08

はじめに ソフトウェアエンジニアでテストマンを生業とする Kuniwak です。今回は家を買うためにやったことを紹介します。 というのも、家を買うためにやったことを知人に話してみたら面白がられたため、誰かの役に立つかもしれないと思ったからです。 なおこの記事はソフトウェアに関する技術の記事ではありません（随所に検証の基本的な考え方などが散りばめられていますが…）。また、この記事で紹介する意見・手法は多分に cocopon 氏の影響を受けています。cocopon 氏の家購入エントリもこの記事と同時に公開されているはずです。 また、この記事はとても長いので先にポイントを説明しておきます。この記事ではライフプランシミュレーションに始まり次のような3Dモデルを作って日照や照明の検証をしていきます。また、3Dモデルを作るだけでは漏れが出るのでさまざまな検証を組み合わせています： 検証のために作った3

コ・デザインのためのシンキングシート

UMLとか構成図とかの図を描くの何のツールを使えばいいか迷いませんか？私は迷います。 ですので、最近使っているツールを紹介します。 世の中にツールがイロイロあるのは理解した上で、大量に紹介するとやっぱり迷うので、似たようなツールや個人的に使わないツールはバッサリ省いています。 パワポで描く まずはPowerPointです。 エンジニアや技術系の方は「パワポで図を描くのはちょっと、、、」と思われるかも知れませんが、状況によってありだと思っています。 パワポのメリット パワポは、ビジネスユーザーならほぼ誰でも使える システムを作る時に、お客さん側も含めた関わるメンバー全員がITに詳しいとは限りません。しかしそういう人にもシステムに対する理解は最低限していただく必要があります。システム構成図とか特に興味がない人に説明するときに「新しいツールをいれてください」というのはハードルが高いです。 パワポ

Googleでの「Design Docs」とは 2007年の Google Developer Day Tokyo での鵜飼氏のプレゼンによると「Google で必ず書くことになっているドキュメント」であり、「プロジェクト立ち上げ時の 1～2週間をかけて書く」ものです。 今回は Google のソフトウェアエンジニアである @cramforce 氏が自身のブログで「Googleでの Design Docs」について解説している記事を公開されていたため、氏の許可を得て翻訳しています。 原文： www.industrialempathy.com 関連書籍： Googleのソフトウェアエンジニアリング ―持続可能なプログラミングを支える技術、文化、プロセス オライリージャパンAmazon 読了目安：11分 (目次) デザインドキュメント の解剖学 文脈と範囲 目標と非目標 実際のデザイン システ

住宅はその構造によって「木造」や「RC造」などがありますが、「軽量鉄骨造」も代表的な構造の一つです。鉄骨を使った構造には、ほかに「重量鉄骨造」というものもありますが、一体どこが違うのでしょうか？　軽量鉄骨造のメリット・デメリットとあわせて、設計工房の一級建築士である久保宗一さんに話を聞きました。 鉄骨造とは？ 鉄骨造の種類 木造との比較 RC造との比較 軽量鉄骨造の特徴、メリット・デメリットは？ 特徴 メリット デメリット 重量鉄骨造の特徴、メリット・デメリットは？ 特徴 メリット デメリット 軽量鉄骨造住宅の実例を紹介！ 【実例1】外に閉じ、中は開放的な鉄骨らしさあふれる住宅 【実例2】7.4坪の狭小地に建つ3階建て軽量鉄骨住宅 【実例3】クリーム色の外壁が特徴的な軽量鉄骨3階建て 軽量鉄骨造で理想の住まいを建てた先輩たちの事例を紹介！ 耐震性にこだわり鉄骨造を選んだシンプルな真四角の家