ソフトウェアの「詳細設計書」とはなんなのか - きしだのHatena

2024/08/15 245 users きしだのHatena ソフトウェア 整合性 抽象化 構造

「設計書」というのは、作るものの構造を抽象的に表現したものと言うことができます。 ただ、ソフトウェアの抽象化の仕組みはプログラミングコード自体に備わっているので、ソフトウェア生成可能な抽象的表現というのはコード表現ができるはずですね。コードで表現しておくと、整合性のチェックとかも行いやすいです。 ... 続きを読む

「ソフトウェア設計仕様書（SDD）」の作成方法、仕様書に含めるべき内容とは

2024/08/09 26 users SDd DevOps ソフトウェア ヒント 構成要素

「ソフトウェア設計仕様書（SDD）」の作成方法、仕様書に含めるべき内容とは：優れたソフトウェア設計仕様書を作成するためのヒント ソフトウェアの設計書は、DevOpsの時代になっても、ソフトウェア開発ライフサイクル（SDLC）の重要な構成要素として位置付けられることは変わらない。ソフトウェア設計書が重要な理由、... 続きを読む

「わし詳細設計書書くのやだよ」システム開発で細かければ細かいほど仕様変わった時の変更が爆増してメンテコスト爆上がりする。かけるべきコストはそこじゃない話に賛否両論

2024/06/15 187 users 賛否両論 コスト 仕様 システム開発 変更

しのゆ𝕏酒くずエンジニア @shinoyu 新宿で社長やってるソフトウェアエンジニア18年生のおかまちゃん / 💻技術🎧 V系 🎀ロリィタの人 / 170スペ109 スプリング、骨ウェーブ、顔ソフエレ / 絡みない鍵とスパムは🚫 / 原則IT関連業のみフォロー /たまに会えるかも @shinjukudist しのゆ𝕏酒くずエンジニア @shinoyu わし詳細... 続きを読む

設計書などドキュメント類は一切作りません！でもその代わりシステムの出来上がりは超速で価格も激安です。っていうベンダーの存在を知った

2024/05/29 25 users ベンダー 支社 TETRA_IT ドキュメント類 超速

てとらα SI @TETRA_IT 設計書などドキュメント類は一切作りません！テスト結果もありません！でもその代わりシステムの出来上がりは超速で価格も激安です。っていう恐ろしい地方ベンダーの存在を知った。とにかく安く早くを求める地方企業や支社などの要望とマッチして管理不能なシステムが量産されてる 2024-05-28 09:2... 続きを読む

SEってよく質問に対して「○○という認識です」って言い回し使うけど「事実を教えてくれ」って思ってしまう→いや、「認識です」にはちゃんと理由があるんだというツッコミ

2024/03/19 435 users ツッコミ 事実 認識 質問 理由

ちょめ子 @chome2xx 私「この機能って今使われてますか？」 ？「今は使われてない認識です」 私「設計書って更新されてます？」 ？「更新されてる認識です」 いや、認識じゃなくて事実を教えてくれって思ってしまうのだが、SEこういう言い回し好きだよね 2024-03-18 10:02:14 続きを読む

サイカの即戦力を生む2つの設計書 - XEP と Architecture Guide - XICA Tech blog

2023/07/14 18 users サイカ 鹿島 株式会社サイカ Design Doc プロセス

はじめに 皆さんこんにちは。株式会社サイカでソフトウェアエンジニアをやっている鹿島(kashitaka)です。 皆さんの開発組織では設計書（Design Doc）をどのように運用していますか？ Design Docをめぐる運用は開発組織全体の広い取り組みとしてプロセスに落とすことが難しく、チームごとに独自で運用しているなど取り組... 続きを読む

markdownlintで設計書の品質を高める | フューチャー技術ブログ

2023/04/17 125 users GitHub Markdown GitLab TIG真野 品質

はじめにフューチャー技術ブログのリレー形式の連載である、春の入門祭り2023の1日目です。TIG真野です。 ここ数年、Markdownで設計書をチームで書き、GitHub（GitLab）上でレビューするフローを採用しています。なるべくテキストベースで設計開発フローを統一するため、私の所属するチームでは以下のようなツールを採用... 続きを読む

【インフラ】障害事例から学ぶ設計/手順レビューの勘所 - Qiita

2022/12/17 10 users 領域 レビュー 手順書 属人化 インフラ屋さん

はじめに 設計書や手順書のレビューって最後まで残る 属人化・人のスキル次第の領域ですよね。 私の属人的知識を共有し、それを活用して2人分の属人化知識に 昇華する人が現れ、がどんどん回っていくことを願い、 The属人知識を公開します。 インフラ屋さんなので完全インフラ向け 障害事例を詳細に出すことはできないの... 続きを読む

GoogleのDesign Docsから学ぶソフトウェア設計 - Qiita

