仕様書

技術広報のyayawowoです。 『仕様書』 と聞き、何の仕様書を思い浮かべますでしょうか？ また、仕様書と設計書の違いを説明できるでしょうか？ 今回は、仕様書とは何なのかをはじめ、種類や作成のポイントなどを分かりやすく解説したいと思います！ システム開発に携わる方は、是非ご参考になさってください。 仕様書とは 仕様書があると良いこと 設計書と何が違うの？ 仕様書の種類 要求仕様書 機能仕様書 技術仕様書 テスト仕様書 良い仕様書とは 要求事項漏れがない 図表を使い、丁寧に説明している 機能の振る舞いを明確にしている おすすめ書籍 ラクスの特徴 終わりに

新人OJTネタです。 前回に続き、機能開発における仕様書のレビューについて。 coublood.hatenablog.com 仕様書のレビューをやっていますが、不思議とグルグル回ることが多々ありました。 1ページに大量の文章を書きすぎていて、全然情報が整理されていなかったので、「図や表を使って情報を整理してください」と指摘します。 そして次のレビューには、文章がすっかりなくなり、箇条書きや表と図で出てきました。 その表や図がものすごい大作。 超巨大でどこから読んでいいかがわからない…そもそも何についての表なのかがわからない。情報量が多すぎて、逆にわかりにくい。 図も、矢印が飛び交っていて、結局…

新人OJTネタです。 機能開発における仕様書のレビュー。 今回、仕様を説明するために、初めて仕様書を自分で書いてもらうことに。 そして、その仕様書の説明会に向けて、まずは個別にレビューで説明してもらいましたが… ・・・うん、分からん（笑） 第一印象は、何を言っているかがチンプンカンプン。 最初に出てきた初版を見ると、文字がずら〜〜っと書いてある状態。 箇条書きもなければ、図も表もない…。 国語のテストとかでよく見る「長文」が果てしなく続いているような感じですね。 ・・・ちょっと目を離すと、今どこを読んでるんだ？というような内容。 これでは、聞いている方は何が書いてあるかがさっぱり・・・。 なの…

draw.ioってめちゃくちゃ便利ですよね。最近は何をするにしてもdraw.ioを使用している気がします。例えばこんなときに私はdraw.ioを書いてます。 メンバーにシステム感のつながりを教えるとき terraformなどで構築したAWSのドキュメント オフショア開発でベトナムで開発しているヒトに仕様や実装の方針を伝えるとき chatベースでは伝わりにくい時に図を書いて渡す 今回は、オフショア開発でベトナムで開発しているヒトに仕様や実装の方針を伝えるときにやってみた話をお伝えします。 draw.ioで仕様書を書く意味って何？ それぞれの職場で各々仕様書の書き方は違うと思います。私の職場でもそ…

