SOLIDの原則など、ソフトウェアを設計する上で知っておくべき記事や単語について書いています。
シーケンス図とは何か、またPlantUMLによるシーケンス図の書き方を解説します。シーケンス図を書けるようになることで、ドキュメントやブログ、チーム開発においてものごとを伝えるための表現の幅が広がります。また設計のときに思考が整理されるという利点もあります。
ユーザーの認可にはOAuthを用いるのが一般的ですが、OAuth標準の仕様だと第三者にアクセストークンを取得されるおそれがあります。これを防ぐのがPKCEで、この記事ではPKCEの概要と実装例を示します。
開発や学習をするとき、APIの動作を確認することがあると思います。この記事ではcurlコマンドとPostmanというツールを用いてAPIを実行する方法を解説します。APIを用いた開発に必要な基本知識が身に付きます。
この記事では、私がチームでテストの書き方について共有するために、テストケースとはなにか、作り方や観点、書き方などについての基本的な内容をまとめてみました。テストを行う際の参考になればうれしいです。
この記事を読むことで、障害が起きたときの業務フローを学ぶことができます。実際に障害が起きたときに見ながら対応することで、復旧につながっていきます。また、障害が起こらないための準備についてもまとめています。
プログラミングで分かりづらいテーマの一つが例外処理です。私は実務でレビューを受けたりしながら例外処理について学びました。この経験をもとに、この記事では例外処理とはなにか、目的や考え方について書いていきます。
この記事でプルリクエストとはなんなのか、誰が読むのか、目的はなにか、書くべきことなどをまとめてみました。記事の後半にはプルリクエストのテンプレートもあります。
ソフトウェアを開発する上でしっかりと対応しておきたいのがログの出力です。この記事ではログの出力を設計する指針について、書き方やフォーマットの例をもとに整理します。ログを設計するときの参考になればうれしいです。
この記事では、Webアプリケーションやネイティブアプリでのユーザー認証の仕組みや方法を説明した上で、どの方法がいいのかをケースごとに見ていきます。
チームでプロダクトを開発するとき、ソースコードレビューをすることがあると思います。私もレビューをよくするのですが、やる度にレビューの観点が変わるような気がしていて、一度整理したいと思いました。この記事では、ソースコードレビューとはなにか、目的ややり方、観点のチェックリストについて書いています。
プログラミングを効率的に学ぶにはプログラミングスクールに通った方がいいですが、候補がたくさんあってどこがいいか迷うと思います。この記事で〈プログラミングスクールに通うべきかどうか〉がわかり、学ぶと決めたときに〈どこを選べばいいか〉がわかります。
この記事を読むことで、バッチ処理とはなにか、どう設計すればいいか、そのやり方がわかるようになります。バッチ処理を設計する上で押さえるべきポイントをまとめているので、参考になればと思います。
チームで開発をするとき、技術選定をすることがあります。どの技術を使うべきか、説明責任もともなうので、よく悩みます。自分の中で判断基準を明確にもっておくために、技術選定のポイントについてまとめてみました。
ライブラリを使うときに、なにかしらの条件をもとに『そのライブラリを使っていいかどうか』を考えたりします。自分の中で、このライブラリの選定基準をうまく言語化できてなかったので、自分なりにまとめてみました。
この記事を読むことで、権限管理とはなにか、その際に押さえておくべきRBACとABACについて、また権限管理を設計するやり方の一例がわかるようになります。
Next.jsでHTMLからの画像の生成は、Puppeteerにより簡単に実装できます。この記事では画像を自動生成するときの要件・実装方法の選択肢、具体的な実装方法を解説します。コストをかけることなく、ユーザーに魅力的にコンテンツを届けられるようになります。
サイトのドメイン変更は、SEOの観点からいうと基本的にはリスクしかありません。ただ、正しい手順で行うことで、SEOの評価を維持することができます。この記事では、SEOの評価を維持する条件をもとに、7つの手順を示します。安心してドメインを変更できると思います。
この記事では、管理画面を設計する上でなにを考えればいいか、指針をまとめていきます。また、プロダクトのフェーズにおける管理画面の考え方についても整理します。
Content Delivery APIのlinks_to_entryという検索パラメータを用いて、エントリへの参照数を取得する方法について説明します。
ContentfulのImages APIでできることを一覧で示しつつ、それぞれの概要と使い方をコードで示します。本ブログはContentfulを用いていて、Images APIも使っています。このときに調べたことを、備忘録的にまとめたのがこの記事となります。よかったら参考にしてくださいね。
Terraformなどでインフラを構築するときに安全性を高めるための機密情報管理サービスについて、AWS Secrets Manager、Systems Managerパラメータストア、Hashicorp Vaultの3つを比較します。
Terraformはコードをどう配置するかというルールがありません。だからといって自由にコードを書いてしまうと、コードを管理しづらくなったり、メンバーがコードの変更をキャッチアップしづらくなってしまいます。Terraformのコードを扱うときは、どう管理するかというルールを定めることが大切です。この記事では、Terraformにおけるディレクトリ構成の例を示します。
ソフトウェアが運用段階に入ると、重要になってくるのが運用監視です。ソフトウェアが動作するサーバを監視することで、ソフトウェアを正常に動作させ、また問題が起きそうなときにも、あらかじめ対策をとることができます。この記事ではサーバの運用監視の目的や種類、ツールなどについてまとめてみました。
ローカルに開発環境を構築するときに、手動でやるか、あるいはVagrantやDockerなどの仮想化技術を用いるか。どの方法で作ればいいか？について、私がチームで開発したときにつまずいた経験などを元に書いています。
この記事ではソフトウェア開発におけるドキュメントとはなにか、なにを書くべきか、あるいは書くべきでないかなどについて整理してみました。個人やチームによらずソフトウェア開発に携わっているエンジニアの方にとって参考になると思います。まず全体をざっと読んで概要を把握しつつ、実際にドキュメントを書くときに見る、というような読まれ方を想定しています。
