系统产品说明文档（Product Specification Document）

┌─────────────────────────────────────────────────────────────┐
│                    系统三端架构                          │
├──────────────────┬──────────────────┬───────────────────────┤
│   PC Web 端      │   PC 桌面应用端   │      移动端            │
│                  │                  │                       │
│ • 全功能管理界面    │ • DCC 插件面板    │ • NEXUS Go App        │
│ • 审片播放器       │ • 本地文件操作    │ • 审片 + 管理双模式    │
│ • BI 仪表盘       │ • 桌面通知       │ • 离线支持             │
│ • 客户门户        │ • 高性能渲染预览  │ • 触控批注             │
│                  │                  │                       │
│ 浏览器:           │ 操作系统:        │ 平台:                  │
│ Chrome/Firefox/  │ Windows 10+     │ iOS 15+ / Android 12+ │
│ Safari/Edge      │ macOS 12+       │ iPadOS 15+            │
│                  │ Linux (Ubuntu    │                       │
│                  │ 20.04+/CentOS 7+)│                       │
└──────────────────┴──────────────────┴───────────────────────┘

┌─────────────────────────────────────────────────────────────────────┐
│                    系统功能架构全景图（v2.0）                      │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐     │
│  │ 任务管理 │ │ 文件管理 │ │ 流程自动化│ │ 通讯协作 │ │ 统计与BI │     │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘     │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐     │
│  │ 插件集成 │ │ 审片反馈 │ │ 多地协作 │ │ 外包管理 │ │ 交付管理 │     │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘     │
│                        十大核心模块                                  │
│                                                                     │
│  ┌───────────────┐ ┌──────────────┐ ┌──────────────┐               │
│  │ 移动端NEXUS Go │ │ AI 智能化    │ │ 开发者生态    │  三大扩展     │
│  └───────────────┘ └──────────────┘ └──────────────┘               │
│                                                                     │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │ 用户权限 | 系统管理 | 通知引擎 | 全局搜索 | 审计日志          │   │
│  │ 数据迁移 | 国际化   | 自定义配置| 文件预览 | 客户门户          │   │
│  │ 渲染集成 | 回收站   | 收藏访问  | 帮助引导 | 产能规划          │   │
│  │ Showreel | 技能档案                                          │   │
│  └─────────────────────────────────────────────────────────────┘   │
│                       十七项基础支撑                                  │
└─────────────────────────────────────────────────────────────────────┘

Waiting to Start → Ready to Start → In Progress → Pending Review → Approved / Retake
                                                                         ↓
                                                                   Final (锁定)

          Anim    Light   Comp    Final
SH010     ■绿     ■黄     □灰     □灰
SH020     ■绿     ■绿     ■黄     □灰
SH030     ■红     □灰     □灰     □灰
SH040     ■黄     □灰     □灰     □灰

# 命名规范示例
naming_schema:
  pattern: "{Project}_{Sequence}_{Shot}_{Department}_v{Version:03d}"
  extension_whitelist: [".ma", ".mb", ".nk", ".hip", ".psd", ".exr"]
  example: "NEXUS_SQ010_SH005_Anim_v003.ma"

# 目录结构模板
directory_template:
  shot:
    - publish/        # 已审核发布的文件
    - work/           # 工作中的文件
    - caches/         # 缓存文件（Alembic/VDB等）
    - renders/        # 渲染输出
    - plates/         # 实拍素材
    - reference/      # 参考资料

场景清理 → 缩略图截取 → Playblast 生成 → 门禁检查 → 版本号递增 
→ 文件上传 → 数据库记录更新 → 状态变更 → 通知下游

DCC 进程 (Maya/Nuke/Houdini)           NEXUS Desktop (Tauri)
┌─────────────────────┐                ┌──────────────────────┐
│  NEXUS Plugin        │   TCP Socket   │  DCC Bridge Server   │
│  (PySide6 + Python)  │◄─────────────►│  (Rust, port 9876)   │
│                      │   JSON-RPC 2.0 │                      │
└─────────────────────┘                └──────────────────────┘

