詳細設計書なんて、書きたくない・・・・Doxygenを使って自動生成してみる - Qiita
はじめに お客様に提案をしているときの会話です。 お客様：「詳細設計書は作りますか」 私：「昔ながらの詳細設計（ロジックを日本語で書くもの）は作りません。クラス図とか、シーケンス図は複雑であれば作りますが、今回のシステムはそこまで必要なものはないものなので、割愛しようと思っています。」 お客様：「保守をお願いするかどうか未定なので、場合によっては引継ぎのために作ってもらうかもしれません」 私：「・・・・」 といった感じで、私がこの業界に入った30年前は、確かにプログラムを作る前に、詳細設計書と呼ばれるプログラムを日本語で書いていました。 最近、詳細設計と呼ばれるものを作った記憶がなく、無駄なものは作りたくないなぁという思いから、コードから自動生成できないかなと思って、いろいろ試してみました。 Doxygenって いろいろ調べてみると、Doxygen にたどり着きました。 色々な言語に対応し
仕様書通りにシステムを作りました。使えなくても知りません
仕様書通りにシステムを作りました。使えなくても知りません：「訴えてやる！」の前に読む IT訴訟 徹底解説（113）（1/3 ページ） ユーザー企業が作った仕様書に抜け漏れがあり、その通りに作ったシステムが使いものにならなかった。悪いのは、ベンダー、ユーザー企業、どちらなのか？ 連載目次 IT訴訟を例に取り、トラブルの予防策と対処法を解説する本連載。今回取り上げるのは、要件の不備についての裁判例である。ユーザーが示した要件に抜け漏れや誤りがあり、これに沿って構築したシステムはユーザーが本来望んだ動作をしなかったというものだ。 ユーザーはこれを債務不履行であると訴えるが、ベンダーは「言われた通りに作っただけで、こちらには責任はない」と反論した。 この手の紛争について、裁判所の立場はおおむね一貫しているように思われ、似たような判断が各地で示されている。今回取り上げる判決はこうした考え方の大本とな
橋台支承部の応力度が許容値超え、落橋防止機能も確保されない状態に
2018年の西日本豪雨の影響で崩落した橋を復旧したが、設計ミスにより耐震性が不足していた。さらに、桁かかり長が必要な長さを満たしておらず、落橋防止機能が働かない構造になっていた。 中国・四国地方に甚大な被害をもたらした2018年の西日本豪雨（平成30年7月豪雨）。この豪雨の影響で広島県呉市の女垣内（めんごうち）1号線1号橋（以下、女垣内1号橋）が崩落した。市は18～19年度に約5335万円をかけて橋などを復旧したものの、設計ミスが原因で完成後に補修工事を実施するはめになった（資料1）。 復旧した女垣内1号橋は、橋長9.9mで、幅員5m。上部構造はプレストレストコンクリート桁で、下部構造は直接基礎の逆T式橋台2基で構成されている。耐震性能を確保するために、2つの橋台それぞれの支承部に長さ0.58m、直径28mmのアンカーバー5本を設置した。 しかし、会計検査院は復旧した女垣内1号橋は耐震性が
新築住宅に1年住んでわかった後悔ポイントとおすすめ設備 - 若くない何かの悩み
新築住宅に住み始めてから1年経過しました。この1年を振り返ってよかったポイントや後悔ポイント、おすすめ設備を紹介します。 よかったポイント 後悔ポイント トイレの照明スイッチの位置がドアに向かって左右逆だった 問題 有効そうな予防策 対応策 トイレの照明を人感センサーにし忘れた 問題 有効そうな予防策 次善の対応策 追記（2024/01/09） トイレのタンクを断水時用に貯水タンク付きにしたつもりが付いてないかもしれない 問題 有効そうな予防策 次善の対応策 予定外に常設のテレビを設置することになり準備ができていなかった 問題 有効そうな予防策 次善の対応策 リビング階段にカーテンレールつける準備ができていなかった 問題 有効そうな予防策 次善の対応策 蓄電池の容量が少なかった 問題 有効そうな予防策 次善の対応策 エコキュートが昼間に沸き上げしてくれない 問題 有効そうな予防策 次善の対
クリーンアーキテクチャの功罪
クリーンアーキテクチャというと設計における銀の弾丸のように扱われていて、クリーンアーキテクチャを導入するという記事をよく見ます。しかし自分の経験だとクリーンアーキテクチャで書かれているのにもかかわらず開発効率が落ちているという事が多く、いつでも使っておけばいいというものではないと思っています。 最近目にしたクリーンアーキテクチャに対する批判 本筋ではないので詳細は省きますが、あるとき[1][2]にUncle Bobの著書であるCleanシリーズへの批判をXで見ました。 ここで一番載せたかったものが今見つけられないのですが、以下のようなポストがありました。 書籍クリーンアーキテクチャに書いてある内容を抜きにして起こった現象だけを見るとマイナスの方が多い このポストが自分の感じていることを端的に表現できているように感じました。書籍クリーンアーキテクチャの内容を悪いと思いませんが、その影響により
バカみたいに明るい日本の家を何とかしたい…建築家が｢照明が暗い｣という家主のクレームを無視し続けた理由 夏場でもサングラスなしで平気な目に進化した日本人
畳の上にちゃぶ台を置けば、6畳間はダイニングへ 日本の住宅の照明は、部屋のすみずみまで均一に照らすものが久しく好まれてきた。天井の真ん中に鎮座する巨大なシーリングライトがその象徴である。 いわゆる高級マンションを除けば、賃貸物件の照明はいまも天井の真ん中に取りつけるものが一般的だ。シーリング（ローゼット）と呼ばれる照明器具の取付口が天井面にすでにあり、賃借人はその金具を目がけて好みの照明をセットする。 嫌なら使わなければよいのだが、ありがたく使わせてもらっている人が大半だろう。借家歴30年の私も、使わなかったことは一度もない。 部屋のすみずみまで均一に照らすあかりは、「部屋の用途を規定しない」という昔ながらの暮らし方にも都合がよかった。 部屋の用途とは、部屋で何をするのかという主な利用目的のことだ。現代における部屋の用途は平面図を広げればすぐに分かる。キッチン、ダイニング、主寝室……部屋の
猛吹雪によって京都駅内のミスタードーナツが大変なことになってしまった模様「どういうこと…？」「哀愁漂う」
は(・ε・｀ )こ🎌女流フリージャーナリス卜 @eviI_HAK0_21 京都駅、京都タワー側は完全に吹き抜けのスカスカだからこういう時Twitter映えするわね(悪意のある表現
COBOLをJavaで「リライト」の愚、SI企業の良識はどこに？
SI企業の強み・弱みを分析し、SIビジネスの先行きについてまとめた書籍『SI企業の進む道 業界歴40年のSEが現役世代に託すバトン』。同書から抜粋し、「誰も指摘しなかったSI企業の課題」を連載で指摘する。今回は、SIerがユーザー企業の要望に応えられない根源的な理由を探る。（技術プロダクツユニットクロスメディア編集部） 既存ITシステムの問題をユーザー企業以上に理解しているのはSIerである。ところが、その問題をユーザー企業に説明し、対策をとろうとはしない。ではなぜ、SIerのIT技術者たちは口を閉ざしているのだろうか。 その答えはこうだ。問題を説明した後に「では、どうすればいい？」と問われても答えられないからである。つまり、既存ITシステムの変革をどのように行えばいいのか分からないのだ。 情報処理推進機構（IPA）が平成29年に出したレポート「システム再構築を成功に導くユーザガイド」には
いわゆる受託開発における「プログラミングは簡単な部類」は本当なのか - Qiita
上記ツイートについて、いわゆる「受託開発企業」で働く私の印象としては、本当にその通りだな〜と思います。 そして、これまであまり意識しておりませんでしたが「受託開発における納品（完了）までの各フェーズ出し」をしてみようかと思います。 受託開発における納品までの各フェーズ出し １. 問い合わせへの返答 「お問合せいただきありがとうございます。それでは早速Webミーティングにて詳細を」 ２. 第１回Web打ち合わせ「お互い紹介」編 会社スライドにて自社紹介。依頼内容の確認・質問。 できればここで「依頼内容に対してのざっくりの予算感」をさりげなく聞きましょう。奇想天外な予算を想定しているパターンもあります。 ３. 見積もりの作成 できるだけ素早く見積もりを作成し提出すると吉。（早いと喜ばれやすい） 保守費用についても記載してくださいね。（後で聞かれるパターン多い） 見積もり項目は細かい方が信頼度は
石井マークさんによる子ども向けの遊具の構造設計基準について「手作り遊具をすべて否定するものではないが、基準が厳しい理由は知ってほしい」
株式会社石井マーク @ishiimark_sign 標識・銘板の㈱石井マークです。 弊社は 表示という視覚的アプローチによって、防災や防犯、設備分野など様々な産業シーンに「安全」「効率」「伝達」の手段を提供します。 Twitter上からはご注文や納期照会等を受け付けておりません。 会員様向け見積専用サイトは ishiimark.jp をご利用下さい。 ishiimark.com 株式会社石井マーク @ishiimark_sign ご家庭、保育所・児童福祉施設などで「手作りの遊具」や「善意によるオリジナル遊具」を用いる事の全てを必ずしも否定するつもりはありません。 しかし遊具の設計基準では 隙間や開口部の幅、V字構造の角度や向きまで厳しく定められている理由だけは知っておいて下さい。 下手すると普通に死ぬのです。 pic.twitter.com/Q01ivc4WGA
設計書・仕様書のレビュー方法を定めたJIS規格登場 チェック体制を標準化しやすく
経済産業省は11月22日、システム開発時に使う設計書・仕様書などの「作業生産物」のレビュー工程についてJIS規格を制定したと発表した。仕様書などの見直し方や観点などを規格化し、ソフトウェアの品質向上や開発の効率化を促す。 「JIS X 20246」は、設計書・仕様書の見直し作業を「計画作業」「レビューの立ち上げ」「個々人のレビュー」「要検討項目の共有および分析」「修正作業および報告作業」の順に整理し、実行するべきタスクや手順を規定するもの。システム開発や試験、保守などの場面で作るあらゆる仕様書に適用可能。 レビューの曖昧さをなくすため、「目的」「役割」などのレビューの観点10種、「執筆者確認」「同僚との机上確認」などのレビュー手法9種を定めた。JIS制定により、組織や個人のノウハウに依存することなく一定水準のレビューができるようになり、ソフトウェアなどの制作物の品質向上につながるとしている
新国立競技場に行ってきました | 株式会社東和不動産一級建築士事務所のブログ
まずは新国立競技場の象徴ともいえる木でつくられたルーバーなのですが、近づいて見上げてみると吊り天井に使われる吊り材に木を打ち付けただけという、とても安易な施工であることがわかります。
🍛wara🍊bi on Twitter: "家これから建てる人へ ・エアコンの配管は美しくなくても外に出せ、いつか配管を変えなくてはいけない時壁の中だと壁破壊しないと変えられず詰む ・配線図は必ず残せ、できる限り新設の配線ができるように多めに作っておけ 光ファイバーに変えるときに死ぬ ・西側に窓を作るな ・西側に窓を作るな"
家これから建てる人へ ・エアコンの配管は美しくなくても外に出せ、いつか配管を変えなくてはいけない時壁の中だと壁破壊しないと変えられず詰む ・配線図は必ず残せ、できる限り新設の配線ができるように多めに作っておけ 光ファイバーに変えるときに死ぬ ・西側に窓を作るな ・西側に窓を作るな
オワコン大手SIerに学ぶアンチパターン - Qiita
軽い読み物としておもしろおかしく読んでください。 はじめて社外の人の仕事を見た 今まで社内の成果物しか目にしてこなかったのですが、ふとしたきっかけで外部ベンダーが作ったシステムを移行することになりました。 会社名を見て、よく知った会社でちょっと安心しました。 「ここなら設計書とかもきちんとしてるだろう、多少古臭くても堅実にやってるんじゃないかな」って思ってました。ええ。 実態は全然違った とんでもない量のExcelが設計書として渡されました。 さすがに設計が専門だけあって設計書の量はすごいなぁ。と思って読んでいるといろいろ察してきました。 正直、「オワコン大手SIer」と呼ぶしかありません。設計しかできないと思っていたのに、何もできないなんて・・・ 実際に自分が見た「オワコン大手SIer」のアンチパターンをご紹介していきます。 自分が多く当てはまっている場合は今すぐ直してください。移行する
日本のプログラマはレベルが低い
日本のプログラマでマスを占めてるのは、大規模SIのコーダーじゃん？ そんで、そこでのお仕事はExcel方眼紙に書かれた設計書を、ひたすらプログラム言語に翻訳するだけという。 だから翻訳するために最低限の言語仕様だけ知っていれば良くて、あとはまあ上手に立ち回るコミュ力があれば上出来とされるけど、あくまでオプション扱い。 仕事そのものには数学的素養どころか、理系的センスすら全く不要。 つまり、SIにおけるプログラミングは工学でも自然科学でもない。 そんな知識がなくても務まるし、実際備わっていない人が大半。 だからSIにおけるプログラマはどう間違ってもエンジニアではない。 もしエンジニアなどと言ってしまったら、他の分野の「正しい」エンジニアに失礼だろう。 というか、エンジニアと呼べるレベルには程遠いと言い換えてもいい。 まあライン工としては一人前だと思うが。 以上のことから結論づけると、タイトル
親に見つからず夜遊びするために『マンションの4階まで外壁よじ登ってた兄』の話→亡くなる事例も多いのですぐやめよう
bao @baobabustroll 子供の夜遊びをチェックするためにリビング通らないと部屋に行けない設計のお家は良いってツイートを目にしてその通りなんですけど、夜遊びの度にマンション4階まで外壁をよじ登ってベランダから帰ってきたのをとうとう通行人に見つかって通報された兄の話をするべきは今だと確信しました。
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
みずほ銀行のシステム開発裏話、なんかもう俺らからすると当たり前すぎて、逆に何言ってるか解らなくなるまである→「これはひどい」
とある施設の階段およびスロープがあまりにもな設計で頭が混乱する「デザインの暴力」「これは危険すぎる」
設計解がないと思われた製品にエースエンジニアが投入され、翌日あっさり大枠をまとめて来た→その解決方法がカッコよすぎた
「建てる意地と売らない意地」用地買収に失敗した建物シリーズがなかなかにエグい「イオンの駐車場が邸宅を囲んでる」
