feat(sense): establish M1 offline intake skeleton

docs/tasks/T-003.md

@@ -3,7 +3,7 @@ id: T-003
 title: 建立 Sense M1 无实机接入骨架
 phase: 1
 deps: [T-002]
-status: DOING
+status: DONE
 created: 2026-08-03
 issue: 3
 context_ref: e28070dd035cef3ff3e4a2dad879a482c41dac3a
@@ -12,6 +12,7 @@ work_branch: agent/codex/T-003
 write_paths:
   - docs/tasks/T-003.md
   - Sense/
+  - docs/00-ai-start-here.md
   - docs/03-tech-stack.md
   - docs/api.md
   - docs/06-tasks.md
@@ -81,3 +82,23 @@ write_paths:
 - 本任务收敛为 fake ONVIF、MediaMTX 假服务、SQLite 和可选合成 RTSP 可验证的生产骨架；不得用 mock 测试宣称 M0 或 M1 里程碑完成。
 - 真实设备、5 路自动建 path、探活、断线恢复和 MediaMTX 证据拆到 T-006，依赖 T-001 与 T-003。
 - 任务尚未领取；Issue #3 在本次规格合入默认分支前不进入 `status/todo`。
+
+### 2026-08-04 版本与实现决策
+
+- 冻结 Go `1.26.5`、MediaMTX `v1.19.3`、`oapi-codegen v2.8.0` 与 `modernc.org/sqlite v1.54.0`；许可证、module sum、MediaMTX 二进制 SHA-256、OpenAPI SHA-256、升级策略与退出路线已写入 `docs/03-tech-stack.md`。
+- SQLite driver 使用无 CGO 的 `modernc.org/sqlite`，但业务代码只依赖 `database/sql` repository；migration 避免 SQLite 专有业务语义，后续映射到 PostgreSQL `sense` schema。
+- 设备模型使用 `modality + capabilities`；视频配额只统计期望启用且具备视频采集能力的设备。站点默认 16、配置允许 1～128，超出时拒绝新增/启用，已有流不受影响。
+- 数据库持有期望态；ONVIF、MediaMTX 均由 port/adapter 隔离。T-003 实现确定性 fake 与假 HTTP 契约测试，不提供真实厂商兼容结论；对账只创建/修正应有 path，不做孤儿删除。
+- MediaMTX 官方 OpenAPI 按 tag vendoring，生成代码不可手改；薄封装负责状态码、幂等与领域错误映射。服务默认只监听 `127.0.0.1`，非回环监听必须显式开启。
+- 实现中发现标准 AI 入口仍会宣称“没有生产代码”。dispatcher 串行读回 Gitea 后确认只有 T-003 处于活跃状态、无路径冲突，并以完整 `CLAIM RENEWAL` 将 `docs/00-ai-start-here.md` 加入写入范围；worker 已同步本文件后才修改该入口。
+
+### 2026-08-04 实现与验证证据
+
+- 建立 `Sense/go.mod`、`cmd/sense-api`、SQLite v1 migration 与 device/store/onvif/mtx/reconcile/probe 包。进程默认回环监听，只提供 `/healthz`、`/readyz`；真实 ONVIF adapter 显式返回 unavailable，避免把 fake 冒充生产兼容实现。
+- vendoring MediaMTX `v1.19.3` 官方 OpenAPI，输入 SHA-256 为 `a2b58195f1ec76541e124b5de4ee54645e5a3e25f70c4a73acc4a44d6f2b9c52`；`go generate ./internal/mtx` 生成文件 SHA-256 在重复生成前后均为 `9e10d96eac1b332783d7cbfaba5872fede62a16ef6ccc1062cdb246607db7dac`。
+- SQLite 测试覆盖默认第 17 路拒绝、配置 128 路成功、第 129 路拒绝、禁用第 17 路重新启用拒绝、非视频设备不占额度，以及下调配额不关闭已有流。migration、唯一性、期望态 generation 和持久化退避由同一 repository 测试链路执行。
+- ONVIF fixture 覆盖 profile、脱敏 stream URI、校时、认证失败和取消/超时；MediaMTX 假 HTTP 服务覆盖官方生成客户端的 create/read/delete、ensure 幂等/patch、runtime path 探活和错误脱敏。
+- 对账测试覆盖成功收敛后不重复、指数退避、取消不消耗重试预算和关闭/重开 SQLite 后恢复；探活测试覆盖 online/offline 映射。对账器不调用 `DeletePath`，没有孤儿删除旁路。
+- `go test -race ./...` 全部通过；`go test ./... -count=2` 连续两轮通过；`go vet ./...`、`go build ./...` 通过。实际构建 `sense-api` 后在随机回环端口用绕过系统代理的 curl 验证 `health=ok`、`ready=ready`，临时 EXE、SQLite 和日志随后逐项删除。
+- 根标准入口 `./init.ps1` 通过：agent-context 校验、18 项治理测试、harness 治理校验、生成漂移检查、Sense 全量测试、vet 与 build 均成功。人工核对生成头为 `oapi-codegen v2.8.0`、OpenAPI/二进制下载使用固定 `v1.19.3` URL 和 SHA-256、MediaMTX/Sense 管理端默认只绑定回环地址。
+- 设备人工验收不适用：未连接摄像头，未宣称 T-001 白名单、真实 5 路或 M0/M1 出口完成；这些证据仍由 T-006 在 T-001 恢复后提供。