DCC Plugin ──TCP──► NEXUS Desktop ──HTTPS──► API Gateway ──► Backend Services
                    (Token 代理)

                    ┌─────────────────┐
                    │   云端主库       │
                    │  (Metadata DB)  │
                    │  (Object Store) │
                    └────────┬────────┘
                             │ 元数据实时同步
              ┌──────────────┼──────────────┐
              │              │              │
     ┌────────▼───────┐ ┌───▼──────────┐ ┌▼───────────────┐
     │  上海边缘节点   │ │ 成都边缘节点  │ │ 温哥华边缘节点  │
     │  (Local NAS)   │ │ (Local NAS)  │ │ (Local NAS)    │
     │  (Cache Layer) │ │ (Cache Layer)│ │ (Cache Layer)  │
     └────────────────┘ └──────────────┘ └────────────────┘

上传PDF → AI解析(NER) → 实体分类 → 人工校验(高亮交互) → 一键生成资产/镜头列表

┌──────────────────────────────────────────────────────────┐
│  顶部导航栏：Logo + 全局搜索 + 通知 + 用户菜单            │
├──────────┬───────────────────────────────┬───────────────┤
│          │                               │               │
│  左侧    │       主内容区域               │   右侧        │
│  导航栏  │                               │   详情面板     │
│          │  • 甘特图/看板/表格视图        │               │
│  • 项目  │  • 审片播放器                 │  • 实体详情    │
│  • 任务  │  • 文件浏览器                 │  • 批注列表    │
│  • 资产  │  • BI 仪表盘                  │  • 活动日志    │
│  • 审片  │  • 工作流编辑器               │  • 关联实体    │
│  • 统计  │                               │               │
│  • 设置  │                               │               │
│          │                               │               │
├──────────┴───────────────────────────────┴───────────────┤
│  底部状态栏：同步状态 + 存储使用量 + 系统通知               │
└──────────────────────────────────────────────────────────┘

┌──────────────────────────────┐
│  NEXUS Panel (200-400px宽)   │
├──────────────────────────────┤
│  [My Tasks] [Loader] [Pub]   │  ← 标签页切换
├──────────────────────────────┤
│                              │
│  当前任务：SH010_Anim_v003   │
│  状态：In Progress           │
│  截止：2026-03-15            │
│  ────────────────────────    │
│  📋 总监反馈：               │
│  "手臂动作幅度再大一些"       │
│  [查看帧级批注]              │
│  ────────────────────────    │
│  📁 输入文件：               │
│  ✅ Rig_v005 (最新)          │
│  ⚠️ Layout_v003 (有更新v004) │
│     [更新] [忽略]            │
│  ────────────────────────    │
│  [打开工作文件]  [Smart发布]  │
│                              │
└──────────────────────────────┘

模块::动作::子动作
示例：
  file::cache::get          # 获取缓存文件
  file::cache::clear        # 清理缓存
  sync::delta::pull         # 拉取增量数据
  sync::offline_queue::push # 推入离线操作队列
  db::tasks::query          # 查询本地任务
  auth::token::refresh      # 刷新本地 Token
  dcc::connect::status      # 查询 DCC 连接状态

┌─────────────────────────────────────────┐
│  NEXUS Desktop (Tauri 主进程)            │
│  ┌───────────────────────────────────┐  │
│  │  Rust Core                        │  │
│  │  • SQLite 本地数据库               │  │
│  │  • 文件缓存管理 (LRU)             │  │
│  │  • 文件监控 (notify-rs)           │  │
│  │  • WebSocket 客户端               │  │
│  │  • 后台同步引擎                    │  │
│  │  • DCC Bridge (localhost TCP)     │  │
│  └───────────────────────────────────┘  │
│  ┌───────────────────────────────────┐  │
│  │  WebView (渲染进程)               │  │
│  │  • React UI（与 Web 端共享组件库） │  │
│  │  • invoke() 调用 Rust Core        │  │
│  └───────────────────────────────────┘  │
└────────────────────┬────────────────────┘
                     │ localhost TCP/Named Pipe
