atelier-kyo-manager 機能要件
最終更新: 2026-05-26 関連: 経営者判断 — 手数料・関税率・利益閾値・ブランド戦略等の経営判断はこちらを参照 状態: Phase 1 完了・Phase 2 完了・Phase 3（SaaS化）将来構想
1. システム概要
atelier-kyo-managerは、海外公式ブランドサイトから転送倉庫を経由してBUYMAへ出品する「無在庫転売モデル」に特化した業務管理・自動化システム。
利益最大化と業務効率化を実現するため、価格計算、在庫管理、画像処理、AIによる説明文生成などを統合的に管理する。当初は個人での週10-20時間の開発・運用制限を考慮し、月商30万円を達成するためのMVPを構築し、段階的に機能を拡張していく。
規模（2026-05-26時点）
| 指標 | 値 |
| 総コード行数 | 約12,300行 |
| ルートエンドポイント | 85+ |
| HTMLテンプレート | 37ファイル |
| テスト数 | 1,168テスト（62ファイル） |
| routes | 18ファイル |
| services | 12ファイル |
| models | 19ファイル |
2. 機能要件
Phase 1: コア機能（完了）
| ID | 機能名 | 優先度 | 状態 | 実装場所 |
| FR-001 | 簡易利益計算 | Must | ✅ 実装済み | app/utils/pricing_calculator.py |
| FR-002 | 画像AI処理（収集+背景除去） | Must | ✅ 実装済み | app/services/image_service.py |
| FR-003 | AI説明文生成+出品テキスト | Must | ✅ 実装済み | app/services/template_service.py |
| FR-004 | BUYMA価格調査 | Must | ✅ 実装済み | app/services/price_scraper.py |
| FR-005 | 実ベース利益計算 | Must | ✅ 実装済み | app/core/pricing/calculator.py |
| FR-006 | 18日ルール管理 | Must | ✅ 実装済み | app/models/order.py, app/routes/orders.py |
| FR-007 | 出品候補リスト生成 | Must | ✅ 実装済み | app/routes/products.py + CSV出力 |
Phase 2: 拡張機能（完了）
| ID | 機能名 | 優先度 | 状態 | 実装場所 |
| FR-008 | パイプライン一括実行・バックグラウンド化 | Should | ✅ 実装済み | app/services/pipeline_service.py |
| FR-009 | AI自動発注 & Slack通知 | Should | ✅ 実装済み | app/services/auto_order_service.py, app/services/notification_service.py |
| FR-010 | AI ChatBot（顧客対応） | Should | ✅ 実装済み | app/services/chatbot_service.py, app/routes/chatbot.py |
| FR-011 | 出品完全自動化 | Should | ✅ 実装済み | app/services/template_service.py（BUYMA CSV生成） |
| FR-012 | 発送通知API連携 | Should | ✅ 実装済み | app/routes/shipment_notifications.py, app/routes/warehouse_webhook.py |
| FR-017 | BUYMA出品CSV拡張 | Should | ✅ 実装済み | app/services/template_service.py, app/routes/products.py |
| FR-018 | Analyticsダッシュボード | Could | ✅ 実装済み | app/routes/analytics.py |
Phase 2+: 追加実装済み機能
| 機能 | 実装場所 | 内容 |
| 海外価格スクレイピング | app/services/brand_price_scraper.py | 7ブランドEUR価格自動取得 |
| BUYMA販売価格自動検索 | app/services/buyma_price_scraper.py | ファジーマッチングでBUYMA価格取得 |
| 価格比較ダッシュボード | app/routes/brand_prices.py | 仕入れ原価vs販売価格の利益比較 |
| 在庫・価格チェック | app/routes/stock_checks.py | 出品中商品の在庫・価格自動チェック |
| 人気度トラッキング | app/routes/popularity.py | 商品人気度の記録・追跡 |
| 买付先地域レコメンド | app/routes/region_recommendations.py | 仕入れ地域の推奨 |
| リピーター管理 | app/routes/partners.py（customers） | リピーター顧客管理 |
| 出品進捗トラッカー | app/routes/listing_progress.py | 出品作業の進捗管理 |
| 出品テンプレート管理 | app/routes/listing_templates.py | テンプレートCRUD |
| FAQテンプレート | app/routes/faq_templates.py | 顧客対応FAQ管理 |
| 禁制品買付先チェック | app/routes/prohibited_sources.py | BUYMA規約違反チェックAPI |
| LLMルーティング | app/utils/ai_llm_controller.py | Gemini/OpenAI/DeepSeek/localの統合制御 |
| キャッシュフロー予測 | app/routes/orders.py（/cashflow） | 入金予定の可視化 |
| 為替レート自動取得 | app/utils/fx_utils.py | ECBからEUR/USD/GBP→JPY |
Phase 3: SaaS化（将来構想）
| ID | 機能名 | 優先度 | 状態 |
| FR-014 | マルチテナント・権限管理 | Won’t | 未実装 |
| FR-015 | 海外公式サイト価格調査SaaS | Won’t | 部分実装（FR-004で基盤あり） |
| FR-016 | ChatBot自動海外仕入れ | Won’t | 未実装 |
3. 非機能要件
| 項目 | 要件 | 状態 |
| 認証 | Flask-Login + パスワードハッシュ化 | ✅ 実装済み |
| 可用性 | ローカル/低価格クラウドで稼働 | ✅ |
| 性能 | 利益計算3秒以内、スクレイピングバックグラウンド | ✅ |
| 運用保守性 | モジュール疎結合、フォールバック可能 | ✅ |
| CI/CD | GitHub Actions自動テスト | 📋 未構築 |
| テストカバレッジ | 1,168テスト | ✅ |
| コスト | 初期100万円以内 | ✅ |
4. 制約事項
BUYMA規約遵守（違反 = アカウント停止）
- 禁止仕入れ先: 国内公式オンライン、メルカリ等フリマアプリ
- 許可仕入れ先: 海外オンライン（公式・セレクトショップ）、海外店舗、国内実店舗
- 18日以内発送（延長申請可能）
- 成約手数料 7.7%（国内ショッパー）
技術的制約
- スクレイピングはブロックリスク常時あり → 手動フォールバック必須
- 転送倉庫経由購入 → ブランド側の転売制限に抵触する可能性
開発制約
- ソロ開発、週10-20時間
- MVP優先、スモールスタート
5. 残タスク（実戦投入）
以下は開発ではなくビジネス側の準備が必要:
| タスク | 状態 | 必要アクション |
| BUYMA本人確認 | ⏸️ 未着手 | BUYMAへの本人確認書類提出 |
| 銀行口座登録 | ⏸️ 未着手 | BUYMAに振込先口座登録 |
| 転送倉庫登録 | ⏸️ 未登録 | Buyandship等に登録 |
| 最初の10品出品 | ⏸️ 未着手 | 上記完了後、Tier 2ブランド中心に出品 |
6. 用語定義
| 用語 | 定義 |
| BUYMA | 海外ブランドアイテムの購入代行EC |
| 無在庫転売 | 在庫を抱えず、購入確定後に仕入れるモデル |
| 18日ルール | BUYMA購入者への発送完了を18日以内に行う規則 |
| pipeline_status | 商品のパイプライン処理状態 (pending/running/success/partial/failed) |
| 転送倉庫 | 海外購入品を日本へ転送するサービス (Buyandship等) |