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

View File

@ -29,7 +29,7 @@ State is an architectural boundary here, not a preference.
## 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
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. 五分钟跑起来
需要可达的 Redis 7 实例、一个 JMAP session 与一个 Telegram bot token。
需要可用的 Redis 服务、一个 JMAP session 与一个 Telegram bot token。
```sh
cp .env.example .env # 填写 REDIS_URL 与 CONFIG_ENCRYPTION_KEY