┌────────────────────▼────────────────────┐
│  DCC 插件进程 (Maya/Nuke/Houdini...)     │
│  • PySide6 面板 UI                      │
│  • 通过 localhost:9876 与桌面应用通信     │
└─────────────────────────────────────────┘

分层架构（Clean Architecture 变体）：

┌──────────────────────────────────────┐
│  UI Layer (Widgets + Controllers)     │
│  • ConsumerWidget / HookConsumerWidget│
│  • 只读取 Provider，不直接操作数据      │
├──────────────────────────────────────┤
│  Application Layer (Use Cases)        │
│  • StateNotifierProvider / AsyncNotifier│
│  • 业务逻辑、状态转换、离线队列协调      │
├──────────────────────────────────────┤
│  Domain Layer (Entities + Repos)      │
│  • 纯 Dart 对象，无框架依赖            │
├──────────────────────────────────────┤
│  Data Layer (Repositories + Sources)  │
│  • Provider 封装 Dio 网络请求          │
│  • Provider 封装 Drift/Hive 本地存储   │
│  • 离线/在线数据源自动切换              │
└──────────────────────────────────────┘

{
  "notification": {
    "title": "审片反馈",
    "body": "VFX总监对 SH010_Comp_v005 添加了批注"
  },
  "data": {
    "type": "review.commented",
    "entity_type": "review_session",
    "entity_id": "uuid-xxx",
    "project_id": "uuid-yyy",
    "deep_link": "nexus://projects/uuid-yyy/review/uuid-xxx"
  }
}

src/
├── components/
│   ├── atoms/          # 最小粒度组件（Button, Input, Icon, Badge）
│   ├── molecules/      # 原子组合体（SearchBar, FileCard, UserAvatar）
│   ├── organisms/      # 完整功能区块（GanttChart, ReviewPlayer, TaskBoard）
│   ├── templates/      # 页面骨架布局（ThreeColumnLayout, FullScreenLayout）
│   └── pages/          # 路由级页面组件（ProjectDashboard, ShotDetail）
├── hooks/              # 自定义 Hooks（useWebSocket, useOfflineQueue）
├── stores/             # Zustand stores
├── services/           # API 请求封装
├── utils/              # 工具函数
├── styles/             # 全局样式、Design Tokens
├── i18n/               # 国际化资源
└── routes/             # 路由配置

AuthGuard（登录检查）
  └── TenantGuard（租户校验）
       └── ProjectGuard（项目成员校验）
            └── RoleGuard（角色权限校验）
                 └── FeatureGuard（功能开关校验）

/* tokens.css - CSS 自定义属性 */
:root[data-theme="dark"] {
  --color-bg-primary: #1a1a2e;
  --color-bg-secondary: #16213e;
  --color-bg-tertiary: #0f3460;
  --color-text-primary: #e8e8e8;
  --color-text-secondary: #a0a0a0;
  --color-accent: #4361ee;
  --color-success: #06d6a0;
  --color-warning: #ffd166;
  --color-error: #ef476f;
  --spacing-unit: 4px;
  --radius-sm: 4px;
  --radius-md: 8px;
  --shadow-sm: 0 1px 2px rgba(0,0,0,0.3);
  /* ... */
}

App ErrorBoundary（全局兜底，显示"出错了"+ 刷新按钮）
  └── Layout ErrorBoundary（侧边栏/顶栏独立，主区域出错不影响导航）
       └── Page ErrorBoundary（页面级，显示页面级错误提示）
            └── Widget ErrorBoundary（仪表盘卡片级，单卡片出错不影响其他）

请求拦截器：
  1. 注入 Authorization: Bearer {accessToken}
  2. 注入 X-Tenant-ID
  3. 注入 X-Request-ID (UUID v4)
  4. 注入 X-Idempotency-Key (仅 POST/PUT/PATCH)

响应拦截器：
  1. 401 → 使用 refreshToken 刷新（加锁防并发）→ 重放请求
  2. 429 → 读取 Retry-After → 自动重试
  3. 5xx → 指数退避重试（最多 3 次）
  4. 网络错误 → 检测在线状态 → 离线则入队列

