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

ila
2026-08-12 17:45:11 +08:00
parent 7a6afe9381
commit 4e54f0a2ef
@@ -1,9 +1,9 @@
# 23 Sense设备台账与凭据边界 # 23 Sense 设备台账与凭据边界
- 类型:需求 / 缺陷 / 重构 - 类型:需求
- 所属 Epic:# - 所属 Epic:#7
- 所属 MVP / 版本:# - 所属 MVP / 版本:#8
- 状态:待验收 / 已完成 - 状态:待验收
- 日期:2026-08-12 - 日期:2026-08-12
- Gitea 工单:https://git.ilapage.cn/ila/yovision/issues/23 - Gitea 工单:https://git.ilapage.cn/ila/yovision/issues/23
- Wiki 页面:Task-23-Sense设备台账与凭据边界 - Wiki 页面:Task-23-Sense设备台账与凭据边界
@@ -11,32 +11,41 @@
## 背景与目标 ## 背景与目标
<!-- 原来有什么问题,这次达到什么结果。 --> 用稳定 Device 标识管理视频设备,并保证摄像机凭据只写不读。
## 最终方案 ## 最终方案
<!-- 说明实际实现。与建单方案不同之处必须写清原因。 --> 实现 Device 创建、查询、编辑、停用和 20/50/100 分页;非 video 类型明确为 adapter_not_ready。摄像机用户名/密码经仓库外 32 字节密钥使用 AES-256-GCM 加密,所有读取模型只返回 credential_configured;关键变更写入统一审计。
与已确认方案一致。为使用 #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/:无生产数据、无真实秘密的验收说明与夹具。
## 验收结果 ## 验收结果
| 验收标准 | 结果 | CRUD、停用、分页超过 16 项、未就绪适配器、乐观版本和凭据不回显测试通过。
|---|---|
| | 通过 / 未通过 | 工单保持 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 测试:通过。
- **未验证部分**:未在真实 PostgreSQL 执行迁移,未使用实验室设备验证实施人员完整操作。
## 相关提交 ## 相关提交
- `<提交哈希>` <提交说明> - $(System.Collections.Hashtable.commit) 本工单实现提交
- 5177861 docs: document Sense MVP operations (#22-#27)