ホーム画面のウィジェットにお気に入りが並び、タップで店の購入画面が開く
Maintainers usually reply within 1 day
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 20/100
Research direction
Start with QuickBuyWidget/FavoritesWidget.swift, then read the referenced requirements in documents/PROJECT.md and documents/DIRECTION.md and the purchase URL rule in .claude/rules/purchase-url.md. Check how issues #9 and #12 provide saved favorites and purchase links, and establish widget verification steps for AGENTS.md. Done means small and medium widgets show the leading favorites, empty state, open the correct purchase URL, and refresh after favorite changes; tests and CI must pass.
Written by the indexing model from the issue text.
Description
困ること
Quick Buy を使う人が、いつもの商品を買い直す時に、毎回アプリを開いて一覧から探す必要があり、ホーム画面から 1 タップで購入画面を開けない。
挙動の変化
- before: ホーム画面に置けるウィジェットは雛形のままで、お気に入りを表示せず、タップしても購入画面は開かない。
- after: ホーム画面のウィジェットにお気に入りが保存した並びで表示され、商品をタップするとその商品が個数分カートに入った店の購入画面が開く。
背景
Quick Buy は、Shopify の店のいつもの商品をお気に入りにし、ホーム画面のウィジェットから購入画面を開く iOS アプリ (要件は documents/PROJECT.md、判断の根拠は documents/DIRECTION.md)。ウィジェットはこのアプリの主な入口で、今は雛形 (QuickBuyWidget/FavoritesWidget.swift) だけがある。
- 画面の見本は
documents/design/mock-2026-11-17/の「ホーム画面のウィジェット」(保存の PR: https://github.com/bannzai/quickbuy/pull/7 )。中サイズは複数件、小サイズは 1 件を出す。見た目の方向は https://github.com/bannzai/quickbuy/issues/8 で bannzai に見てもらっている途中。見本にある「そろそろ」の表示は、リマインド (設定した日数が過ぎた時の知らせ) を作る時に足すため、この issue では作らない - 並びの先頭から、ウィジェットの大きさに入る数だけ表示する (
documents/data-structure/favorite-2026-11-17.html「利用者の操作と、読み書きするデータ」) - ウィジェットのタップで渡る URL は自分のアプリが受け取る、というのが調査の読みで、ウィジェットから Safari を直接開けるかは実機で未確認 (
documents/PROJECT.md「外部サービスの規約で設計に効くもの」の iOS のウィジェットの行、documents/research/2026-11-17/feasibility.md)。タップがアプリを通る作りにすると、リマインドの日数の数え直しができる (同じ資料の型定義の下の箇条書き) - 購入画面の URL は保存済みのお気に入りから組み立て、ウィジェットに渡す値から外部の URL をそのまま開かない (
.claude/rules/purchase-url.md) - ホーム画面へのウィジェットの配置とタップを、simtunnel (GitHub Actions の macOS Runner 上のリモート iOS Simulator) で確かめられるかは未確認。
AGENTS.md「検証方法」に、ウィジェットを実装する最初の issue で確立して追記すると書いてあり、この issue がそれに当たる。simtunnel の操作で配置できなかった時は、試した操作と結果をAGENTS.mdに書き、ウィジェットの表示はプレビューかスナップショットのテストで確かめる - ビルドとテストは PR の CI で確かめる。作業用の Mac でビルド・simulator を動かさない
前提: お気に入りを端末内に保存する issue (https://github.com/bannzai/quickbuy/issues/9 。保存と読み出しの処理) と、お気に入りの一覧の issue (https://github.com/bannzai/quickbuy/issues/12 。保存済みのお気に入りから購入画面を開く処理) が main に入っていること
なぜやるか
- どの仮説・指標を動かすか:
documents/DIRECTION.mdの判定基準「直近 14 日の新規の利用者のうち、ウィジェットを置いた人の割合」と「直近 14 日に購入画面を 1 回以上開いた利用者数」 - 何を観測して思いついたか:
documents/DIRECTION.md「必要な機能」のホーム画面のウィジェットの行が未実装で、QuickBuyWidget/が雛形のままであること - うまくいったら次に何が変わるか: 仮説の中心 (ウィジェットから 1 タップで購入画面) を実際に試せるようになる
- これの最小の版は何か: 小サイズと中サイズのウィジェットにお気に入りを表示し、タップでその商品の購入画面を開く。お気に入りが無い時の表示。確認方法の
AGENTS.mdへの追記 - 今日これ 1 件しか出せないとしても出すか: 出す。仮説がウィジェットを入口にしているため
- まともなエンジニアが読んで、やるべきだと納得する理由が書けているか: ウィジェットが無いと「決めた後は 1 タップ」という仮説を確かめられず、判定基準の 2 行がこの機能を数えるため
完了条件
- ウィジェットが保存済みのお気に入りを並びの先頭から表示し、お気に入りが無い時は登録を促す表示になる (表示する件数を決める処理はユニットテストで確かめる)
- ウィジェットの商品をタップした時に開く URL が、その商品の店のドメイン・商品バリアントの ID・個数から組み立てたものであることをテストで確かめている
- お気に入りを追加・変更・並べ替え・削除した時に、ウィジェットの表示が更新される
AGENTS.md「検証方法」のウィジェットの項に、確立した確認方法か、simtunnel で試した操作と結果が書いてある- PR の CI (
.github/workflows/ci-test.ymlの jobtest) が成功している
同じ問題がある他の場所
なし。新しく作る機能で、gh issue list -R bannzai/quickbuy --state all で同じ内容の issue が無いことを確かめた。
セッション再開
cd /Users/bannzai/ghq/github.com/bannzai/quickbuy
claude --resume 86577cfa-19b2-452c-87c1-baee27a74c3c
- Dominant language
- HTML
- Stars
- 0
- Forks
- 0
- Avg merge
- 6h 58m
- Merged PRs (30d)
- 10
Getting set up
This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from bannzai/quickbuy
-
Difficulty 4/5 3-5 days Newbie friendliness 48/100
Maintainers usually reply within 1 day
-
Difficulty 4/5 3-5 days Newbie friendliness 45/100
bannzai/quickbuy#28 · 1 comment ·
Maintainers usually reply within 1 day
-
Difficulty 3/5 1-2 days Newbie friendliness 55/100
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 20/100
bannzai/quickbuy#18 · 6 comments ·
Maintainers usually reply within 1 day
-
Difficulty 5/5 Over a week Newbie friendliness 15/100
bannzai/quickbuy#17 · 1 comment ·
Maintainers usually reply within 1 day
All issues in bannzai/quickbuy
Similar issues
-
26.04 bug dark-mode Easy Hack impress symptom: visual
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
CollaboraOnline/online#16421 · 1 comment ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
Paul-Austin-Oswego-CSC480-HCI521/gift-app#266 ·
Maintainers usually reply within 1 day
-
Native event listener types should allow a promise return typePossibly taken @willnie9 claimed this today. Openscope: types
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Maintainers usually reply within 1 day
-
bug host P3 web
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
jphacks/kz_2613#589 · 1 comment ·
Maintainers usually reply within 1 day
-
status/awaiting_triage
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
Maintainers usually reply within 1 day