-- 租户表
CREATE TABLE tenants (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    name            VARCHAR(255) NOT NULL,
    slug            VARCHAR(100) UNIQUE NOT NULL,
    logo_url        TEXT,
    settings        JSONB DEFAULT '{}',       -- 全局配置
    license_type    VARCHAR(50),               -- 许可类型
    license_expires TIMESTAMPTZ,
    created_at      TIMESTAMPTZ DEFAULT NOW(),
    updated_at      TIMESTAMPTZ DEFAULT NOW()
);

-- 用户表
CREATE TABLE users (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    tenant_id       UUID NOT NULL REFERENCES tenants(id),
    username        VARCHAR(100) NOT NULL,
    email           VARCHAR(255) NOT NULL,
    password_hash   VARCHAR(255),              -- SSO用户可为空
    display_name    VARCHAR(255),
    avatar_url      TEXT,
    department_id   UUID REFERENCES departments(id),
    role_id         UUID NOT NULL REFERENCES roles(id),
    timezone        VARCHAR(50) DEFAULT 'Asia/Shanghai',
    locale          VARCHAR(10) DEFAULT 'zh-CN',
    status          VARCHAR(20) DEFAULT 'active',  -- active/inactive/suspended
    last_login_at   TIMESTAMPTZ,
    mfa_enabled     BOOLEAN DEFAULT FALSE,
    custom_fields   JSONB DEFAULT '{}',
    created_at      TIMESTAMPTZ DEFAULT NOW(),
    updated_at      TIMESTAMPTZ DEFAULT NOW(),
    UNIQUE(tenant_id, username),
    UNIQUE(tenant_id, email)
);

-- 部门表
CREATE TABLE departments (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    tenant_id       UUID NOT NULL REFERENCES tenants(id),
    name            VARCHAR(255) NOT NULL,
    parent_id       UUID REFERENCES departments(id),  -- 树形结构
    manager_id      UUID REFERENCES users(id),
    created_at      TIMESTAMPTZ DEFAULT NOW()
);

-- 角色表
CREATE TABLE roles (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    tenant_id       UUID NOT NULL REFERENCES tenants(id),
    name            VARCHAR(100) NOT NULL,
    description     TEXT,
    permissions     JSONB NOT NULL,            -- 权限清单
    is_system       BOOLEAN DEFAULT FALSE,     -- 系统预置角色不可删除
    created_at      TIMESTAMPTZ DEFAULT NOW()
);

-- 项目表
CREATE TABLE projects (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    tenant_id       UUID NOT NULL REFERENCES tenants(id),
    name            VARCHAR(255) NOT NULL,
    code            VARCHAR(50) NOT NULL,       -- 项目短代码
    status          VARCHAR(30) DEFAULT 'active',
    resolution      VARCHAR(20),               -- 如 "3840x2160"
    fps             DECIMAL(5,2),              -- 帧率
    color_space     VARCHAR(50),               -- 如 "ACEScg"
    start_date      DATE,
    end_date        DATE,
    budget          DECIMAL(15,2),
    currency        VARCHAR(3) DEFAULT 'CNY',
    naming_schema   JSONB,                     -- 命名规范配置
    directory_template JSONB,                  -- 目录结构模板
    workflow_id     UUID REFERENCES workflows(id),
    custom_fields   JSONB DEFAULT '{}',
    created_at      TIMESTAMPTZ DEFAULT NOW(),
    updated_at      TIMESTAMPTZ DEFAULT NOW(),
    UNIQUE(tenant_id, code)
);

-- 序列/场次表
CREATE TABLE sequences (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    project_id      UUID NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
    name            VARCHAR(255) NOT NULL,
    code            VARCHAR(50) NOT NULL,
    sort_order      INTEGER DEFAULT 0,
    description     TEXT,
    custom_fields   JSONB DEFAULT '{}',
    created_at      TIMESTAMPTZ DEFAULT NOW(),
    updated_at      TIMESTAMPTZ DEFAULT NOW()
);

