仕様書

こんにちは！ dely株式会社でクラシルリワードのバックエンド開発を担当しているおぺんです。 今回はサーバーサイド仕様書をGitHubで管理してよかったことを書いていきます💪 ※ Railsアプリケーションリポジトリとは別のサーバーサイド仕様書専用のリポジトリで管理しています。 ※ GitHub管理しているのはサーバーサイドの仕様書のみで、機能仕様に関しては別のドキュメントツールで管理しています。 背景 クラシルリワードは新規事業として、ここ1年で注力・成長してきたサービスになります。 立ち上げからリリース後しばらくの間まで、一人でサーバーサイドを担当していたということもあり、各機能の開発の目…

新機能の仕様作成はPMが担当するでしょう。しかし、仕様を作成する時の気をつける部分を新人メンバーに教えるのがなかなか難しいです。 そのため、今回仕様検討時に意識すべきことを言語化してみます。 ※具体的な内部仕様や設計はエンジニアの仕事なので、今回の記事ではスコープ外とします ファクトベースで、インサイトを洞察する 仕様書が機能の共通認識になる 将来のメンバーが見ることを念頭におこう 実現可能性を検証する 最小機能でv1をリリースする アップデートや他の新機能とのコンフリクトを意識する まとめ ファクトベースで、インサイトを洞察する プロダクトの仕様を考えるときに、解釈と事実を分けて考えることが…

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

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

vkCreateImageView ImageViewはvkCreateImageView()で作成できるが、作成にはVkImageViewCreateInfo構造体に必要な情報をインプットする必要がある。 vkCreateImageView(3) VkImageViewCreateInfo VkImageViewCreateInfo - Structure specifying parameters of a newly created image view // Provided by VK_VERSION_1_0 typedef struct VkImageViewCreateInfo …

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

エンジニアの仕事はファクトを積み上げていって、出戻りをなるべく発生させず、より良いゴールを目指す仕事である。 まめなコミュニケーションと事実確認、文章力が問われる。 そのために 良い睡眠が取れるように生活習慣を見直す 分からない事を放置しない 質問力を上げる 基本的なエンジニア力を上げる 等が求められる。 良い睡眠が取れるように生活習慣を見直す 運動する時間を作る(エレベーターを使わない、帰宅後に10分でも良いので歩く、等) 寝る前に考え事や勉強をしない ハッピーな事を考える時間を作る 寝る前スマホを止める お風呂に入る時間を早くする 寝る前にストレッチをする 楽しかった事を思い出す or ハ…

背景：部屋の空気質(CO2、温度、湿度）をクラウドに上げて集計しているが、気圧が計測できていなかった。高精度の気圧センサ―らしいQMP6988を使って気圧を計測、集計する 課題：QMP6988はレジスタの値を読んだ後、補正が必要なのだが補正式が結構複雑。Arduino/MicroPyhon版のドライバであればGitHubに公開さえているがRust版は無いようだ（もし公開されていてもいざ使おうとすると引数の型変換等エラー出まくって苦労しそう） 取り組み：プログラミングの勉強も兼ねてRust版QMP6988のドライバを作ってみる 詳細： 補正式はQMP6988の仕様書にかかれているのだけど*1、結…

ほどほどの価格（3万円以下）でそこそこの性能の中華タブレットを購入する際にチェックしたいスペック・機能をまとめてみました。 大画面か小型画面か 11インチ前後の大画面か、8インチ前後の小型画面か、どちらのサイズのタブレットにするのかをまず決める。想定する使用方法や用途によって自ずと決まってくるかと思います。 小型画面の場合はスマホとどのように使い分けるのかも考えておきたい。 解像度は２K以上 今ならそれくらいは欲しい。 Androidのバージョンは13以上 Andoroid13からタブレット向け機能が強化され、使いやすくなった。 CPUはHelio G99 ・中華タブレットでよく使われているC…

同好会経営シミュレーションゲーム「アマクラ（仮）」のモック作成はいま現在中断していて、仕様書を作成しています。 土日で一気に仕上げられたらいいのですが。 モック作成だからそこまでこだわる必要はないのでは、と思われるかもしれませんが、作ったものと設計に隔たりがあると、あとで見返したときに要らぬ苦労をすることになるからです。

最近の MYOS は、 WebAssembly ランタイムエンジンの大規模改修などをしていました。 github.com github.com 主な更新内容は、以下のように多岐にわたります。 WASM 2.0 の機能 (の一部) の追加サポート 開発初期は WebAssembly MVP (最初のリリース) が出ていたのでこのライブラリも MVP のサブセットとして開発が始まりました。 WebAssembly 自体はその後いくつかの拡張機能の提案をマージして現在では WebAssembly 2.0 がリリースされようとしています。 *1 このライブラリにも一部の拡張機能が実装されていましたが、…

ブルシットジョブ（牛糞のような仕事）は、デヴィッド・グレーバーによる2018年の著書で注目された社会学的概念である。ブルシットとは「大仰に見えるが価値のない事物」くらいの俗語で、そんな仕事がじつは少なくないという指摘だ。経済発展の過程で不可避的に生み出されるが、それを担う労働者は自分の仕事が社会的に無価値なのではないかと苦悩する羽目になる。 本記事では、ブルシットジョブに似た「ブルシットエンジニアリング」の問題を取り上げたい。グレーバーを読むずっと以前から私は、業務システム開発にはほとんど価値を生まない「設計作業」が大量に含まれていることを知っていた。ソフトウエアというものが、コンピュータを用…

BMSプレイヤーを制作しようとした際に資料集めにかなり苦労したので、自分が見つけたサイトをブログに書き留めておきます。このブログに無い役立ちそうなサイトがありましたらコメントやTwitterのリプでお教え頂けると幸いです。 ・おとゲマＺ by CharatSoft www.charatsoft.com Visual Studio 2015(Visual C++)+DirectXでのBMSプレイヤー制作マニュアル。 他の言語での制作の場合でも十分役立つ内容だと思います。 ・BMS command memo (JP) by Hitkey[追記 2024/7/5] hitkey.nekokan.dy…

こんにちは！TECH Street編集部です！ 2024年4月1日（月）に開催した、 「アプリケーション開発エンジニア勉強会」のイベントレポートをお届けします。今回は3社のアプリケーション開発に携わるエンジニアが集まり、それぞれの知見を発表し、学びあう勉強会を開催しましたので、その様子をレポートいたします。 登壇者はこちらの方々！ Seiya Umemoto ／ パーソルキャリア株式会社azukiazusa ／ 株式会社はてな今枝 ／ 株式会社オプティム 早速、内容を紹介いたします！ Azureで社内文書から回答可能な生成AIチャットサービスを作った話 目次 はじめに 社内向けチャットサービス…