01 / OVERVIEW — PROJECT 01 / PRIVATE TOOL + PUBLIC DEMO
eBayTool
複雑な利益判断から始まり、
実際に使いながら育てた販売支援ツール。
実運用版は非公開・保守モード／利益計算の簡易版を公開中
02 / WHY & STORY
利益を判断する手間から、すべてが始まりました。
eBay販売では、仕入価格だけでなく、販売価格、送料、手数料、広告費、為替まで考えなければ利益を判断できません。その計算を簡単にするため、最初は小さな利益計算ツールとして作り始めました。
使い続けるうちに、計算結果を実際の商品と結び付けて残したい、eBay上の状態を同じ場所で確認したいという課題が見えました。そこで商品保存、商品管理、為替自動取得、外部APIからの情報取得へ、必要になった機能を順番に加えました。
03 / FEATURES
現在できること
- 01利益計算
販売価格から最終利益・利益率・損益分岐点を確認し、希望利益から参考販売価格を逆算します。
- 02商品管理
計算条件を商品として保存し、一覧と編集画面で原価、送料、重量、サイズ、メモを管理します。
- 03外部情報の取得
為替を自動取得し、Production APIから商品情報、ビュー、ウォッチ、広告情報を読み取ります。
- 04保存と復元
保存形式の移行、バックアップ、SHA-256検証、失敗時のロールバックを備えています。
- 05販売実績の基盤
Fulfillmentの読み取り専用同期と、重複を防ぐ販売実績保存の基盤まで実装しています。
04 / DESIGN & THINKING
便利さより先に、実運用データを守る。
情報を混ぜない
APIから取得した情報、利用者が入力した原価や送料、計算で求めた値を分離。API取得に失敗しても、既存値や手入力情報を消さない構造にしました。
環境を混ぜない
ProductionとSandboxの接続先、認証情報、macOS Keychainを分離。現在の環境を画面にも表示し、Production接続中の書き込み確認を拒否します。
保存を急がない
バックアップの復元は、読み込み直後に本体へ上書きしません。内容とdigestを検証し、stagingを経て切り替え、失敗時は元の状態へ戻します。
05 / DEVELOPMENT
使うたびに見えた課題を、次の機能へ。
- 01利益計算
送料・手数料・広告費・為替を含む利益を一度に判断。
- 02保存・商品管理
計算結果を実際の商品と結び付け、一覧と編集画面へ発展。
- 03為替・Production API
手作業で確認していた外部情報を読み取り、管理画面へ統合。
- 04安全な更新設計
Sandboxで価格変更、再取得、元価格への復元まで確認。
- 05v2保存・Fulfillment
データ移行と復元を固め、販売実績を保存する基盤へ拡張。
06 / PROBLEMS & IMPROVEMENTS
曖昧さと事故の可能性を、一つずつ減らしました。
PROBLEM
「更新」が送信か取得か分かりにくい
通常の更新はeBayからeBayToolへの再取得と定義。将来の送信操作とは名称、画面、処理を分ける方針にしました。
PROBLEM
API失敗や複数タブで保存値を失う可能性
商品単位・領域単位で最新データへマージし、nullや空値で既存情報を上書きしない保護を入れました。
PROBLEM
価格更新は小さな誤操作でも影響が大きい
専用Sandbox商品だけを使い、事前確認、増減幅制限、更新後再取得、元価格への復元と再確認を一連で検証しました。
07 / TECH & SPEC
画面の裏側にある構成
- DATA
- localStorage、IndexedDB、dataVersion 2、JSONバックアップ
- API
- eBay Trading／Browse／Analytics／Marketing／Fulfillment等の読み取り
- AUTH
- ローカル補助サービス、OAuth、macOS Keychain。Tokenをブラウザ保存しない構成
- SAFETY
- Production／Sandbox分離、競合検出、再取得確認、SHA-256検証、rollback
08 / CURRENT & NEXT
現在は保守モードです。
利益計算から商品管理、Production APIの読み取り、安全な保存・復元、Fulfillmentの最小同期までを実装し、大規模開発を一度止めています。
実注文を使った販売実績保存の最終確認と、Finances API以降は次の段階として保留中です。実運用版は公開せず、一般向け簡易版で利益計算の中心部分を体験できます。
09 / DEMO
利益計算を試す
販売価格からの利益計算と、希望利益からの参考販売価格逆算を利用できます。
eBay Inc.との提携・公認を示すものではありません。