-- 镜头表
CREATE TABLE shots (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    project_id      UUID NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
    sequence_id     UUID REFERENCES sequences(id),
    name            VARCHAR(255) NOT NULL,
    code            VARCHAR(50) NOT NULL,
    status          VARCHAR(30) DEFAULT 'active',
    frame_start     INTEGER,
    frame_end       INTEGER,
    handle_start    INTEGER DEFAULT 0,         -- 头部余量帧
    handle_end      INTEGER DEFAULT 0,         -- 尾部余量帧
    thumbnail_url   TEXT,
    description     TEXT,
    cut_order       INTEGER,                   -- 剪辑顺序
    custom_fields   JSONB DEFAULT '{}',
    created_at      TIMESTAMPTZ DEFAULT NOW(),
    updated_at      TIMESTAMPTZ DEFAULT NOW()
);

-- 资产表
CREATE TABLE assets (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    project_id      UUID NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
    name            VARCHAR(255) NOT NULL,
    code            VARCHAR(50) NOT NULL,
    asset_type      VARCHAR(50) NOT NULL,      -- character/prop/environment/fx
    status          VARCHAR(30) DEFAULT 'active',
    thumbnail_url   TEXT,
    description     TEXT,
    tags            TEXT[],                    -- 标签数组
    ai_tags         JSONB DEFAULT '{}',        -- AI自动打的标签+置信度
    custom_fields   JSONB DEFAULT '{}',
    created_at      TIMESTAMPTZ DEFAULT NOW(),
    updated_at      TIMESTAMPTZ DEFAULT NOW()
);

-- 资产变体表
CREATE TABLE asset_variants (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    asset_id        UUID NOT NULL REFERENCES assets(id) ON DELETE CASCADE,
    name            VARCHAR(255) NOT NULL,     -- 如"破损版"、"雨天版"
    description     TEXT,
    created_at      TIMESTAMPTZ DEFAULT NOW()
);

-- 资产-镜头关联表 (多对多)
CREATE TABLE shot_assets (
    shot_id         UUID NOT NULL REFERENCES shots(id) ON DELETE CASCADE,
    asset_id        UUID NOT NULL REFERENCES assets(id) ON DELETE CASCADE,
    variant_id      UUID REFERENCES asset_variants(id),
    PRIMARY KEY (shot_id, asset_id)
);

-- 任务表
CREATE TABLE tasks (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    project_id      UUID NOT NULL REFERENCES projects(id),
    entity_type     VARCHAR(20) NOT NULL,      -- 'shot' 或 'asset'
    entity_id       UUID NOT NULL,             -- 关联的shot_id或asset_id
    name            VARCHAR(255) NOT NULL,
    department      VARCHAR(50),               -- 部门/环节：modeling/rigging/animation等
    status          VARCHAR(30) DEFAULT 'waiting',
    priority        VARCHAR(10) DEFAULT 'normal', -- low/normal/high/urgent
    assignee_id     UUID REFERENCES users(id),
    reviewer_id     UUID REFERENCES users(id), -- 审核人
    estimated_hours DECIMAL(8,2),              -- 预估工时
    actual_hours    DECIMAL(8,2) DEFAULT 0,    -- 实际工时
    bid_days        DECIMAL(8,2),              -- 报价天数
    start_date      DATE,
    due_date        DATE,
    completed_at    TIMESTAMPTZ,
    sort_order      INTEGER DEFAULT 0,
    is_locked       BOOLEAN DEFAULT FALSE,     -- Final后锁定
    custom_fields   JSONB DEFAULT '{}',
    created_at      TIMESTAMPTZ DEFAULT NOW(),
    updated_at      TIMESTAMPTZ DEFAULT NOW()
);
CREATE INDEX idx_tasks_project ON tasks(project_id);
CREATE INDEX idx_tasks_assignee ON tasks(assignee_id);
CREATE INDEX idx_tasks_entity ON tasks(entity_type, entity_id);
CREATE INDEX idx_tasks_status ON tasks(status);
CREATE INDEX idx_tasks_due_date ON tasks(due_date);

