docs: record Sense reliable outbox (#78)

ila
2026-08-28 17:19:24 +08:00
parent 637efa818b
commit 5721f90d1a
+27
@@ -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 -->