From 67df831bfef5eea6ba55ba6aa32eee551803798c Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Fri, 14 Aug 2026 09:18:21 +0800 Subject: [PATCH 1/2] docs: retire old runtime facts from active baseline (#58) --- docs/03-business-rules-and-glossary.md | 23 +++++++++++++++++++++-- docs/06-troubleshooting.md | 25 +++++++++++++++++++++++-- 2 files changed, 44 insertions(+), 4 deletions(-) diff --git a/docs/03-business-rules-and-glossary.md b/docs/03-business-rules-and-glossary.md index 26d6cd2..b7cb97d 100644 --- a/docs/03-business-rules-and-glossary.md +++ b/docs/03-business-rules-and-glossary.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Business-Rules-and-Glossary wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Business-Rules-and-Glossary.- -wiki_revision: 7a9645a7ca7f4b3478d27afb2d441238431f501e -synchronized_at: 2026-08-11T10:30:38Z +wiki_revision: 85ddfe99c2f9c97b18d5e39849a50b8c5fca276e +synchronized_at: 2026-08-14T01:17:28Z # 业务规则与术语 @@ -66,3 +66,22 @@ synchronized_at: 2026-08-11T10:30:38Z - 三个交付单元的正式版本与发布流程。 未确认项不得从旧代码或模板默认值推断为当前事实。 + + +## Sense 旧 MVP 规则状态 + +2026-08-14 前的 Sense 账户、设备、发现、Profile、MediaMTX、播放会话和区域版本实现规则仅适用于 `explore` 快照，不是新 `main` / `dev` 的运行事实。迁移工单应从这些记录提取已确认业务与安全约束，但认证、RBAC、管理端外壳和通用 CRUD 必须基于冻结 GoAdmin 源码重新实现并重新验收。 + + + + +## Bell 旧 MVP 规则状态 + +2026-08-14 前的 Bell 独立身份、Event/Receipt、规则、Alert、ack/close 和审计实现仅保存在 `explore`。不可变、幂等、并发处置和产品独立边界仍是待迁移业务要求，但新实现必须从冻结 GoAdmin/go-admin-ui 源码派生并重新验收。 + + + + +## 旧实现迁移边界 + +旧 Sense 中已验证的中文设备字段、请求白名单、凭据隔离和媒体链路行为可作为迁移验收用例；不得把旧自研基础框架直接复制到新 `dev`。 diff --git a/docs/06-troubleshooting.md b/docs/06-troubleshooting.md index f675362..de2864e 100644 --- a/docs/06-troubleshooting.md +++ b/docs/06-troubleshooting.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Troubleshooting wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Troubleshooting -wiki_revision: 632e07b6cd22f6e3ae07c23ed58439ea2beecff2 -synchronized_at: 2026-08-11T10:30:46Z +wiki_revision: 2be5d803b954df64e31085bcf097ee27f8611f9d +synchronized_at: 2026-08-14T01:17:28Z # 故障排查 @@ -39,3 +39,24 @@ synchronized_at: 2026-08-11T10:30:46Z - 契约破坏性变化没有新版本、迁移和回退方案； - 涉及删除、不可逆迁移、发布或生产变更但没有明确授权； - 工作区出现来源不明且与当前任务重叠的修改。 + + +## 旧 Sense MVP 排错资料 + +旧 Sense 的数据库、ONVIF/RTSP、MediaMTX、实时监看、会话和区域排错只适用于 `explore` 快照。新 `main` / `dev` 当前没有可运行 Sense；在新的 GoAdmin 派生骨架和业务迁移工单完成前，不使用旧命令或旧状态判断新实现。 + + + +## 旧 Sense Windows 包状态 + +旧 Windows 打包与启动脚本仅保存在 `explore`，不属于新开发基线。新的 GoAdmin 派生实现必须由独立工单重新建立打包、配置和排错说明。 + + + + +## 重建阶段常见问题 + +| 现象 | 处理 | +|---|---| +| 在 `dev` 找不到 Sense/Bell 可运行代码 | 这是重建空基线的预期状态；旧实现位于 `explore`，新代码必须由 GoAdmin 源码派生工单建立。 | +| 新骨架只有相似页面、没有 GoAdmin 启动链或权限模块 | 不符合二次开发门禁；停止验收，对照 `goadmin-baseline.json`、上游源码和 go-admin-doc 重新实施。 | -- 2.34.1 From 45d316dcbf24f3aade022f26542657a579a54b54 Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Fri, 14 Aug 2026 09:19:16 +0800 Subject: [PATCH 2/2] docs: synchronize final branch governance mirrors (#58) --- docs/delivery/README.md | 28 +++++++++++++++++-- ...支治理并重置GoAdmin开发基线.md | 1 - 2 files changed, 26 insertions(+), 3 deletions(-) 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 ## 未验证部分 - **未验证部分**：无。产品源码导入和业务迁移明确属于后续工单，不是本任务未验证项。 - -- 2.34.1