お気に入りの追加で商品の種類を複数選び、種類ごとに個数を決めて保存できる

Open
#30 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
48/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
ios, swift
Domain
mobile

Research direction

Read Shared/AddFavoriteView.swift, Shared/ShopifyProductPage.swift, and Shared/Favorite.swift, then review the design mock at documents/design/mock-2026-11-18/index.html and the favorite data structure document. Implement variant selection and per-variant quantities while preserving domain confirmation and the shared menu flow. Done means selected variants save as separate favorites with their names and quantities, the stated tests pass, and the updated documents match the implementation.

Written by the indexing model from the issue text.

Description

困ること

Quick Buy を使う人が、同じ商品の大きさ違いや挽き方違いをいつも買っていても、その商品をアプリのお気に入りに入れる時にどの大きさ・挽き方を入れるかを選べず、渡した商品ページが最初に選んでいる 1 つしかお気に入りにならない。

挙動の変化

  • before: お気に入りの追加の画面は、商品ページの URL が指す商品バリアント (同じ商品の中の、大きさや色などの違いごとの 1 つ) を 1 つだけ登録し、どの商品バリアントかは名前の文字列でしか分からない。
  • after: お気に入りの追加の画面に、その商品の商品バリアントが並び、入れたいものを複数選んでそれぞれの個数を決めると、選んだ商品バリアントごとにお気に入りが 1 件ずつ保存され、それぞれが商品バリアントの名前を持つ。

背景

Quick Buy は、いつもの商品をお気に入りにし、アプリの一覧かホーム画面のウィジェットから店の購入画面を開く iOS アプリ (要件は documents/PROJECT.md、判断の根拠は documents/DIRECTION.md)。この文書では、商品バリアントを画面の文言で「種類」と呼ぶ。

決まっている流れ

