Skip to main content

📋 要件定義概要

📋 AI SUMMARY​

System: Nekomata Photo Printing Service Requirements Purpose: Multi-brand photo printing platform with 89mm square high-quality prints Key Rules: Multi-brand isolation, PII in Shopify only, 89mm print standard, commercial-grade quality Architecture: Next.js + React Native frontend, Cloudflare Workers backend, Shopify headless commerce

🎯 QUICK REFERENCE​

  • 主要ブランド: neko (猫), tokinoe (日本画), dog (将来展開)
  • プリントサイズ: 89mm × 89mm正方形、1051×1051px @ 300DPI
  • 技術スタック: Next.js + Cloudflare Workers + Shopify + Firebase
  • 目標性能: 表示速度100ms、稼働率99.9%、同時ユーザー1000人

🔗 INTEGRATION POINTS​

  • Input Systems: ユーザーアップロード、Shopify注文データ
  • Output Systems: 印刷工場システム、配送管理
  • Dependencies: Firebase認証、Shopify API、Cloudflare インフラ
  • Validation: 画質チェック、注文検証、配送追跡
# 要件ルール（機械可読版）
BUSINESS_REQUIREMENTS:
  multi_brand_support:
    - "ブランド: neko, tokinoe, dog"
    - "完全分離: データ・UI・設定"
    - "統一管理: 管理画面・API"
    
  print_specifications:
    - "サイズ: 89mm × 89mm正方形"
    - "解像度: 1051×1051px @ 300DPI"
    - "用紙: 写真用光沢紙"
    - "品質: 商業レベル"
    
  data_privacy:
    - "PII保存: Shopifyのみ"
    - "D1データベース: PII一切保存禁止"
    - "工場アプリ: 一時取得のみ（保存禁止）"

TECHNICAL_REQUIREMENTS:
  performance_targets:
    - "表示速度: 100ms以下"
    - "稼働率: 99.9%以上"
    - "同時ユーザー: 1000人対応"
    - "API応答時間: 200ms以下"
    
  scalability:
    - "エッジ配信: 世界展開対応"
    - "自動スケーリング: 負荷対応"
    - "CDN活用: 高速配信"

🎯 サービス概要​

Nekomataは、愛猫の写真を89mm正方形の高品質プリントに変える写真印刷サービスです。

核心機能​

  • 📷 写真アップロード: スマホ・PCから簡単投稿
  • 🎨 簡易編集: トリミング・フィルター機能
  • 💳 オンライン決済: Shopifyによる安全な支払い
  • 🏭 高品質印刷: 商業レベルの89mm正方形プリント
  • 📦 配送管理: 自動発送・追跡システム

🏗️ システム構成​

詳細はシステム設計を参照

主要技術スタック​

  • フロントエンド: Next.js + React Native (Expo)
  • バックエンド: Cloudflare Workers + D1 + R2 + Queues (API制限対策)
  • 認証: Firebase Authentication
  • EC基盤: Shopify (Headless)
  • 非同期処理: Cloudflare Queues + Workers (Shopify API制限回避)
  • 工場システム: Electron App

📊 品質・性能要件​

パフォーマンス目標​

項目目標値根拠
表示速度100ms以下World-Class UX基準
注文処理2秒以内Queueシステムで即座レスポンス
稼働率99.9%以上商用サービス標準
同時ユーザー1000人対応成長予測ベース
APIエラー率0% (429エラー)Queueシステムで完全解決

セキュリティ基準​

  • 🔐 認証: Firebase Auth + JWT検証
  • 🛡️ データ保護: GDPR準拠・暗号化保存
  • 📝 監査ログ: 全API操作記録

📦 商品・サービス仕様​

MVP商品​

  • サイズ: 89mm × 89mm正方形
  • 解像度: 1051×1051px（300DPI）
  • 用紙: 写真用光沢紙
  • 価格: 競合調査ベース設定

将来展開​

  • 🐶 犬向けサービス
  • 🎨 日本画プリント
  • 📱 スマホケース・マグカップ

⚠️ 重要な制約・リスク​

技術制約 → 🎉 Queue Systemで完全解決​

詳細は 技術制約リファレンス を参照

✅ 完全実装済みソリューション​

  • ✅ Shopify API制限: Cloudflare Queues + Workersで429エラー100%撲滅
  • ✅ 注文処理高速化: 即座レスポンス(≤ 2秒) + 背景処理
  • ✅ 障害耐性: 自動リトライ + DLQ(Dead Letter Queue)対応
  • ✅ 重複防止: Idempotency Keyで同一注文の重複処理防止
  • ✅ 監視体制: Queue状態リアルタイム監視システム

📈 成功指標​

目標KPI​

  • 月間注文: 1000件（6ヶ月目標）
  • 顧客満足度: 4.5/5以上
  • リピート率: 30%以上

詳細設計: システム設計 | 開発ガイド