2022/06/23 271 users ドキュメント ソフトウェア 要素 Qiita ソフトウェア設計

概要 Design Documentと聞くと何を想像しますか？ 一般的にDesign Documentが指すのは設計書であることが多いのではないでしょうか。 設計書、簡単に説明するのであればソフトウェアを「どうやって作るの？」を説明したドキュメントです。 Googleではソフトウェアエンジニアリング文化における重要な要素として、今回お... 続きを読む

設計書・仕様書のレビュー方法を定めたJIS規格登場　チェック体制を標準化しやすく

2021/11/22 692 users JIS規格 観点 チェック体制 ソフトウェア 仕様書

経済産業省は11月22日、システム開発時に使う設計書・仕様書などの「作業生産物」のレビュー工程についてJIS規格を制定したと発表した。仕様書などの見直し方や観点などを規格化し、ソフトウェアの品質向上や開発の効率化を促す。 「JIS X 20246」は、設計書・仕様書の見直し作業を「計画作業」「レビューの立ち上げ」「... 続きを読む

設計書・仕様書のレビュー方法を定めたJIS規格登場　チェック体制を標準化しやすく（要約）

2021/11/22 89 users 工程 観点 JIS規格化 要約 経済産業省

経済産業省が設計書・仕様書などのレビュー工程をJIS規格化標準的なレビューの工程や観点などを規定成果物の品質や開発の効率化に期待 続きを読む

設計書には何を書くべきなのか - terurouメモ

2020/07/28 272 users terurouメモ

設計とは、 要求（やりたいこと）をヒアリングする 要求を要件（何を満たさないといけないのか）に落とし込む 要件を実現するために考えられる手段を洗い出す 手段の検証を行う 検証結果を元に、どの手段を使うかを選定する 選定した手段を合意する（一部要件を満たさない事項がある場合は、代替策や妥協ラインについて... 続きを読む

日本のプログラマはレベルが低い

2020/02/02 241 users プログラマ コーダー オフ Excel方眼紙 マズ

日本のプログラマでマスを占めてるのは、大規模SIのコーダーじゃん？ そんで、そこでのお仕事はExcel方眼紙に書かれた設計書を、ひたすらプログラム言語に翻訳するだけという。 だから翻訳するために最低限の言語仕様だけ知っていれば良くて、あとはまあ上手に立ち回るコミュ力があれば上出来とされるけど、あくまでオプ... 続きを読む

SIerに生息する「おじさんSE」の生態を知る - Qiita

2019/09/11 46 users Qiita SIer コーディング 生態 エンジニア

ここでいうおじさんSEとは、主にSIerに生息する、 ・30歳以上で ・モダンな技術を知らない ・レガシーな技術しか知らない ・主に設計書などのドキュメント類を弄っており、コーディングをしない ・現状から変わる気がない（キャリアアップに対し具体的なアクションがない） 人たちを指す。 決して単に妙齢のエンジニアを... 続きを読む

SIerに生息する「おじさんSE」の生態を知る - Qiita

2019/09/10 590 users Qiita SIer コーディング 生態 エンジニア

ここでいうおじさんSEとは、主にSIerに生息する、 ・30歳以上で ・モダンな技術を知らない ・レガシーな技術しか知らない ・主に設計書などのドキュメント類を弄っており、コーディングをしない ・現状から変わる気がない（キャリアアップに対し具体的なアクションがない） 人たちを指す。 決して単に妙齢のエンジニアを... 続きを読む

MarkdownとPlantUMLでソフトウェアの仕様書や設計書を書くための環境構築手順 - EurekaMoments

2018/12/17 126 users Markdown plantUML Graphviz 仕様書

背景・目的 Markdownで書くメリット Markdown記法一覧 環境構築手順 1. Visual Studio Codeをインストールする 2. PlantUMLをインストールする 3. Javaをインストールする 4. Graphvizをインストールする 5. Markdown Preview Enhancedをインストールする 環境構築後の動作確認 Markdownでドキュメントを書く際に便利な... 続きを読む

draw.io で書いた画面設計書いてみたらストレスフリーになった 〜 続・gitbookで設計書を作成したら最高だった話 - フォトシンス エンジニアブログ

2018/06/28 113 users GitBook フォトシンス draw.io 試行錯誤 僕自身

こんにちは フォトシンスでソフトウェア開発のマネージャーをやっている @ishturky です。 今日のエントリーは、以前書いた 「gitbookで設計書を作成したら最高だった話」の続きです。 akerun.hateblo.jp こんなコメントいただいております。 はい。これはとても悩ましいですね。僕自身もとても悩んでまさに試行錯誤して... 続きを読む

「設計書」が書けない設計者 | 日経 xTECH（クロステック）

2018/04/12 168 users xTech クロステック 日経 設計者