FRAM(強誘電体RAM)をアクセスするためのFPGAをテーマに、FPGAを設計するまでの一連の工程を記載して行こうと思います。 ブロック仕様 Verilog-HDLによるコーディング シミュレーション(RTLシミュレーション) Platform DesignerとFPGA Topの作成 論理合成とインプリメント NiosIIのコーディング NiosIIを含めたシミュレーション 本記事では、まずはブロックの仕様を記載します。 (後半に、FRAMとインターフェイスを行うSPIブロックのVerilogコードも記載しています。) ※FRAMのモデルは「CY15B102QN」となります。 (ちょうど、…

概要 APIの利用について APIの種類 共通の出力項目(操作用) 共通の出力項目 会議単位簡易出力の出力項目 会議単位出力 発言単位出力 検索パラメータ 参考 補足 利用してみる 概要 項目 内容 APIが返却するもの 国会会議録検索システム（ウェブサイト）の内容 返却形式 XMLかJSON 検索条件 APIの種類に関わらず共通 操作方法 開始位置と、次開始位置を辿ることですべて取得できる仕組み APIの利用について 営利・非営利 区分 結果 共通 アクセス 多重リクエストを避け、データを取得し終えてから、数秒程度空けて次のリクエストを行う 共通 公開 出典（国会会議録検索システム）を明記す…

はじめに メーカーのコーポレート部門でエンジニア兼スクラムマスターをやっているモンゴルです。 mongolyy.hatenablog.com の続きを書いていこうと思います。 前回は次のことを書きました。 ドキュメントを作ることで対話が生まれ共通認識を作ることは大事ということ 環境によって整備できていない現場、整備されていなくても成立している現場があったこと 今回はアジャイル開発においてどういうドキュメントが必要なのか？どうやってメンテナンスしていくか？ということを書いていこうと思います。 TL;DR イテレーティブにソフトウェア開発をしていくときに重要なのは認知負荷の低さ CIで統一感を作り…

今日はちゃんと眠れた！チョロだと思っていたけれど、よくよく見ると意味不な仕様書の更新をする。マジで意味不だ。なぜなぜどうして。どうしてここはAなのに、ここはBなの？わたしが技術も知識もないし、頭も悪いから分からないのか？泣く泣く質問をすると、引用元の仕様書がそもそもあまりメンテナンスされておらず、テヘペロ的な感じらしい。くっそー。自分を自分で下げ過ぎるのも良くない。5月はマジでビチクソだ。まあ、世の中には5月病という便利な病気もあるわけだし、6月はハピハピでいきたい。 残業を減らすためフレックスで退社。健康診断以来、わたしの中でわんぱくな食べ物が流行っているため、ラーメンでも食べに行くかと考え…

[目次] 信頼と信頼性 信頼性と品質保証 参考サイト 宇宙業界は高信頼性であるといわれています。 ただ、高信頼性といっても決して特殊な設計方法をしているのではなく、自動車や家電、パソコンと同じ設計方法を取っています。 宇宙業界で有名なロケットは千を超える部品で構成され、宇宙機（人工衛星、探査機）を地球外に安全に運び出すという機能を持っています。 ロケットに搭載される宇宙機は、数週間から数年も休みなく稼働します。 開発方法は同じですが明確な違いがあります。 それは動き始めたら人間によるメンテナンスができないという点です。 地球からプログラムの書き換えはできるのですが、物理的なメンテナンスがほとん…

スーツケースのキャスターが壊れた時、あなたはどうすればいいのか？ 頑丈なキャスターを選ぶポイントとは？ 材質と耐久性 サイズと回転性 取り外し可能性 スーツケースのキャスターを修理する方法 メーカーに修理を依頼する 専門の修理業者に相談する 自己修理する 新しいスーツケースを購入する レビューや評価を確認する ブランドの信頼性を考慮する キャスターの仕様を確認する キャスターの保証に注意する スーツケースのキャスターが壊れた時、あなたはどうすればいいのか？ スーツケースは旅行や出張で重要なアイテムですが、中でもキャスターは頻繁に使用されるため、故障しやすい部分です。しかし、キャスターが壊れたか…

KotestでTable Driven Testをサポートしているシンタックスがあるのでそれを使えば良い。 JUnitでもやっている例はあるけど、Kotestの方がデータ型の用意が不要だったりするのと、テストの可読性が高そうにみえる(好みの範疇)。 また、Table Drivenにテストを書くことで、テストケースの網羅性が確認しやすいのと、テスト実行のためのボイラープレートを減らせるので、入力パターンが3件以上くらいになってくると良いと思われる。 なおテストの実行上はテーブル内にテストケース名を書かなくても良いが、テスト仕様書として考えると必要であり、個人的なおすすめとしては必ずテーブルの1列…

コロナの流行でリモートワークや複数拠点での開発が多くなりました。今の現場でも主体は中部エリア、わたしたちは関西エリアでの作業となっています。 やり取りはネット会議やRedmineといったものになります。記録を残すということもあって、システムそのものに関係する要件、設計などはRedmineを利用しています。ということは、文字でコミュニケーションすることになります。文字で過不足なく正確に伝えるのは、本当に難しいです。それを理解した上でであっても、各自の拝啓も違う中で、思ったようには伝わりません。 また現プロジェクトの要件定義に記載されている要件はたった１行です。そこから、プロジェクト参画したばかり…

朝活～ 今日の内容はデバック Node.js IV 第4章完了 次は第5章へ このデバックというもの 問題・バグの原因を見つけて、解決していくのですが プログラミングの勉強の中で「なんでうまく機能しないのかなあ？」と 何度も壁にぶつかってきたので、 その繰り返しでした。 「間違い探し」 この場合、不具合が起きての原因追及ですが 仕事の場合、見積もりや書類、図面、仕様書など 自分が作成したものを出力しチェックして 不具合が起きないようにする”大切な”業務です。 建築の打ち合わせの終盤の社内でのまとめ作業の際はチェックマーカーの 嵐です。 私のルールは 黄色の蛍光マーカーは「見たよ」のチェック用 …

ナゾトキCTF2-虹色の研究-をプレイしました。そのwrite-up記事です。前回の「nazotokiCTF～入社試験からの脱出～」のwrite-upに引き続き、今回もゆるく書きます。 なお、トップページに以下の記載がある通り、プレイするにはお買い物が必要です: 同人サークル「のみぞーーーん」がやってるナゾトキとCTFを組み合わせたゲーミフィケーションコンテンツです。 プレイにはBOOTHまたは即売会でサークルが頒布する同人誌をお買い上げ頂く必要があります。 Ruleページ記載のwrite-up記述ルールには従っていますが、解法ネタバレを大いに含むのでご注意ください。また、私は謎解き関係能力は…

高卒の給料は、大卒と比較すると低くなる傾向にあります。ただし、業種・職種によっては、高卒でも高額な給料を得ることは可能です。高卒の給料について、初任給や生涯賃金を交えて紹介します。また高卒が高い給料を得ている業界についても解説します。 高卒の給料は？大卒と比較 (出典) pixta.jp 高卒の給料は、大卒と比較すると低水準で遷移している傾向にあります。初任給や平均賃金・生涯賃金を比較しながら紹介します。 高卒・大卒の初任給 高卒・大卒の初任給については、厚生労働省が発表する「2022年賃金構造基本統計調査」で確認できます。（※1） 資料によると高卒の初任給は、18万1,200円です。一方、大…

1問題文「3カ月前に用途が見直され、重要なアプリケーションプログラムが導入されたので、移転期間中に13台のバックアップ機をBCに新規設置することとなった。」に着目。以上より、サーバ移転作業中に障害が発生した場合にバックアップ機が存在しないため、移転前にBCへバックアップ機を設置することに言及し回答を導く。 2・監査証拠問題文 表2項番1③より回答を導く。・検証した内容発見事項(2)及び表2(項番1①)より互換性確認テストの期間は1週間しかとれないことに着目。 3情報システム部による調査結果の適切性を判断するための監査手続を回答。情報システム部による調査結果の検証手続が定められていない状況下で、…

まだあわわわ．．．慌てる時間ではない．．．はず． 子供らも最近ポンコツ化しつつあり，宿題や公文の計算ミスが多い．なので，計算アプリで練習させる．頑張ってくれ． 今日も7時半には研究室．やるべきことが多い． 明日からの週末もバタバタしそうな感じで，なかなかスケジューリング厳しいねえ．Android 12 タブレット8インチ8コアCPU 1920*1200 IPSディスプレイ4G LTE SIM通話アンドロイドタブレット2.4G WIFIモデルGMS TELEC認証済大容量5000mAhバッテリーGPS機能搭載日本語仕様書Type-C充電3.5MMイヤホン対応薄型軽量たぶれっとユアユーAmazon…

羽田新ルートに関連しそうな契約情報につき、3つの段階（発注予定、入札公告、入札結果）に分けて整理しておいた。 ※投稿23年2月15日（更新23年5月22日：NEW） もくじ １．発注予定（見通し）段階 衛星航法サービス高度化に対応した進入方式の設計資料作成調査 測位衛星を活用した新たな進入方式に係る運航基準の策定に関する調査 ２．入札公告の段階 東京国際空港周辺航空機騒音測定局２式の更新（製造・調整） ※NEW 東京国際空港周辺航空機騒音実態調査 住宅騒音防止工事における標準工事費等調査 羽田空港機能強化に係る情報提供・意見把握検討等業務 ３．入札結果の段階 １．発注予定（見通し）段階 情報源…