docs: 完成任务 #27 待验收归档

ila
2026-08-12 17:45:17 +08:00
parent 4635d6dbe8
commit c98b84d1b1
@@ -1,9 +1,9 @@
# 27 Sense区域与方向警戒线版本配置
# 27 Sense 区域与方向警戒线版本配置
- 类型:需求 / 缺陷 / 重构
- 所属 Epic:#
- 所属 MVP / 版本:#
- 状态:待验收 / 已完成
- 类型:需求
- 所属 Epic:#7
- 所属 MVP / 版本:#8
- 状态:待验收
- 日期:2026-08-12
- Gitea 工单:https://git.ilapage.cn/ila/yovision/issues/27
- Wiki 页面:Task-27-Sense区域与方向警戒线版本配置
@@ -11,32 +11,41 @@
## 背景与目标
<!-- 原来有什么问题,这次达到什么结果。 -->
在设备 Profile 画面上配置版本化多边形和方向警戒线,并在分辨率变化后阻止静默复用。
## 最终方案
<!-- 说明实际实现。与建单方案不同之处必须写清原因。 -->
实现 0..1 归一化坐标、Device/Profile/宽高绑定、不可变版本行、乐观并发、停用版本和重新校准。后端校验范围、最少点数、自交、退化、线端点和方向;前端只新增局部 SVG AreaCanvas,其他表单、表格、Dialog 和 Tag 复用 Element Plus。
与已确认方案一致。为使用 #21 的模块注册和项目内窄端口,实施前已在工单评论中记录精确集成 write_path;未修改 contracts、Brain、Bell 或根级部署。
## 修改文件
- `<文件>`:<改动说明>
- Sense/server/app/sense/:本工单后端领域、适配器、服务、HTTP 与测试。
- Sense/server/cmd/sense/modules_*.go:独立模块注册文件。
- Sense/server/database/migrations/:本工单需要的 PostgreSQL 迁移(如适用)。
- Sense/ui/src/:本工单 API、页面、路由及明确需要的局部业务组件。
- Sense/tests/、Sense/testdata/:无生产数据、无真实秘密的验收说明与夹具。
## 验收结果
| 验收标准 | 结果 |
|---|---|
| | 通过 / 未通过 |
有效/越界/自交/退化多边形、方向线、版本递增、并发冲突、分辨率变化标记和重新校准测试通过。
工单保持 open / 待验收,未代替用户执行浏览器、真实设备或部署环境验收。
## 测试
- 执行命令:`<命令>`
- 结果:
- **未验证部分**:<!-- 必填;没有就写“无”。 -->
## 遗留问题
<!-- 没有就删除本节。 -->
- Go 1.26.5 go vet ./...:通过。
- Go 1.26.5 go test -race ./...:全部通过。
- Go 1.26.5 go test -count=1 ./...:全部通过。
- Go 1.26.5 go build ./...:通过。
- corepack pnpm@9.15.1 install --frozen-lockfile:通过。
- corepack pnpm@9.15.1 lint --quiet:通过。
- corepack pnpm@9.15.1 build:通过;仅有 Element Plus vendor bundle 体积建议警告。
- Sense 独立 smoke、Harness 严格检查和 31 项 Harness 测试:通过。
- **未验证部分**:未用真实视频画面和目标岗位用户完成浏览器绘制、双向线及 Profile 切换人工验收。
## 相关提交
- `<提交哈希>` <提交说明>
- $(System.Collections.Hashtable.commit) 本工单实现提交
- 5177861 docs: document Sense MVP operations (#22-#27)