From 6a560236f4661a904c2c2a93b2249168a7fe6927 Mon Sep 17 00:00:00 2001
From: kdletters <kdletters@qq.com>
Date: Tue, 21 Apr 2026 01:42:47 +0800
Subject: [PATCH] build: add server-rs test scripts

---
 .../01_M0_M2_FOUNDATION_AND_AUTH.md           |  3 +-
 server-rs/README.md                           |  6 ++-
 server-rs/apps/api-server/README.md           |  1 +
 server-rs/scripts/test.ps1                    | 49 +++++++++++++++++++
 server-rs/scripts/test.sh                     | 40 +++++++++++++++
 5 files changed, 96 insertions(+), 3 deletions(-)
 create mode 100644 server-rs/scripts/test.ps1
 create mode 100644 server-rs/scripts/test.sh

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 1db85ee0..f7798f2e 100644
--- a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md
+++ b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md
@@ -117,7 +117,8 @@
 
 - [x] 新增本地开发脚本
   交付物：[../server-rs/scripts/dev.ps1](../server-rs/scripts/dev.ps1)、[../server-rs/scripts/dev.sh](../server-rs/scripts/dev.sh)
-- [ ] 新增测试脚本
+- [x] 新增测试脚本
+  交付物：[../server-rs/scripts/test.ps1](../server-rs/scripts/test.ps1)、[../server-rs/scripts/test.sh](../server-rs/scripts/test.sh)
 - [ ] 新增 lint / fmt / clippy / check 脚本
 - [ ] 新增 smoke 脚本
 - [ ] 新增 SpacetimeDB 本地开发脚本
diff --git a/server-rs/README.md b/server-rs/README.md
index 0ad76926..8b080765 100644
--- a/server-rs/README.md
+++ b/server-rs/README.md
@@ -14,7 +14,7 @@
 
 ## 2. 当前阶段说明
 
-当前目录已经完成以下二十六项初始化：
+当前目录已经完成以下二十八项初始化：
 
 1. 为新后端预留正式目录并把路径固定到仓库结构中。
 2. 创建虚拟 workspace `Cargo.toml`，后续 package 会逐项挂入。
@@ -42,10 +42,12 @@
 24. 创建 `packages/tests-support/` 目录占位，固定测试支撑共享 package 落位。
 25. 创建 `scripts/dev.ps1`，固定 Windows 本地开发入口。
 26. 创建 `scripts/dev.sh`，固定 Unix-like 本地开发入口。
+27. 创建 `scripts/test.ps1`，固定 Windows 本地测试入口。
+28. 创建 `scripts/test.sh`，固定 Unix-like 本地测试入口。
 
 后续任务会继续在本目录内按顺序补齐：
 
-1. 测试、lint、smoke 与 SpacetimeDB 本地脚本
+1. lint、smoke 与 SpacetimeDB 本地脚本
 
 ## 3. 已冻结边界
 
diff --git a/server-rs/apps/api-server/README.md b/server-rs/apps/api-server/README.md
index 4a419d29..714d1df2 100644
--- a/server-rs/apps/api-server/README.md
+++ b/server-rs/apps/api-server/README.md
@@ -12,6 +12,7 @@
 4. 中间件挂载
 5. `/healthz`、`/api/*`、SSE 与静态资源兼容层装配
 6. 由 `../../scripts/dev.ps1` 与 `../../scripts/dev.sh` 驱动的本地开发启动链路
+7. 由 `../../scripts/test.ps1` 与 `../../scripts/test.sh` 驱动的本地测试链路
 
 ## 2. 当前阶段说明
 
diff --git a/server-rs/scripts/test.ps1 b/server-rs/scripts/test.ps1
new file mode 100644
index 00000000..d6e11c5b
--- /dev/null
+++ b/server-rs/scripts/test.ps1
@@ -0,0 +1,49 @@
+[CmdletBinding()]
+param(
+    [Alias("h")]
+    [switch]$Help,
+    [string]$Package = ""
+)
+
+$ErrorActionPreference = "Stop"
+
+function Write-Usage {
+    @(
+        'Usage:'
+        '  ./server-rs/scripts/test.ps1'
+        '  ./server-rs/scripts/test.ps1 -Package api-server'
+        ''
+        'Notes:'
+        '  1. Run cargo test for the server-rs workspace by default'
+        '  2. Use -Package to target one workspace package only'
+    ) -join [Environment]::NewLine
+}
+
+if ($Help) {
+    Write-Usage
+    exit 0
+}
+
+$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$serverRsDir = Split-Path -Parent $scriptDir
+$manifestPath = Join-Path $serverRsDir "Cargo.toml"
+
+if (-not (Test-Path $manifestPath)) {
+    throw "Missing server-rs/Cargo.toml, cannot start test script."
+}
+
+Write-Host "[server-rs:test] working dir: $serverRsDir"
+
+Push-Location $serverRsDir
+try {
+    if ([string]::IsNullOrWhiteSpace($Package)) {
+        cargo test --manifest-path $manifestPath
+    }
+    else {
+        Write-Host "[server-rs:test] target package: $Package"
+        cargo test -p $Package --manifest-path $manifestPath
+    }
+}
+finally {
+    Pop-Location
+}
diff --git a/server-rs/scripts/test.sh b/server-rs/scripts/test.sh
new file mode 100644
index 00000000..43574247
--- /dev/null
+++ b/server-rs/scripts/test.sh
@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+usage() {
+  cat <<'EOF'
+Usage:
+  ./server-rs/scripts/test.sh
+  SERVER_RS_TEST_PACKAGE=api-server ./server-rs/scripts/test.sh
+
+Notes:
+  1. Run cargo test for the server-rs workspace by default
+  2. Use SERVER_RS_TEST_PACKAGE to target one workspace package only
+EOF
+}
+
+if [[ "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
+  usage
+  exit 0
+fi
+
+SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+SERVER_RS_DIR="$(cd -- "${SCRIPT_DIR}/.." && pwd)"
+MANIFEST_PATH="${SERVER_RS_DIR}/Cargo.toml"
+
+if [[ ! -f "${MANIFEST_PATH}" ]]; then
+  echo "[server-rs:test] Missing ${MANIFEST_PATH}, cannot start test script." >&2
+  exit 1
+fi
+
+echo "[server-rs:test] working dir: ${SERVER_RS_DIR}"
+
+cd "${SERVER_RS_DIR}"
+
+if [[ -n "${SERVER_RS_TEST_PACKAGE:-}" ]]; then
+  echo "[server-rs:test] target package: ${SERVER_RS_TEST_PACKAGE}"
+  cargo test -p "${SERVER_RS_TEST_PACKAGE}" --manifest-path "${MANIFEST_PATH}"
+else
+  cargo test --manifest-path "${MANIFEST_PATH}"
+fi