詳細設計書ってよくわからない - 未来のいつか/hyoshiokの日記
わたしは、情報システムと呼ばれているものを作った経験がないので、よくわからないのだが、世の中には詳細設計書というのがあるらしい。 下記参照。 http://gm7add9.wordpress.com/2012/11/30/%E8%A9%B3%E7%B4%B0%E8%A8%AD%E8%A8%88%E6%9B%B8/ プログラムの詳細設計をやる人というのがいて、その人が書くらしい。あくまで自分には経験がないので、伝聞、想像でものを言っている。 プログラムの詳細設計というのは、プログラムへの要求仕様というのがあって、それを実現するために書くらしい。要求仕様というのは最終的な利用者が、こーゆーものが欲しいとか、こーゆーことができたらいいなということを、なんらかの方法で、なんらかの形でまとめたものらしい。 そんでもって、要求仕様を作る人と、詳細設計を作る人と、プログラムを作る人と、テストをする人と、
CSV実践講座 その1 ユーザ要求仕様書の書き方
＜連載 全12回＞ CSV実践講座（第1回） CSV実践について研究するページです。 ＊万が一文中に解釈の間違い等がありましても、当社では責任をとりかねます。 本文書の改訂は予告なく行われることがあります。 1. はじめに 昨年は「システムの信頼性保証の考え方」と題して、7回にわたり大所高所からコンピュータシステムの信頼性保証の確保に関する考え方を解説してきた。 本年は筆者のこれまでの経験をもとに、より詳細にCSV文書の作成方法について解説をしてみたい。 実際にコンピュータシステムを導入する際や、バージョンアップを行う際にいざCSV文書を作成しようと思っても、何をどう書いたら良いのかがわからない。 本シリーズでは、これまでに解説してきたシステムの信頼性保証の考え方を踏襲し、具体的にCSV文書の書き方を解説したい。おおよそ下記のようなスケジュールを予定している。 第1回 ユーザ要求
個人で作ったWebサービスの仕様書（Evernoteのメモ）を2つ公開してみる - アインシュタインの電話番号
個人でWebサービスを作る際の考察に関する以下の記事が、とても興味深く面白かった。ここに書いてあることはだいたい同意で、自分も実践したいと思うことばかり。 個人でWebサービスを超高速でつくる人たちの作り方を考察。 │ モノづくりブログ 株式会社8bitのスタッフブログです で、記事の最後に執筆者が聞いてみたいこととして「個人Webサービスの場合、仕様書はどうしてるの？」と呼びかけていたので、僭越ながら自分が過去に作ったWebサービスの仕様書（Evernoteに書いたメモ）を公開してみる。公開するのはNekostagramとはてなスターカウンターのもの。 仕様書（TODOリスト）の書き方 自分の場合、Webサービスを作るときに書くものは「仕様書」などと呼べるようなちゃんとしたシロモノではなく、Evernoteに思いついたことをどんどんリストアップしていくだけ。いわゆるTODOリストですね。
運用要求の概要
運用要求とは，システムが完成して実際に業務で利用することを想定して洗い出される，システムの運用にかかわる諸々の要求を総称したものである。当たり前のことであるが，システム構築はそれ自体が目的ではなく，システム構築プロジェクトの期間というのはひと言で言ってしまえば「準備期間」に過ぎない。システムが出来上がって実際に業務で利用することが「本番」なのだ。従って運用要求というのは，非常に重要な要求事項である。 しかし，システムを構築する以前の，RFPを作成する段階では「まだ先の話」として軽視されてしまうことがしばしばある。どうしても目の前のシステム構築に目が行ってしまい，運用は軽視されてしまうのだ。だが，システムは適切に運用されてこそ投資効果が生まれるのである。そのことをあらためて思い出すべきである。 また別の観点からも，運用要求は重要な役割を果たす。評判の悪いベンダーはいわゆる「売り逃げ」のような
鈴村さんが指南する業務フロー図の上手な書き方
まずは，業務フローの例を見てみよう。UMLのアクティビティ図で書いたのが（図1）である。スイムレーンに役割を書き，上から下（または左から右）に向かって業務の進行を書いていく。かどの丸い四角形で示したアクティビティが業務プロセスに対応し，矢印で示したフローが業務の流れになる。「誰が何をするか」が明確になる。 よほど定型化されたものでない限り，業務とは複雑なものである。厳密に書こうとすると，業務フローも複雑になりがちである。しかし，分かりやすさを重視するなら，一つの業務フローに登場するアクティビティはせいぜい10～15程度にとどめるべきだ。 複雑なフローを表現したければ，一部の業務フローを別に切り出して，サブ業務フローとして記述すればよい。親の業務フローのある業務プロセスの内部が，サブ業務フローとなっているというように階層化する。 スイムレーンには顧客や営業担当など役割を設定する。「松山さん」
開発工程でSEが書く文書の基本 − ＠IT自分戦略研究所
「提案書」や「要件定義書」は書くのが難しい。読む人がITの専門家ではないからだ。専門用語を使わず、高度な内容を的確に伝えるにはどうすればいいか。「提案書」「要件定義書」の書き方を通じて、「誰にでも伝わる」文章術を伝授する。 SEはさまざまな文書を作成する必要があります。その中でも、提案書や要件定義書の作成に悩むSEは多いようです。なぜなら、これらは「顧客に読んでもらわなければならない文書」だからです。 本連載では、「誰にでも分かる」提案書や要件定義書を作成するための文章術を解説します。ただし、分かりやすい文書を作成するには、文章術だけでは十分ではありません。必要な情報を顧客から引き出すためのコミュニケーション、文書全体の構成も重要です。 第1回では、SEが作成する文書はどのようなものかを概観します。第2回では、情報を引き出すための顧客とのコミュニケーションのポイントを説明します。第3、4回
こどものもうそうblog | 文章を書いたらチェックしたい17の項目
Selected Entries 文章を書いたらチェックしたい17の項目 (09/18) Categories WORKS (594) 講座 (236) game (153) BOOK (373) computer (23) iPhone&iPad (2) MOVIE (48) music (38) News Dig (23) PLAY (136) publication (52) web (20) web game (26) すごいよ！ (45) カード (15) ゲームをつくろう (3) ゲーム実習 (14) コックリさん (11) 気になるの (109) 写真 (24) 日々 (128) 萌え発想 (32) Archives August 2017 (1) April 2017 (1) December 2016 (1) November 2016 (1) October 2016
満足せる豚。眠たげなポチ。:業務システム開発でドキュメントを作ることについて
職場でここ３〜４ヶ月の間、システム再構成のためのドキュメント化プロジェクトというのを進めてきた。その中で『ドキュメントを書く』ということに対する意識が随分自分の中で変化したので、メモしておく。 まずは経緯から。 そのシステムは、いわゆるレガシーなシステムで、十数年来の歴史を持つ。これまで基盤が多少変わることがあっても基本的にソフトウェアアーキテクチャ（どのような単位で機能をモジュール化するか、どのように機能を抽象化し変化に対して柔軟にするか）に変わりはなく、作った当初の設計にツギハギしてメンテナンスを続けていた。 元々は、一体何をすれば増員以外の手段で開発量を上げられるかということを議論していた。現行のアーキテクチャのままでは求められる開発期間とバージョンアップのサイクルに対して近い将来限界を迎えることが明白であったためだ。 今のアーキテクチャや設計に問題があり、メンテナンス性を大いに損ね
業務フローとデータ・モデリングの設計のコツがいよいよ公開
ITベンダー9社が参加する業界団体「実践的アプローチに基づく要求仕様の発注者ビュー検討会」は2008年3月18日、外部設計を発注者に分かりやすく進めるガイドラインを公開した。業務フローとデータ・モデリングの2つだ。同日開催した記者会見では、今後の普及展開活動を情報処理推進機構（IPA）のソフトウェア・エンジニアリング・センター（SEC）が引き継ぐことも明らかにした（写真）。 ガイドラインは設計書の書き方とレビューの進め方の“コツ”を体系化したもの。外部設計手法そのものではない。業務フロー設計を進めるための「システム振る舞い編」では35個の書き方のコツと23個のレビューの進め方のコツを記述した。同じく、論理データモデル設計を進めるための「データモデル編」では書き方で16個、レビューで31個のコツを記述した。 ガイドラインの目的などを記した「概説編｣と、ガイドラインを読み進めるための用語30個
残業を減らすには、「最終完成物の摺り合わせ」のルーチン化から - モチベーションは楽しさ創造から
ある飲食店チェーンの会議での話。 そのクライアントは、現在、システム導入に向けての最終段階に入っています。 会議では、ベンダーさんがマニュアルを作ってきており、その確認作業をしていました。 マニュアルは完成型で納入されてはいたのですが、それを見て、クライアントの担当者の一人がベンダーさんに向けて、注文をつけ始めました。 貰ったマニュアルをベースに、チェーン店別、パート、社員、店長用という形で社内で再マニュアル化をする必要がある その為には、再マニュアル化がしやすい形でのマニュアルの納入してくれないか？（マニュアルのレイアウト、マニュアルの構成等） また、エクセルでマニュアルを作ってあるのだが、再マニュアル化をしていく為には、ワードでの納品が望ましいという要望が出てきたのです。 「再マニュアル化」の話は、何度も行っていたのですが、 ・マニュアルの完成イメージ（レイアウト、アウトライン構成、、
ユメのチカラ: 開発工程を別々に担当してはいけない
古典的なウォータフォールモデルでは、ソフトウェア開発を要求仕様分析、概要設計、詳細設計、実装(コーディング)、内部テスト、統合テスト、運用、保守みたいな工程にわけ、通常は各工程を別々の人が担当するというような方法がよくおこなわれている。 特に、要求仕様の分析、概要設計などは上流工程などとよばれていて、詳細設計、実装とは別の人ないしは組織が担当する。実装とかテストは下流工程などとよばれている。 よくあるパターンとしては元請けが上流工程を、下請け、孫請けが実装やテストなどを担当し、人月単価も下流の方が安い。 ウォーターフォールモデルでは各工程毎に成果物(仕様書や各種ドキュメント、プログラム)が大量に生産される。各フェーズ毎に定義された成果物がそろってから次のフェーズに移行するというのが建前なので、各フェーズでのドキュメントはどうしても冗長になりがちである。 一度固定した文書は次のフェーズで変更
HowToWriteAnEffectiveDesignDocument - 設計文書のうまい書き方
HowToWriteAnEffectiveDesignDocument - 設計文書のうまい書き方 目次 この文書について 設計文書のうまい書き方 なぜ設計文書を書くのか 良い設計とは何か 同僚の開発者に向けて書く 第 1 節に書くこと: プロジェクト/サブシステムの目的を示す 第 2 節に書くこと: 設計に使う高レベルなエンティティを定義する 第 3 節に書くこと: 個々のエンティティに関する低レベルの設計を書く 使い方 設定 モデル 相互作用 第 4 節に書くこと: 利点, 前提, リスク/懸念事項 マネージャ向けに書くこと 最後に 設計文書のうまい書き方 この文書について "How to Write an Effective Design Document" の日本語訳です. http://blog.slickedit.com/?p=43 推敲歓迎: 誤訳, タイポ, 訳語の不統一,
要件定義カード1枚8万円──脱・人月商売宣言 － ＠IT
「1タスク8万円」という価格体系を提示し、人月商売からの脱却を宣言するスターロジック代表取締役兼CEO 羽生章洋氏 「二度と人月商売はしません」──スターロジックは7月19日、都内で開催した自社イベント「StarLogic Conference2007」において、エンドユーザー自身による要件定義に基づき、「要件定義のカード1枚当たり8万円（税別）」という価格体系でシステム構築ビジネスを進めていくと発表した。従来の「人月」に基づく見積もりと比べて、1/3から1/5の価格になるという。 「人月換算でコストを請求する商習慣こそが、SI業界のさまざまな問題の根源。人月から脱却するには、納得でき、分かりやすい価格体系を提示することだ」（スターロジック代表取締役兼CEO 羽生章洋氏）。 低コストにできる理由は、ユーザー自ら要件定義を行い仕様を最初に明確にする点と、実装段階で自動生成により生産性を追求し
はてなブログ | 無料ブログを作成しよう
顔に見える？最近「送水口」が気になるという話 「送水口」が気になる今日この頃 最近街中で気になる存在、それがこの「送水口」です。地上のフロアが7階以上あるビルなど、一定の条件を満たした建築物には設置が義務付けられているもので、火事が発生したフロアにただちに水を送るために使われるものです。ポンプ車…
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Excel 方眼紙撲滅委員会 活動報告 2012.11 #odstudy
実践的アプローチに基づく要求仕様の発注者ビュー検討会 - NTTデータ
[Think IT] 【楽々デブドックを書こう！】開発☆ドキュン
Blog - Mikula Beutl