私の兄は建築士です。建築士の場合、例えば「森と調和する美術館」や「3世帯同居の一戸建て」などを設計する際に、そのコンセプトや予算に応じた規模、メンテナンス箇所、強度計算を含んだ「設計書」を作成し、コンペ（建築設計の競技）に臨んでいます。どうして、機械設計には「設計書」の単語がないのでしょうか？ この質問に対する私の回答はこうです。 【回答18】 恐らく、実務経験のない学者か誰かがそうした設計フロー... 続きを読む

開発とテストの段取りを工夫する | Think IT（シンクイット）

2018/02/20 18 users 区分け Think メインテーマ シンクイット 段取り

はじめに 本連載は開発を加速・効率化させる「ソフトウェアテスト」がメインテーマです。 前回 はこのテーマを実現するための全体的な戦略やアプローチを解説しました。今回は、そういった戦略やアプローチを考えるための、テストの種類や区分けを俯瞰的に解説していきます。 開発との関係から見るテストの役割 ソフトウェアテストは、テスト対象とテストベース（仕様書、設計書などテストのための資料）を入力にテストを実施... 続きを読む

エンジニア歴20数年の私が、設計書を書く際に心がけていること - Qiita

2018/02/13 1319 users Qiita word Excel 本稿 前提

はじめに 時の経つのは早いもので、私がIT業界に身を置いて四半世紀になってしまいました。 その間、膨大な数の「設計書（仕様書）」を書いて来ましたが、未だに悩み・迷いは尽きません。 それでも、 亀の甲より年の劫 とも申しますので、私なりの経験則を「個人」と「チーム」の両観点でまとめてみました。 本稿で前提とする設計書は、ExcelやWordで書かれた、フォーマルな設計文書、です。 したがって、自社サ... 続きを読む

gitbookで設計書を作成したら最高だった話 - フォトシンス エンジニアブログ

2017/12/26 416 users GitBook ishturk フォトシンス 要件 ツール

2017 - 12 - 26 gitbookで設計書を作成したら最高だった話 こんにちは。Akerunエンジニアの @ishturk です。 Akerun Advent Calendarの記事です。 今日は設計書の話です。 設計書をどんなツールで書くかは、僕らソフトウェアエンジニアの尽きない悩み（楽しみ）ですね。 最近はまったツールが最高に良かったので紹介させてください。 僕のツールに求める要件は... 続きを読む

すごい設計書 - システムに不可欠なセキュリティ対策、漏れを食い止める設計書3点セット：ITpro

2017/11/27 58 users ITpro クロスサイトスクリプティング セキュリティ対策

「セキュリティ対策はシステム開発で不可欠だが、設計書でうまく表現できている開発現場はまだ少ない」――。 ラックの永井英徳氏（エンタープライズ・セキュリティサービス事業部セキュリティディレクションサービス部長 兼 第一グループ部長）はこう指摘する。よく見られるのが、「クロスサイトスクリプティングの脅威には、Aフレームワークを利用することで対処する」などと、個別の脅威ごとに対策を記述するケースという。... 続きを読む

プログラマは裁量労働制の対象外、SEも場合によっては対象外に | スラド

2017/08/22 23 users Anonymous Coward 裁量 スラド 職種 一方

あるAnonymous Coward 曰く、 日本では同じような職種だと思われやすい「プログラマ」と「システムエンジニア（SE）」だが、SEは裁量労働制の対象である一方、プログラマは対象外であるという違いがあるそうだ（ Yahoo!ニュース ）。 プログラマは設計書に従って作業をするだけの職種で、「業務遂行の手段や方法、時間配分等を大幅に労働者の裁量にゆだねる必要がある職種」とはみなされないため。... 続きを読む

32TBにも及ぶ｢Windows 10｣のソースコードなどがウェブに流出 | 気になる、記になる…

2017/06/24 229 users 流出 ウェブ ソースコード 32TB Windows 1

The Register によると、32TBにも及ぶMicrosoftの｢Windows 10｣に関するソースコードがウェブ上に流出している事が分かりました。 流出したのは合計で32TBという巨大なファイルサイズになる公式及び非公式のインストールイメージやソフトウェアの設計書などで、今年の3月頃にMicrosoftの社内システムから密かに抽出されたものとみられています。 流出したコードなどの内容を... 続きを読む

astahで設計書とモデル、プロセスをつなぐ為の資料のリンク: プログラマの思索

2017/06/15 11 users Redmine 思索 プログラマ word Redmine大阪

astahの事例を探していた時に、設計書とモデル、プロセスをつなぐ為のアイデアが書かれた資料を見つけたのでメモ。 以下はラフなメモ書き。 間違っていたら後で直す。 【参考】 モデルへの参照を含む多様な設計情報の継続的統合ドキュメント化に向けて 【1】以前、Redmine大阪で宿口さんの講演を聞いた時、機能安全規格を満たすプロセスをRedmineで実現する話があった。 その実装方法を聞くと、Word... 続きを読む