アプリ– category –
自分が実際に使うものを作る。動いて、使えて、手元に残るもの。
-
アプリ
「動く」と「使える」の差は4つの状態 — Reactの画面
APIは前回で動いています。ここからは人が触るものを作るので、判断の基準が「正しいか」から「分かるか」に変わります。hitokoto の画面を3枚だけ作り、Vite の server.proxy で開発中のCORSを消し、そのうえで山場として「読み込み中 / 空っぽ / エラー / 正常」の4つの状態を全部書きます。一番忘れるのは空っぽです。初めて開いた人が最初に見る画面がそこだからです。フォームの二重送信を止め、失敗しても入力を消さず、デザイントークンとButtonを作り直さずに使い回します。最後は npm run build して nginx から dist/ を配り、/api をプロキシして「本番の形」で確認します。開発サーバーでしか動かない状態で終わりにしません。 -
アプリ
全部書いてから動かさない — 作品のAPIと認証
作品づくりの2本目。練習用の ~/server は開けず、新しく ~/hitokoto を作るところから始めます。テーブルより先にマイグレーションを書き、外部キーの ON DELETE を用途で選び分ける。URLの一覧を表で先に決めてから、まず POST /api/books と GET /api/books の2本「だけ」を通す。動いたら次を足す。登録画面は作らず管理者1人を seed で用意し、書き込みだけログインを要求する。入力の検証とエラーの形を1つに揃え、公開用のAPIを別の道に分けて、画面が無いまま curl で全部確かめ、systemd で常駐させるところまで。 -
アプリ
公開の前に、戻せることを確かめる — デプロイと運用の入口
hitokoto はまだ自分のVMの中でしか動いていない。「公開する」を「届く場所に置く・名前を付ける・暗号化する・落ちても戻せる」の4つに分解して、順に埋める。山場はバックアップと復元で、わざと消して戻せることを確かめてから外に出す。独自ドメインもVPSも無くても、VMの中で本番と同じ形を最後まで作れるようにした。 -
アプリ
作らないものリストを先に書く — 個人開発の題材選び
道具は全部そろったのに手が止まるのは、実力の問題ではなく「何を作るか決めていない」からです。この記事ではコードをほとんど書きません。そのかわり紙とファイルに残します。題材の選び方を3条件に絞り、この連載で作るアプリ hitokoto(読んだ本と、そこから引いた一文を残すアプリ)を決めます。山場は作らないものリストで、作るものリストより長く書き、1つずつ「なぜ今はやらないか」と「あとで足せるか」を書きます。画面を3枚に数え、データを users / books / quotes の3つの箱に分けてER図を紙で描き、何ができたら完成かを文章で定義し、最後に docs/adr/0001-what-to-build.md として全文を残します。見積もりはしません。かわりに順番を決めます。 -
アプリ
他人は5分しか見ない — READMEと技術選定
動くものは完成しました。でも、リポジトリのURLだけを渡された人には、それが何なのかも、触れる場所も、なぜその技術なのかも伝わりません。この記事では hitokoto のREADMEを「1行でなにか / スクリーンショット / 触れる場所 / 使い方 / 技術構成 / 設計判断 / 既知の問題 / これから」の順で全文書きます。山場は技術選定の1行説明と、できていないことを正直に書くところ。動く場所が無いときの代替(GIF)、デモ用アカウントの作り方、本物の鍵を置かないこと、コミット履歴も見られていること、AIを使ったことを隠さずに書く方法、ライセンスを付けないと「使えない」の意味になること、そして9段階を振り返って次に何をするかまで。就職の指南記事ではありません。他人が5分で理解できる形にする話です。 -
アプリ
Webhookは向こうから来る — Botと署名検証
APIは「こちらから聞きに行く」もの、Webhookは「向こうから来る」もの。この向きの違いが全部を決めます。まず最大の壁——自分のVMには外から届かない——をNATの話から正面で扱い、トンネル・VPS・ポート開放を比べます。次に受け口を作り、山場の署名検証をHMACで自分で書きます。ここで必ずハマる「express.json のあとでは検証できない」と「=== で比べてはいけない」も実際に起こします。さらに、遅いと再送されて二重実行されること、同じイベントIDが2回来ること(再送は仕様)に、200即返しと冪等化で対処します。最後に返信する側のトークン管理・レート制限・リトライ、そしてBotが荒らしにならないための設計まで。トークンはすべてダミーです。 -
アプリ
npm publish は取り消せない — CLIツールを配る
これまで npm は「取ってくる側」でした。この回は出す側に回ります。Markdownの見出しを一覧にする mdtoc を作り、npm link で手元に入れ、--help と --version を付け、結果は標準出力・メッセージは標準エラーに分け、終了コードを返してCIから使えるようにします。山場は公開の直前です。npm view で名前を調べ、npm pack で中身を見て .env が混ざっていないか確かめ、2要素認証を設定してから publish します。publish は取り消せません。同じ名前とバージョンは二度と使えず、消しても入れた人には影響が残ります。だから公開しないという選択肢(npm pack で配る・GitHubのURLから直接入れる・スコープ付きで組織内に限る)も、対等に並べます。 -
アプリ
他人のページを書き換える — ブラウザ拡張を作る
DOM操作の回で自分のページを書き換えました。ブラウザ拡張は、まったく同じことを他人のページに対してやる仕組みです。この回は Manifest V3 で最小の拡張を1つ作ります。作るのは「開いているページの読了時間を右上に出すバッジ」だけ。文字数を数えるだけの30行です。ストアには出しません。自分のブラウザに読み込んで、自分だけが使う形で完結させます。山場は権限の話で、なぜインストール時の権限画面が怖いのかを、作る側から説明します。あわせて chrome.storage と localStorage の違い、常駐しない Service Worker、他人のページを壊さない作法、そして拡張が売却されて悪意ある更新が降ってくる事故の型まで。
1