# CIF OS v16.0 — 完全システム仕様書

**CONFIDENTIAL — INTERNAL SPECIFICATION**

- **バージョン**: CIF OS v16.0
- **作成日**: 2026年4月5日
- **ステータス**: 本番稼働中
- **テスト結果**: 全54テスト PASS（3周検証完了）
- **セキュリティ基盤 増分（固定）**: 本書 v16.0 に対し、横断セキュリティ基盤を **v16.1〜v16.4** として固定。CIF OS 統合バージョンは **v16.4**。詳細は `docs/cif_v16_1_to_v16_4_security_baseline.md` を参照（v16.1 Critical Safety Alignment / v16.2 High-Risk Wiring / v16.3 Storage Safe Helper / v16.4 Legacy Bucket Boundary）。

---

## 目次

1. [システム概要](#1-システム概要)
2. [チャンネル構成](#2-lineチャンネル構成)
3. [v16.0 新機能一覧](#3-v160-新機能一覧)
4. [CIF AI エージェント構成（28体・9階層）](#4-cif-aiエージェント構成28体9階層)
5. [CIF Orchestrator v1.1](#5-cif-orchestrator-v11)
6. [LINE リッチメニュー構成](#6-lineリッチメニュー構成)
7. [主要 API エンドポイント（28本）](#7-主要-apiエンドポイント28本)
8. [外部 UI ページ一覧（18ページ）](#8-外部-uiページ一覧18ページ)
9. [データベース構成](#9-データベース構成)
10. [セキュリティ仕様](#10-セキュリティ仕様)
11. [外部依存サービス](#11-外部依存サービス)
12. [テスト結果](#12-テスト結果3周検証)

---

## 1. システム概要

CIF OS v16.0 は **FastAPI ベースの非同期 Webhook 駆動アーキテクチャ**で構築されたマルチテナント SaaS プラットフォームです。

LINE Messaging API をコアとして、OpenAI / Claude / Gemini を統合し、スケジュール・タスク・メモ・AI動画・収益インテリジェンスなど全 28 AI エージェントを 9 階層で構成します。

全データは **Supabase REST API** で統一管理（psycopg2 直接接続禁止）し、PostgreSQL 20テーブル（CIF Orchestrator 専用）と Supabase（全業務データ）のハイブリッド構成です。

### コアアーキテクチャ

| レイヤー | 技術スタック | 役割 |
|---------|------------|------|
| Webhook受信 | FastAPI + uvicorn | LINE/HTTP イベント受信（署名検証付き） |
| AI処理 | OpenAI / Claude / Gemini | NLP・生成・分析・意図分類 |
| データ永続化 | Supabase REST API | 全業務データ（psycopg2 禁止） |
| CIF DB | PostgreSQL (DATABASE_URL) | Orchestrator 20テーブル専用 |
| スケジューラ | APScheduler | 日次通知・自動実行（毎朝7:00 JST） |
| ストレージ | Supabase Storage | 画像・PDF・動画ファイル管理 |
| 通知チャンネル | LINE Push API | ユーザーへのプッシュ送信 |

### UI/UX 設計方針

- **LINE UI**: 3層 Flex Message 構造・黒背景・ゴールドアクセント・Quick Reply
- **Web ダッシュボード**: Notion×Linear インスパイア・黒背景ゴールドアクセント・PWA対応
- **統一デザインシステム**: 黒×金テーマ・Weekly Calendar Bubble・Daily Cards Carousel・Hourly Timeline

---

## 2. LINEチャンネル構成

### OS International チャンネル（メイン・全機能担当）

- **環境変数**: `LINE_CHANNEL_ACCESS_TOKEN` / `LINE_CHANNEL_SECRET`
- **担当機能**: スケジュール・タスク・メモ・AI動画・リサーチ・戦略・Luna・CIF AI実行・画像生成など全28機能
- **Webhook URL**: `/webhook`

### GCA チャンネル（教育特化）

- **環境変数**: `GCA_LINE_CHANNEL_ACCESS_TOKEN` / `GCA_LINE_CHANNEL_SECRET`
- **対象**: Global Creator Academy（TikTok LIVE クリエイター教育）専用
- **対応リージョン**: USA / CA / JP / UK（4リージョン）
- **特徴**: 自然言語処理なし・教育コンテンツ特化
- **Webhook URL**: `/gca/webhook`

---

## 3. v16.0 新機能一覧

### 3.1 CIF 収益インテリジェンス（完全自動収益化エンジン）

- **フロー**: Gemini 2.0 Flash 市場調査 → Claude Sonnet 収益提案生成 → LINE Flex Message 承認ワークフロー → CIF オーケストレーター自動タスク実行
- **自動実行**: 毎朝 7:00 JST（APScheduler）
- **サービスファイル**: `services/market_intel_service.py`、`services/revenue_proposal_engine.py`
- **DB テーブル**: `revenue_proposals`
- **Web UI**: `/viewer/revenue-proposals.html`（AI実行フロー図・KPI統計・承認/却下UI）
- **LINE トリガー**: 「AI戦略」メニュー → 「収益化提案」
- **API**: `GET /api/revenue-intel/proposals`、`POST /api/revenue-intel/generate`、`GET /api/revenue-intel/stats`

### 3.2 事業案 Validator（Business Case Validator）

- **フロー**: 事業案を6次元構造分解（顧客/チャネル/収益モデル/業種/コスト/再現性）→ ルールスコアリング（LLM不使用）→ 成功12件+失敗8件事例DB照合 → 信頼度スコア付き要約（OpenAI）
- **出力**: Executive Summary / 類似成功事例 / 類似失敗事例 / キーリスク / 検証スコア / 収益化提案 / Next Action
- **サービスファイル**: `services/case_validator_service.py`
- **Web UI**: `/viewer/case-validator.html`（類似度ゲージ・事例DB閲覧・検証履歴）
- **LINE トリガー**: 「事業案を検証」「事業検証」「ビジネス検証」
- **API**: `POST /api/validate/business-case`、`GET /api/validate/reports`、`GET /api/validate/cases`

### 3.3 AI 動画管理 UI

- **機能**: HeyGen/Shotstack 全動画一覧・ステータス表示・インライン再生・スクリプト閲覧・タイトル編集・削除
- **自動更新**: 処理中動画は30秒ごと自動リフレッシュ
- **Web UI**: `/viewer/ai-videos.html`
- **LINE 動線**: 「AI動画」メニュー → 「AI動画一覧」

### 3.4 Google スライド自動生成

- **フロー**: LINE で「プレゼン作って」→ トピック入力 → Claude Sonnet でコンテンツ生成 → Google Slides API で黒金テーマプレゼン作成 → シェアURL送信
- **サービスファイル**: `services/google_slides_service.py`
- **Web UI**: `/viewer/google-slides.html`（プレビュー・スライド数統計・一覧・削除）
- **OAuth**: Slides + Drive スコープ追加済み

### 3.5 AI 画像生成（DALL-E 3）

- **フロー**: LINE コマンド「画像を作って: [プロンプト]」→ DALL-E 3 HD 生成 → Supabase Storage アップロード → LINE FlexCard 配信
- **サービスファイル**: `services/image_gen_service.py`
- **Web UI**: `/viewer/showcase.html`（ライブデモUI・AIギャラリー）
- **API**: `POST /api/image/generate`

### 3.6 cif_context_memory 高速化

- **問題**: PGRST205 エラーで存在しないテーブルへのアクセスが 23秒かかっていた
- **解決**: `_unavailable_tables` セットによる即時スキップ実装
- **効果**: Webhook 応答時間 23秒 → 1〜4秒に大幅改善
- **実装**: `supabase_utils.py` の `SupabaseService` クラス

### 3.7 後方互換エイリアス追加

| 旧エンドポイント | エイリアス先 | 理由 |
|----------------|------------|------|
| `GET /api/ai-videos/list` | `GET /api/ai-videos` | 旧クライアント対応 |
| `GET /api/revenue-intel/status` | `GET /api/revenue-intel/stats` | 旧クライアント対応 |

---

## 4. CIF AIエージェント構成（28体・9階層）

CIF OS は 9 階層 28 体の専門 AI エージェントで構成された組織型 AI システムです。
**CIF Common Protocol** および **Chain of Command Protocol** により階層的意思決定と役割特化が実現されています。

| Layer | エージェント名 | 役割・担当 |
|-------|-------------|----------|
| L1 CEO | CLARA | 最高意思決定AI・全エージェント統括・ユーザー対話主体 |
| L2 CFO | Ren | 財務戦略・リソース配分・収益最大化提案 |
| L3 COO | Aron | 業務執行・タスク管理・スケジュール調整 |
| L4 Safety | Sol | 安全監査・リスク評価・実行停止権限 |
| L5 Research | Lynx | 市場調査・現実性審査・競合分析 |
| L6 Creative | Muse | コンテンツ生成・プレゼン・クリエイティブ |
| L7 Data | Atlas | データ分析・KPI追跡・インサイト抽出 |
| L8 Personal | Luna | 継続学習パーソナルAI・思考モデル構築・Reasoning Engine |
| L9 Specialist | Mason | 財務診断・CFO分析・健全性スコア |
| L9 Specialist | Athena | ピッチデッキ生成・投資家Q&A対応 |
| L9 Specialist | Kai | GCA 教育AI・クリエイター指導 |
| L9 Specialist | 他18体 | 各業界・機能特化専門AI |

### 主要プロトコル

- **CIF Common Protocol**: エージェント間通信の標準規格
- **Chain of Command Protocol**: 階層的指揮命令系統
- **Real Execution System**: 実際のシステム操作を実行するバックエンド
- **Context Layer**: 会話メモリ・スロット継承・自動継続検出

---

## 5. CIF Orchestrator v1.1

「壊れ方まで制御されたシステム」— 11専門サービス構成。

### 構成サービス

1. **CLARA** — 意図解析・要約・指揮
2. **Ren** — コスト評価・財務判定
3. **Aron** — 実行計画・タスク分解
4. **Sol** — 安全監査・緊急停止権限
5. **Lynx** — 現実性審査・情報収集
6. **ApprovalPolicyEngine** — 15次元入力×4ティア承認判定
7. **JobCompiler** — failure_class×recovery_action 設計込みジョブ生成
8. **ExecutionRouter** — デュアルモード実行＋自動フォールバック
9. **LyraArchive** — 実行結果・知識の永続保存
10. **ModelRouting** — OpenAI/Gemini/Claude 自動選択
11. **Orchestrator** — 全体調整・進捗管理

### 実行フロー

```
LINE入力
  → CLARA（意図解析・要約）
  → Ren（コスト評価）
  → Aron（実行計画）
  → Sol（安全監査・停止権限）
  → Lynx（現実性審査）
  → ApprovalPolicyEngine（15次元×4ティア承認判定）
  → ModelRouting（OpenAI/Gemini/Claude 自動選択）
  → ExecutionRouter（実行・フォールバック）
  → LyraArchive（結果保存）
  → LINE返信
```

### 承認ポリシー（4ティア）

| ティア | 条件 | アクション |
|--------|------|----------|
| tier_0 自動実行 | リスク低・コスト小・既知パターン | 即時実行（承認不要） |
| tier_1 条件付き | 中リスク・参照データあり | 内部検証後に実行 |
| tier_2 承認必須 | 高リスク・外部API・データ変更 | 管理者承認待ち |
| tier_3 二重確認 | 最高リスク・不可逆操作・大規模変更 | 二重承認 + 監査ログ |

### 障害・復旧システム

- **failure_classifier**: 障害種別の自動分類
- **recovery_policy_service**: 復旧ポリシーの自動適用
- **execution_validation_service**: QA検証の自動実行

### 専用 DB テーブル（PostgreSQL・20テーブル）

`cif_sessions` / `jobs` / `job_steps` / `approvals` / `agent_status` /
`model_routing_logs` / `analysis_assets` / `dev_tasks` / `cif_roles_output` /
`governance_reviews` / `memory_records` / `approval_policies` / `cif_phase_events` /
`execution_failures` / `recovery_runs` / `qa_validation_runs`

---

## 6. LINEリッチメニュー構成

**仕様**: 3×3グリッド（2500×1686px）・黒背景・カラーアクセント・NotoSansJP
**更新日**: 2026年4月5日（richmenu-40a41594 適用済み）

| セル位置 | アイコン | ラベル | アクション | サブメニュー主要項目 |
|---------|---------|-------|----------|------------------|
| [0,0] | CAL | スケジュール | 今日の予定 | 今日の予定・予定追加・空き時間・今週・リマインダー |
| [0,1] | TSK | タスク | 今日のタスク | 今日のタスク・タスク追加・一括完了・AI提案・進捗 |
| [0,2] | MEM | メモ | メモ | メモを取る・音声コマンド・要約メモ・メモ一覧・業務ログ |
| [1,0] | VID | AI動画 | menu:video | Tips動画・プレゼン作って・AI動画一覧(NEW)・Googleスライド(NEW) |
| [1,1] | RSH | リサーチ | menu:hybrid | リサーチ+提案書・アイデア分解・競合調査・実行計画 |
| [1,2] | STR | AI戦略 | menu:strategy | 収益化提案・提案ダッシュ・事業案を検証(NEW)・検証UI(NEW) |
| [2,0] | LNA | Luna | menu:luna | Luna対話・マインドセット更新・A層インタビュー |
| [2,1] | BOT | AI実行 | menu:cif | AI画像生成・リサーチ実行・収益Ops・ショーケース・指令センター |
| [2,2] | CFG | 設定 | menu:settings | タイムゾーン・通知設定・プロフィール・ヘルプ |

---

## 7. 主要 APIエンドポイント（28本）

### コア

| エンドポイント | メソッド | 説明 |
|-------------|---------|------|
| `/webhook` | POST | LINE Webhook 受信（HMAC-SHA256 署名検証） |
| `/gca/webhook` | POST | GCA LINE Webhook 受信 |
| `/health` | GET | ヘルスチェック |
| `/cif_status` | GET | CIF OS 全体ステータス |

### スケジュール・タスク

| エンドポイント | メソッド | 説明 |
|-------------|---------|------|
| `/schedules/list` | GET | スケジュール一覧 |
| `/tasks/list` | GET | タスク一覧 |
| `/tasks/summary` | GET | タスクサマリー統計 |

### メモ・ダイジェスト

| エンドポイント | メソッド | 説明 |
|-------------|---------|------|
| `/api/viewer/memos` | GET | メモ一覧 |
| `/api/viewer/digests` | GET | ダイジェスト一覧 |
| `/api/viewer/memos/search` | GET | メモ全文検索 |

### 事業案検証

| エンドポイント | メソッド | 説明 |
|-------------|---------|------|
| `/api/validate/business-case` | POST | 事業案検証（6次元スコアリング） |
| `/api/validate/cases` | GET/POST | 事例DB 取得/追加 |
| `/api/validate/reports` | GET | 検証レポート履歴 |
| `/api/validate/reports/{id}` | GET | 検証レポート詳細 |

### 収益インテリジェンス

| エンドポイント | メソッド | 説明 |
|-------------|---------|------|
| `/api/revenue-intel/generate` | POST | 収益提案即時生成 |
| `/api/revenue-intel/proposals` | GET | 収益提案一覧 |
| `/api/revenue-intel/stats` | GET | 収益提案統計 |
| `/api/revenue-intel/status` | GET | `/stats` エイリアス（後方互換） |
| `/api/revenue-intel/proposals/{id}/approve` | POST | 収益提案承認 |
| `/api/revenue-intel/proposals/{id}/reject` | POST | 収益提案却下 |

### AI 動画・画像・スライド

| エンドポイント | メソッド | 説明 |
|-------------|---------|------|
| `/api/ai-videos` | GET | AI動画一覧（HeyGen/Shotstack） |
| `/api/ai-videos/list` | GET | AI動画一覧エイリアス（後方互換） |
| `/api/ai-videos/stats` | GET | AI動画統計 |
| `/api/slides/list` | GET | Googleスライド一覧 |
| `/api/image/generate` | POST | DALL-E 3 画像生成 |
| `/api/image/list` | GET | 生成画像一覧 |

### CIF Orchestrator

| エンドポイント | メソッド | 説明 |
|-------------|---------|------|
| `/api/cif/jobs` | GET | CIF ジョブ一覧 |
| `/api/cif/routing` | GET | AIモデルルーティングログ |
| `/api/cif/failure` | GET | 実行障害ログ |
| `/api/cif/recovery` | GET | 自動復旧ログ |
| `/api/cif/validate` | POST | QA検証実行 |

---

## 8. 外部 UIページ一覧（18ページ）

| URL パス | ページ名 | 主な機能 |
|---------|---------|---------|
| `/viewer/index.html` | メインダッシュボード | 全機能ナビゲーション・v16.0最新機能セクション |
| `/viewer/showcase.html` | Showcase | DALL-E 3 ライブデモ・AI機能紹介・パーティクルアニメーション |
| `/viewer/revenue-proposals.html` | 収益インテリジェンス | AI実行フロー図・KPI統計・承認/却下UI |
| `/viewer/case-validator.html` | 事業案 Validator | 6次元検証・類似度ゲージ・事例DB閲覧・検証履歴 |
| `/viewer/ai-videos.html` | AI動画管理 | 全動画一覧・インライン再生・編集・削除・30秒自動更新 |
| `/viewer/google-slides.html` | Googleスライド | プレゼン一覧・プレビュー・生成前確認 |
| `/viewer/meeting-minutes.html` | 議事録管理 | 音声文字起こし・AI要約・PDF出力・検索 |
| `/viewer/luna-dashboard.html` | Luna Dashboard | 思考モデル可視化・学習ログ・パーソナルOS |
| `/viewer/financial.html` | 財務診断 | Mason CFO分析・健全性スコア |
| `/viewer/pitch-deck.html` | ピッチ支援 | Athena ピッチ生成・投資家Q&A |
| `/viewer/executive.html` | Executive Layer | Clara/Ren/Mason/Sol/Kai ステータス |
| `/viewer/assistant.html` | AI アシスタント | CIF AIエージェント直接対話 |
| `/viewer/work-log.html` | 業務ログ | AI要約・タスク抽出・カテゴリ分類 |
| `/viewer/data-intelligence.html` | データ分析 | メモ・ダイジェスト・インサイト |
| `/viewer/task-calendar.html` | タスクカレンダー | Asana式月次カレンダー・ステータス管理 |
| `/viewer/pc-agent.html` | CIF指令センター | Orchestrator v1.1完全フロー監視・承認・障害 |
| `/viewer/specification.html` | システム仕様書 | 本仕様書（Web版）・PDFダウンロード |
| `/admin/gca` | GCA管理 | クリエイター管理・STL分析・ブロードキャスト |
| `/viewer/gca-broadcast.html` | LINE一斉送信 | 国別クリエイター選択・一括ブロードキャスト |

---

## 9. データベース構成

### Supabase（REST API 経由・全業務データ）

> **絶対ルール**: psycopg2 / DATABASE_URL 直接接続禁止。全テーブルは Supabase REST API 経由のみ。

**`_unavailable_tables` 機能**: 存在しないテーブルへのアクセスを自動スキップ（PGRST205 即時検知）。Webhook 応答時間を 23秒→1〜4秒に短縮。

主要テーブル:
- `schedules` / `tasks` / `task_categories` / `memos` / `memos_metadata`
- `digests` / `digest_tasks` / `meeting_minutes` / `work_logs`
- `business_plans` / `financial_reports` / `pitch_decks` / `slides`
- `revenue_proposals` / `business_cases` / `validation_reports`
- `ai_generated_videos` / `generated_images` / `user_settings`
- `luna_memory` / `conversation_context` / `cif_knowledge_base`

### PostgreSQL（DATABASE_URL・CIF Orchestrator 専用・20テーブル）

psycopg2 による直接接続。CIF Orchestrator 専用。

テーブル:
- `cif_sessions` / `jobs` / `job_steps` / `approvals` / `agent_status`
- `model_routing_logs` / `analysis_assets` / `dev_tasks` / `cif_roles_output`
- `governance_reviews` / `memory_records` / `approval_policies` / `cif_phase_events`
- `execution_failures` / `recovery_runs` / `qa_validation_runs`

---

## 10. セキュリティ仕様

| 項目 | 実装内容 |
|------|---------|
| LINE 署名検証 | X-Line-Signature ヘッダーで HMAC-SHA256 検証（全 Webhook） |
| Admin 認証 | Bearer トークン（ADMIN_TOKEN）・RBAC（viewer/gca_admin/super_admin） |
| マルチテナント分離 | company_id 必須。レガシーは LEGACY_TENANT_ID=0 自動割当 |
| OAuth 2.0 | Google Calendar/Slides・state パラメータ・CSRF 対策 |
| 環境変数管理 | 全シークレットは Replit Environment Variables で管理 |
| Supabase RLS | Row Level Security でテナント間データ分離 |
| ファイルサニタイズ | アップロードファイル名の sanitize 処理 |
| 監査ログ | 管理者操作は全件 audit_log テーブルへ記録 |

---

## 11. 外部依存サービス

| サービス | 用途 | モデル/バージョン |
|---------|------|----------------|
| LINE Messaging API | コアBot機能・Webhook受信 | v3 SDK |
| OpenAI API | NLP・画像生成・音声認識・タスク抽出 | gpt-4o-mini / DALL-E 3 / Whisper |
| Anthropic Claude | 提案書生成・Webリサーチ・タスク分解 | claude-sonnet-4-6 / claude-haiku-4-5 |
| Google Gemini | 市場調査・トレンド分析・翻訳 | Gemini 2.0 Flash |
| Google Calendar API | スケジュール管理 | v3 |
| Google Slides API | プレゼン自動生成 | v1 |
| Zoom API | Zoom会議作成 | Server-to-Server OAuth |
| Supabase | DB・Storage | PostgreSQL + REST |
| HeyGen | AI動画生成 | API |
| Shotstack | 動画レンダリング | API |

---

## 12. テスト結果（3周検証）

**実施日**: 2026年4月5日

| ラウンド | スコア | 内容 |
|---------|-------|------|
| Round 1 | 43/43 PASS | 全Webhook・API・UIページ検証。バグ修正: get_events_multi・/tasks/summary・/api/image/list |
| Round 2 | バグ4件発見 | 修正: /api/ai-videos/list(405)・/api/revenue-intel/status(404)・cif_context_memory 23秒遅延 |
| Round 3 | 54/54 PASS | 全修正確認・高負荷Webhook（20s timeout）含む完全テスト通過 |
| Final検証 | 41/41 PASS | 全API・外部UI・v16.0セクション・LINEサブメニュー動線全確認 |

---

## バージョン履歴

| バージョン | 更新日 | 主な変更 |
|-----------|-------|---------|
| v16.0 | 2026-04-05 | 収益インテリジェンス・事業案Validator・AI動画UI・Googleスライド・DALL-E 3・高速化対応 |
| v15.8 | — | GCA Batch Report System・音声処理強化 |
| v15.0 | — | CIF Orchestrator v1.0 導入 |
| v10.0 | — | マルチテナント SaaS 基盤構築 |
| v7.0 | — | Dual Layer Architecture 採用 |

---

*本仕様書は CIF OS Project の内部機密文書です。*
*© 2026 CIF OS Project. All Rights Reserved.*
*最終更新: 2026年4月5日*

> **常時公開 URL**: https://core-intelligence.pro/docs/CIF_OS_Specification_v16.md
> **仕様書 Web 版**: https://core-intelligence.pro/viewer/specification.html
