Plan

現行計畫

追蹤 repo 內各計畫/設計文件的狀態,以及正在進行或待啟動的工作。方向層級的整理見 Roadmap。

設計文件狀態

文件	內容	狀態
plan-for-deploy-r2.md	全量影像上傳 R2 + 上線 runbook	✅ 已完成執行,保留作維運參考(見 Maintenance)
docs/plans/2026-07-01-owner-login-design.md	owner 登入 + 伺服器端互動紀錄設計	🟡 已上線(bearer token 路徑);Access email 閘門尚未建立

進行中 / 待啟動

1. 建立 Access email 登入閘門(方向 A)— 最優先

設計已定案、後端已支援,只差建立 Access 應用。無法 headless 完成的原因:現有 Cloudflare token(wrangler OAuth + MCP)對 Access 只有 read 權限。

執行步驟(擇一):

• cf-gate skill:在 skill 的 .env 放入具 Access: Apps and Policies: Edit 權限的 API token,然後 cf-gate gate hematok.hsiehting.com/api hsieh.ting.lin@gmail.com
• 直接呼叫 API:POST /accounts/{id}/access/apps,設 self_hosted_domains: ["hematok.hsiehting.com/api", "hematok.pages.dev/api"], 一條 allow policy 含 hsieh.ting.lin@gmail.com,IdP 用既有 onetimepin。

注意:只蓋 /api 路徑,絕不蓋整個站(站必須保持公開匿名可瀏覽)。Team domain:htlin.cloudflareaccess.com。

完成後:header 的 Login 改指向 /api/login?rd=…(trampoline 已部署),bearer token 變為選用。

2. 推薦訊號調整

伺服器端已累積 like / dislike / read,下一步在 worker 的排序中引入權重與時間衰減。尚未開設計文件。

待決事項

• Access 上線後是否保留 bearer token 作為備援(建議保留,成本低)
• 多使用者化的時機:等有第二位使用者需求再動(YAGNI)

慣例

• 新的設計文件放 docs/plans/,檔名 YYYY-MM-DD-<slug>.md,內文標註 Status
• 文件狀態變更時同步更新本頁與 Roadmap