タグ検索の該当結果が少ないため、タイトル検索結果を表示しています。
Excel設計書を抹殺したくて4年前にWiki設計書を導入したら、意外とちゃんと開発回ってた話。 - Qiita
初めましてこんにちは。 最近コードレビューの記事書いたら、Excelベースだったことを理由に Qiitaコメントとはてブで徹底的に燃やされたおじさんです。 いやね、僕だって使いたくて使ってるわけではなくてね、 できることなら使いたくないんですよ。 というわけで名誉挽回のために脱Excelできた話、 それも日本の三大悪三大風習に数えられるExcel設計書を抹殺した話を書きます。 (2/25修正：悪は言いすぎました。訂正します。） Growi 最高。 またの名をExcel方眼紙。 エクセルのセルの縦横を同じくらいの大きさに調整し方眼紙のようにして、 そこに設計書として文字と図と表を記載する方式。 メリット 一つのファイルに文字と図と表がまとめて記載できる テキストでは文字は書けても図と表が書けない Wordでは、文字と図表エリアとを2列表示するのが難しい できなくはないが面倒くさい UMLモデ
経済産業省は11月22日、システム開発時に使う設計書・仕様書などの「作業生産物」のレビュー工程についてJIS規格を制定したと発表した。仕様書などの見直し方や観点などを規格化し、ソフトウェアの品質向上や開発の効率化を促す。 「JIS X 20246」は、設計書・仕様書の見直し作業を「計画作業」「レビューの立ち上げ」「個々人のレビュー」「要検討項目の共有および分析」「修正作業および報告作業」の順に整理し、実行するべきタスクや手順を規定するもの。システム開発や試験、保守などの場面で作るあらゆる仕様書に適用可能。 レビューの曖昧さをなくすため、「目的」「役割」などのレビューの観点10種、「執筆者確認」「同僚との机上確認」などのレビュー手法9種を定めた。JIS制定により、組織や個人のノウハウに依存することなく一定水準のレビューができるようになり、ソフトウェアなどの制作物の品質向上につながるとしている
設計とは、 要求（やりたいこと）をヒアリングする 要求を要件（何を満たさないといけないのか）に落とし込む 要件を実現するために考えられる手段を洗い出す 手段の検証を行う 検証結果を元に、どの手段を使うかを選定する 選定した手段を合意する（一部要件を満たさない事項がある場合は、代替策や妥協ラインについても合意する） 合意内容を元に、実装や設定に落とし込む をやることである。画面設計や機能設計のように、3-5の検証/選定が薄くなったり曖昧になったりするものはあるが、一般化するとこの流れになる。 設計書には、上記の設計でやってきたことを順番に書いていけばよい。これを文章構成のテンプレに落としていくと、 要求 要件 方式 対応案（いわゆる比較表で書いていくのが楽） 検証結果 選定・合意結果（合意した代替策や妥協ラインについても記載する） 詳細設計（どういう実装にするとか、パラメーターにするとか、細
はじめにフューチャー技術ブログのリレー形式の連載である、春の入門祭り2023の1日目です。TIG真野です。 ここ数年、Markdownで設計書をチームで書き、GitHub（GitLab）上でレビューするフローを採用しています。なるべくテキストベースで設計開発フローを統一するため、私の所属するチームでは以下のようなツールを採用しています。 シーケンス図、業務フロー図 Markdown中にPlantUMLで記載 参照はGitHub上からも見れるように、pegmatite を利用 システム構成図など画像系 Diagrams.net（draw.io）で作成し、.drawio.png の拡張子でMarkdownから参照 これだけは目視で差分チェックとなる Web API定義 OpenAPI SpecのYAMLファイル 参照はGitHub上からも見れるように、swagger-viewer を利用 ER
この記事は 食べログアドベントカレンダー2023 の23日目の記事です🎅🎄 こんにちは。食べログシステム本部 技術部 仕入チームの@shohei-yです。 今回は、新規事業の「食べログ仕入」プロダクト開発において所謂「設計書」を書かない設計に挑戦して開発効率を向上させた話を書きます。 （結局「書くの？書かないの？どっちなんだい！」と感じた人は、ぜひ読み進めてください。） 所属している仕入チームについてはこちらの記事をご覧ください。 目次 なぜ設計書を書かない設計に挑戦したのか 設計書を書かないチーム 設計書を書かないことによる問題 1. チーム協力の課題 2. ソースコードの複雑化 3. チーム変動に関わる問題 設計工程導入のきっかけ 設計書を書かない挑戦の背景 設計書を書かない設計 フロントエンド・バックエンドのインターフェースの明確化 ソースコードのスリム化対策 設計のレビュー方法
設計書・仕様書の書き方が分かる！
弊社では開発工程の上流である「要件定義、基本設計、詳細設計」において必要となるドキュメント標準が定義されております。本稿では「ドキュメント標準」の一部をご紹介しますので、是非ご参考にしてください。 各工程で必要なドキュメントを定義しましょう 下記のように工程ごとにドキュメント成果物、内容を定めております。 どの企業でも必要なドキュメント成果物になりますが、必要に応じて追加・削除頂ければと思います。 ※業務系のシステム開発に照準を当てております。 要求分析（要件定義） システム開発は要求分析（要件定義）というプロセスから始まります。要求分析（要件定義）は、顧客の要求を把握してシステム要件を確定することです。主に以下のような事項をまとめます。 要求概要 システムの目的 現状の課題と改善案 基本要件と優先順位 到達目標 システムの実現手段 システム化の範囲 概略費用 効果（定性／定量） 体制図
モーダル間の変換後の一致性とジャンル表を用いた解釈可能性の考察� ～Text-to-MusicとText-To-ImageかつImage-to-Musicを例に～
基本設計は、顧客の要件を実現するための機能を具体化する工程だ。 基本設計工程では、画面・帳票・テーブルなどの設計した後に「基本設計書」としてまとめるが、どのような資料を作るのか不安を感じるエンジニアも多いと思う。 そこで...
はじめまして。 株式会社Enlytのベトナム側開発拠点、SupremeTech Co.,Ltdの上木です。 SupremeTechの副社長として、Project Management Office（PMO）やResource Management Office（RMO）など、管理面から開発プロジェクトを支援しています。 このEnlytブログでは名無しのインタビュアーとしてこれまでに２件の記事を書きましたが、ご覧いただけましたでしょうか。 【社長インタビュー】スタートアップとポストコロナ〜VUCA時代における不安との付き合い方〜【社長インタビュー】スタートアップがAIのR&Dにかける思い 先日「Why programmers don’t write documentation」という興味深い記事を読みまして、思うところがあり筆を執りました。以前、ディレクターの竹内がEnlytブログでドキュメ
連載目次 基本契約と個別契約 今回は「契約論」に関わる紛争の例を紹介したい。 ある程度の規模のシステム開発、特にウオーターフォール型の開発では、その全体を1つの契約で行わない場合が多い。まず、プロジェクトの全体を通して大きな1つの契約を結ぶ。そこには実現すべき機能や費用などの詳細は記述されず、ただ全体としてのシステム開発を行うこと、そして機能や費用、具体的なスケジュールなどは別途契約して決めていくという程度のことが書かれている。これはよく「基本契約」と呼ばれる。 この基本契約の約束に従って作業工程を分割し、その小さな単位ごとに結ばれる契約を「個別契約」という。設計、製造、テスト――といった具合に小さな単位で契約し、検収もその単位で行うというわけだ。 大きなシステム開発の場合は、契約時点では先のことが分からず、作るべきものも費用も曖昧なことが多いので、工程ごとにそれらを決めて検収する方法はあ
テスト設計書ひな型の著作物性・営業秘密該当性等 東京地判令4.5.31（令元ワ12715） - IT・システム判例メモ
テスト業務の専門事業者から退職した従業員が、テスト設計書のひな型を持ち出して転職先で使用したという件について、誓約書違反、不法行為、著作権侵害、不正競争（営業秘密）など、さまざまな根拠を挙げて損害賠償請求を行ったという事案。 事案の概要 Ｙ１は、2017年5月にソフトウェアテスト専門業者のＸ社に入社し、ソフトウェアテスト事業に従事し、グループ長を務めた後に2018年7月に退職した。その後、ＡＩの研究開発、テスト業務を行うＹ２社に転職した。 Ｙ１は、入社時に守秘義務を負う旨の誓約書をＸ社に提出しており、退職時にも守秘義務と競業避止義務を負う旨の誓約書をＸ社に提出していた。 Ｘ社では、テスト業務に用いるテスト設計書のひな型として、本件ファイル１，本件ファイル２を作成していた。 Ｙ１は、Ｘ社を退職する直前に本件ファイル１をチャットツールの自身のアカウントにアップロードし、Ｙ２社に転職した後にダウ
サイカの即戦力を生む2つの設計書 - XEP と Architecture Guide - XICA Tech blog
はじめに 皆さんこんにちは。株式会社サイカでソフトウェアエンジニアをやっている鹿島(kashitaka)です。 皆さんの開発組織では設計書（Design Doc）をどのように運用していますか？ Design Docをめぐる運用は開発組織全体の広い取り組みとしてプロセスに落とすことが難しく、チームごとに独自で運用しているなど取り組みが限定的だったりします。（社内の別チームは開発ドキュメントなどないチームもあったり） サイカでは Design Doc を開発組織全体として設計し運用しています。このDesign Docの運用体系は2021年ごろに定義し、 約2年運用して組織的に定着しています。 今回の記事ではサイカがどのように Design Doc を管理・運用しているのかをご紹介します。 この記事がチームや組織のDesign Docの運用に悩んでいる方、これから Design Doc の運用を
システム開発工程における詳細設計は、どんな作業をすればいいのか、どんなアウトプットを出せばいいのか疑問を持つことも多いと思う。 そこで今回は詳細設計のサンプルを紹介しつつ書き方も簡単に説明していく。 なお、詳細設計は内部...
Noteからの転載 —- 設計書は、現在、または過去、未来をつなぐコミュニケーションツールなので、そのコミュニケーション設計をどうするか？って話を抜きに、どう書くべきか？そもそも書くべきか？みたいな議論を始めてしまうと、会話が成立しないことが多いですよね 必要な抽象度だって全然違ってくるし— magnoliak🍧 (@magnolia_k_) 2021年2月6日 これが設計書です！と言われて見せられたものが、あからさまに個人的なメモを超えるものでない場合、「この文書は誰とのコミュニケーションを目的としましたか？」と聞くと良いのではないかっていう みんなオレオレ正しい設計書理論があるので— magnoliak🍧 (@magnolia_k_) 2021年2月6日 設計書になにが書かれているべきか、コードの世界と違ってあまりコンセンサスが得られた回答を見たことが無い気がする。 かなり大きめの
※ 設計書に関する本文およびテンプレートは制限無く公開しておりますので、当該記事をご購入頂かなくても設計書テンプレートの利用は可能です。応援いただける方のみご購入頂けますと幸甚です。こんにちは。 フリーランスエンジニアの山口です。 私は元々SIer企業の会社員エンジニアでしたが、2019年3月よりフリーランスエンジニアとして活動を始めました。 フリーになってから参画先のプロジェクトで経験したのは、意外と設計書のテンプレートは整備されていないということです。 そもそも設計書が存在していないとか、メンテ不能なPDF版で存在するとか、設計書のフォーマットがばらばらでメモ書きのような雑なものだったりなど。 そのような現場に入った際に利用可能なテンプレートがあると便利だと思いませんか？ 書籍でも設計書の書き方や設計書として揃えるべきドキュメントの種類を学ぶことは可能です。むしろ、書籍のほうがまとまっ
Excel で設計書作るのそんなに悪いことか？ 僕は長らく Excel で仕様書や設計書、テストケースなどを作ってきた。現在も、何か情報を整理しようと思うと、とりあえず Excel に書き始めている。とある現場では「Excel マスター」なる称号をもらったりしたし、Excel の細かな仕様は技術ブログ Corredor でも度々紹介してきたとおり、そこら辺のニホンノエスイーよりは熟知した上で使っていると自負している。 しかし、ネットの界隈では「まだ Excel で仕様書書いてんの？」という風潮が強く、「Excel で仕様書のフォーマット作ってみました！」みたいな記事にネガティブコメントがわんさか付き、「Docker を使って PlantUML 環境を構築！」みたいな記事が高評価を得ていたりする。自分も技術オタクなので、イマドキのツールが簡単便利に色んなことができるのを見ると、いいね！と思う
令和時代の設計書の基本方針
はじめに さて、今回から機能設計書の標準化について取り上げていきます。今回は、平成時代の基本設計書を押えたうえで、令和時代の機能設計書の書き方や標準化に向けた基本的なドキュメント方針を解説します。 機能設計書とは 第4回の図3「システム開発のドキュメントフロー」で、システム開発に必要な主なドキュメントを紹介しました。ここで画面遷移図や業務フローなどはシステム全体に対して作成しますが、機能設計書は機能ごとに作成します。例えば基幹業務システムなら「受注入力画面」「受注伝票検索画面」「受注伝票(帳票)」などが”機能”で、全部で200機能あるとすれば200冊の設計書が作成されます(図1)。 Excelベースの機能設計書(基本設計書サンプル) 2005年の連載「即活用! 業務システムの開発ドキュメント標準化」では、図2のような機能設計書(基本設計書)のひな型をダウンロードできるようにしていました。こ
令和時代のシステム開発では、どのような設計書を書くべきか
Copyright © 2004-2022 Impress Corporation. An Impress Group Company. All rights reserved.
一般的にはどうなのか？が気になる人は後半にある「一般的には（参考）」に先に目を通してもらったほうがいいかもしれません。 サンプルダウンロード サンプルのダウンロードはこちらから。 作成してみる では作成していきましょう。 作成方針・ポイント 概要でも書きましたが、詳細設計書までの書類で開発に必要となる情報の全てを記述しておく必要があるので、要件定義書、基本設計書の記述として足りない内容を記述していきます。 構成（目次）を考える 今回は下記のような項目を記述してみました。 一般的には基本設計で行う外部設計、内部設計といった内容に加え、実装に必要な情報を記述します。 サーバ/アカウント情報 外部設計 PC用画面 スマホ用画面 画面のマークアップ バリデーションルール（フロント）と表示項目 送信ボタン押下時の処理 スプレッドシートのデータ構造とレイアウト 内部設計 APIの処理フロー APIの仕
WEBアプリ開発のプロジェクトで詳細設計書を一から作成することになったので、 これを機に「詳細設計書に必要な最低限の記載内容」の再確認とメモ書きφ(..) また別プロジェクトで一から書くことになった時の判断基準にするためにも。 本題に入る前に、前提知識をザックリと。 詳細設計書は、上流工程の 「要件定義」 クライアントの要望とその要望をどのように叶えるのかを明確にする。 ↓ 「外部設計」 要件定義で決まった内容をもとに、画面や帳票、操作性などのユーザーインターフェースを設計する。 外部システムと連携する部分の仕様を設計し、内部設計の土台を作る。 ↓ 「内部設計」 外部設計で決まった内容をもとに、システムとして何を使ってどう実現していくかを具体的に定めていく。←★ここの工程で必要になる設計書 一先ず、 ・外部設計で作成する「基本設計書」はどちらかというとクライアント向けの設計書。 ・内部設計
仕様書・設計書テンプレート（サンプルあり）基本設計書・詳細設計書
システム開発では会社に定められたドキュメントのフォーマットがない場合、独自に作成する必要があります。これにより、仕様書や設計書の作成にかかる時間はかなり増加します。 SEを目指す方々も、求めるシステム開発用テンプレートを簡単には見つけられません。 そのため、エクセルでの仕様書や設計書のテンプレートやサンプルを無料でダウンロード可能にしました。システム開発の際の参考としてご利用ください。
社畜バンドマンの備忘録 大手メーカー勤務のエンジニアの備忘録。 サラリーマンをやりながらロックバンドもゆるーく活動しており、社会人として、バンドマンとしての成長をここに刻む。 ビジネス関連、音楽関連はもちろん、テクノロジー、VR、ペット（鳥）など幅広く手を出しすぎて収集がつかなくなっている。 が頑張る。 今日は仕事の話。 弊チームはソフトウエアの開発も仕事の一部なのだが、開発の中で「詳細設計書」が問題に上がっている。 そこで世の中の「詳細設計書」について調べるため、ちょっとググってみたら気になるワードがヒットした。 「詳細設計書という名のゴミ」 元ネタのページは消えてしまっていたが、それを参考にしたページはいくつもあり、まさに今我々が直面している内容について書かれていた。 今回はそんな「詳細設計書」について書こうと思う。 私の所属している会社は製造業だ。 しかし、モノだけ作っているかという
iselegant | Masaya ARAI on Twitter: "よくジュニア層から「監査証跡のログってなんで3年間や5年間保存するんですか？」と聞かれることがある。 設計書には背景が記載されていないこともままあるけど、IPAの資料にいい感じにまとまっているので、気になる方は一度目を通しておく… https://t.co/kfCPAgjhfA"
よくジュニア層から「監査証跡のログってなんで3年間や5年間保存するんですか？」と聞かれることがある。 設計書には背景が記載されていないこともままあるけど、IPAの資料にいい感じにまとまっているので、気になる方は一度目を通しておく… https://t.co/kfCPAgjhfA
弊社では最近、新たなドキュメント管理ツールとしてNotionを導入しました。Notionは非常に使いやすく、システムの仕様書管理とも相性が良かったので、今回はその魅力をご紹介したいと思います。 Notionに移行した経緯以前は、Confluenceを使ってドキュメントの管理を行い、Jiraでタスク管理を行っていました。しかしNotionを試してみると、これらの機能を兼ね備えているだけでなく、カスタマイズ性が高く、操作性も良いのでドキュメント作成に適していると感じました。ツールを一元管理することで総合的なコストも下がるので、Notionへの移行に踏み切りました。 それでは、各仕様書の具体的な記載内容についてご紹介します。 今回は下記仕様書に絞って記載しています（他にも業務フロー図や状態遷移図、エラーメッセージ一覧などシステム仕様で必要なドキュメントは全てNotionで作成しています） 画面仕
ゼロから始めるVue.jsコミュニティ貢献 / first-vuejs-community-contribution-link-and-motivation
弊社サービスをご利用頂き、誠に有り難うございます。 ドキュメントのダウンロード件数が2007年5月の開設以来300000件を突破しました！ 今度ともご愛顧の程よろしくお願いいたします。 PocketDOC(ポケットドック)とはシステム開発に必要な設計書や仕様書などのドキュメントやテンプレートはもちろんのこと、 議事録、納品・検収書、近年話題になっている個人情報に関しての取扱管理表などの ドキュメントやテンプレートも提供しています。 実際に弊社のプロジェクトで使用されているため精度も高く、カスタマイズなしでも利用可能なほどです。 上流工程から下流工程まで広い範囲をサポートしているので、 必要なテンプレートだけをダウンロードして利用することも可能です。 ドキュメントやテンプレートのファイル形式はWord(doc形式)やExcel(xls形式)です。 ダウンロード後、すぐにお使いいただけるように
我々は、なぜ設計書を作成するのか
はじめに 先日、「設計書の書き方」セミナーで、設計の効率化＆品質向上のために下記3つのうちどれが一番大切だと思うかを聞いてみました。みなさんなら、どれを選びますか。 (A)設計スキルを教育する(B)設計の標準化を進める(C)設計ツールを導入する システム設計ツール(CAD)を自らの効率化のために作った身からすると、今こそ(C)は重要だと思っています。しかし、そんな私でもこの3つはどれも大切で、どれが一番とは甲乙つけがたいものと感じています。 内心、票が割れるかなと思っていたのですが、結果は(B)の標準化に手を上げる人が圧倒的に多くいました。 それほど多くの人々が重要視している設計書の標準化ですが、その割にはチームごと、部署ごとにフォーマットがバラバラで、「組織単位で設計書を標準化できている」と胸を張れる会社は多くありません。そこで、令和時代の設計書の標準とはどうあるべきかをテーマにしている
人生の設計書を作る方法Bonnie Wan氏も2010年に、この難問に答えが見出せず、行き詰まりを感じていました。のちに『The Life Brief: A Playbook for No-Regrets Living（人生の設計書：後悔のない生き方のために）』という本を著したWan氏は、はた目には非の打ち所がない人生を送っているように見えました。 素晴らしい夫に、3人の子ども、素敵な家を持ち、夢のようなキャリアを築いていたからです。 しかし心の内はというと、疲労感にさいなまれ、さまざまな疑問を抱えていました。 Wan氏は自分の仕事において、クライアントが自身の本音にたどり着く手助けをするために、質問を投げかけたり、「クリエイティブ・ブリーフ」と呼ばれる、広告戦略を簡潔にまとめた設計書を作成したりしています。 そこでWan氏はこの手法を自分自身にも適用して、「ライフ・ブリーフ（人生の設計書
設計書とか試験仕様書とか書くのって超大変だろ これを簡単だと思ってるやつはプログラミングも大したことない 「無駄だ」とか「やりたくない」ならわかる 「簡単」って言ってるやつを信用するな
私はソフテックに入社して15年超の社員で、主に組込みソフトの開発に携わっています。最近、関わった仕事で、内部設計フェーズにおいてどういった資料を作成すべきかを見直す機会がありました。 今回のソフテックだよりでは、組込みソフト開発において内部設計書に書くべき内容について、まとめてみたいと思います。ソフテックで実際に作成している資料など、できるだけ具体的な例をあげて、ご説明していきます。 内部設計書とは、一般的に、ユーザーの目に見えないシステム内部の設計を記述したドキュメントを指します。詳細設計書と呼ばれる場合もあり、ソフトウェアのプログラミングを行うために必要な資料になります。 ソフトウェアの開発プロセスは一般的に下図のようなV字モデルで示されますが、その中で、内部設計書を作成する段階は、要件定義と基本設計（外部設計）が完了した後、プログラミング（コーディング）を行う前の作業になります。 図
キーワードで探す カテゴリで探す トレンドを知る 事例を知る 展望を知る 技術ブログ サービスで探す コンサルティング CRM（Salesforce） ERP（SAP/Biz∫） 顧客接点・決済 カーボンニュートラル SCM・ロジスティクス 電子申請 データ＆インテリジェンス アプリケーション開発・管理 ブロックチェーン 量子コンピュータ・イジングマシン デジタルツイン IoT ロボティクス・RPA クラウド ネットワーク データセンター サイバーセキュリティ アウトソーシング 生成AI 業種で探す 金融 官公庁・自治体 医療・ヘルスケア 防災・レジリエンス 食品 流通・小売 モビリティ 製薬・ライフサイエンス 食農・農業 製造 通信・放送 電力・ガス・水道 建設・不動産 個人のお客様向け 教育 トピックで探す Foresight Day サステナビリティ キーワードで探す カテゴリで探す
はじめに これまで設計書からプログラム、構成図からIaCなど、GPT4-Vで画像を使ったケースを取り扱ってきました。今回は画面設計書みたいなものから画面のコードを生成させてみたいと思います。 なお、生成するコードはSvelteコンポーネントです。 画面設計書 本当は日本語が良かったのですが、日本語OCRの精度に不安があったので英語で記載しました。なお、英語もChatGPTで日本語をもとに翻訳したものをそのままいれています。 DallePanel.svleteというSvelteコンポーネントについて、画面の構成と、動作に関する説明などを右側にいれています。右側の説明は画像にいれなくてもプロンプトに入れてもいいかなと思いましたが、とりあえず画像です。 ともすればfigmaとかでもいいじゃないかっていう話もありますが、動作含めて画像にすることを今回試します。 説明の内容は日本語（翻訳前）だと以下
システム開発・設計企業必見！実際の設計書を公開！
div.hs-menu-wrapper > ul > li" data-pacnav-mobile-width="820"> OB Designer とは 機能 動作環境 導入事例 価格 FAQ 保守サポート バージョンアップ履歴 ブログ 昨今、基幹システムの入れ替え（マイグレーション案件）や債券法の改正など、IT業界に影響が多いことばかりです。請負契約に関しては「長年にわたって無償改修のリスク」を伴うことが予想される為、ますます納品物・成果物に対しての品質が問われてくるのではないでしょうか。 以前まではシステムを引き渡してから1年間だけでしたが、改正後は10年後に変更されることが予定されております。つまり、契約不適合が認められた場合は10年前のシステムであろうとも改修を行う必要がでてきます。当然、改修費用や保守費用も上乗せが必要と言えるでしょう。 しかしながら、債券法の改正が無かったとし
これらの疑問にに解決していきます。 システム開発にAPIが必要な理由 今までAPIを利用せずにWebシステムを作ってきたのですが、最近の開発はAPIを中心としたものがメインになっています。 理由はWebだけでなくiPhoneやAndroidといったスマートフォンやIoTの機器と連携するときにAPIが必要になるからです。スマートフォンアプリから直接データベースに参照したり更新をかけることができないため、APIが必要になります。簡単な図はこちらです。 WebもAPIにする理由はVueやReactといったJavascriptがAPIを取得できるのでWebもAPIとの相性がよく使われています。また、IoTも流行りつつあり、IoTこそAPIを利用して機器の操作をすることが増えてきています。そのため、APIが必要になってきたのです。 APIインターフェース仕様設計について APIインターフェース仕様書
# API設計書サンプル ## ファイル登録API ### 概要 ファイルをxxxxxする ### パス `/api/v1/register` ### メソッド - POST - J
2022/10/31 New!! この記事の続編となるGitlab Wiki整備編を公開しました。 概要 現在社内で作られるドキュメントのほとんどがExcelで作成されています。 議事録 提案書 見積 設計書 テスト仕様書 打ち合わせで使う資料 etc... この中の一つである設計書を脱Excel化しようと試みたのでその過程と結果を何回かに分けて Qiitaにアウトプットしようと思います。 前提条件 プロダクトバックログ及びスプリントバックログはBacklogにて管理する ソースはGitにて管理し、GitLabを利用する 取り組む内容 ①Excelに変わる新たな設計書作成手段の導入 今までExcelでしかやってこなかったのでまずは調べる所から ②設計書のテンプレート作成 テンプレートを用意しておかないと人によってこの項目を書いた/書いてないが分かれてしまいそう。 そのため各資料ごとに簡単な
何度か、設計書を書かない現場に行ったことがありまして、その度に炎上し、仕方ないのでさかのぼって設計書を書く経験を何度もしたことがあります。 設計書を書かない理由は、設計書を書く意味をわかっていないからだと思います。一方で、設計書を書く言語能力も欠如しているからだとも思います。 これから作るものに対して、なぜ作るか。どのように作るか。そして達成しなければいけないことは何か。それぞれを、日本語で他人にわかるように文章で書くというのは意外と得意ではない人は多いものです。 得意じゃないのなら作らなくてもいいのかというと全くそんなことはないのですが、できれば作りたくない。目の前のコンピュータと対峙したいし設定する能力はある。そして結局は実装しないと最終的にどんな設計になるのか未確定だから、と言って設計書を書かずにいきなり実装に入ってしまう、そんなパターンばかりだったように思います。設計書を書く方が実
magnoliak🍧 on Twitter: "設計書、シュッと実装するための構造と、トラブルシュート時にガッと把握できる一覧生が有り、さらには自分が更新したくなる魅力を備えておいてくれればそれでいいです"
設計書、シュッと実装するための構造と、トラブルシュート時にガッと把握できる一覧生が有り、さらには自分が更新したくなる魅力を備えておいてくれればそれでいいです
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
設計書・仕様書のレビュー方法を定めたJIS規格登場 チェック体制を標準化しやすく
設計書には何を書くべきなのか - terurouメモ
markdownlintで設計書の品質を高める | フューチャー技術ブログ
設計書を書かない設計で開発効率を向上させた話 - Tabelog Tech Blog
伝統的なエンプラ企業で取り組むインフラの設計書のモダナイゼーション.pdf
基本設計における成果物一覧と書き方（基本設計書サンプルあり） | 若手エンジニアの羅針盤
【徹底解説】アジャイル開発に設計書は不要か？｜開発管理者が語る設計書の役割と運用・管理方法
基本設計書は納品前ですが、システム作っちゃいました
詳細設計における成果物一覧と書き方（詳細設計書サンプルあり） | 若手エンジニアの羅針盤
設計書には何が書かれてるべきか - Magnolia Tech
基本設計書のテンプレート｜Shinji Yamaguchi
Excel で設計書作るのそんなに悪いことか？ - Neo's World
「詳細設計書」を作ってみる - Qiita
詳細設計書って何をどう書くの？ - Qiita
「詳細設計書という名のゴミ」が問題になっている : 社畜バンドマンの備忘録
【Notion】システム開発における設計書の管理方法 | ELW株式会社
IaCジェネレーターとBedrockで詳細設計書を生成してみた
設計書仕様書テンプレート PocketDOC | 株式会社イーイノベーション
幸福度が自然と上がる「人生設計書」の書き方 | ライフハッカー・ジャパン
設計書とか試験仕様書とか書くのって超大変だろ これを簡単だと思ってるや..
技術レポート「内部設計書に書くべきこと～組込みソフト開発の場合～」｜ソフテックだより｜株式会社ソフテック
プレインテキスト形式の設計書で、生産性を向上 | NTTデータ
GPT4-Vで画面設計書から画面を生成させる - Qiita
外部設計 PART4 APIインターフェース仕様設計書
ワイヤーって何？ 要件定義では、いったい何を定義しているの？｜Step 2-7 サイト設計書の作成③ワイヤー・要件定義書 | Web担当者になったら知っておきたい「基本」が学べる Web担ビギナー | Web担当者Forum
API設計書サンプル - HackMD
脱Excelでシステム設計書を作成する(ツール選定編) - Qiita
設計書はなぜ必要か - orangeitems’s diary
a-hanoi.hatenablog.com
www.chugoku-np.co.jp
aoi.px.ebb.jp
yomitai.jp
www.zetsumeshi-ishikawa.jp
jp.reuters.com