ロードマップ挑戦– category –
roadmap.sh のロードマップを、読むだけで終わらせず実際に構築して検証する記録。
-
システム設計
読んでも消えないキュー — Kafkaとオフセット
RabbitMQ で ack を返した瞬間、そのメッセージは消えました。「あの処理、もう一度やり直したい」ができません。Kafka はここが根本的に違います。読んでも消えず、どこまで読んだかは読む側が覚える。この回では Kafka を KRaft モードの1ノードで立て、CLI で送って読み、そのうえでオフセットを巻き戻して同じメッセージをもう一度処理します。コンシューマーグループとパーティションを実際に2つ立てて確かめ、保持期間・背圧まで見たうえで、最後に「個人のサービスには重すぎる」ことを正直に書きます。 -
バックエンド
LLMは検索ではない — 埋め込みとRAGを手で書く
「自分のドキュメントについて答えさせたい」は誰もが最初に思うことですが、素のLLMにはできません。理由は「次の1語を確率で選んでいる」ことと「文脈ウィンドウに全部は入らない」ことの2つです。そこから出てくるのがRAGです。この記事の山場は、埋め込み(ベクトル)を自分で扱うところ。コサイン類似度をライブラリ無しで10行書き、全文検索の回で見た「値段」と「価格」が別物になる問題を、数字で確かめます。APIキーが要る部分は全部「任意」にしてあり、キーが無くても最後まで手が動きます。従量課金の防ぎ方、チャンクの切り方で答えが変わること、そして「検索で足りるならRAGは要らない」まで。 -
DevOps
AWSとVPSは値段が10倍違う — クラウドの選び方
EC2を立てて消し、Lambdaを動かし、静的ホスティングまで来て、まだ説明していないことがひとつある。なぜAWSなのか。理由は「情報が多いから」で、それ自体は正しいが、それだけでは選べない。VPSとハイパースケーラが別物であること、AWS・Azure・GCPの性格差、部品の対応表、ロックインで移せるもの・移せないもの、無料枠の3種類を整理して、契約せずに読んで判断できるようにする回。 -
フロントエンド
同じボタンが3種類できる理由 — デザインシステム
一人で作っていても、ページを増やすほど「同じはずのボタン」が微妙に違うものになっていきます。原因はセンスでも手抜きでもなく、毎回その場で色と余白を決め直しているからです。CSS変数でデザイントークンを定義してマジックナンバーを消し、variantをpropsで受けるButtonを1つ作り、使う側が色を指定できないようにするところまで実際にやります。そのうえでStorybookは入れずに1枚のカタログページを自作し、なぜそう作ったのかをADR(設計判断の記録)として docs/adr/0001 に残します。データの持ち方と、外部と繋ぐときの3つの型も同じ「設計を言葉にする」話として扱います。一人でデザインシステムを作り込みすぎないための線引きも書きました。 -
バックエンド
FTPは平文で流れる — 仕事で出会う古い技術
入った会社に、自分が選んだ技術は無い。Oracle・SQL Server・FTP・IMAP・SAML は「古いから残っている」のではなく、動いていて、業務がその上に乗っているから残っている。なぜ置き換わらないのかを構造から説明し、山場ではFTPが本当に平文で流れることを自分のVMの中だけで確かめ、SFTPがFTPとは別物であることを手を動かして区別する。 -
フロントエンド
Svelteは仮想DOMを使わない — React以外の現在地
フレームワークの回でReactを選んだが、実際に動かしたのはReactだけだった。比べていないものは「選んだ」とは言わない。同じカウンターをReact・Svelte・Solidの3つで実際に作って動かし、行ごとに対応表を作る。仮想DOMを使うか使わないかで性格が決まること、Angularがフレームワークではなくプラットフォームであること、メタフレームワークが何を足しているか、GraphQLクライアントがなぜ要るかまで。最後に、それでもこのサイトがReactを続ける理由を書く。 -
データベース
1つの表に全部入れると壊れる — テーブル設計と正規化
正規化は「第1〜第5正規形を暗記するもの」として教えられがちですが、それでは何のためにやるのか分かりません。この記事では、わざと壊れる表を1枚作って、更新時・挿入時・削除時の3つの異常を実際にSQLで起こします。そのうえで「番号」ではなく「いま何をしているか」で表を分け、外部キーで繋ぎ直します。ON DELETE の選び方、連番とUUIDのどちらを主キーにするか、正規化しすぎて遅くなったときにあえて重複を残す判断、NULLの扱い、そしてKnexのマイグレーションに落とすところまで。 -
Linux
aptが無いサーバーもある — Ubuntu以外のOS
仕事で渡されるサーバーは Ubuntu とは限らない。apt が無い、ufw が無い、そして SELinux が nginx を止める。VMを増やさずコンテナで AlmaLinux を立て、同じことを違うコマンドでやってみる。RHEL派生・SUSE・BSD の関係も整理する。 -
バックエンド
3つ目で言語の地図ができる — Pythonを触る
2つ目のGoで「言語の性質」と「共通のもの」を分ける線は引けた。ただし2点では地図にならない。3つ目のPythonを置いて、はじめて面になる。Python入門はしない。同じ/api/tasksを3列に並べて、インデントが文法であること、型は書かなくていいが書けること、そして同じ計算ループをGo・Node.js・Pythonで実際に測って「遅い」を数字で見る。そのうえで、遅い言語が駄目ではない理由(動く時間より書く時間が高いことがある)まで。Ubuntuの Python を sudo pip install で壊さない話と、venv も必ず通ります。最後に9つの言語を4象限に置いて、次に何を学ぶかの判断軸を作ります。 -
フロントエンド
Electronは重くTauriは軽い — ブラウザの外へ
PWAでホーム画面には置けた。それでも「アプリ」とは呼ばれない。ストア・通知・センサー・オフライン前提という4つの線が引かれているからです。この回はブラウザの外に出る選択肢を4つに整理し、Windows側で同じReactのコードをそのままデスクトップアプリの実行ファイルにします。Electron は Chromium を丸ごと同梱し、Tauri は OS のWebViewを借りる。その差はファイルサイズにそのまま出ます。React Native と Flutter は手を動かさず考え方だけ。そして一番大事なのは「増える仕事」の方で、ストア審査・署名・自動更新・端末差は Web には無かったものです。