docs: right-size test guidance and Redis wording

This commit is contained in:
anonsaber 2026-10-01 02:38:16 +08:00
parent 7a27f7ff00
commit 94032a1e08
3 changed files with 7 additions and 6 deletions

View File

@ -168,11 +168,12 @@
### 6.2 测试要求 ### 6.2 测试要求
- 每个行为变更都要有测试覆盖;纯重构不得改变测试总数。 - 测试投入与风险匹配:影响安全不变量、API 契约、持久化、重试/幂等或关键数据流的行为变更,应增加或调整能区分正确与错误行为的测试。纯文档/文案、格式化、机械重命名,以及有充分理由确认不改变行为的局部整理,不需要新增单元测试。
- **每条硬性安全不变量都要有一条测试或断言能证明它成立**,而不是只写在文档里。 - **每条硬性安全不变量都要有一条测试或断言能证明它成立**,而不是只写在文档里。
- 门禁必须全部通过才算交付:格式化检查、依赖锁校验、静态检查(warning 当错误)、测试。 - 选最小但有判别力的验证:开发中优先跑受影响的测试;在一个关键阶段、准备提交或交付前,再运行该改动要求的完整门禁。独立且微小的编辑不要求每次重复全量测试。
- **禁止**删除测试、跳过测试、放宽检查级别、删除访问控制来通过门禁。 - 门禁必须全部通过才算交付:适用的格式化检查、依赖锁校验、静态检查(warning 当错误)与测试。门禁范围和严重级别不得为了变绿而缩小。
- **不得提交未验证的代码。** 门禁结果必须来自本轮实际执行,不得沿用历史结论。 - **禁止**删除已有测试、跳过必要验证、放宽检查级别或删除访问控制来通过门禁。
- **不得提交未验证的代码。** 结果必须来自本轮实际执行;记录测试范围和结果,不得沿用历史结论。
### 6.3 测试与实现同路径 ### 6.3 测试与实现同路径

View File

@ -29,7 +29,7 @@ State is an architectural boundary here, not a preference.
## 2. 5-minute setup ## 2. 5-minute setup
Requires a reachable Redis 7 instance and a JMAP session plus a Telegram bot token. Requires a reachable Redis instance and a JMAP session plus a Telegram bot token.
**This is a local container smoke test.** Production deployment can use any platform that **This is a local container smoke test.** Production deployment can use any platform that
can run the backend container, inject encrypted secrets, and connect to externally managed can run the backend container, inject encrypted secrets, and connect to externally managed

View File

@ -27,7 +27,7 @@ MessageWeave 位于 JMAP 邮件服务器(例如 Stalwart)与 Telegram bot
## 2. 五分钟跑起来 ## 2. 五分钟跑起来
需要可达的 Redis 7 实例、一个 JMAP session 与一个 Telegram bot token。 需要可用的 Redis 服务、一个 JMAP session 与一个 Telegram bot token。
```sh ```sh
cp .env.example .env # 填写 REDIS_URL 与 CONFIG_ENCRYPTION_KEY cp .env.example .env # 填写 REDIS_URL 与 CONFIG_ENCRYPTION_KEY