From 5721f90d1a7ff768b7e84b510a0228044643ab8f Mon Sep 17 00:00:00 2001
From: ila <2+ila@noreply.git.ilapage.cn>
Date: Fri, 28 Aug 2026 17:19:24 +0800
Subject: [PATCH] docs: record Sense reliable outbox (#78)

---
 Local-Development-and-Verification.-.md | 27 +++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/Local-Development-and-Verification.-.md b/Local-Development-and-Verification.-.md
index f5af702..e101d1d 100644
--- a/Local-Development-and-Verification.-.md
+++ b/Local-Development-and-Verification.-.md
@@ -507,3 +507,30 @@ go test ./cmd/migrate/migration/version -run TestMediaShardMigrationOnPostgres -
 
 验证应覆盖任意配置容量、稳定重复分配、容量耗尽、分片故障后归属不变、设备/Profile/路径影响范围、只读迁移预检、只读 RBAC、Control API 不出现在响应，以及 Brain/Bell 均不运行。没有专用 PostgreSQL 连接时必须记录真库迁移测试未执行。
 <!-- sense-media-shards:end -->
+
+<!-- sense-outbox:start -->
+## Sense Outbox 本地验证
+
+从 `Sense/server` 运行完整后端测试：
+
+```powershell
+go test ./...
+```
+
+PostgreSQL 多 worker 集成测试必须使用专用隔离数据库，不得指向开发或生产库：
+
+```powershell
+$env:SENSE_OUTBOX_TEST_DATABASE_URL = '<隔离 PostgreSQL 连接>'
+go test ./app/sense/outbox -run TestPostgresConcurrentWorkersDoNotClaimSameMessage -count=1 -v
+```
+
+前端从 `Sense/ui` 运行：
+
+```powershell
+pnpm lint
+pnpm test:unit -- --runInBand
+pnpm build:prod
+```
+
+验证至少覆盖：领域记录与 outbox 原子回滚、并发 claim/lease、租约恢复、退避与 dead、人工重新排队及操作人、永久幂等收据、production 禁用测试 sink、只读/恢复权限、API 不泄露 payload，以及 Brain/Bell 均不运行时页面可观察。无专用 PostgreSQL 连接时必须明确记录真库并发测试未执行。
+<!-- sense-outbox:end -->