bannzai が 2026-11-18 に体験の流れを決め直した (documents/DIRECTION.md「決めたこと」の 2026-11-18「見た目と体験の方向の判断」の行)。そのうちこの issue が扱うのは「お気に入りは個数と種類 (商品バリアント) を決められ、種類ごとに行を分ける」。見本は documents/design/mock-2026-11-18/index.html の「2. 検索 → お気に入り追加 (種類と個数)」で、bannzai はこのモックの方向でよいと返答している (https://github.com/bannzai/quickbuy/issues/8#issuecomment-6968093230 )。

今の実装

https://github.com/bannzai/quickbuy/pull/20 で入った、2026-11-18 の判断より前の形:

  • Shared/AddFavoriteView.swift: 商品ページの URL を入力する画面と、店のドメイン・名前・個数を確かめる画面。アプリの中の貼り付けと、共有メニューの拡張 (QuickBuyShare/) の両方が使う
  • Shared/ShopifyProductPage.swift: 商品ページの URL を店のドメインと商品のハンドルに分解し、店の /products/{商品のハンドル}.js から名前・画像・商品バリアントの ID を取る。URL に ?variant= が無い時は「最初の今買える商品バリアント」を登録し、商品バリアントを選ぶ画面は作っていない (documents/DIRECTION.md「決めたこと」の 2026-11-17「お気に入りの追加の実装」の行。同じ行に、この点は 2026-11-18 の判断で変わると書いてある)
  • Shared/Favorite.swift: お気に入りの型 Favorite は名前・画像の URL・個数・商品・リマインドを持ち、商品バリアントの名前を持たない
この issue で agent が決めたこと

後から変えられる (公開前で、保存の形を変える時に移行は要らない。documents/DIRECTION.md「決めたこと」の 2026-11-17「お気に入りの保存の実装」の行):

  • 見本のお気に入りの一覧 (モックの「4. お気に入り一覧 → カートイン → トースト」) とウィジェット (モックの「5. ウィジェット → 通知」) が、商品の名前と種類の名前を別の行に出しているため、Favorite に商品バリアントの名前を持たせる。Amazon の商品など、種類の名前が無いお気に入りもあるので、無い状態を表せる形にする。型の資料 documents/data-structure/favorite-2026-11-17.html も合わせて直す
  • 商品バリアントが 1 つだけの商品は、選ぶ操作を挟まず、その 1 つの個数を決めるだけにする
  • 商品ページの URL に ?variant= がある時は、その商品バリアントを最初から選んだ状態にする
  • 店のドメインを目立つ形で見せて利用者が確かめる確認 (documents/adr/0003-open-purchase-screen-by-fixed-url-and-user-confirms-payment.md、.claude/rules/purchase-url.md) は、今の画面のまま残す
範囲と検証

範囲に入れないもの: 商品の検索からこの画面に入る入口 (検索に使う API を調べる https://github.com/bannzai/quickbuy/issues/27 の結論の後に別の issue で作る)、Amazon の商品の追加、一覧の行の見た目 (別の issue で作る)。

ビルドとテストは PR の CI で、画面の確認は simtunnel (GitHub Actions の macOS Runner 上のリモート iOS Simulator) で行う。作業用の Mac でビルド・simulator を動かさない (AGENTS.md「検証方法」)。

前提: https://github.com/bannzai/quickbuy/pull/20 が main に入っていること

なぜやるか

  1. どの仮説・指標を動かすか: documents/DIRECTION.md の判定基準「直近 14 日に購入画面を 1 回以上開いた利用者数」。購入画面は、登録した商品バリアントがカートに入った状態で開く (documents/PROJECT.md「体験の流れ」) ので、登録する商品バリアントを選べることが、開いた購入画面の中身を決める
  2. 何を観測して思いついたか: 2026-11-18 の bannzai の判断 (種類を決められ、種類ごとに行を分ける) と、今の追加の画面が商品バリアントを選べないこと
  3. うまくいったら次に何が変わるか: 一覧とウィジェットに種類ごとの行を並べる issue が、種類の名前を持つお気に入りを前提に作れる
  4. これの最小の版は何か: 商品バリアントを選んで個数を決める画面、選んだ数だけの保存、Favorite の商品バリアントの名前
  5. 今日これ 1 件しか出せないとしても出すか: 出す。documents/DIRECTION.md「必要な機能」が、お気に入りの追加とウィジェットの両方を「種類ごとの行」と書いており、その元になる値のため
  6. まともなエンジニアが読んで、やるべきだと納得する理由が書けているか: bannzai が決めた流れの入口で、型の変更を含むため、後ろの画面より先に入れる必要がある

完了条件

  • 商品バリアントが複数ある商品の商品ページの URL を渡すと、追加の画面に商品バリアントが並び、複数選んでそれぞれの個数を決められる
  • 「お気に入りに追加」の操作で、選んだ商品バリアントごとに 1 件ずつ、選んだ個数と商品バリアントの名前を持つお気に入りが保存される (選んだものから保存するお気に入りを作る処理を、ユニットテストで確かめている)
  • 共有メニューから渡した URL でも同じ画面を通る
  • 店のドメインを確かめる表示が残っていて、利用者が追加の操作をするまで保存されない (テストで確かめている)
  • documents/data-structure/favorite-2026-11-17.html と documents/DIRECTION.md (「必要な機能」のお気に入りの追加の行、「決めたこと」の 2026-11-17「お気に入りの追加の実装」の行の、商品バリアントを選ぶ画面を作らないという記述) が実装に合っている
  • simtunnel で撮った追加の画面のスクリーンショットが PR 本文にある
  • PR の CI (.github/workflows/ci-test.yml の job test) が成功している

同じ問題がある他の場所

なし。gh issue list -R bannzai/quickbuy --state all で、商品バリアントを選んで追加する issue が無いことを確かめた。開発者メニューの見本のお気に入り (QuickBuy/DeveloperMenuView.swift) は、この issue で商品バリアントの名前を持つ形に直す。

セッション再開

cd /Users/bannzai/ghq/github.com/bannzai/quickbuy
claude --resume d8b7ab6e-290a-4adf-afcd-a9c4a94ed90a
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

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from bannzai/quickbuy

All issues in bannzai/quickbuy

Similar issues

More Mobile Dev issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.