- 締切済み
設計書を作らないスタイルだったのですが
私が以前勤めていた企業は独立型のSIerで、大手企業の業務を 受託でやっていました。 私は、 ハードよりのソフトウェア開発 ...........(1) オリジナルの試験環境作り ...........(2) をやっていました。 いずれも技術資料を読んで仕様・設計を考えて作っていくもの でしたが、顧客の注文・要望もあり、いずれもフローチャートや Wordなどでドキュメントしっかりとをつくるようなことはしませんで した。そして、 (1) → 事前のミーティングで、Excelで作った簡単な図を使って 「～な感じでコーディングをします」とレビューをして、 メンバー全体が納得をしたら、あとは詳細設計書は作成せ ずに、コーディング。 (2) → 週に1,2回の割合で開かれるミーティングで、事前にある 程度、考え出した仕様を説明した後、作成段階に入ると 最新版の環境を顧客にデモして、修正を入れながら 作り上げていく。 という流れでやってきました。 これは、コーディング、作成だけでなく、設計といえるのでしょう か？ドキュメントは出していないので、微妙だと思っています。 それと、これから新しい職場を考えていますが、面接の場で、 これは設計をしていないというべきなのか、どう言えばベターなのか がわからなくなっています。顧客は名の知れた企業なので こういったスタイルもそれほど珍しくないのかな、とも 思うのですが。 みなさまどう思われますか？お願いします!! ※(2)は、試験環境ですが、コマンド一つで何千通りの試験を オプション付きでする環境で、それ以前に似たような環境がなく 位置からアイデアを出してC/C++やBasicを組み合わせて作るという ものでした。
- izumi-mach
- お礼率86% (32/37)
- SE・インフラ・Webエンジニア
- 回答数4
- ありがとう数6
- みんなの回答 （4）
- 専門家の回答
みんなの回答
- jacta
- ベストアンサー率26% (845/3158)
- lv4u
- ベストアンサー率27% (1862/6715)
その昔テストプログラムを作成して居た時は、（某メーカ） 企画書を頂き、それを元にフローチャートを作成して、書類にプログラム記載しその後PL/Iでコーテングしています。 そして最後に詳細な手順書を作成していました。 担当が元のプログラムを作ったのですが、追加の事を考慮して無かったし、書類自体も存在して居なかったので『０』から書き直しました。 （愚子は助っ人として担当しました。３昼夜連続勤務して） ニューフェイスに説明するとしてもやはり有る程度ドキュメントが無いと作業が理解出来ないのではと考えます。
お礼
お答えいただき感謝します。 そうですね。やはりドキュメントがないとあとで困ってしまいますよね。モジュール設計書は作ってよかったと思います。
システムの内容によるとは思うのですが（INとOUTのフォーマットが明確ならそれでいいこともあるかもしれない） ドキュメントなしでISO9001などはどうされているんでしょうか 議事録などで代替することができるんですか？ メンバーの頭の中にしかない仕様だとあとあとたいへんな気がします （詳細なフローは作る必要はないと思っていますが。）
お礼
お答えいただき感謝します。 ＞ドキュメントなしでISO9001などはどうされているんでしょうか ＞議事録などで代替することができるんですか？ ＞メンバーの頭の中にしかない仕様だとあとあとたいへんな気がします (１)は、ファームウェアの開発ですが、詳細設計書(モジュール設計書)は結局作らず、レビューで使ったExcelのドキュメント（設計方法の概略を書いたもの）を提出しました。それと結合試験のドキュメントを最後に提出しました。 （２）に関しては、環境完成後、使用手順書を作成し納品物として提出しました。（結局、設計・作成方針に関しては、顧客との相談の中で決めていき、完成後にその話の内容をまとめたということになりますね。） 議事録も納品として、そのまま提出しています。しかし、提出後のことに関しては、顧客にしかわからず、私にはわからないのです。
関連するQ&A
- 設計について
プログラム作成を他人に依頼できるように設計書を作りたいのですが、書き方がわかりません。その設計書があれば誰がコーディングしても同様のものができるような設計書を作りたいです。 そこで、ソフトウェアの設計の入門書で良書はありませんか？SE関係の本を書店で読んだところ、それらは依頼者からの要求を仕様書に落とし込むような技術を説明しているような本でした。そういったものでなく作るものが決定していて、それを作る際の指針となるデータ構造やGUI設計といったものの参考となる書類の作成をしたいです。 一般論でお願いします。
- ベストアンサー
- その他（プログラミング・開発）
- 仕様書？設計書？要件定義書？
仕様書・設計書・要件定義書、これらの違いがいまいちパっとしないのですが、どう言う違いがあるとかんがえたらよいのでしょうか？ 要件定義書は顧客の要求をまとめたもので、それに基づき作成するものが仕様書と理解していますが、仕様書と設計書の違いとはどのような違いでしょうか？ 境界の目安がわかればおしえていただけるでしょうか？ また、システム設計書と外部設計書の違いもいまいちわかりません。 教えてください。 よろしくお願いいたします。
- ベストアンサー
- SE・インフラ・Webエンジニア
- ソフトウェア設計書の書き方の例を学びたい
趣味で、C++のプログラムを勉強していて、アプリを作ってみたりしています。 プロの人たちはどういった設計書を書いているのか、その実物かそれに近いものを見てみたいな、と思うようになりました。 自分もそんな手順でアプリを作れるとかっこいいなぁ、と。 (業務用殆どの資料は、外部への公開が厳禁というのが普通でしょうけど。) 今は、部分的な流れ図とかスレッドの機能や連携を少し考えて、トライアンドエラーでいきなりコーディングしています。 試験にいたっては、かなり適当です。 どこか、公開のソフトウェアで、設計書や要求仕様書(要件定義？)も一緒につくっているものがあれば、参考にしたいので教えて欲しいです。★ (ソースフォージなどの公開プロジェクトはどうやって連携してつくっているのでしょう？) もしくは、設計書の学習用のWebサイトがあれば、とても助かります。 かなり漠然としていて、範囲が広すぎると思います。 少し検索してみると、ウォーターフォールモデルというのが多いみたいな雰囲気だったので、これと、 プラス、C++でオブジェクト指向も使ってみているので、それに関連するあたりで学びたいです。 書籍でもOKですが、要求から試験完了まで、ひとつ以上の例題を一連でとりあつかったものでないと漠然としていて学び取れないと思っています。 (あまりきつそうであれば諦めます。仕事ではないので…。)
- 締切済み
- C・C++・C#
- プログラミングの一般論
C++でプログラムするときに、 一般的にどんな手順で行いますか？ 非オブジェクト指向型の言語では、 フローチャート書いてそのままコーディングできると思うのですが、 C++の場合だと、徹底的に設計をしておかないと後で かなり困ることになると思うんです。 また、実際のコーディングの時は、 classごとにまとめて書いたほうがいいのでしょうか？ （今日はこのclassを、明日は別のclassのコーディングをしよう、みたいな感じです。） それとも、メンバ関数ごとに書いたほうがいいのでしょうか？
- ベストアンサー
- C・C++・C#
- 受託加工の営業に求められる資質とは？
受託加工といった製造業のメーカーの営業にどのような資質が求められるのでしょうか？ 受託加工ですので、決まった製品や定価というものは一切在りません。 出来合いの製品を売り込むということはないです。 顧客から製作図面をもとにその仕様通りに製作します。 商談相手は開発・設計をしているエンジニアの方々です。
- ベストアンサー
- 転職
- 仕様書や設計図の出来不出来について
OA事務派遣としてここ数年、各外注社員の方が作成した仕様書の校正を行う機会が多いのですが・・・ 社員さん曰く、「素人に読んでもらったほうが、指摘箇所が発見しやすいから。。」との事で、フローチャートと文章化した仕様書を読むのですが・・・素人の私でも解読出来る仕様書と社員さんでも解読出来ない仕様書にはっきり分かれます。そして結局、丸ごと社員さんが一から再作成や再翻訳・追記をする事になるのです・・・戸惑い。 この差は一体、どこからやって来るのでしょうか？ 使用経験がないハードやソフトの仕様書や設計図を起こす時、こういった現象が起こるのでしょうか？ 私の場合、機能自体の設計記述もれを見つける事が多いので、エンジニアさんに対して、蛇足的な指摘してんのかなあ・・・と心配になってくるのですが。 私は新卒時代から、金融系の契約書の記述ミスを校正する仕事が多かったので、どうしても発見してしまうのです・・・ プロジェクトが遅延気味なので、自分としても、余計な指摘をして、工数を増やしたくないのですが、細かい指摘って、正しい事ですか？無駄な事ですか？
- ベストアンサー
- SE・インフラ・Webエンジニア
- 設計事務所から不動産業者への紹介料について
設計事務所を開設している者です。 不動産業者から顧客を紹介していただいた際の紹介料についてご意見をください。 昨年、不動産業者より 「土地の購入を検討されている顧客が居るのだが、その敷地にどんな建物が建てられるかプレゼンをして欲しい」 との依頼を受けました。 配置図、平面図、3DCGパースを作成してプレゼン資料を作成し、不動産業者へ渡しました。 資料作成には５日ほど費やしましたので、１５万程度の作成費ですが、 この不動産業者からは初の依頼で、事前の料金の話もなかったこともあり、 自己紹介も兼ねてプレゼン料は請求せず、無償でプレゼンしました。 半年後、プレゼンした顧客に土地が売れ、建物の計画案も気に入っていただけたので、 不動産業者を通じて、顧客が当設計事務所との面通しを希望され、顧客と直接設計契約に結びつきました。 その後は顧客と直接打合せを重ね、現在、設計も完了し、現場が着工した段階です。 そこで不動産業者より紹介料の請求を受けています。 不動産業者からの紹介料は「設計料の10％」との数字が出ています。 私としては、今後も不動産業者と上手にお付き合いをしていきたいと考えています。 そこで今回も含めて、今後のお付き合いの形として、紹介料の取り決めを不動産業者へ提案したいと思っています。 以下の内容で不動産業者へ提案したいと考えているのですが、ご意見をお聞かせください。 －－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－ 今後予想される紹介のケースとして３つ考えられました。 (1)特命紹介 不動産業者より当建築設計事務所のみへの特命の顧客紹介の場合。 特命紹介の際は、設計料の10％を紹介料としてお支払する。 計算の際の設計料は、経費を除いた額とする。（構造設計料、設備設計料、その他下請けへの支払等） (2)コンペ形式 土地購入済みの顧客に対して、設計事務所数社の提案によるコンペによって仕事へつながった場合。 競合会社数で上記特命紹介の紹介料を割った割合の紹介料をお支払する。 例／コンペ参加社数２社の場合は、特命紹介料の1/2（設計料の5％）、 ３社ならば1/3（設計料の3.3％）という割合です。 (3)提案形式 土地購入前の顧客に対して、当設計事務所のプレゼン資料を用いて土地の売却につながり、当社の設計業務へつながった場合。 設計事務所のプレゼン資料を用いて、土地の売却が決定し、設計の仕事へつながった場合は、プレゼン資料が不動産業者の土地売却の営業の一貫を担う役割を果たしていますので、プレゼン料金と紹介料は相殺したいと考えます。 またプレゼンにより仕事に結びつかなかった際には、プレゼン作成費の請求はせず、成功時の紹介料が複数回のプレゼン作成費と相殺するとします。 要するに、共に紹介料とプレゼン作成費は発生しないという考え方です。 －－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－ 上記の提案をしようと思っております。 現在進行中の工事は(3)に該当し、今回請求を受けている10％の紹介料は、 プレゼン作成費と相殺としてもらおうと考えています。 不動産業者へは今回の物件で、信頼と実績は築けていると思っています。 私の作るプレゼン資料で土地の販売の促進になるので、 業務提携の形としては成り立っていると考えています。 一般的に不動産業者から設計事務所が顧客の紹介を受けた際に、 紹介料が発生するとした場合、どの程度の額が妥当なのかも教えていただけると有難いです。 私の考え方に助言・アドバイスを頂けると有難いです。 どうぞよろしくお願いいたします。
- 締切済み
- 研究・開発・技術職
- SIerの上場企業と非上場企業
メーカー系SIerの上場企業と非上場企業の両方から内定を頂いた就職活動生です。 どちらの企業に行こうか悩んでいます。 SE職で内定を頂いています。 上場企業で働いた環境と 非上場企業で働いた環境のある人からお聞きしたいです。 Q 働く上での環境の違いは、どのようなものですか。 例えば、非上場での企業なら親から降りてくる案件が多いから最終責任は親にあるので、それほどピリピリしていないとか、逆に上場して独自に開拓した顧客の案件は、直接、顧客と顔を合わせるので緊張感があったなど
- ベストアンサー
- SE・インフラ・Webエンジニア
- 業務運営が出来ていない場合の対処
毎度お世話になっております。 私は組込み系の開発を行っている企業に勤めているのですが、 弊社の業務フローで悩んでおりご質問させて頂きました。 以前(約1年前)に開発案件受注から設計書作成・コーディング・テスト→納品との流れが判る業務フローを作成し、運用しているのですが・・・ (作成までその様なフローはなくその場仕事でした) フローの流れが守られておりません。 フロー自体は複雑ではなく、受注→基本設計→詳細設計→テスト→納品との流れを図で記述した程度のものです。 現状、受注を受け基本設計が作成終わるか終わらないかでコーディングをし、仕様も明確になってないままテストを行っており客先納品の間際になって詳細設計を作成し納品している状況です。 このままでは、不具合の乱立・仕様検討不足による漏れが出てもおかしくないと思います。 ルールを細分化し厳守させようとしましたが効果薄でした。 口頭による仕様変更追加等も多々あります。 フロー通りに運営するにはどこから手をつけていくかすら不明になっています・・・ アドバイス・経験談などありましたご教授お願いしたいと思います。
- ベストアンサー
- コンサルティング
- Linux系での開発ドキュメントの作成・管理
今日人生ではじめての転職をしました。 Linux環境で開発ドキュメント（UI仕様書や、データ設計書など）を 作成する際に、どのようなツールを使用していますか？ また、ドキュメントのバージョン管理にはどのようなソフトを使用していますか？ オススメがあれば教えていただきたいです。 昨日までの会社ではWindowsベースでの開発環境だったため、 開発ドキュメントの作成にはVisioやExcelを使っていました。 今日から勤務する会社ではLinuxベースの開発環境なのですが 現存するドキュメントが全く無く、参考にするものがありません。 困った困った・・・
- ベストアンサー
- その他（ITシステム運用・管理）
- フリーターで月に10万程の収入を得ている場合、社会保険に入ると手取りが少なくなる可能性があります。
- 一方、社会保険に加入すれば、将来的なリスクへの備えや福利厚生などのメリットがあります。
- 社会保険に入るかどうかは、将来の安心感やリスクにどれだけ重きを置くかによって判断する必要があります。
お礼
どうもご回答ありがとうございました。 一般的にOutputとなる設計書はあると思いますが、内容がやはり重要だなと思いました。 ＞最近は、Doxygenなど、C++,Javaソース等から、きれいな資料を生成する無償ツールなどもあります。もちろんこれで全ての資料を作ってくれるわけではないですが。 これは全然知りませんでした。 とはいうものの、やはり、これからは設計書をがっちりつくる機会があるに越したことはないので、そうなれたらいいなと思いました。