リファクタリングをする際にソースコードの設計からはじめてはいけない - MonotaRO Tech Blog
どうも、レコメンド商品のシステム開発をしている野川と申します。 私は、2021年にモノタロウに新卒入社し、2022年5月からレコメンド商品の開発に関わり始めました。 モノタロウのレコメンド商品は、下の図の①～④の流れでクライアントサイドで表示しています。大部分の処理はJavaScriptで構成しており、UIもそのHTML部分をjQuery(JavaScript)で作成しています。 図：レコメンド商品表の流れ 入社当時私は、ソフトウェアエンジニアとして、「可読性の低いコードは駆逐するべきだ」「読みやすいコードだけが正義である」「理解しやすいシステムだけが皆を幸せにする」と心の底から考えていました。加えて、「なぜ先輩たちは可読性の低いコードを放置して平気なのか？」と疑問を持つこともしばしばありました。 レコメンド商品周りのコードはまさに可読性の低いコードベースとなっていたため、当事者となった私
【C#】SOLID原則を学ぼう - Annulus Games
今回の記事はオブジェクト指向プログラミングにおける設計の基本、「SOLID原則」について。 ある程度プログラミングの文法を知っていれば、動作するコードを書くことは可能です。しかし、より良いコードを書きたいのであれば、文法の知識だけではなく、設計に関する知識も必要になってきます。 特にUnityでは、適当にコードを書いていくと目も当てられないようなスパゲッティーコードが容易に出来上がります。「とりあえずシングルトンにすりゃいいや！」みたいなノリで「何とかManager」クラスを作りまくった結果、「あれ？この処理どこに書いたんだっけ？」という状況になったこと、誰しも一度はありますよね…？ 今回は、そんなクソk…良くないコードを書かないための設計原則である「SOLID原則」について紹介します。記事内のコードはC#で記述しますが、言語に関わらずSOLID原則は広く応用の効く考え方なので、是非とも覚
第4回：アジャイルに対する誤解（1）--設計せずにいきなり作る？文書を書かない？
梗概 現代社会は多くのものがソフトウェアで成り立っており、絶えず変化するニーズに応じられる柔軟でスピーディーな開発が求められています。その一方、何が正解（ゴール）なのかが分からない、という不確実性の時代でもあります。不確実性に対処するには「アジャイル開発」が最も有望ですが、その成功裏の実践には、従来の常識の解体と再構築が必要です。エンタープライズにおけるアジャイル開発の実践が待ったなしの状況の中、理論、課題、近年の動向も踏まえ、実例を交えながら幅広く解説します。 「文書を書かない」という誤解 本連載の第1回～第3回において、ウォーターフォール方式に変わる、新たな開発手法が発見され、それが1990年代後半～2000年代の「Linux」やスマートフォンの開発において極めて重要な役割を果たし、それが今日のアジャイル開発手法の原則として受け継がれてきていることを解説しました。今回から、アジャイル開
デジタル庁がエンジニアに求める“必須スキル”は妥当？ 求人要件に賛否 同庁に経緯を聞いた
デジタル庁の求人要件がTwitterで話題になっている。政府職員が使う基盤サービスの開発エンジニアを募集するもので、必須スキルとして「Webアプリの開発経験5年以上」や「C#によるWebバックエンドアプリケーション開発経験3年以上」「TypeScript、React、Vue、GitHubなどを用いた開発経験2年以上」など10項目を記載している。 業務内容は「公的機関で使用するID管理基盤の設計・開発」「連携サービスとの相互運用・相互接続、プロビジョニングを行うサービスの設計・開発」などの他、各設計の最適化や品質向上のための分析、改善業務など。必須スキルは下記10項目。 Webアプリケーション開発経験5年以上 TypeScript、React、Vue、GitHub等を用いた開発経験2年以上 DevOpsの設計・開発、アジャイル開発経験2年以上 C#によるWebバックエンドアプリケーション（M
リファクタリングは事前準備が９割 - freee Developers Hub
会計チームで債権周りの開発をしている hachi (@hachiblog)です。会計チームが開発している freee 会計は freee の中で一番歴史が長いプロダクトです。加えて会計というドメインは複雑かつバグを生むと顧客の業務を大きく阻害するという点で一度作ったものを変更しづらいという特徴があります。 そのような環境で今回、債権のチームでは freee会計の初期からある「自動で経理」という機能の一部リファクタリングを行いました。リファクタリングのしづらい環境下でうまくリファクタリングをすすめるための tips は多くの人に役立つのではと思い、このエントリを書くに至りました。 今回「自動で経理」でリファクタリングしたときに事前に以下のことを行いました。 課題の発見 課題の具体化 設計とスケジュール見積もり テストコード実装 それぞれについて今回意識したことを書いていきます。 課題の発見
悪しきコードの痛みを知り、設計スキルを高める方法を学ぶ 全17章からなる『良いコード/悪いコードで学ぶ設計入門』
4/30発売の『良いコード/悪いコードで学ぶ設計入門』を紹介する「『良いコード/悪いコードで学ぶ設計入門』著者トーク」。ここで著者の仙塲大也氏が登壇。続いて、各章の概要について話します。前回はこちらから。 第1章：悪しきコードの弊害から痛みを知る 仙塲大也氏（以下、仙塲）：ここからは各章の紹介です。本書は1章から17章までの全400ページあります。第1章「悪しき構造の弊害を知覚する」。1章と2は、新卒さん向けの章です。「設計なんかぜんぜん知らないですよ」という方向けの章です。 そもそも設計って、「設計しなきゃ」という危機意識が必要なわけですね。その危機意識の醸成には、悪しきコードによる弊害を知覚する必要がありますよ。悪しきコードの弊害を数例用いてダイジェスト的に紹介して、痛みを知ってもらおうという章です。 第2章：「設計とは？」を学ぶ 第2章「設計の初歩」。本格的な設計は3章の「クラス設計
書評『良いコード／悪いコードで学ぶ設計入門』 - uhyo/blog
皆さんこんにちは。今回は、2022年4月30発売の『良いコード／悪いコードで学ぶ設計入門』を読み終わったので、書評という形で感想と紹介を述べたいと思います。筆者はもともと技術書を読まず「ネットでいいやん」派だったのですが、このたびTypeScript入門書を出版したこともあり、それを過去の話として葬り去るべく技術書を読んでいくことにしました。せっかくなので、読んだ技術書の感想等を紹介します。 おことわり: この記事では、「筆者」とはこの書評を書いた人を指し、『良いコード／悪いコードで学ぶ設計入門』を書いた人のことは「著者」と呼びます。また、この記事の内容はすべて筆者の個人的な見解であり、本の内容や本を読んで得られる知識について何らかの保証をするものではありません。 筆者について筆者はフロントエンドエンジニアで、TypeScriptとReactを専門としています。業務では何だかんだで設計の番
組み込みエンジニアは何故やめとけと言われるのか？実はおすすめな理由と将来性を解説
組み込みエンジニアはやめとけは本当？インターネット上や現役のエンジニアから、組み込みエンジニアはやめとけ、という声を聞いたことがある方は多いと思います。数あるエンジニア職種の中でも難易度が高い業務内容であることは確かに事実です。しかし、だからといって本当に避けるべきなのでしょうか。 本記事では、組み込みエンジニアの仕事内容、市場価値、年収にフォーカスし、なぜやめとけと言われるのかという理由とそれでもおすすめできる理由を解説していきます。 組み込みエンジニアに将来性はあるまず結論から言うと、組み込みエンジニアには将来性があり、エンジニア本人の適性が合えば、非常におすすめできる職種であると言えます。その理由について詳しくは後述しますが、市場価値が非常に高まってきていることが挙げられます。 IoT、DXが活況な現在のエンジニア市場では、エッジデバイスをはじめとした組み込みハードウェアの需要が急激
ソフトウェアドキュメント作法 - maru source
こんにちは丸山@h13i32maruです。つい先日、devchat.fmというポッドキャストに出演して、「ドキュメント」というお題について話しました。なぜこんなニッチなお題について話したかというと、Ubie Discoveryに入社して5ヶ月の間にいくつか*1まとまったソフトウェアドキュメントを書いたので、自分の中でホットな話題だったからです。 #devchatfm 33回目は、Ubie DiscoveryのSWE @h13i32maru にドキュメントを書くことで得られるメリットや、ポイント・工夫などを聞きました！ #33 チームの生産性を上げるドキュメントのすすめ with@h13i32maruhttps://t.co/TrmZd13D91— 久保 恒太 / Ubie CEO (@quvo_ubie) 2021年8月12日 これらのドキュメントは個人的にわりと良く書けたと思ってますし、
k-method.jp - このウェブサイトは販売用です！ - k method リソースおよび情報
This webpage was generated by the domain owner using Sedo Domain Parking. Disclaimer: Sedo maintains no relationship with third party advertisers. Reference to any specific service or trade mark is not controlled by Sedo nor does it constitute or imply its association, endorsement or recommendation.
「テストの観点」とは何か、テスト観点リストはどう使うのか | Qbook+
テストを設計する上で、「テストの観点」は非常に重要なものです。しかし、その「テストの観点」をまとめた「テスト観点リスト」が形骸化し、実務で使われない、というケースが生じている所もあります。 本稿では、テストの観点とは何かを「テスト観点モデル」で改めて整理し、テスト観点リストの基本的な構造を示していきいます。 もくじ 「テストの観点」とは テストの観点とは テスト観点リスト ＝ テストの観点をまとめたもの テスト観点リストはせっかく作っても使えないことがある 使いやすくするには「テストの観点」を理解することが重要！ テストの観点を項目分けした「テスト観点モデル」 機能要素 検証アングル テストパラメータ 確認ポイント テスト観点モデルに基づき、テスト観点リストを整理しよう まとめ 1．「テストの観点」とは テストの観点とは テストの観点とは、ソフトウェアが正しく動作するかを確認するための項目
C#の標準化作業がオープンソースに
C#標準化のオープンソース化は、作業を容易にすることを目的に.NET Foundationの下で行われており、言語の革新や機能の設計から実装、標準化まで、すべてがオープンソース化された。オープン化によって、言語設計チーム、コンパイラの実装チーム、標準化委員会の3者間でのやり取りが容易になるとともに、すべての会話は公開される。 ECMAのC#標準化委員会であるTC-49-TG2が、C#の標準案作成を担っており、標準化作業の状況はC# 6の標準テキストで確認できる。具体的な作業の内容は、dotnet/csharplangリポジトリでホストされているドラフト仕様と、現在のC# 5標準テキストとのマージで、C# 7の機能も組み込まれる。 C#に関連するリポジトリとしては、C#の言語設計と進化の取り組みが含まれる前述のdotnet/csharplangのほか、コンパイラと関連ツール実装用のdotne
なぜプロダクト完成間近のテストではなく、上流品質を高めてバグを減らすべきなのか
プロダクトの品質を高めるための開発者テスト。一般に開発の後半で行うイメージがあるかもしれませんが、下流工程で集中的にチェックしようとすると、スケジュールの遅れやバグの見逃し、さらには長時間労働に繋がってしまいます。だからこそ上流品質を高めようと提案するのが、高橋寿一さんによる『ソフトウェア品質を高める開発者テスト』です。今回は本書から、なぜ上流工程で細かくテストをするべきかを解説した「第2章 上流品質向上のためのテスト」を抜粋して紹介します。 本記事は『ソフトウェア品質を高める開発者テスト アジャイル時代の実践的・効率的なテストのやり方』の「第2章 上流品質向上のためのテスト」を抜粋したものです。掲載にあたって一部を編集しています（注記と参考文献は本書を参考ください）。 上流品質向上のためのテスト 日本で定説化・定型化されている、すべての工程のバグをシステムテストで解決しようとすると、絶対
ソフトウェア品質 - Wikipedia
出典は列挙するだけでなく、脚注などを用いてどの記述の情報源であるかを明記してください。 記事の信頼性向上にご協力をお願いいたします。（2019年8月） ソフトウェア品質（ソフトウェアひんしつ、英: Software quality）は、ソフトウェアの品質を指し、プログラマの観点からはソースコードの品質、エンドユーザーの観点からはアプリケーションソフトウェアの品質を意味する。 ソフトウェア品質の定義は様々である。ジェラルド・ワインバーグは著書 Quality Software Management: Systems Thinking v. 1 で「品質とは誰かにとっての価値である」と書いている。この定義は品質が本来主観的なものであることを強調している。同じソフトウェアであっても人によって品質の感じ方は全く異なる。この定義の利点は、ソフトウェア開発チームに「このソフトウェアは誰のために作ってい
ユビキタス言語の作り方（ある一つの事例より） - Qiita
ある出版社プロジェクトにおける事例 出版社は「書籍」と「雑誌」を制作している。制作した「書籍」と「雑誌」は、取次（※出版業界における卸のような位置付けの業態）や書店へ卸す。 「書籍」には返品があり得て、また在庫は会計上資産として扱われる。「雑誌」は返品はあり得ず、また在庫は資産として扱われない。 「書籍」には「ジャンル」という販売管理上の分類がある。具体的には下記の通り。 一般書籍 企画書籍（※雑誌と書籍の中間的なもの、書籍だが決して重版しない） 音響・映像媒体付き（※特別扱い） 成人向け（※特別扱い） 販売管理観点では、「雑誌」もある種の一つの「ジャンル」として扱っている。販売管理観点での「ジャンル」は、つごう下記5つという認識。 一般書籍 企画書籍 音響・映像媒体付き書籍 成人向け書籍 雑誌 「取引条件」という売価、支払サイト等に関わる諸条件が、おおよそ取引先（＝取次や書店）×ジャンル
ドメイン駆動設計に関する何か - 日々常々
2020-03-13追記: 「ドメイン駆動設計」のハードルを上げる意図はありません。そもそもそんな特殊技能でもないと思っています。「ドメイン駆動設計が合っているか」を測る材料になるかも？くらいの気持ちで読んでいただけると幸いです。 何度目か知りませんがDDDがまたブームを迎えているようで。DDD難民と言う言葉が出た頃を思うと感慨深いですね。実際難民になったわけではないので肌感覚で知らないのが残念なところですが、これはどうでもいい。 DDD、日本語ではドメイン駆動設計となりますが、DDDを冠していてもドメインが語られることは少ないようです。 数ある書籍もドメインモデリングの話ではなく、ドメインモデルをいかに実装に落とし込むかにフォーカスしていると感じています。 これはこれで仕方ないと言うか、ドメインの話って広く語れないんですよね。 ドメインは領域で境界があって範囲が限定されています。特定ドメ
Excel設計書を抹殺したくて4年前にWiki設計書を導入したら、意外とちゃんと開発回ってた話。 - Qiita
初めましてこんにちは。 最近コードレビューの記事書いたら、Excelベースだったことを理由に Qiitaコメントとはてブで徹底的に燃やされたおじさんです。 いやね、僕だって使いたくて使ってるわけではなくてね、 できることなら使いたくないんですよ。 というわけで名誉挽回のために脱Excelできた話、 それも日本の三大悪三大風習に数えられるExcel設計書を抹殺した話を書きます。 (2/25修正：悪は言いすぎました。訂正します。） Growi 最高。 またの名をExcel方眼紙。 エクセルのセルの縦横を同じくらいの大きさに調整し方眼紙のようにして、 そこに設計書として文字と図と表を記載する方式。 メリット 一つのファイルに文字と図と表がまとめて記載できる テキストでは文字は書けても図と表が書けない Wordでは、文字と図表エリアとを2列表示するのが難しい できなくはないが面倒くさい UMLモデ
俺たちのドメイン駆動設計はこれからだ！
ドメイン駆動設計に取り組んだ事例をもとに以下の点について説明しました。 1. ドメイン駆動設計とは一体何か？ 2. どんなメリットがあるのか？ 3. ドメインモデルについて 4. 設計パターンについて 5. ドメイン層の隔離について
HTTP API の設計方向
見てみると、たしかに Get 系の API だとしても POST を利用しているし、API の URL 設計に get_shared_link_file のようによく言われる REST っぽい設計は使っていなかった。 この方針は同意だ。自分は結構前に REST っぽい API を捨てることにした。だからといって REST API がダメだとかは思っていない。 一般ユーザが使う場合の API は REST API であるほうが慣れ親しんでいる場合が多いからだ。 AWS で利用されている HTTP API 仕様AWS の DynamoDB の Erlang/OTP ドライバーを書いているときに気づいたのだが、AWS の一部のサービスはかなり独特な API の仕様になっている。
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
履歴を持つデータの設計
