作るかの判断: 仮説・成功指標・必要な機能の一覧とお気に入りの型
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 15/100
Research direction
Start by reading the linked research report and the favorite data structure document; the issue asks the project owner to decide whether to build Quick Buy, its feature order, the Favorite type, Amazon’s initial role, and Firebase use. Reply to the numbered decisions in the issue. The work is complete when those decisions are made; implementation depends on them.
Written by the indexing model from the issue text.
Description
困ること
Quick Buy を作るか、何を最初に作るかがまだ決まっていない。このままだと、機能の実装・デザイン・ストアの準備に進めない。
決めてほしいこと
下の 1〜5 にコメントで返答をください (番号ごとに一言で足ります。「任せる」でも進みます)。返答を待つ間も、返答に依存しない土台 (規約・iOS の雛形・CI・法務文書) は https://github.com/bannzai/quickbuy/pull/1 で進めています。
- 作るか (作る / 作らない)
- 必要な機能の過不足と、作る順
- お気に入りのデータの形 (型定義を下に載せています)
- Amazon を最初の版でどう扱うか
- 計測に Firebase を使い、agent が Firebase のプロジェクトを作ってよいか
評価の結論: 作る (ただし需要とマネタイズは △)
需要・競合・マネタイズ・実現性を調べ、評価レポートにまとめた。
| 観点 | 判定 | 要点 |
|---|---|---|
| 需要 | △ | 「履歴・お気に入りから買い直す」行動は大手 EC のレビューで確かめられた。同種のアプリは評価 0〜88 件 (多くは 2026 年公開)。「ウィジェットから買いたい」という利用者の言葉は 0 件 |
| 競合・代替 | △ | 1 社の中の再購入は埋まっている。複数の店の商品をウィジェットからカートに入った状態で開くアプリは、調べた範囲では見つからなかった。最も近いのは「リピかご」(2026-07 公開、評価 0 件。Amazon・楽天・Yahoo! の商品ページをワンタップで開く) |
| マネタイズ | △ | 月 10 万円に要る購入は、Amazon の紹介料 5% なら月 667 件、Shopify の 0.3% なら月 11,112 件 (注文 3,000 円の仮定)。Amazon はアプリの審査での承認が前提 |
| 実現性 | △ | 最初の版はサーバー無しで作れる。Amazon の規約と iOS のウィジェットの制約が設計を縛る (下の「先に知っておいてほしい制約」) |
| 作り手の文脈 | ○ | 既存の案「Shopify Dash Button」と同じ方向。ウィジェットを持つ iOS アプリの実績がある |
作り手の目的は「収益」、目標は月 10 万円と仮定した (企画の試算の値)。違っていたら教えてください。
仮説
同じ商品を繰り返し買うが、間隔が決まっておらず定期購入は契約したくない人が、いつもの商品が切れそうな時に、店を開いて商品を探してカートに入れる手間を面倒に感じている。お気に入りをホーム画面のウィジェットに並べ、タップすると商品がカートに入った状態の購入画面が開くことで、「自分で決めるが、決めた後は 1 タップ」にする。
成功指標・しきい値・打ち切り条件 (判定は 14 日ごと)
しきい値は実測の裏付けが無い仮の値。直したい数があれば書いてください。
| 指標 | 継続のしきい値 | 打ち切り条件 | 転換の条件 |
|---|---|---|---|
| 直近 14 日に購入画面を 1 回以上開いた利用者数 | 10 人以上 | 3 人未満が 2 回連続 | 新規は 10 人以上いるのに開いた人が 3 人未満なら、お気に入りを登録する入口を作り直す |
| 新規の利用者のうち、ウィジェットを置いた人の割合 | 30% 以上 | 10% 未満が 2 回連続 | ウィジェットは置かれないがアプリの中から開かれているなら、通知・アプリ内の一覧を主な入口に替える |
| 購入画面を開いた利用者のうち、次の 14 日にも開いた人の割合 | 30% 以上 | 10% 未満が 2 回連続 | 1 回しか開かれないなら、対象を「毎月買う消耗品」に絞る |
必要な機能と、作る順 (決めてほしいこと 2)
企画の「最初に作る範囲」に沿って分けた。
最初に作る (iOS。お気に入り → ウィジェットのタップ → 購入画面)
土台 (先に作り、ほかの機能が依存する):
- お気に入りを端末内に保存する。一覧・名前と個数の変更・並べ替え・削除
- 購入画面を開く (Shopify の店は cart permalink)
- 開発者メニュー (DEBUG ビルドだけ): 見本のお気に入りを入れる・消す
土台の上に作る:
- お気に入りの追加: 商品ページの URL か店が配る追加リンクを、貼り付けるか共有メニューから渡す
- ホーム画面のウィジェット: お気に入りを並べ、タップで購入画面を開く
- 店ごとの「いつものセット」: 同じ店のお気に入りを 1 つの URL にまとめて開く
- 設定画面: お問い合わせ・利用規約・プライバシーポリシー・アフィリエイトのリンクを含むことの表示
- 計測とクラッシュ収集 (Firebase Analytics・Crashlytics。決めてほしいこと 5)
- 多言語化 (日本語・英語) とストアの素材
その後 (上が触れるようになってから、順に)
- 自分のサーバーを経由する URL (ブックマークできる・中身の商品を後から変えられる・経由した回数を数える)
- アプリ内の検索 (Shopify の Catalog)
- 相性の良い商品の一覧 (最初の画面) と、店の表示枠
- 通知から購入画面を開く
- 店向けの無料 Shopify アプリ (「Quick Buy に入れる」ボタン・追加リンク・QR)
- Android 版 (Kotlin・Glance)
- 楽天の商品 (商品ページを開くところまで)
企画と違う点が 2 つあります。
- 企画の「最初に作る範囲」の 1 番「Shopify の Catalog の API キーを発行し、日本の店の商品が検索に出るかを試す」は、API キーの発行が bannzai にしかできないため「その後」に置いた。先に試したい場合は発行をお願いします (下の「bannzai にしかできない作業」)
- 企画の入口 (検索・一覧・店が配るリンクや QR) に無い「URL を貼り付ける・共有メニューから渡す」を足した。検索と一覧は API キーとサーバーが要り、それらが無い最初の版でお気に入りを登録する手段が要るため
お気に入りのデータの形 (決めてほしいこと 3)
最初の版が端末内に保存する型はこの 1 つだけです。型定義と、利用者の操作ごとの読み書きの表を 1 ページにまとめました。
- 見やすいページ (bannzai のアカウントだけが開けます): https://claude.ai/artifact/LRs5gZc3jfFa6AgF5gL9Eu
- リポジトリ内の同じ内容: https://github.com/bannzai/quickbuy/blob/803e9c46609fd5b5184dfdb469ba44edab2b9039/documents/data-structure/favorite-2026-11-17.html
/// お気に入り: 利用者が「また買う」ために登録した 1 つの商品。
struct Favorite: Codable, Identifiable, Equatable {
/// お気に入りの識別子 (端末内で作る)。
let id: UUID
/// 一覧とウィジェットに出す名前。利用者が編集できる。
var name: String
/// 商品の画像の URL。取得できなかった時は nil。
var imageURL: URL?
/// 1 回に買う個数。1 以上。
var quantity: Int
/// どの店のどの商品か。
var product: Product
/// 購入画面を開くのに要る、店の種類ごとの商品の指し方。
enum Product: Codable, Equatable {
/// Shopify の店の商品。店のドメインと商品バリアントの ID。
case shopify(shopDomain: String, variantID: UInt64)
/// Amazon (amazon.co.jp) の商品。ASIN。
case amazon(asin: String)
}
}
// 端末内に保存するのは [Favorite] の 1 つだけ。配列の並びが、一覧とウィジェットの並び順になる。
見てほしい点:
- URL ではなく、店のドメイン・商品の識別子・個数を保存する。企画は「URL を保存して開く形」だったが、URL のままだと個数の変更や同じ店の商品をまとめるたびに URL を書き換えることになり、渡された URL をそのまま開く作りにもなる
- 「いつものセット」を保存しない。同じ店のお気に入りは全部まとめて 1 つのセットになる。「セットに入れる商品を選ぶ」「同じ店でセットを 2 つ持つ」が要るなら、セットの型を足す
- アカウント・購入の履歴・最後に開いた日時は持たない
Amazon を最初の版でどう扱うか (決めてほしいこと 4)
規約に書いてあること (Amazon アソシエイト・プログラムのポリシー https://affiliate.amazon.co.jp/help/operating/policies を 2026-11-17 に取得。原文の引用は documents/research/2026-11-17/monetization.md):
- モバイル・アプリケーション・ポリシー: 「Google Play、AppleまたはAmazonアプリストアのいずれかで提供されること」「Amazonのショッピングアプリの機能を模倣(エミュレート)しないこと」「甲は、乙のアプリケーションを審査し、参加の可否を通知します。」
- 参加要件 第 5 条(a): 「承認モバイル・アプリ」を除き、端末上のソフトウェアにリンクを置くことを禁じている
- 参加要件 第 6 条(u): 「乙は、乙自身の使用またはその他の個人もしくは企業の使用が目的であるかを問わず、特別リンクを経由して直接または間接的に商品を購入したり…してはなりません。」
企画の実測: Amazon のカートに入れる URL は、アソシエイトのタグが無いと空のカートへ送られる。
ここからは agent の読みで、Amazon に確かめたものではありません。
- Amazon のカートに入れる機能は「アプリを公開 → 承認を申請 → 承認後に有効にする」の順になる (承認の条件がストアで提供されていることで、承認前はタグ付きのリンクを置けないため)
- bannzai 自身が自分のタグで Amazon の商品を買い直す使い方は、第 6 条(u) に当たる
- 「いつもの商品を 1 タップで買い直す」が「模倣しないこと」に当たるかは、審査の結果を見るまで分からない
選択肢:
- 案 A (agent の推奨): 最初の版は Shopify の店だけにする。公開後に Amazon へ承認を申請し、通ったら Amazon を足す
- 案 B: 最初の版から Amazon の商品も登録できるようにし、承認までは商品ページを開くだけ (タグ無し・カートには入らない) にする
- 案 C: Amazon を対象から外す
配信先
立ち上げ情報のとおり、iOS (App Store) と Android (Google Play) のストア配布として進めます。Android は iOS の最初の版の後に着手する案です (上の「その後」)。
先に知っておいてほしい制約
- iOS のウィジェット: タップで渡る URL は自分のアプリが受け取る、と Apple の文書にある。ウィジェット → Quick Buy が一瞬開く → 店の購入画面、という経路になる見込み (文書からの推論。実機では未確認で、ウィジェットを実装する時に確かめる)
- Shopify の cart permalink: 従来の形は legacy で、後継の形は店ごとの設定を読む必要がある。最初の版は従来の形で作り、後継への対応は別の issue にする
- Shopify の紹介料 (promoted placements): 0.3%・招待制。順番待ちの登録は bannzai の作業
- Shop アプリ: 「再購入の動線が無い」という企画の確認と食い違う情報が検索に出た (本文は未取得)。手元の Shop アプリでもう一度見てもらえると確かです
bannzai にしかできない作業
作ると決まった後に「ユーザー作業の一覧」の issue にまとめます。今の時点で見えているもの:
- simtunnel (GitHub Actions 上のリモート iOS Simulator) 用の Secrets
TS_OIDC_CLIENT_ID/TS_OIDC_AUDIENCEを quickbuy に登録する (未登録の間、agent は画面の動作確認ができない) - Shopify の Dev Dashboard で Catalog の API キーを発行する / promoted placements の順番待ちに登録する
- Amazon アソシエイトへのアプリの承認の申請 (公開後)
セッション再開
cd /Users/bannzai/ghq/github.com/bannzai/quickbuy
claude --resume 8f529b2f-93c9-4048-b3e0-91a832b2851e
- 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
-
design good first issue help wanted
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
-
Unified account interface not translated into Simplified ChinesePossibly taken @xuenhua claimed this 2 days ago. Openunconfirmed
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
thunderbird/thunderbird-android#11936 · 1 comment ·
Maintainers usually reply within 3 days
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
tauri-apps/tauri#16563 ·
Maintainers usually reply within 1 day
-
fxios-coreexperience
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
mozilla-mobile/firefox-ios#36661 ·
Maintainers usually reply within 1 day
-
good first issue qualidade
Difficulty 1/5 Under an hour Newbie friendliness 72/100
Maintainers usually reply within 1 day