home-kitchen¶

自宅のコーヒーと料理を、同じ帳面に残す PWA である。公開 URL は https://home.ntatsuya.com。Cloudflare Access の後ろで動かす。

アプリのホーム画面名は recipe である。 Worker 名と GitHub リポジトリ名は home-kitchen のままである。

このドキュメントについて

この docs/ は Zensical 向けのコンテンツツリーである。集約リポジトリ（docs-hub）はフォルダ構成からナビを自動生成する。ページの追加と移動は、このリポジトリの docs/ だけ直せば足りる。

読み方（4系統）¶

系統	問い	入口
使い方	画面で何ができるか	タブ、タイマー、お気に入り
アーキテクチャ	どう動くか、誰が見られるか	技術スタック、アクセス制御、データ
運用	何をすればよいか	ローカル、デプロイ、マイグレーション
参照	本番 URL はどこか	ホストと Cloudflare

取込系統は無い。レシピは手入力が正であり、外部サービスからの自動取込は実装していない。

いまできること¶

コーヒー帳と料理帳の一覧、詳細、追加、編集、削除、写真
コーヒーの抽出タイマー（音と振動、3秒前の予告）
お気に入りと閲覧履歴（ホーム、最大3ページ）
編集履歴（最大50件、変更箇所の粗いラベル）
PWA としてホーム画面に追加

まだないもの: レシピ URL の取り込み、コレクション、分量の倍率、本文のオフライン複製。

よく使うページ¶

用途	ページ
画面の操作	アプリの使い方
技術スタック	全体構成
誰が何を見られるか	アクセス制御
テーブルと R2	データ
手元で動かす	ローカル開発
本番へ出す	デプロイ

ディレクトリ構成¶

.
├── .github/workflows/
├── src/                 # React クライアント
├── worker/              # Hono API（Cloudflare Workers）
├── shared/              # クライアントと Worker で共有する型
├── migrations/          # D1
├── public/              # PWA アイコン
└── docs/
    ├── guide/
    ├── architecture/
    ├── ops/
    └── reference/