AQUACUT — 動画制作フロー図
アートアクアリウム美術館 GINZA／TikTok 投稿動画の制作
時点 2026-09-17
読み方 上から下へ流れます。自動＝機械 人＝担当者 未接続＝設計はあるが、まだ繋がっていない工程 任意＝飛ばせる工程。
表の「いまの状態」は 動いている／用意済み／未接続（設計中・未着手を含む）の3段階です。
／ 置き場所と配線は システム構成図
機械が作るのは下書きまでです。
④で組んだ下書きを、⑤で小林が手直しし、⑦で AP社が確認・修正・承認します。
承認された版が FIX 版＝実際に出す絵です（2026-09-13 小林確定）。
⑤は飛ばせます。下書きのまま⑥の書き出しに回して⑦へ出し、AP社側で直してもらうこともできます。
AP社はコンソールから編集画面を開いて自分で直せます。
端から端まで繋がってはいません。③構成案の受け渡しと、⑧投稿連携がまだ空いています。
全体の流れ
現場・素材撮影
小島構成案・投稿
AQUACUT本番VPS
/api・engine・ffmpeg
小林手直し
AP社 コンソール伊藤さん（修正担当＝reviser）
1素材を入れる人
プロジェクトへ取り込む
コンソールの「素材管理」から、または編集画面の素材ビンへ D&D
⚠️ 先に入れておく必要があります。
構成案の画面（ターゲット設定）からは上げられません
①② 取り込む（ffprobe → proxy → シーン検出）
2取り込む（ingest）自動
素材を測って下ごしらえする
ffprobe で尺・解像度・音声を読む ／ 編集用の proxy と poster を作る ／ シーンの切れ目を検出する
↓
台帳に置く素材1件ごとに、測った値と proxy・poster を並べて持つ
ここは人の操作を待ちません。入れた時点で走ります
3構成案を書く人
小島
週次定例のあとに書く
ダッシュボード（PDCA）と定例資料を見て、次に作る本数ぶんの構成案を出す
型／主役語／投稿先／尺／場面数／会期 ほか
受け渡しの契約は ComposerSpec（docs/COMPOSER_CONTRACT.md）
ここがまだ
繋がっていません
画面（composer.html「ターゲット設定」）と契約は用意済み。
渡し方・週の本数・締切の3点を小島と調整中です（2026-09-13〜）
形が決まってから作る
構成案を AQUACUT に合わせない
システムの型に構成案を寄せるのではなく、来た構成案に機械が合わせる（2026-09-13 小林指示）
③④ ComposerSpec を engine へ
4下書きを組む自動
engine が構成案の型からテンプレを選んで組む
構成案の型 announce（告知）／experience（体験）／howto（案内）／ugc（UGC紹介）を、
engine 側のテンプレに割り当てます（howto と ugc は同じテンプレ）。
素材は色相で自動的に選ばれます（カット単位の指定は受けられません）
POST /api/composer/drafts
↓
出てくるのは下書きですここから先、直す人は2人います（⑤小林・⑦AP社）
5手直しする人任意
小林
編集画面で直す
タイムラインとコントロールパネルで、テロップ・カット・BGM を整える
↓
ここは飛ばせます。下書きのまま⑥へ出して、AP社側で直してもらう形も取れます
6書き出す自動
ffmpeg で焼き込んで繋ぐ
テロップを焼き込み、連結し、音の大きさを揃える
POST /api/jobs（kind: render）→ GET /api/jobs/:id/download
↓
mp4 ができる投稿画面に、プレビューと投稿文の下書きが載ります
再書き出しAP社が直した内容で、その場で書き出し直せます（rerender）
7確認・修正・承認人用意済み
AP社 伊藤さん
投稿画面 studio.html
プレビューを見て、①投稿文を確定 ②動画を確定、の2つを済ませると承認ボタンが押せます。
直すときは「修正する」で編集画面が開きます
↓
できること承認／承認の取り消し／編集画面で直す／再書き出し／素材のアップロード・フォルダ整理／一覧から片付ける（アーカイブ・戻せます）
できないこと完全に削除する／素材・プロジェクトの削除／プロジェクトの作成・更新／投稿画面への新規掲載
8投稿する未接続
小島の投稿システム
AQUACUT から投稿はしません
AQUACUT 側の publish は状態を変えるだけです。
承認済みの動画を小島のシステムへどう渡すか、いま形を決めているところです
承認しても、自動では出ません
検討中の形＝AQUACUT が承認済み一覧と期限付きの動画URLを出し、
小島のシステムが取りに来る（pull 型）。両側に作るものがあります
AQUACUT 側に作るもの
⑴承認済み一覧を返す API
⑵認証の外に出す、期限付き・推測不能な mp4 の URL
⑶投稿結果（投稿URL）を受け取る口
※「ローカルに落とさず投稿」は、プラットフォームが動画を取りに来る方式です。
いまは全体に認証が掛かっていて取りに来られないので、⑵が要ります
↓
未確認のこと
いまのドメインで TikTok の所有権確認が通るか（DuckDNS のような共有ドメインを受け付けるか）。
ここが通らないと方式ごと変わります。最初に確かめます
画面の文言について
投稿画面には承認すると「予約に入りました」と出ますが、これは
AQUACUT 側で状態を「承認済み」に変えたという意味です。
実際の投稿は小島のシステムが行います。画面の文言は、繋いだあとに合わせます
9FIX版を学習する設計中
直された結果を次の下書きに返す
FIX 版（＝AP社が承認した版）と下書きの差を、機械で測れる特徴（明るさ・色・動きの量）で見て、④に反映する
小林の直しと AP社の直しは分けて持ちます（2026-09-13 小林確定）。
正本 docs/learning/LEARNING_DESIGN.md
取り込み・書き出し・画面
自動生成
人が決めるところ
できあがり
まだ繋がっていないところ
人の手が要るのはどこか
FIX 版とは何か
FIX 版 ＝ AP社が承認した版です（2026-09-13 小林確定）。
機械の下書きでも、小林が手直しした版でもありません。
この定義は⑨の学習に直結します。学習の「正解」は AP社の承認版で、
小林の手直し版は途中段階として記録します。
「小林の直し」と「AP社の直し」は分けて持ちます — 混ぜると、誰の好みを学んでいるのか分からなくなるためです。
構成案として渡せば効くもの／いま効かないもの
③で受け取る構成案のうち、実際に動画を変えるのはここに挙げた項目だけです（2026-09-13 に実体で確認）。
ここに無いことを書いても、いまの自動編集には入りません。
いちばん効くのはテロップの実文言です（texts.title / subtitle / info）。
空のままだと {axis}が、いちばん美しく見える一瞬。 のような雛形がそのまま出ます。
小島が定例資料で作った言葉をそのまま入れるのが、いちばん価値が高いところです。
ほかに効くもの：場面名（室名ラベル）／見た目の系統（縦組み明朝・横組み・既定のハイブリッド）／
語り口（投稿文の一人称と結びにだけ効く）／作り分けの本数（1〜5本。同じ設定で別案を出す）／音（BGM焼き込み or 無音）。
まだ繋がっていないところ
③ 構成案の受け渡し — 形を小島と決めてから実装
- 画面（composer.html「ターゲット設定」）と契約（ComposerSpec）は用意済み。繋ぐ実装がまだありません
- 調整中なのは 渡し方・週の本数と締切・ダッシュボードとの紐づけの3点（2026-09-13〜）
- ここが決まると受け渡しの形が変わるので、先に作ると作り直しになります
⑧ 投稿連携 — 渡し方を検討中
- AQUACUT の publish は状態を変えるだけ。投稿そのものは小島のシステムが行います
- 検討中の形＝承認済み一覧を API で出し、小島のシステムが取りに来る pull 型
- 未確認：いまのドメインで TikTok の所有権確認が通るか。通らなければ渡し方が変わります
⑨ FIX版学習 — 設計中
- 設計書は docs/learning/LEARNING_DESIGN.md（v2）。コードは未着手です
- 2026-09-13 に「FIX版＝AP社の承認版」と前提が変わったため、いったん改訂を止めています
そのほか
- 同時編集の保護：2人が同じプロジェクトを同時に開いたときの扱いが未着手（2026-09-15 起票）
- 縦組みタイトルの折れ：出力比によって2列に折れる件は、絵を見て小林が決める形で保留（2026-09-06〜）
誰が何を持っているか
⚠️ /console/ のファイルは 755/644（誰でも読める）で配る必要があります。
配信しているサービスと、配備するユーザーが別だからです。
640 で書かれた瞬間に /console/ は全部見えなくなります。
実測値