-- 任务依赖关系表
CREATE TABLE task_dependencies (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    predecessor_id  UUID NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
    successor_id    UUID NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
    dependency_type VARCHAR(5) DEFAULT 'FS',   -- FS/SS/FF/SF
    lag_hours       DECIMAL(8,2) DEFAULT 0,    -- 滞后时间
    lag_percentage  DECIMAL(5,2),              -- 百分比滞后（如完成80%开始）
    UNIQUE(predecessor_id, successor_id)
);

-- 排期基线快照
CREATE TABLE schedule_baselines (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    project_id      UUID NOT NULL REFERENCES projects(id),
    name            VARCHAR(255),
    snapshot_data   JSONB NOT NULL,            -- 任务排期快照
    created_by      UUID REFERENCES users(id),
    created_at      TIMESTAMPTZ DEFAULT NOW()
);

-- 工时记录表
CREATE TABLE timesheets (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    user_id         UUID NOT NULL REFERENCES users(id),
    task_id         UUID NOT NULL REFERENCES tasks(id),
    date            DATE NOT NULL,
    hours           DECIMAL(4,2) NOT NULL,
    description     TEXT,
    created_at      TIMESTAMPTZ DEFAULT NOW(),
    UNIQUE(user_id, task_id, date)
);

-- 发布文件表（已通过审核的版本）
CREATE TABLE published_files (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    project_id      UUID NOT NULL REFERENCES projects(id),
    task_id         UUID REFERENCES tasks(id),
    name            VARCHAR(500) NOT NULL,
    file_type       VARCHAR(50),               -- maya_scene/nuke_script/image/cache等
    version_number  INTEGER NOT NULL,
    file_path       TEXT NOT NULL,              -- 逻辑路径
    file_size       BIGINT,                    -- 字节
    checksum        VARCHAR(128),              -- MD5/XXHash
    thumbnail_url   TEXT,
    metadata        JSONB DEFAULT '{}',        -- 帧范围、分辨率等元数据
    published_by    UUID REFERENCES users(id),
    description     TEXT,
    storage_tier    VARCHAR(20) DEFAULT 'hot', -- hot/warm/cold
    created_at      TIMESTAMPTZ DEFAULT NOW()
);
CREATE INDEX idx_published_files_task ON published_files(task_id);
CREATE INDEX idx_published_files_version ON published_files(task_id, version_number);

-- 文件依赖关系表
CREATE TABLE file_dependencies (
    file_id         UUID NOT NULL REFERENCES published_files(id),
    depends_on_id   UUID NOT NULL REFERENCES published_files(id),
    dependency_type VARCHAR(30),               -- reference/import/cache/plate
    PRIMARY KEY (file_id, depends_on_id)
);

-- 文件锁定表
CREATE TABLE file_locks (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    file_path       TEXT NOT NULL UNIQUE,       -- 被锁定的文件逻辑路径
    locked_by       UUID NOT NULL REFERENCES users(id),
    locked_at       TIMESTAMPTZ DEFAULT NOW(),
    host_name       VARCHAR(255),              -- 锁定发起的主机
    expires_at      TIMESTAMPTZ                -- 自动过期时间
);

-- 存储配置表
CREATE TABLE storage_mounts (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    tenant_id       UUID NOT NULL REFERENCES tenants(id),
    name            VARCHAR(255) NOT NULL,
    mount_type      VARCHAR(20),               -- local/s3/oss/nfs
    config          JSONB NOT NULL,            -- 连接配置（加密存储）
    path_mappings   JSONB NOT NULL,            -- 逻辑路径到物理路径的映射
    is_active       BOOLEAN DEFAULT TRUE,
    created_at      TIMESTAMPTZ DEFAULT NOW()
);

