[T-008] 冻结 Sense 设备管理 API 与 Bell 配额只读投影契约 #29

2026-08-07T17:13:19+08:00

ila commented

2026-08-07 17:13:19 +08:00

任务映射

Closes [T-008] 冻结 Sense 设备管理 API 与 Bell 配额只读投影契约 (#27)
task_file: docs/tasks/T-008.md
context_ref: cc47e1463849151bee3c349cc53971181e262043
claim_branch: claims/T-008
work_branch: agent/codex/T-008
write_paths:
- docs/tasks/T-008.md
- docs/contracts/
- docs/api.md
- docs/04-architecture.md
- docs/06-tasks.md
- docs/current-state.md
- tests/test_sense_control_contract.py

变更摘要

冻结 Sense Control API v1 的 7 个设备/批量操作 endpoint，以及 Bell 所有、Sense 只读的 bell.site_quota_v1 五列投影。同步资源所有权、tenant 边界、敏感字段、幂等/并发、分页/批量上限、失败语义和未来分库版本策略，并以 8 个正负契约测试阻止关键约束漂移。本 PR 不实现 HTTP handler、认证、Bell 表或 migration。

验证证据

命令	结果
`./init.ps1`	通过：治理校验、Go test/vet/build 和生成漂移检查均通过
`python -m unittest discover -s tests -p "test_*.py"`	通过：26 项
`python -m unittest discover -s tests -p "test_sense_control_contract.py"`	通过：8 项正例/负例
`python scripts/validate_agent_context.py`	通过
`python scripts/validate_harness_governance.py`	通过
`python -m json.tool docs/contracts/sense-control-v1.openapi.json`	通过
`git diff --check`	通过

风险与回滚

本次只冻结契约和文档，没有运行时或数据库变更。后续实现必须遵守 v1；若评审否决，可整体回滚本 PR，不涉及数据迁移。未来分库需发布新版本，不能原地改变 v1 语义。

检查清单

当前 PR 只对应一个任务 / Issue。
变更未超出 write_paths，没有夹带无关修改。
任务文件执行记录包含相同的验证证据。
合并前任务文件 frontmatter 已为 DONE；Closes 自动关闭 Issue 不会制造假完成。
未提交 Token、Authorization header、私有配置或实例地址。
Issue 已切换到唯一 status/review；合并后才标记 status/done。

## 任务映射 - Closes #27 - task_file: `docs/tasks/T-008.md` - context_ref: `cc47e1463849151bee3c349cc53971181e262043` - claim_branch: `claims/T-008` - work_branch: `agent/codex/T-008` - write_paths: - `docs/tasks/T-008.md` - `docs/contracts/` - `docs/api.md` - `docs/04-architecture.md` - `docs/06-tasks.md` - `docs/current-state.md` - `tests/test_sense_control_contract.py` ## 变更摘要冻结 Sense Control API v1 的 7 个设备/批量操作 endpoint，以及 Bell 所有、Sense 只读的 `bell.site_quota_v1` 五列投影。同步资源所有权、tenant 边界、敏感字段、幂等/并发、分页/批量上限、失败语义和未来分库版本策略，并以 8 个正负契约测试阻止关键约束漂移。本 PR 不实现 HTTP handler、认证、Bell 表或 migration。 ## 验证证据 | 命令 | 结果 | | --- | --- | | `./init.ps1` | 通过：治理校验、Go test/vet/build 和生成漂移检查均通过 | | `python -m unittest discover -s tests -p "test_*.py"` | 通过：26 项 | | `python -m unittest discover -s tests -p "test_sense_control_contract.py"` | 通过：8 项正例/负例 | | `python scripts/validate_agent_context.py` | 通过 | | `python scripts/validate_harness_governance.py` | 通过 | | `python -m json.tool docs/contracts/sense-control-v1.openapi.json` | 通过 | | `git diff --check` | 通过 | ## 风险与回滚本次只冻结契约和文档，没有运行时或数据库变更。后续实现必须遵守 v1；若评审否决，可整体回滚本 PR，不涉及数据迁移。未来分库需发布新版本，不能原地改变 v1 语义。 ## 检查清单 - [x] 当前 PR 只对应一个任务 / Issue。 - [x] 变更未超出 `write_paths`，没有夹带无关修改。 - [x] 任务文件执行记录包含相同的验证证据。 - [x] 合并前任务文件 frontmatter 已为 `DONE`；`Closes` 自动关闭 Issue 不会制造假完成。 - [x] 未提交 Token、Authorization header、私有配置或实例地址。 - [x] Issue 已切换到唯一 `status/review`；合并后才标记 `status/done`。

ila added 2 commits 2026-08-07 17:13:19 +08:00

chore(task): claim T-008

Harness governance / validate (push) Has been cancelled

Details

1c63143106

docs(contract): freeze Sense control API v1 [T-008]

Harness governance / validate (push) Has been cancelled

Details

Harness governance / validate (pull_request) Has been cancelled

Details

b70df147ea

ila merged commit 14d29a47d1 into main

2026-08-07 17:16:23 +08:00

ila referenced this issue from a commit

2026-08-07 17:16:24 +08:00

Merge pull request '[T-008] 冻结 Sense 设备管理 API 与 Bell 配额只读投影契约' (#29) from agent/codex/T-008 into main

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: opc/yovision#29