Sociofy 仕様書

1. 決定事項

• 提供形態
  最初は内部ツール。将来的には外部顧客が自分のSNSアカウントを接続するマルチテナントSaaSへ拡張する。
• 承認
  公開前に人間の承認を必須にする。完全自動投稿はMVP対象外。
• コンテンツ形式
  静止画スライドショーが中心。AI生成の動画そのものは扱わず、静止画から決定的にMP4を生成する。
• Instagram
  CarouselとReelsの両方をサポートするが、投稿ごとに承認者が有効化する形式を選ぶ。
• TikTok
  MVPではPhoto Modeのみ。動画フォールバックは将来検討に回す。
• YouTube
  Shorts専用APIではなく通常の動画アップロードAPIで縦型MP4を投稿する。
• 言語
  ユーザー選択式。MVPでは英語、スペイン語、韓国語、中国語に最低対応する。
• 画像生成
  OpenAI GPT Image 2、モデルID gpt-image-2 を主画像生成モデルにする。
• スライド構成
  初期はAI生成画像4枚 + 固定CTA画像1枚の5枚構成。CTA画像は日次生成せず、将来の可変化に備えて設定化する。

2. プロダクト設計

コンテンツパッケージ

Sociofyは論理フィードごとに、1日1つの承認済みコンテンツパッケージを生成する。

3. MVPスコープ

4. 推奨技術スタック

