Bladeren bron

feat(docs): add comprehensive design documents for multi-camera surveillance system

- Introduced two new documents detailing the brainstorming and design phases for a multi-camera surveillance system tailored for Japanese pachinko parlors.
- The brainstorming document outlines use cases, system module breakdown, camera layout strategies, and compliance with privacy regulations.
- The design document elaborates on design goals, business use cases, camera layout strategies, multi-angle playback interactions, storage policies, and compliance with Japanese laws.
- These documents serve as foundational resources for the development and implementation of the surveillance system, ensuring clarity and alignment on objectives and requirements.
yb 2 weken geleden
bovenliggende
commit
4724fde476

+ 324 - 0
docs/pachinko-multi-camera-system-brainstorm.md

@@ -0,0 +1,324 @@
+# 日本パチンコ店多摄像头监控+多角度同步回放系统
+
+> 版本: v2.0
+> 日期: 2026-01-16
+> 状态: 头脑风暴完成
+
+---
+
+## 1. 用例场景 (Use Cases)
+
+| 场景 | 描述 | 优先级 |
+|------|------|--------|
+| **纠纷回溯** | 客户投诉机台故障/奖金争议,需多角度验证 | P0 |
+| **作弊检测** | 识别职业作弊团伙行为模式 | P0 |
+| **事故取证** | 打架斗殴、盗窃等治安事件 | P0 |
+| **员工监督** | 收银操作合规性、服务质量 | P1 |
+| **运营分析** | 热门机台、客流动线分析 | P2 |
+| **合规审计** | 定期提交给监管部门的证据存档 | P1 |
+
+---
+
+## 2. 系统模块拆分
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      管理层 (Management)                     │
+├─────────────┬─────────────┬─────────────┬──────────────────┤
+│  用户权限   │  设备管理   │  告警中心   │   报表统计       │
+└─────────────┴─────────────┴─────────────┴──────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│                     业务层 (Business)                        │
+├─────────────┬─────────────┬─────────────┬──────────────────┤
+│ 同步回放引擎│ 事件标签系统│ 智能检索   │  导出/分享       │
+└─────────────┴─────────────┴─────────────┴──────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│                     数据层 (Data)                            │
+├─────────────┬─────────────┬─────────────┬──────────────────┤
+│  时间轴索引 │ 元数据存储  │ 热存储NVR  │  冷存储归档      │
+└─────────────┴─────────────┴─────────────┴──────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│                    采集层 (Ingestion)                        │
+├─────────────┬─────────────┬─────────────┬──────────────────┤
+│ RTSP采集网关│ 时钟同步NTP │ 编码转码   │  边缘AI检测      │
+└─────────────┴─────────────┴─────────────┴──────────────────┘
+```
+
+### 核心模块职责
+
+| 模块 | 职责 | 关键技术点 |
+|------|------|-----------|
+| **采集网关** | 统一接入各品牌摄像头 | RTSP/ONVIF协议适配 |
+| **时钟同步** | 确保多路视频帧级对齐 | NTP + PTP精确时钟 |
+| **同步回放引擎** | 多画面联动播放/暂停/跳转 | 基于时间戳的帧对齐 |
+| **事件标签系统** | 人工/AI标注关键时刻 | 标签分类+搜索索引 |
+| **热存储** | 近期高频访问视频 | SSD/NVMe + 本地NVR |
+| **冷存储** | 长期归档合规保留 | 对象存储 + 分层迁移 |
+
+---
+
+## 3. 摄像头布局与多角度策略
+
+### 典型パチンコ店布局 (200台机规模)
+
+| 区域 | 摄像头类型 | 数量 | 覆盖策略 |
+|------|-----------|------|---------|
+| **机台区域** | 固定枪机 | 40-50 | 每4-5台机1个,俯视45° |
+| **机台正面** | PTZ球机 | 8-10 | 可调焦看客户手部操作 |
+| **走道通道** | 广角枪机 | 15-20 | 覆盖人员动线 |
+| **收银台** | 高清枪机 | 4-6 | 正面+侧面+手部特写 |
+| **出入口** | 人脸识别机 | 4-6 | 全景+人脸抓拍 |
+| **景品柜台** | 固定枪机 | 4-6 | 交易全过程 |
+| **后场仓库** | 广角枪机 | 4-6 | 出入+操作台 |
+
+### 多角度同步分组策略
+
+```
+┌─────────────────────────────────────────┐
+│           机台区 Zone-A (1-50号机)       │
+│  ┌─────┐  ┌─────┐  ┌─────┐  ┌─────┐    │
+│  │CAM01│  │CAM02│  │CAM03│  │PTZ01│    │
+│  │俯视 │  │俯视 │  │俯视 │  │特写 │    │
+│  └──┬──┘  └──┬──┘  └──┬──┘  └──┬──┘    │
+│     └────────┴────────┴────────┘        │
+│              同步组 SG-A01              │
+└─────────────────────────────────────────┘
+```
+
+**分组原则:**
+- 物理相邻的摄像头归入同一同步组
+- 每组3-6路视频为宜
+- 同组摄像头必须时钟严格同步(误差<100ms)
+
+---
+
+## 4. 同步回放 UX 设计
+
+### 4.1 时间轴界面
+
+```
+┌───────────────────────────────────────────────────────────┐
+│  [◀◀] [◀] [▶/‖] [▶▶] [1x▼]  │ 2024-01-15 14:32:15.234  │
+├───────────────────────────────────────────────────────────┤
+│ CAM-01 ████████░░░░░░░░░████████████░░░░░░░░░░░░░░░░░░░░ │
+│ CAM-02 ████████░░░░░░░░░████████████░░░░░░░░░░░░░░░░░░░░ │
+│ CAM-03 ████████░░░░░░░░████████████░░░░░░░░░░░░░░░░░░░░░ │
+│ PTZ-01 ████████░░░░░░░░░████████████░░░░░░░░░░░░░░░░░░░░ │
+├───────────────────────────────────────────────────────────┤
+│        ▲告警  ★书签  ●动检  ■事件标签                     │
+│   [14:00]----[▲]--[★]----[●●●]--[■纠纷]----[15:00]       │
+└───────────────────────────────────────────────────────────┘
+```
+
+### 4.2 事件标签体系
+
+| 一级分类 | 二级标签 | 触发方式 |
+|---------|---------|---------|
+| **安全事件** | 打架/盗窃/可疑人员 | 人工+AI |
+| **纠纷事件** | 机台故障/奖金争议/服务投诉 | 人工 |
+| **作弊嫌疑** | 异常手法/团伙配合/设备干扰 | AI+人工确认 |
+| **运营事件** | VIP到店/高额中奖/设备维护 | 系统自动 |
+| **合规存档** | 定期抽检/监管备查 | 人工标记 |
+
+### 4.3 检索功能
+
+| 检索维度 | 示例 | 实现方式 |
+|---------|------|---------|
+| **时间范围** | 2024-01-15 14:00~15:00 | 时间戳索引 |
+| **摄像头** | CAM-01, CAM-02 | 设备ID过滤 |
+| **区域** | 收银台区、A区机台 | 空间分组 |
+| **事件标签** | 纠纷+收银台 | 标签组合查询 |
+| **AI检测** | 人员聚集>5人 | 边缘AI元数据 |
+| **全文搜索** | "客户投诉 50号机" | 备注文本索引 |
+
+### 4.4 同步播放交互
+
+| 操作 | 行为 | 快捷键 |
+|------|------|--------|
+| 点击任一画面 | 该画面放大/全部联动跳转 | 单击 |
+| 时间轴拖动 | 全部画面同步跳转 | 拖拽 |
+| 标签点击 | 跳转到事件起始时刻 | 单击标签 |
+| 播放速度 | 0.25x/0.5x/1x/2x/4x | 数字键 |
+| 逐帧 | 前进/后退单帧 | ←/→ |
+| 书签 | 标记当前时刻 | B键 |
+
+---
+
+## 5. 存储与保留策略
+
+### 5.1 分层存储架构
+
+```
+┌────────────────────────────────────────────────────────┐
+│                    访问频率                             │
+│  高 ▲                                                  │
+│     │  ┌──────────┐                                   │
+│     │  │ 热存储   │ SSD/NVR  7天  高码率原片           │
+│     │  │ (Hot)    │ 本地      快速随机访问             │
+│     │  └────┬─────┘                                   │
+│     │       ↓ 自动迁移                                 │
+│     │  ┌──────────┐                                   │
+│     │  │ 温存储   │ HDD/NAS  30天  中码率转码          │
+│     │  │ (Warm)   │ 本地/近端  顺序读取优化            │
+│     │  └────┬─────┘                                   │
+│     │       ↓ 自动迁移                                 │
+│     │  ┌──────────┐                                   │
+│     │  │ 冷存储   │ 对象存储 90天+ 低码率归档          │
+│     │  │ (Cold)   │ 云端     按需恢复(分钟级)         │
+│  低 │  └──────────┘                                   │
+└────────────────────────────────────────────────────────┘
+```
+
+### 5.2 保留策略明细
+
+| 层级 | 保留期 | 存储介质 | 码率 | 访问延迟 | 成本/TB/月 |
+|------|--------|---------|------|---------|-----------|
+| **热** | 7天 | 本地SSD/NVR | 原始8Mbps | <1秒 | ¥¥¥¥ |
+| **温** | 30天 | 本地HDD阵列 | 转码2Mbps | <10秒 | ¥¥ |
+| **冷** | 90天 | 云对象存储 | 归档1Mbps | 1-5分钟 | ¥ |
+| **长期** | 1年+ | 深度归档 | 关键帧only | 数小时 | ¢ |
+
+### 5.3 容量估算 (80路摄像头)
+
+| 参数 | 数值 |
+|------|------|
+| 摄像头数量 | 80路 |
+| 平均码率 | 4Mbps |
+| 每日数据量 | 80 × 4Mbps × 86400s ÷ 8 = **3.4TB/天** |
+| 热存储(7天) | ~24TB |
+| 温存储(30天) | ~50TB (转码后) |
+| 冷存储(90天) | ~75TB (归档后) |
+
+---
+
+## 6. 日本隐私/合规清单
+
+### 6.1 法律框架
+
+| 法规 | 要求 | 对策 |
+|------|------|------|
+| **個人情報保護法** | 个人信息收集须告知目的 | 店内明显位置张贴告示 |
+| **風営法** | パチンコ店特定监控要求 | 依规保留期限+监管报备 |
+| **肖像権** | 未经同意不得公开面部 | 导出时自动马赛克选项 |
+| **労働基準法** | 员工监控须事先告知 | 劳动合同明确条款 |
+
+### 6.2 合规检查清单
+
+- [ ] **告知公示**: 入口处设置"防犯カメラ作動中"标识
+- [ ] **目的限定**: 明确"防犯・安全管理"用途,禁止营销分析
+- [ ] **保留期限**: 普通视频≤90天,涉案视频按案件期限
+- [ ] **访问控制**: 分级权限,操作全程审计日志
+- [ ] **数据加密**: 存储加密(AES-256)+ 传输加密(TLS)
+- [ ] **马赛克功能**: 导出前非相关人员面部自动模糊
+- [ ] **删除机制**: 超期自动删除,删除日志可追溯
+- [ ] **跨境限制**: 数据不出日本境内(使用AWS东京/GCP东京)
+- [ ] **员工培训**: 年度隐私合规培训记录
+- [ ] **应急预案**: 数据泄露72小时内报告流程
+
+### 6.3 监管报备
+
+| 监管方 | 报备内容 | 频率 |
+|--------|---------|------|
+| 都道府県公安委員会 | 摄像头位置图、保留策略 | 新增/变更时 |
+| 個人情報保護委員会 | 数据处理报告 | 年度 |
+| 店内掲示 | 监控告知、投诉窗口 | 常设 |
+
+---
+
+## 7. MVP vs Phase-2 路线图
+
+### MVP (3个月)
+
+| 功能 | 优先级 | 说明 |
+|------|--------|------|
+| 多路RTSP接入 | P0 | 支持主流NVR/摄像头 |
+| 时钟同步 | P0 | NTP服务+时间戳校准 |
+| 基础同步回放 | P0 | 4画面联动播放 |
+| 时间轴导航 | P0 | 拖拽跳转+播放控制 |
+| 手动书签 | P0 | 标记关键时刻 |
+| 基础权限 | P0 | 管理员/操作员两级 |
+| 热存储7天 | P0 | 本地NVR直接读取 |
+| 视频导出 | P1 | 片段下载(带水印) |
+
+**MVP交付物:**
+- 可部署的Web应用
+- 支持单店80路摄像头
+- 完成收银台区域全流程验证
+
+### Phase-2 (6个月)
+
+| 功能 | 优先级 | 说明 |
+|------|--------|------|
+| 分层存储 | P0 | 热→温→冷自动迁移 |
+| 事件标签系统 | P0 | 分类标签+检索 |
+| 高级检索 | P1 | 多条件组合查询 |
+| AI动检告警 | P1 | 异常聚集/滞留检测 |
+| 多店管理 | P1 | 集团化部署支持 |
+| 审计日志 | P1 | 操作全程追溯 |
+| 马赛克导出 | P1 | 人脸自动模糊 |
+| API开放 | P2 | 与现有系统集成 |
+| 移动端回放 | P2 | iPad/手机查看 |
+
+### 后续迭代方向
+
+- AI作弊行为识别模型
+- 与POS/会员系统数据关联
+- 跨店嫌疑人员追踪
+- 3D空间重建回放
+
+---
+
+## 8. 关键取舍 (Trade-offs)
+
+### 8.1 架构决策
+
+| 决策点 | 选项A | 选项B | 建议 | 理由 |
+|--------|-------|-------|------|------|
+| **存储位置** | 全云端 | 本地+云混合 | **混合** | 热数据本地保证延迟,冷数据云端降成本 |
+| **视频编码** | 保持原始 | 统一转码 | **统一转码** | H.265统一格式便于回放兼容 |
+| **时钟同步** | 软件NTP | 硬件PTP | **软件NTP** | MVP阶段100ms精度够用,硬件成本高 |
+| **AI部署** | 云端推理 | 边缘推理 | **边缘** | 减少带宽,保护隐私 |
+
+### 8.2 功能取舍
+
+| 功能 | 收益 | 成本 | MVP纳入 | 理由 |
+|------|------|------|---------|------|
+| 人脸识别 | 高(追踪嫌疑人) | 高(合规风险) | **否** | 隐私法限制严格,Phase-2评估 |
+| 实时AI告警 | 高(即时响应) | 高(算力/误报) | **否** | 先验证回放价值,再加实时 |
+| 语音拾取 | 中(纠纷还原) | 高(隐私合规) | **否** | 日本对录音限制更严 |
+| 360°全景 | 中(沉浸体验) | 高(特殊设备) | **否** | ROI不高,传统多角度够用 |
+
+### 8.3 风险与缓解
+
+| 风险 | 影响 | 概率 | 缓解措施 |
+|------|------|------|---------|
+| 时钟漂移导致不同步 | 高 | 中 | 定期校准+漂移检测告警 |
+| 存储成本超预算 | 中 | 中 | 智能保留策略+压缩优化 |
+| 隐私投诉/监管处罚 | 高 | 低 | 严格合规+定期审计 |
+| 摄像头兼容性问题 | 中 | 高 | 提前测试主流品牌+ONVIF标准 |
+| 网络带宽瓶颈 | 中 | 中 | 边缘转码+分时段传输 |
+
+### 8.4 成本结构预估 (单店80路)
+
+| 项目 | 初期投入 | 月度运营 |
+|------|---------|---------|
+| 摄像头设备 | ¥3,000,000 | - |
+| 本地服务器/NVR | ¥1,500,000 | ¥30,000 (维护) |
+| 网络改造 | ¥500,000 | ¥50,000 (专线) |
+| 软件授权 | ¥800,000 | ¥80,000 (订阅) |
+| 云存储(冷) | - | ¥100,000 |
+| **合计** | **¥5,800,000** | **¥260,000** |
+
+---
+
+## 总结
+
+本方案为日本パチンコ店设计了完整的多摄像头监控与同步回放系统:
+
+1. **核心价值**: 纠纷快速取证、作弊行为追溯、合规存档
+2. **技术重点**: 精确时钟同步、分层存储、事件标签检索
+3. **合规优先**: 严格遵循日本隐私法规,数据不出境
+4. **渐进演进**: MVP聚焦同步回放核心,Phase-2扩展AI能力

+ 468 - 0
docs/plans/2026-01-16-pachinko-multi-camera-surveillance-design.md

@@ -0,0 +1,468 @@
+# 日本パチンコ店多摄像头监控系统设计
+
+> 版本: v1.1
+> 日期: 2026-01-16
+> 状态: 头脑风暴阶段
+
+---
+
+## 〇、设计目标与约束
+
+### 目标客户
+- **通用可扩展架构**:适配中小型(50-200台)、大型(200-500台)、连锁集团
+
+### 核心优先级
+| 优先级 | 业务场景 | 系统要求 |
+|--------|----------|----------|
+| **P0** | 纠纷处理 | 高质量多角度同步回放、快速检索 |
+| **P0** | 作弊检测 | 实时监控、事件告警、行为分析 |
+| P1 | 机器故障 | 设备联动、异常通知 |
+| P2 | 客流分析 | 热力图、利用率统计 |
+
+---
+
+## 一、业务用例分析
+
+### 1.1 纠纷处理 (P0)
+
+**典型场景**:
+- 客户投诉"机器吞币"、"该出没出"
+- 奖品兑换争议
+- 客户之间冲突
+
+**系统需求**:
+| 需求 | 说明 | 重要性 |
+|------|------|--------|
+| 多角度同步回放 | 同时查看玩家、机器面板、周边环境 | 必须 |
+| 精确时间定位 | 客户报告时间 ±5分钟快速定位 | 必须 |
+| 高清画质 | 能看清按钮操作、球的流向 | 必须 |
+| 视频导出 | 带时间戳水印、法律证据级别 | 必须 |
+| 书签/标注 | 标记关键时间点便于复查 | 重要 |
+
+**处理流程**:
+```
+客户投诉 → 确认时间/机台号 → 调取多角度视频 → 同步回放分析
+    → 标注关键点 → 导出证据 → 处理结论 → 归档
+```
+
+### 1.2 作弊检测 (P0)
+
+**常见作弊手法**:
+| 类型 | 手法 | 检测难度 |
+|------|------|----------|
+| 电磁干扰 | 使用设备干扰弹珠轨道 | 中 |
+| 体感作弊 | 拍打/摇晃机器 | 低 |
+| 团伙配合 | 一人操作一人望风 | 高 |
+| 内部勾结 | 员工配合调整机器 | 高 |
+| 工具作弊 | 特殊工具操纵发射 | 中 |
+
+**系统需求**:
+| 需求 | 说明 | 实现阶段 |
+|------|------|----------|
+| 实时监控 | 可疑区域重点关注 | MVP |
+| 异常行为告警 | 频繁大当、异常停留 | Phase 2 |
+| 人物跟踪 | 跨摄像头追踪可疑人员 | Phase 3 |
+| 历史比对 | 同一人物历史行为分析 | Phase 3 |
+| 黑名单识别 | 已知作弊者自动告警 | Phase 3 |
+
+### 1.3 机器故障 (P1)
+
+**监控目标**:
+- 卡球/卡币
+- 故障灯亮起
+- 异常停机
+- 出玉异常
+
+**系统需求**:
+- 机台信号联动(Phase 2)
+- 故障事件自动标记
+- 运维工单触发
+
+### 1.4 客流分析 (P2)
+
+**分析维度**:
+- 区域热力图
+- 座位利用率
+- 高峰时段识别
+- 动线分析
+
+---
+
+## 二、摄像头布局与多角度策略
+
+### 2.1 布局方案对比
+
+| 方案 | 每百台摄像头数 | 月存储成本 | 适用场景 |
+|------|---------------|-----------|----------|
+| A. 单机单摄 | ~100 | ¥50万 | 预算紧张、基础需求 |
+| B. 单机双摄 | ~200 | ¥100万 | 高端店、纠纷频发 |
+| C. 区域共享 | ~50 | ¥25万 | 成本敏感、补充覆盖 |
+| **D. 混合策略** | ~80-120 | ¥40-60万 | **推荐:ROI最优** |
+
+### 2.2 推荐方案:混合策略
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                        店铺平面示意                           │
+├─────────────────────────────────────────────────────────────┤
+│  入口 ◎──────────────────────────────────────────────◎ 出口  │
+│       [入口全景]                              [出口全景]      │
+│                                                              │
+│  ┌─────────────────┐  ┌─────────────────┐                   │
+│  │ 高价值岛(海物语) │  │  普通岛 A       │                   │
+│  │  ◎    ◎    ◎   │  │    ◎      ◎    │   ◎ = 摄像头      │
+│  │ [双摄/每台]     │  │  [区域共享]     │                   │
+│  └─────────────────┘  └─────────────────┘                   │
+│                                                              │
+│  ┌─────────────────┐  ┌─────────────────┐                   │
+│  │  普通岛 B       │  │  景品柜台       │                   │
+│  │    ◎      ◎    │  │  ◎    ◎   ◎   │                   │
+│  │  [区域共享]     │  │ [多角度覆盖]    │                   │
+│  └─────────────────┘  └─────────────────┘                   │
+│                                                              │
+│  走道 ◎────────────◎────────────◎────────────◎ 走道        │
+│       [走道监控]                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 2.3 摄像头配置标准
+
+#### 高价值区域(双摄配置)
+| 位置 | 角度 | 分辨率 | 帧率 | 用途 |
+|------|------|--------|------|------|
+| 机台正上方 | 俯视45° | 1080P | 25fps | 玩家操作、球流向 |
+| 机台侧面 | 侧视 | 1080P | 25fps | 面板显示、手部动作 |
+
+#### 普通区域(区域共享)
+| 位置 | 覆盖范围 | 分辨率 | 帧率 | 用途 |
+|------|----------|--------|------|------|
+| 岛头 | 4-6台机器 | 4K | 25fps | 区域全景 |
+| 岛中 | 4-6台机器 | 1080P | 25fps | 补充覆盖 |
+
+#### 公共区域
+| 位置 | 数量 | 分辨率 | 用途 |
+|------|------|--------|------|
+| 入口 | 2 | 4K | 人脸采集、进出记录 |
+| 出口 | 2 | 4K | 离店记录 |
+| 景品柜台 | 3 | 1080P | 兑换过程 |
+| 走道 | 按长度 | 1080P | 动线追踪 |
+| 休息区 | 1-2 | 720P | 补充覆盖 |
+
+### 2.4 机器分级标准
+
+| 级别 | 机型特征 | 摄像头配置 | 示例 |
+|------|----------|-----------|------|
+| S级 | 高人气、高赔率 | 双摄 | 海物语、北斗 |
+| A级 | 中等人气 | 单摄+区域补充 | 普通机型 |
+| B级 | 低人气、边角位置 | 区域共享 | 老旧机型 |
+
+---
+
+## 三、多角度同步回放交互设计
+
+### 3.1 界面布局
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  [检索栏] 日期 | 时间 | 机台号 | 事件类型 | 关键词    [搜索] │
+├─────────────────────────────────────────────────────────────┤
+│  ┌───────────────────┐  ┌───────────────────┐               │
+│  │                   │  │                   │               │
+│  │    主画面 (大)    │  │    副画面 1       │               │
+│  │    CAM-01         │  │    CAM-02         │               │
+│  │                   │  │                   │               │
+│  └───────────────────┘  ├───────────────────┤               │
+│                         │    副画面 2       │  [摄像头列表] │
+│  [⏮][⏪][▶/⏸][⏩][⏭]  │    CAM-03         │  □ CAM-01 ✓  │
+│  播放速度: [0.5x][1x]   │                   │  □ CAM-02 ✓  │
+│            [2x][4x]     └───────────────────┘  □ CAM-03 ✓  │
+│                                                □ CAM-04    │
+├─────────────────────────────────────────────────────────────┤
+│  时间轴                                                      │
+│  14:00    14:15    14:30    14:45    15:00                  │
+│  ├────────┼────────┼────────┼────────┼────────┤             │
+│  CAM-01 ████████████████████████████████████                │
+│  CAM-02 ████████████████████████████████████                │
+│  CAM-03 ████████░░░░████████████████████████                │
+│  事件   ▲纠纷     ▲大当たり    ▲标注                        │
+├─────────────────────────────────────────────────────────────┤
+│  书签/标注: [+ 添加书签] [+ 添加标注]                         │
+│  📌 14:23:45 - 客户投诉时间点                                │
+│  📌 14:25:12 - 大当たり开始                                  │
+│  🏷️ 14:24:00 - 可疑动作(需复查)                              │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 3.2 时间轴功能
+
+| 功能 | 说明 | 快捷键 |
+|------|------|--------|
+| 缩放 | 1分钟~24小时范围 | 滚轮 |
+| 拖拽定位 | 点击跳转到指定时间 | 点击 |
+| 区间选择 | 选择导出范围 | Shift+拖拽 |
+| 同步锁定 | 多路视频保持同步 | 默认开启 |
+| 独立控制 | 单路视频独立播放 | 右键菜单 |
+
+### 3.3 书签与标注系统
+
+#### 书签类型
+| 类型 | 图标 | 用途 | 可见性 |
+|------|------|------|--------|
+| 临时书签 | 📌 | 快速标记,会话内有效 | 个人 |
+| 永久书签 | 🔖 | 保存到数据库 | 可共享 |
+| 系统事件 | ⚡ | 自动生成(大当たり等) | 全员 |
+
+#### 标注功能
+| 功能 | 说明 |
+|------|------|
+| 文字标注 | 添加描述文本 |
+| 分类标签 | 纠纷/作弊/故障/其他 |
+| 严重等级 | 高/中/低 |
+| 关联人物 | 链接到人物档案(Phase 3) |
+| 关联机台 | 链接到机台编号 |
+
+### 3.4 检索系统
+
+#### 快速检索
+```
+示例查询:
+- "2026-01-15 14:30 机台A-15" → 直接定位
+- "今天 大当たり CAM-05" → 筛选事件
+- "本周 纠纷" → 事件列表
+```
+
+#### 高级检索 (Phase 2)
+| 维度 | 操作符 | 示例 |
+|------|--------|------|
+| 时间 | 范围、相对 | `昨天 14:00-16:00` |
+| 空间 | 摄像头、区域 | `1号岛 OR 入口` |
+| 事件 | 类型、等级 | `纠纷 AND 高优先级` |
+| 人物 | ID、特征 | `红衣男子` (Phase 3) |
+
+---
+
+## 四、存储保留策略 (热/冷分层)
+
+### 4.1 分层架构
+
+| 层级 | 存储介质 | 保留时间 | 访问延迟 | 用途 |
+|------|----------|----------|----------|------|
+| **热层** | NVMe SSD | 7天 | <100ms | 实时回放、频繁检索 |
+| **温层** | HDD RAID | 30天 | <1s | 日常调查、事件回溯 |
+| **冷层** | 对象存储/磁带 | 180天-3年 | 分钟级 | 合规存档、法律证据 |
+| **永久层** | 离线归档 | 永久 | 小时级 | 重大事件证据 |
+
+### 4.2 生命周期策略
+
+```
+录制 → 热层(7d) → 温层(30d) → 冷层(180d) → 删除/永久归档
+                       ↓
+              [有事件标签] → 延长保留 / 永久归档
+```
+
+**策略规则**:
+- 无标签视频:按标准生命周期流转
+- 有普通标签:保留延长至 1 年
+- 有重要标签(争议/纠纷):自动升级为永久归档候选
+- 警方调取:标记为永久保留
+
+### 4.3 存储容量估算
+
+#### 按规模估算
+| 规模 | 摄像头数 | 日存储 | 7天热存储 | 30天温存储 | 年存储 |
+|------|----------|--------|-----------|-----------|--------|
+| 小型(100台) | 60 | 2.6TB | 18TB | 78TB | 950TB |
+| 中型(200台) | 120 | 5.2TB | 36TB | 156TB | 1.9PB |
+| 大型(500台) | 300 | 13TB | 91TB | 390TB | 4.7PB |
+
+*假设:平均4Mbps码率(1080P H.265)*
+
+#### 成本优化策略
+- 低活动时段(深夜)降低分辨率/帧率至720P/15fps
+- 无运动区域使用更高压缩率(CRF+5)
+- 冷存储使用低频访问存储类型(Glacier等)
+- 定期清理无标签过期数据
+
+---
+
+## 五、合规与隐私 (日本法规)
+
+### 5.1 适用法规
+
+| 法规 | 核心要求 | 影响范围 |
+|------|----------|----------|
+| **個人情報保護法** | 利用目的明示、安全管理措施 | 全系统 |
+| **風営法** | 营业记录保存义务 | 存储策略 |
+| **各都道府県条例** | 地域特定要求 | 按店铺所在地 |
+
+### 5.2 合规要点
+
+#### 5.2.1 告知义务
+- 店内明显位置设置「防犯カメラ作動中」标识
+- 明示管理者信息、利用目的
+- 入口处公示隐私政策摘要
+
+#### 5.2.2 数据最小化
+- 仅采集必要区域
+- 避免采集店外公共区域
+- 音频采集需额外合规评估(建议不录)
+
+#### 5.2.3 访问控制
+| 角色 | 权限范围 |
+|------|----------|
+| 店长 | 全部摄像头、全部时间、导出权限 |
+| 主任 | 指定区域、30天内、有限导出 |
+| 一般员工 | 指定摄像头、7天内、仅查看 |
+
+- 敏感操作双人确认
+- 访问日志完整记录(保留3年)
+
+#### 5.2.4 数据主体权利
+- 提供开示请求应对流程
+- 删除请求处理机制(需平衡风营法保存义务)
+- 30天内响应请求
+
+#### 5.2.5 第三方提供
+- 警察要求需正式书面请求(令状或捜査関係事項照会書)
+- 导出视频添加不可篡改水印
+- 记录所有外部提供(时间、对象、范围、经手人)
+
+### 5.3 隐私保护技术
+
+| 技术 | 应用场景 | 实现阶段 |
+|------|----------|----------|
+| **区域遮蔽** | 固定隐私区域(如更衣室入口) | MVP |
+| **审计水印** | 导出视频隐形水印追踪 | MVP |
+| **人脸模糊** | 非关联人员自动模糊 | Phase 2 |
+| **访问脱敏** | 低权限用户查看时模糊敏感信息 | Phase 2 |
+
+---
+
+## 六、MVP与二期路线
+
+### 6.1 MVP (Phase 1) - 3个月
+
+**目标**: 基础多摄像头同步回放,满足日常纠纷处理需求
+
+| 功能 | 优先级 | 说明 |
+|------|--------|------|
+| 多路视频接入 | P0 | 支持 RTSP/ONVIF |
+| 录制存储 | P0 | 热/温两层,30天保留 |
+| 时间轴同步回放 | P0 | 最多4路同屏 |
+| 时间点检索 | P0 | 按日期时间查找 |
+| 基础权限 | P0 | 管理员/普通用户 |
+| 手动事件标注 | P1 | 人工打标签 |
+| 书签系统 | P1 | 临时+永久书签 |
+| 视频导出 | P1 | 带时间水印 |
+| 区域遮蔽 | P1 | 固定隐私区域 |
+| 审计水印 | P1 | 导出视频追踪 |
+
+**MVP 不做**:
+- ❌ AI 事件检测
+- ❌ 人脸识别
+- ❌ 机台信号联动
+- ❌ 冷存储归档
+- ❌ 音频录制
+
+### 6.2 Phase 2 - 6个月
+
+| 功能 | 说明 |
+|------|------|
+| 事件自动检测 | 异常行为 AI 识别 |
+| 机台信号联动 | 大当たり等事件自动标记 |
+| 冷存储归档 | 对象存储 + 生命周期管理 |
+| 高级检索 | 事件类型、多维度组合 |
+| 细粒度权限 | RBAC + 区域权限 |
+| 人脸模糊 | 非关联人员自动模糊 |
+| 访问脱敏 | 权限级别差异化展示 |
+| 实时告警 | 可疑行为推送通知 |
+
+### 6.3 Phase 3 - 12个月
+
+| 功能 | 说明 |
+|------|------|
+| 人物跟踪 | 跨摄像头人物追踪 |
+| 人脸识别 | VIP/禁入者识别(需额外合规审批) |
+| 智能摘要 | 事件时间线自动生成 |
+| 移动端 | 管理人员移动查看 |
+| 多店统一管理 | 连锁店中央管理平台 |
+| 历史比对 | 同一人物历史行为分析 |
+
+### 6.4 里程碑
+
+```
+Month 0    Month 3      Month 6      Month 9      Month 12
+   │          │            │            │            │
+   ▼          ▼            ▼            ▼            ▼
+ 启动       MVP上线     Phase2上线   移动端Beta   Phase3上线
+            (基础回放)   (AI+冷存储)  (人脸识别)   (多店管理)
+```
+
+---
+
+## 七、关键取舍 (Pros/Cons)
+
+### 7.1 摄像头布局策略
+
+| 选项 | Pros | Cons | 决策 |
+|------|------|------|------|
+| 单机双摄 | 证据链完整、细节清晰 | 成本高、存储压力大 | 仅高价值机器 |
+| 区域共享 | 成本低、管理简单 | 细节不清、定位困难 | 普通区域采用 |
+| **混合策略** | ROI最优、灵活配置 | 配置复杂、需机器分级 | ✅ 采用 |
+
+### 7.2 存储架构
+
+| 选项 | Pros | Cons | 决策 |
+|------|------|------|------|
+| 纯本地存储 | 低延迟、数据主权 | 容量有限、灾备难 | 热/温层 |
+| 纯云存储 | 弹性扩展、免运维 | 带宽成本、延迟高 | 仅冷层 |
+| **混合云** | 平衡成本与性能 | 架构复杂 | ✅ 采用 |
+
+### 7.3 AI功能时机
+
+| 选项 | Pros | Cons | 决策 |
+|------|------|------|------|
+| MVP就上AI | 早期验证、竞争优势 | 延期风险、误报困扰 | ❌ |
+| **Phase 2上AI** | MVP稳定、数据积累 | 竞争力延后 | ✅ 采用 |
+
+### 7.4 人脸识别时机
+
+| 选项 | Pros | Cons | 决策 |
+|------|------|------|------|
+| Phase 2 | 功能完整度高 | 合规风险、审批耗时 | ❌ |
+| **Phase 3** | 充分合规准备 | 功能延后 | ✅ 采用 |
+
+### 7.5 编码格式
+
+| 选项 | Pros | Cons | 决策 |
+|------|------|------|------|
+| H.264 | 兼容性好、解码快 | 存储成本高 | 回退方案 |
+| **H.265** | 存储省40%、画质同等 | 编解码资源占用高 | ✅ 优先 |
+
+---
+
+## 八、风险与对策
+
+| 风险 | 影响 | 概率 | 对策 |
+|------|------|------|------|
+| 摄像头协议不兼容 | 接入失败 | 中 | 预留协议适配层,支持主流品牌 |
+| 存储容量超预期 | 成本上升 | 中 | 动态码率调整,低活动时段降分辨率 |
+| AI 误报率高 | 人工负担 | 高 | 阈值可调,MVP 以人工为主 |
+| 合规审查延迟 | 功能延期 | 高 | 人脸识别等敏感功能后置 |
+| 网络带宽不足 | 回放卡顿 | 中 | 本地缓存,自适应码率 |
+| 时间同步误差 | 多路不同步 | 低 | NTP强制同步,帧级校准 |
+
+---
+
+## 九、下一步行动
+
+- [ ] 确认摄像头覆盖策略选择(等待用户回复)
+- [ ] 确认摄像头品牌型号及协议支持
+- [ ] 确认机台信号接口规范
+- [ ] 评估连锁店数量及多店管理需求
+- [ ] 启动合规审查(特别是人脸识别部分)
+- [ ] MVP 技术选型及架构设计
+
+---
+
+*文档结束 - 待用户确认摄像头布局策略后更新*

+ 2 - 2
src/views/machine/index.vue

@@ -5,7 +5,7 @@
       <el-form :model="searchForm" inline data-id="search-form">
         <el-form-item :label="t('机器ID')">
           <el-input
-            v-model="searchForm.machineId"
+            v-model.trim="searchForm.machineId"
             placeholder="请输入机器ID"
             clearable
             data-id="search-machine-id"
@@ -14,7 +14,7 @@
         </el-form-item>
         <el-form-item :label="t('名称')">
           <el-input
-            v-model="searchForm.name"
+            v-model.trim="searchForm.name"
             placeholder="请输入名称"
             clearable
             data-id="search-name"