diff --git a/docs/delivery/README.md b/docs/delivery/README.md index f141842..d0cda95 100644 --- a/docs/delivery/README.md +++ b/docs/delivery/README.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Delivery-Documentation-Guide wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Delivery-Documentation-Guide.- -wiki_revision: e0b43bfada515ff95831debc4378de41a8ad969a -synchronized_at: 2026-08-11T10:31:06Z +wiki_revision: d4f2bfcef46493361ba019839b36957ed9947003 +synchronized_at: 2026-08-14T01:18:58Z # 交付文档指南 @@ -78,3 +78,27 @@ synchronized_at: 2026-08-11T10:31:06Z ## 不在本页解决的内容 开发任务怎样建单、实施和归档见[开发工作流](Development-Workflow.-)；代码结构和维护入口见[架构与代码地图](Architecture-and-Code-Map.-)。本页不规定市场宣传、合同、法务或商务承诺。 + + +## Sense MVP 岗位操作路径 + +Sense 面向网管、实施人员和非技术现场人员，菜单按日常任务组织：工作台 → 设备管理 → 视频接入 → 视频服务 → 实时监看 → 区域与警戒线。普通操作优先展示中文状态与下一步，不要求用户理解 ONVIF、RTSP 或 MediaMTX 内部模型。 + +- 系统管理员：完成一次性安全初始化，维护 Sense 用户与角色，查看操作记录。首次管理员和新用户密码仅要求至少 6 个字符，不限制字符种类并允许包含用户名；仍应由管理员选择难猜且不复用的密码。 +- 实施/运维：添加设备、只写更新凭据、在获准网卡发现或手工接入、检查主辅码流、处理媒体进程与对账。 +- 站点管理员：查看/维护站点设备，实时监看，绘制和发布区域版本；无权创建系统管理员。 +- 只读用户：查看设备、媒体状态、实时画面和区域，不能修改。 + +交付验收必须使用仓库外测试账户和获准实验室设备；文档、截图、工单和日志不得包含摄像机密码、Cookie、令牌、含凭据 URI 或客户真实画面。当前自动化已覆盖内部状态和安全边界；真实 PostgreSQL、MediaMTX、摄像机兼容与目标浏览器画面仍需实施人员验证。 + + + +## Sense Windows 运行包交付 + +交付对象为实施和运维人员。`sense-windows-amd64.zip` 包含后端程序、已构建前端、空值示例配置、上游许可证、启动脚本与包内说明；不包含 PostgreSQL、MediaMTX、Windows 服务、生产数据或秘密。 + +- 临时查看必须显式运行 `start-sense.bat demo`，其内存数据在进程结束后丢失，不能当作生产部署。 +- 生产配置可由运维写入解压目录的 `config\sense.env`，或通过 Windows 进程环境安全注入；进程环境优先。先运行 `start-sense.bat check` 检查必填项，再运行 `start-sense.bat`。 +- 交付时记录 ZIP SHA-256，并至少验证 `/healthz` 与首页；真实 PostgreSQL、MediaMTX、摄像机和目标浏览器仍需在获准环境验收。 +- 包内 `README-WINDOWS.md` 是现场操作入口；真实 `config\sense.env` 只留在具体部署目录，不得提交 Git 或重新打入交付 ZIP，交付 ZIP 只保留 `sense.env.example`。 + diff --git a/docs/task/58-建立explore-main-dev分支治理并重置GoAdmin开发基线.md b/docs/task/58-建立explore-main-dev分支治理并重置GoAdmin开发基线.md index 7f9c017..3909664 100644 --- a/docs/task/58-建立explore-main-dev分支治理并重置GoAdmin开发基线.md +++ b/docs/task/58-建立explore-main-dev分支治理并重置GoAdmin开发基线.md @@ -84,4 +84,3 @@ synchronized_at: 2026-08-14T01:14:45Z ## 未验证部分 - **未验证部分**：无。产品源码导入和业务迁移明确属于后续工单，不是本任务未验证项。 -