本仓库保存独立 SCADIA 工程的源码、实施计划和维护文档。主要技术为 Angular、Node.js/Express、SQLite、Python 视觉服务。现场工作站使用 http://127.0.0.1:1881，视频代理使用 127.0.0.1:1886。
当前版本可用于部署、联调和现场验收。门口实际几何标定、真实正反通行、专项识别准确性及长期稳定性尚未完成验收。MES/EMS 展示页含示例数据，不能当作生产实绩。 本说明以可核对的代码和测试为依据，完整边界见产品说明书。
| 文档 | 阅读目的 |
|---|---|
| 软件使用手册（Word） | 零基础图解版：启动登录、收敛后的菜单总览、每个页面逐步操作、报表与账号活动、值班交班、FAQ，含 21 张真实界面截图 |
| 工程配置与修改手册（Word） | 交付目录、运行环境、启停重启、全部配置文件逐字段说明、界面收敛与账号审计开关、常见改造速查、排错决策树，含 13 张界面截图 |
| 产品说明书 | 系统组成、八场景定义、能力矩阵、证据与数据边界 |
| 使用手册 | 登录、画面、门口标定、统一 AI、历史记录、报警确认、故障排查 |
| 部署维护手册 | 源码构建、现场启动、独立配置、测试、备份、迁移和回滚 |
| 当前实施 PLAN | 第 16.6 节跟踪门口与八场景记录，勾选状态按实际验收维护 |
| 验收记录 | 本轮与先前测试结果、限制和现场未完成项 |
| 历史文档目录 | 已归档的旧规划、评审、交接及原架构/开发教程 |
| 源码说明 | 原有开发结构说明；具体端口、路径、模块状态以本页和当前主手册为准 |
旧规划和交接记录已归档，便于追溯，不作为现版本使用说明。旧 CHM 与旧展示截图也不能替代当前主手册。
| ID | 本现场目标 | 来源与限制 |
|---|---|---|
| V1 | 指定门口进入 | 可见光；仅指定门口向内过线，当前实际位置未标定 |
| V2 | 蹲下 / 倒地 | 可见光姿态候选，蹲下也需记录 |
| V3 | 点烟 / 吸食 | 可见光候选与 VLM 复核，手口动作可能有混淆 |
| V4 | 戴安全帽 | 办公室反向规则：戴帽为目标，未戴帽正常 |
| V5 | 4 人及以上聚集 | 同画面人数，不排除工位坐着的人 |
| V6 | 原位连续 30 秒静止 | 连续轨迹计时，单帧不能证明时长 |
| V7 | 小火苗 / 通道 / 画质 | 打火机出现可见火苗即为目标，通道区域待标定 |
| T1 | 红外相对热源辅助 | 独立红外流；无真实测温接口，不输出真实体温 |
统一 AI 默认提供 V1–V7、T1 目标。每个目标读取自己的持久事件、事件复核和历史证据；巡视、候选、VLM结论和人工确认分开显示。视频源离线不会删除历史记录。证据不足不会被写成现场正常；分析不会执行设备控制。
/scenes：八场景画面与门口标定。/people：指定门口进入记录。/scene-records?scene=V3：八场景记录筛选与分页，可切换 V1–V7、T1。/ai-analysis：统一 AI 分析及管理员模型配置。/mes、/ems：业务展示；实际业务证据绑定需另行配置。
全局场景文件还没有逐相机 ACL；安全模式下场景状态、实时帧、事件和证据需要管理员。开放演示模式允许浏览，写入仍要求有效管理员身份。
Windows PowerShell，在仓库根目录：
.\start-scadia.ps1也可双击 启动 SCADIA.cmd。脚本使用本机 project，按配置启动代理、事件桥接、可见光追踪、独立红外追踪和本地 VLM。缺少配置或权重会跳过相应服务。登录使用现场授权账号。
GitHub 源码不包含现场 project、模型、Node/FFmpeg 二进制、依赖、数据库、密钥和抓拍。 新克隆先按部署维护手册准备环境和工程备份，不能据源码仓库的缺省启动认定八场景已接通。
cd source\server
npm ci
npm run build
npm run test:lint
npm test -- --exit
cd ..\client
npm ci
npx tsc --noEmit -p src/tsconfig.app.json
npm run build -- --configuration production
cd ..\..
python -m unittest discover -s source/tools -p "test_scadia_scenes.py"服务端、客户端和 Python 的检查范围不同。运行 deploy-scenes.ps1 前须先构建，脚本只负责本工程进程重启和 /api/version 就绪探测。升级前备份 project 和模型/依赖清单，详见部署维护手册。
source/client/ Angular 界面源码与构建入口
source/server/ Node.js 服务端、API、运行时、自动化测试
source/tools/ 视觉追踪、状态机、VLM主管、视频代理及检查工具
docs/ 当前产品说明书、使用手册、部署维护手册
docs/archive/ 旧规划、评审与交接文档
project/ 本机现场工程、私有配置与运行数据（不入库）
models/ 本机模型权重（不入库）
runtime/ 可选便携 Node / FFmpeg（不入库）
本轮及历史测试结果记录在验收文档。自动化测试覆盖场景对应、权限、状态机、持久化、复核租约、历史证据、异步响应和构建。真实相机准确率、门口实际标定、现场 ACK、30 分钟/2 小时稳定性、完整角色和导航交互另行验收。不得用测试通过数或静态页面截图替代这些现场证据。
仓库目标：https://github.com/kcylp/SCADIA。整理旧资料保留 Git 历史；不强推清历史、不删除未指定的 Release、不清现场数据。