内部MVPではTypeScript-firstの業務アプリケーションを推奨する。 機能的に独立Repositoryへ切り分けるほどの境界はまだないため、初期は単一モノレポで進める。 ドメイン設計はモジュラーモノリス寄りに保ちつつ、apps/* と packages/* で実行単位と共有コードを分離する。

社内でAWSを既に利用している前提のため、実行基盤、キュー、ストレージ、ログ、シークレット管理はAWS managed servicesを第一候補にする。 例外はOpenAIによるAI生成、各SNSの公式API、既存開発ワークフローに密接なツールに限定する。

技術スタック対応表

5. コアワークフロー

6. 生成・レビュー要件

プロダクト設定で必要な情報

編集切り口の手動設定

Sociofyは編集切り口の自動提案機能をMVPに含めない。 初期の切り口は人間が手動で考え、オペレーターが管理画面から登録する。 SmartScout初期は既存運用にある4つの切り口を取り込む。

• EditorialAngleのCRUD、複製、並び替え、有効/無効切り替えを提供する。
• CSVまたは簡易フォームでの一括登録を許容する。
• 各切り口は、作成後に言語別LogicalFeedへ展開される。
• 切り口の良し悪しの評価、候補生成、ランキングはMVP対象外にする。

コンテンツ生成の出力

{
  "topic": "string",
  "objective": "awareness | education | activation | retention",
  "angle_id": "string",
  "language": "string",
  "slides": [
    {
      "index": 1,
      "role": "hook | body | proof | cta",
      "headline": "string",
      "body": "string",
      "visual_prompt": "string",
      "alt_text": "string"
    }
  ],
  "captions": {
    "instagram": "string",
    "tiktok_title": "string",
    "tiktok_description": "string",
    "youtube_title": "string",
    "youtube_description": "string"
  },
  "hashtags": ["string"],
  "disclosures": {
    "synthetic_media": true,
    "own_brand_promotion": true,
    "paid_partnership": false
  }
}

レビューUIで表示するもの

• プロダクト、切り口、言語、対象アカウント
• 全スライドの順序付きプレビュー
• プラットフォーム別プレビューとキャプション
• AI生成、ブランド投稿、提携などのラベル
• 予約時刻、API準備警告、投稿上限警告
• InstagramではCarousel、Reels、両方のいずれかを選択

7. レンダリング要件

8. SNS API共通仕様

プラットフォームAPIは変更が多いため、本番公開前および外部SaaS化前に公式ドキュメントを再確認する。 各SNS連携は共通インターフェースを持つアダプターとして実装し、UIから直接呼び出さず、必ずキュー経由で実行する。

interface SocialPublisher {
  validate(job: PublishJob): Promise<ValidationResult>;
  publish(job: PublishJob): Promise<PublishInitResult>;
  pollStatus(job: PublishJob): Promise<PublishStatus>;
  cancel?(job: PublishJob): Promise<void>;
}

共通要件

• idempotency keyを使い、ワーカー再実行で重複投稿しない。
• リクエストID、プラットフォームID、エラーコード、HTTPステータスを保存する。
• アカウント別、アプリ別のレート制限を適用する。
• トークンと署名付きURLをログに出さない。

公開メディアURL

• 生成物の原本と非公開派生物はAWS S3に保存する。
• 投稿時にSNSが取得するURLはCloudFrontのカスタムメディアドメインで配信する。
• 本番では生のS3 URLを使わない。
• TikTok Pull From URLではリダイレクトなし、所有確認済みURL prefixが必要。
• 最低48時間は取得可能にする。

9. TikTok API仕様

MVP方針 TikTokはPhoto Mode Direct Postのみを使う。

10. Instagram API仕様

MVP方針 CarouselとReelsを両方生成可能にし、投稿ごとに承認者が選ぶ。

11. YouTube Shorts API仕様

YouTube Shorts専用の投稿APIは使わず、通常のYouTube Data API videos.insert で縦型MP4をアップロードする。

12. データモデル

中心となる関係は、ProductからEditorialAngle、LogicalFeed、ContentPackage、PlatformRendition、PublishJobへ流れる。

13. 内部API・バックグラウンドジョブ

POST /api/products/{id}/editorial-angles
PATCH /api/editorial-angles/{id}
POST /api/editorial-angles/{id}/duplicate
POST /api/content-packages/{id}/submit-for-review
POST /api/content-packages/{id}/approve
POST /api/content-packages/{id}/request-changes
POST /api/content-packages/{id}/schedule
POST /api/publish-jobs/{id}/retry
GET  /api/social-accounts/{id}/readiness

14. 運用・安全性

エラー処理

コンプライアンスと開示

• 生成スライドショーは内部メタデータ上AI-assistedとして扱う。
• YouTubeでは該当時に status.containsSyntheticMedia=true を設定する。
• TikTokのブランド投稿/提携投稿は現行ポリシーに従ってtoggleを設定する。
• プラットフォーム側に明示フィールドがない場合、キャプションに開示文を入れる。
• 規制や広告ポリシー上危険な主張はProductの禁止主張に登録する。

15. 容量見積もり

1日あたりの画像生成費用

OpenAI API pricingを2026-05-25時点で確認した計画値。SmartScout初期ではGPT Image 2で64枚/日を生成し、固定CTA画像は既存アセットとして再利用する。 実請求は品質、サイズ、prompt tokens、再生成回数、価格改定で変わる。

16. ロードマップ

17. 確定済み論点

• 言語はユーザー選択式。MVP最低対応は英語、スペイン語、韓国語、中国語。
• SmartScout初期の中国語運用は繁体字 zh-Hant をデフォルトにし、簡体字 zh-Hans はcandidateとして残す。
• 言語数は固定上限にしない。AI翻訳は拡張しやすいが、active化は投稿先アカウント、承認、品質確認、分析の準備状態で管理する。
• SmartScout初期の4つの編集切り口は既存運用から取り込み、人間が手動で定義・確認したものをSociofyへ登録する。AI/ChatGPTによる切り口提案、レコメンド、ランキングはMVP対象外にする。
• 公開メディアはAWS S3に保存し、CloudFrontのカスタムドメインで配信する。
• 技術スタックはAWS優先構成。単一モノレポ、pnpm workspace、Turborepo、共有パッケージ、React SPA + MUI v7 + Emotion、S3 + CloudFront、TypeScript API、ECS Fargate、Aurora PostgreSQL Serverless v2または既存方針に合わせたRDS/Aurora PostgreSQL、TypeORM、SQS、EventBridge Scheduler、DB-backed thin orchestrator、Cognito、Secrets Manager、CloudWatch Logs、AWS CDK。本格モニタリングはMVP後に追加する。
• InstagramはCarousel/Reelsを投稿ごとに選ぶ。通常は1形式だけを推奨。
• TikTokはMVPではPhoto Modeのみ。
• 画像生成はOpenAI GPT Image 2 gpt-image-2。MVPでは1 packageあたり4枚を生成し、固定CTA画像1枚を再利用する。

18. 参照資料

公式資料は2026-05-26に確認。

• TikTok Content Posting API Get Started
• TikTok Photo Post API
• TikTok Direct Post Video API
• TikTok Media Transfer Guide
• TikTok OAuth User Access Token Management
• TikTok API Rate Limits
• Instagram Content Publishing
• Instagram IG User Media
• Instagram IG User Media Publish
• YouTube Data API videos.insert
• YouTube Data API quota overview
• YouTube OAuth guide
• YouTube Shorts upload help
• OpenAI Image generation guide
• OpenAI GPT Image 2 model
• OpenAI API pricing
• Amazon S3 static website hosting
• Amazon CloudFront Origin Access Control for S3
• Amazon ECS on AWS Fargate
• Amazon SQS Developer Guide
• Amazon EventBridge Scheduler
• Amazon Cognito user pools
• Amazon Aurora Serverless v2
• AWS Secrets Manager
• Amazon CloudWatch