From b8df838eb218cafcf8aee2478eb6c35e651dc8b2 Mon Sep 17 00:00:00 2001
From: kdletters <kdletters@qq.com>
Date: Tue, 21 Apr 2026 00:56:45 +0800
Subject: [PATCH] docs: add tests support package placeholder

---
 .../01_M0_M2_FOUNDATION_AND_AUTH.md           |  3 +-
 server-rs/README.md                           |  6 ++--
 server-rs/packages/tests-support/README.md    | 28 +++++++++++++++++++
 3 files changed, 33 insertions(+), 4 deletions(-)
 create mode 100644 server-rs/packages/tests-support/README.md

diff --git a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md
index 9cc41e39..a9bd6b18 100644
--- a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md
+++ b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md
@@ -87,7 +87,8 @@
   交付物：[../server-rs/packages/platform-llm/README.md](../server-rs/packages/platform-llm/README.md)
 - [x] 创建 `packages/spacetime-client`
   交付物：[../server-rs/packages/spacetime-client/README.md](../server-rs/packages/spacetime-client/README.md)
-- [ ] 创建 `packages/tests-support`
+- [x] 创建 `packages/tests-support`
+  交付物：[../server-rs/packages/tests-support/README.md](../server-rs/packages/tests-support/README.md)
 
 ### Axum 基础能力
 
diff --git a/server-rs/README.md b/server-rs/README.md
index acd75fe8..0d53409f 100644
--- a/server-rs/README.md
+++ b/server-rs/README.md
@@ -14,7 +14,7 @@
 
 ## 2. 当前阶段说明
 
-当前目录已经完成以下二十四项初始化：
+当前目录已经完成以下二十五项初始化：
 
 1. 为新后端预留正式目录并把路径固定到仓库结构中。
 2. 创建虚拟 workspace `Cargo.toml`，后续 package 会逐项挂入。
@@ -40,11 +40,11 @@
 22. 创建 `packages/platform-oss/` 目录占位，固定 OSS 平台适配 package 落位。
 23. 创建 `packages/platform-llm/` 目录占位，固定大模型平台适配 package 落位。
 24. 创建 `packages/spacetime-client/` 目录占位，固定 SpacetimeDB 客户端适配 package 落位。
+25. 创建 `packages/tests-support/` 目录占位，固定测试支撑共享 package 落位。
 
 后续任务会继续在本目录内按顺序补齐：
 
-1. `packages/tests-support`
-2. `scripts/*`
+1. `scripts/*`
 
 ## 3. 已冻结边界
 
diff --git a/server-rs/packages/tests-support/README.md b/server-rs/packages/tests-support/README.md
new file mode 100644
index 00000000..a4a32bca
--- /dev/null
+++ b/server-rs/packages/tests-support/README.md
@@ -0,0 +1,28 @@
+# tests-support 共享 package 占位说明
+
+日期：`2026-04-20`
+
+## 1. package 职责
+
+`tests-support` 是测试支撑共享 package，后续负责：
+
+1. contract、integration、smoke 测试的共享夹具与辅助工具
+2. 测试环境配置、测试数据装配与断言工具
+3. 供 `apps/api-server`、`apps/spacetime-module` 与各模块 package 复用的测试基础设施能力
+
+## 2. 当前阶段说明
+
+当前提交仅完成目录占位，不提前进入测试夹具、断言工具与 smoke 支撑实现。
+
+后续与本 package 直接相关的任务包括：
+
+1. 设计接口测试与 contract 回归共享夹具
+2. 设计 reducer / view / projection 测试辅助
+3. 设计主流程 smoke 支撑工具
+4. 设计双栈对比与切流回归辅助
+
+## 3. 边界约束
+
+1. `tests-support` 只承接测试支撑能力，不承接业务规则实现。
+2. 测试夹具要尽量贴近真实 contract 与真实模块边界，避免重新引入脱离现网的伪环境。
+3. 不允许把测试辅助逻辑散落到各模块 package 中重复实现。