-- 审片版本表
CREATE TABLE review_versions (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    published_file_id UUID REFERENCES published_files(id),
    task_id         UUID REFERENCES tasks(id),
    name            VARCHAR(255),
    media_url       TEXT NOT NULL,              -- 流媒体播放地址
    proxy_url       TEXT,                      -- 代理文件地址
    thumbnail_url   TEXT,
    duration_frames INTEGER,
    resolution      VARCHAR(20),
    color_space     VARCHAR(50),
    status          VARCHAR(30) DEFAULT 'pending', -- pending/approved/retake
    reviewed_by     UUID REFERENCES users(id),
    reviewed_at     TIMESTAMPTZ,
    created_at      TIMESTAMPTZ DEFAULT NOW()
);

-- 批注表
CREATE TABLE annotations (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    review_version_id UUID NOT NULL REFERENCES review_versions(id),
    author_id       UUID NOT NULL REFERENCES users(id),
    frame_number    INTEGER,                   -- 批注所在帧
    frame_end       INTEGER,                   -- 批注结束帧（范围批注）
    annotation_type VARCHAR(20),               -- drawing/text/voice
    drawing_data    JSONB,                     -- 绘图数据（SVG/Canvas序列化）
    text_content    TEXT,                      -- 文字内容
    voice_url       TEXT,                      -- 语音批注URL
    voice_transcript TEXT,                     -- 语音转文字
    is_resolved     BOOLEAN DEFAULT FALSE,
    created_at      TIMESTAMPTZ DEFAULT NOW()
);

-- 播放列表表
CREATE TABLE playlists (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    project_id      UUID NOT NULL REFERENCES projects(id),
    name            VARCHAR(255) NOT NULL,
    description     TEXT,
    created_by      UUID REFERENCES users(id),
    share_token     VARCHAR(100) UNIQUE,       -- 外部分享令牌
    share_expires   TIMESTAMPTZ,
    share_password  VARCHAR(255),
    is_public       BOOLEAN DEFAULT FALSE,
    created_at      TIMESTAMPTZ DEFAULT NOW()
);

-- 播放列表项
CREATE TABLE playlist_items (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    playlist_id     UUID NOT NULL REFERENCES playlists(id) ON DELETE CASCADE,
    review_version_id UUID NOT NULL REFERENCES review_versions(id),
    sort_order      INTEGER DEFAULT 0,
    notes           TEXT
);

-- 聊天频道表
CREATE TABLE chat_channels (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    entity_type     VARCHAR(30),               -- project/sequence/shot/asset/task
    entity_id       UUID,                      -- 关联实体ID
    name            VARCHAR(255),
    channel_type    VARCHAR(20) DEFAULT 'entity', -- entity/direct/group
    created_at      TIMESTAMPTZ DEFAULT NOW()
);

-- 聊天消息表
CREATE TABLE chat_messages (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    channel_id      UUID NOT NULL REFERENCES chat_channels(id),
    author_id       UUID NOT NULL REFERENCES users(id),
    content         TEXT NOT NULL,
    content_type    VARCHAR(20) DEFAULT 'text', -- text/file/system
    reply_to_id     UUID REFERENCES chat_messages(id),
    attachments     JSONB DEFAULT '[]',
    mentions        UUID[],                    -- 被@的用户ID列表
    entity_refs     JSONB DEFAULT '[]',        -- 引用的实体（#深度链接）
    is_pinned       BOOLEAN DEFAULT FALSE,
    created_at      TIMESTAMPTZ DEFAULT NOW(),
    updated_at      TIMESTAMPTZ DEFAULT NOW()
);
CREATE INDEX idx_messages_channel ON chat_messages(channel_id, created_at);

-- 通知表
CREATE TABLE notifications (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    user_id         UUID NOT NULL REFERENCES users(id),
    type            VARCHAR(50) NOT NULL,      -- mention/approval/status_change/system
    title           VARCHAR(500),
    content         TEXT,
    entity_type     VARCHAR(30),
    entity_id       UUID,
    is_read         BOOLEAN DEFAULT FALSE,
    channels_sent   TEXT[],                    -- 已发送的通知渠道
    created_at      TIMESTAMPTZ DEFAULT NOW()
);
CREATE INDEX idx_notifications_user ON notifications(user_id, is_read, created_at);