バックエンド– category –
サーバー側の処理、API、認証、セッション。
-
バックエンド
APIのエラー設計 — 4xxと5xxの分け方と、返す本文の決め方
失敗したときに何を返すかを決めます。4xxと5xxの分かれ目、404にするか空配列にするかの基準、利用者に返す情報とログに残す情報の分け方を実装して確かめます。 -
バックエンド
アプリのログ出力 — レベルの決め方とリクエストIDで1件を追う
障害調査に使えるログの出し方を実装します。レベルは誰がいつ見るかで決め、1行1件のJSONにしてリクエストIDを付け、出してはいけない値を確かめます。 -
バックエンド
起動しただけでは動き続けない — Backendの到達作品
サーバー・API・データベース・認証をひととおり読んだあと、「じゃあ何か作って」と言われて手が止まりました。知識と、動く1本を作り切ることは別だからです。この記事は Backend コースの到達点として、ログイン付きの小さなAPI(登録・ログイン・自分のメモをCRUD)を、Express と SQLite で作ります。そして最後に、いちばんの山場——node app.js を手で起動しただけでは SSH を切ると止まる、という壁を越え、systemd で常駐させ、nginx で外から叩ける形にして締めます。「動く」で終わらせず、「動き続ける」まで持っていきます。 -
バックエンド
実行ファイル1つで動く — Goで同じAPIを書く
言語を1つしか知らないと、「その言語の性質」と「プログラミング一般」の区別が付かなくなる。だから2つ目を触る。ただしGoの入門はしない。第5段階の最初に書いた15行のNode.jsサーバーと、同じ/api/tasksを返すGoを、行ごとに並べて比べるだけ。コンパイルすると実行ファイルが1つできて、Node.jsもGoも入っていない環境でそのまま動く。ldd と ls -lh で確かめて、Dockerイメージが小さくなる理由まで繋げます。このサイトは引き続き Node.js で進めます。 -
バックエンド
1画面のために3回叩く — GraphQLとRESTの違い
一覧画面を1つ作るのに、いまのREST APIは何回叩くことになるのか。実際に数えて、過剰取得と不足取得を目で見るところから始めます。GraphQLは「1つのURLにPOSTするだけ」でRESTと同じHTTPの上に乗っていること、スキーマが契約になること、既存のRESTを消さずに /graphql を足す実装、そしてGraphQLが極端にN+1を起こしやすいことを101本のSQLログで確かめます。最後に、失われるもの(HTTPキャッシュ・エラーが200で返る・認可が複雑になる)を正直に並べて、個人のサービスならRESTで十分だという結論まで書きます。 -
バックエンド
OAuthはログインの仕組みではない — 認可とOIDC
「GitHubでログイン」を自分のExpressに付ける。ただしOAuthは認可の仕組みで、ログインに使うための拡張がOpenID Connect。認可コードフローを画面遷移の順に分解し、stateの検証、NATの内側のVMでコールバックをどう受けるか、既存のusersテーブルとどう繋ぐかまで。 -
バックエンド
サーバーから勝手には送れない — WebSocketとSSE
HTTPは「聞かれたら答える」しかできない。だから最初は2秒ごとに聞き直すことになり、無駄なリクエストがログに積み上がるのを実際に見ます。そこからロングポーリング・SSE・WebSocketへ順に進み、向き不向きを表にします。実装は ws パッケージ。nginx を前に立てたまま繋ぐと必ず失敗する Upgrade の話と、プロセスを2つにした瞬間に更新が半分の人にしか届かなくなる事故を、わざと起こして Redis の publish/subscribe で直すところまで。 -
バックエンド
gRPCはcurlで叩けない — 関数を呼ぶようにAPIを呼ぶ
REST・GraphQLに続く3つ目の選択肢としてgRPCを触ります。ただしこれはブラウザ向けではなく、サービス同士が話すための道具です。RPCという古い考え方の系譜をSOAPから辿り、.protoを書いてスキーマを先に決め、@grpc/proto-loaderで動的に読み込んでサーバーとクライアントを両方書き、~/server とは別ポートで共存させます。山場はJSONとProtocol Buffersのバイト数を実測して比べるところ。なぜ小さいのかがフィールド名を送らないことだと分かると、代償として人間が読めないことも同時に納得できます。curlで叩けないことを実際に体験してgrpcurlを入れ、4つの通信の形を整理し、ブラウザから直接使えない理由をHTTP/2の制御が要ることから説明して、最後に「個人のサービスには要らない」と正直に結論します。 -
バックエンド
速いハッシュは使わない — パスワード保存とbcrypt
データベースは漏れる前提で持つ。ハッシュと暗号化の違いから始めて、SHA-256を100万回実際に回して「速いことが弱点になる」を数字で確かめ、ソルトが何を防ぐのかを見る。bcryptで登録と照合を作り直し、$2b$10$… の中身を読み、コストを上げて遅くなることを実測。平文のパスワードを一括変換できない理由と、ログイン時に作り直す移行手順まで。 -
バックエンド
LLMは検索ではない — 埋め込みとRAGを手で書く
「自分のドキュメントについて答えさせたい」は誰もが最初に思うことですが、素のLLMにはできません。理由は「次の1語を確率で選んでいる」ことと「文脈ウィンドウに全部は入らない」ことの2つです。そこから出てくるのがRAGです。この記事の山場は、埋め込み(ベクトル)を自分で扱うところ。コサイン類似度をライブラリ無しで10行書き、全文検索の回で見た「値段」と「価格」が別物になる問題を、数字で確かめます。APIキーが要る部分は全部「任意」にしてあり、キーが無くても最後まで手が動きます。従量課金の防ぎ方、チャンクの切り方で答えが変わること、そして「検索で足りるならRAGは要らない」まで。
12