Files
tdc-rs/scripts/upstream-test-ledger.tsv
T
adminandClaude Code 1a0fdbf879 feat(upstream-parity): 移植上游测试用例 —— 29 条对位用例 + 第五把尺子
**影响**
- 生产档弱密钥守卫从「只比默认值」升级为上游 `ProdGuard` 的**六条判据**(纯函数),
  弱令牌用「默认值加后缀」绕过、弱标记词、长度下限三类都拦得住;`CIPHER_KEY`(协议共享值)**不受管**。
- 出向 TDS 超时**外置到 env**(`SSW_TDS_CONNECT_TIMEOUT_MS` / `SSW_TDS_READ_TIMEOUT_MS`),
  且**只有 cause 链里真有超时**才改写文案 ⇒ 连接被拒 / DNS 失败不再被误报成「超时」(排查方向不被带偏)。
- 上游 15 个测试类全部**登记在册**:3 个已移植(29 条对位用例)、12 个判定超范围(逐条记理由)。
- 新增第五把尺子 `scripts/check-upstream-tests.sh`:台账 ⇄ 代码 ⇄ 上游测试类集合三向对账,
  上游新增测试类而台账没登记 ⇒ **红**(不靠"记得看"防漂移)。
- 回归网:`cargo test` 246 → **278**(+32),其余四把尺子与引用自检**全绿**。

**改动**
- `src/platform/guard.rs`(新):上游 `ProdGuard.violations` 的纯函数移植(弱值清单 / 弱标记词整体词匹配 / `MIN_LEN=12` / 逐条点名)。
- `src/platform/config.rs`:`check_secret_guard` 改走守卫判据;新增 `guard_values`(只放本部署真有的键)
  与出向超时两项配置(非法值回落默认,不让连接器起不来)。
- `src/tdc/client/tds.rs`:新增 `cause_chain_has_timeout` / `timeout_text_or_null`(cause 链遍历**有界** `depth<16`),
  `TdsClient::with_timeouts` 接受超时。
- `tests/upstream_guard_parity.rs`(新 · 19 条)+ `tests/upstream_tds_timeout_parity.rs`(新 · 10 条)。
- `scripts/upstream-test-ledger.tsv`(台账真源)+ `scripts/upstream-test-census.py`(上游测试类普查/对账)
  + `scripts/check-upstream-tests.sh`(第五把尺子)。
- 文档:`docs/UPSTREAM-TEST-PARITY.md`(新)+ `docs/known-limitations.md` L8 + `docs/decisions.md` D22/D23
  + `CLAUDE.md` 同步(尺子表 / 目录树 / 命令速查 / 实现细节 22–23 / 坑位表)。

**设计**
- 上游 hop 1 的「反射读 socket 工厂」**抄不了**(`reqwest::Client` 不暴露超时 getter)⇒ 改用**行为级**判别
  (同一延迟 TCP 服务器:短超时⇒超时错、长超时⇒成功)⇒ 结论等价且更强(真跑 socket 层)。
- 上游 `*SelfTest.java` **surefire 不跑**(无统一入口)⇒ 判据落成 `cargo test` 常规用例(纯函数 ⇒ 可离线断言)。
- 超范围判定原则:**本仓没有对应功能 ⇒ 不搬**(硬搬只会是假绿);「机制」已覆盖的(P2P 那条)按机制记账。

Co-Authored-By: Claude Code <[email protected]>
2026-10-27 09:04:08 +08:00

37 lines
7.6 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 上游测试用例台账(tdc-rs ↔ 上游 TDC/TDS/ssw-common)
#
# 🔴 **本文件是「上游有哪些测试用例、我们搬没搬」的唯一真源** ⇒
# `scripts/check-upstream-tests.sh` 对账(上游新增一个测试类而台账没记 ⇒ 红)。
#
# 列(制表符分隔):
# 1 upstream_class 上游全限定类名(ssw.common.guard.ProdGuardSelfTest …)
# 2 upstream_repo TDC | TDS | COMMON(ssw-common 两侧都有 ⇒ 记 COMMON)
# 3 upstream_file 相对**克隆根目录**的路径(克隆根可用环境变量覆盖)
# 4 kind JUNIT(有 @Test,surefire 跑)| SELFTEST(纯 main,**surefire 不跑**)
# 5 assertions 上游断言条数(`-` = 未逐条计数)
# 6 tdc_counterpart 本仓对位用例:`文件::fn1+fn2+…`(`-` = 无对位)
# 7 status PORTED | OUT-OF-SCOPE
# 8 reason 搬法说明(PORTED)/ 不搬的理由(OUT-OF-SCOPE)
#
# ⚠️ 上游的 `*SelfTest.java` **没有 runner 接线**(surefire 只跑 junit 的 `@Test`)
# ⇒ 上游仓库自己靠 `tools/run-java-selftests.sh` 人工跑
# ⇒ 本仓把它们落成 `cargo test` 的常规用例(判据是纯函数 ⇒ 可离线断言)。
#
# ⚠️ 台账里的 `upstream_file` 只在**上游克隆在场**时才校验;克隆不在 ⇒ 跳过该校验(不判红)。
ssw.common.guard.ProdGuardSelfTest COMMON boot/ssw-common/ssw-common-biz/src/test/java/ssw/common/guard/ProdGuardSelfTest.java SELFTEST 10 tests/upstream_guard_parity.rs::prod_guard_cipher_key_is_not_guarded+prod_guard_default_weak_values_are_still_blocked+prod_guard_strong_values_are_all_allowed+prod_guard_blank_value_is_named+prod_guard_default_value_with_suffix_is_blocked+prod_guard_too_short_value_is_blocked+prod_guard_violation_message_names_the_key+prod_guard_absent_key_is_not_falsely_blocked+prod_guard_exact_weak_value_is_blocked+prod_guard_weak_marker_word_is_blocked+prod_guard_weak_marker_is_whole_word_only+prod_guard_min_len_is_enforced PORTED 六条判据逐条照抄上游 ProdGuard.violations(缺一即空检查):①键不在map⇒跳过 ②值为null/空白⇒违规 ③精确等于弱值⇒违规 ④含弱值片段⇒违规(反绕过)⑤含弱标记词⇒违规 ⑥长度<12⇒违规;上游⓪「security.security-key 不再受管」映射为「CIPHER_KEY(协议共享值)不受管」
ssw.tds.controller.SswProdRuntimeGuardSelfTest TDS boot/ssw-tds/ssw-tds-controller/src/test/java/ssw/tds/controller/SswProdRuntimeGuardSelfTest.java SELFTEST 12 tests/upstream_guard_parity.rs::runtime_guard_non_prod_never_violates+runtime_guard_prod_with_empty_token_violates+runtime_guard_prod_with_null_token_violates_without_panic+runtime_guard_prod_with_default_token_violates+runtime_guard_prod_with_strong_token_passes+runtime_guard_is_discriminable_on_the_prod_switch+runtime_guard_no_deployment_flag_unlocks_a_weak_token PORTED 10 条里搬了 7 条;未搬的 3 条(② prod+codeDev / ⑧ 未声明测试环境 / ⑨ 已声明测试环境)全属**门户验证码通道**(ssw.portal.code-dev)⇒ 本仓无该通道 ⇒ 记 OUT-OF-SCOPE-PART(见 docs/known-limitations.md L8)
ssw.tdc.client.ProviderInvokeTimeoutsSelfTest TDC boot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/client/ProviderInvokeTimeoutsSelfTest.java SELFTEST 11 tests/upstream_tds_timeout_parity.rs::hop1_injected_timeout_actually_reaches_the_socket_layer+hop1_changing_the_injected_value_changes_the_client+hop2_read_timeout_is_rewritten_and_names_current_values+hop2_connect_timeout_is_rewritten+hop2_connection_refused_is_not_rewritten+hop2_dns_failure_is_not_rewritten+hop2_no_cause_is_not_rewritten+hop2_multilevel_wrapped_cause_is_still_detected+hop2_cause_chain_walk_is_bounded+hop2_end_to_end_connection_refused_stays_unreachable PORTED 第1跳(配置值⇒socket工厂)用**行为级**判别替代反射(Rust 的 reqwest::Client 不暴露超时):短超时⇒超时、长超时⇒成功 ⇒ 结论等价且更强;第2跳照抄(只有 cause 链里有超时才改写文案,被拒/DNS/无cause⇒不改写)
ssw.tdc.service.impl.P2pTransferTimeoutsSelfTest TDC boot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/service/impl/P2pTransferTimeoutsSelfTest.java SELFTEST - - OUT-OF-SCOPE 与 ProviderInvokeTimeoutsSelfTest **同一机制**(反射读 socket 工厂),但判据对象是 **P2P 传输客户端**(P2pTransferClient)⇒ 本仓**没有 P2P 出向通道**(P2P 属上游跨端传输能力,不在本仓范围)⇒ 无判据对象可搬;机制本身已由 ProviderInvoke 那条覆盖
ssw.tdc.support.ExecNfsSupportTest TDC boot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/support/ExecNfsSupportTest.java JUNIT 10 - OUT-OF-SCOPE 执行侧 **NFS 通道**(ExecNfsSupport.subPath / 拒绝判据)⇒ 属隐私计算执行面,依赖 Nax 引擎 ⇒ 本仓明确不做(见 CLAUDE.md「明确不在本仓库范围」)
ssw.tdc.engine.NaxPodSupportTest TDC boot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/engine/NaxPodSupportTest.java JUNIT 13 - OUT-OF-SCOPE **Nax 隐私计算引擎** + K8s 拓扑(NodePort 派生 / 探针源码 / tar.gz 投递物)⇒ 本仓不做
ssw.tdc.client.NaxExecRenderTest TDC boot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/client/NaxExecRenderTest.java JUNIT 4 - OUT-OF-SCOPE Nax 执行 **Pod 模板渲染契约**(YAML 空值删行陷阱)⇒ 依赖 K8s + Nax ⇒ 本仓不做
ssw.tdc.client.K8sSandboxClientRenderTest TDC boot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/client/K8sSandboxClientRenderTest.java JUNIT 2 - OUT-OF-SCOPE 沙箱执行 **Pod 模板渲染契约** ⇒ 依赖 K8s ⇒ 本仓不做
ssw.tds.support.MaxkeyRegisterPrecheckSelfTest TDS boot/ssw-tds/ssw-tds-biz/src/test/java/ssw/tds/support/MaxkeyRegisterPrecheckSelfTest.java SELFTEST - - OUT-OF-SCOPE **MaxKey SSO** 的应用注册预检 ⇒ 本仓不实现 MaxKey SSO(`/Auth/SsoConfig` 恒 `enabled:false`,见 docs/known-limitations.md L2)
ssw.tds.service.MaxkeyAppRegistrarLogicSelfTest TDS boot/ssw-tds/ssw-tds-biz/src/test/java/ssw/tds/service/MaxkeyAppRegistrarLogicSelfTest.java SELFTEST - - OUT-OF-SCOPE MaxKey 应用登记**编排判据**(人工优先 / 不抛异常 / 预检先于调用)⇒ 同上:本仓无 MaxKey 侧
ssw.tds.client.MaxkeyMgtClientLiveSelfTest TDS boot/ssw-tds/ssw-tds-biz/src/test/java/ssw/tds/client/MaxkeyMgtClientLiveSelfTest.java SELFTEST - - OUT-OF-SCOPE **实机**打真 MaxKey(登录→建应用→授权→回读→退租;未配环境变量 ⇒ 退出码 4 = UNVERIFIED)⇒ 本仓无 MaxKey 侧,且该用例本质是**平台侧**实机联调
ssw.tds.crypto.CertSignerStrictSelfTest TDS boot/ssw-tds/ssw-tds-biz/src/test/java/ssw/tds/crypto/CertSignerStrictSelfTest.java SELFTEST - - OUT-OF-SCOPE **CA 签发严格模式**(prod 档缺根证书必抛 / 合法 SM2 根必放行)⇒ 本仓不做 CA 签发(软 PKI 由上游 scard 安全平面承担)
ssw.tds.service.GuardAlertTypeSelfTest TDS boot/ssw-tds/ssw-tds-biz/src/test/java/ssw/tds/service/GuardAlertTypeSelfTest.java SELFTEST - - OUT-OF-SCOPE **守门告警类型名长度不变式**(`GUARD_` + 原因 ≤ 列宽;实测曾 33 > varchar(30) ⇒ 告警静默丢库)⇒ 该告警表在 TDS 侧,本仓无对应表
ssw.common.util.IpWhitelistUtilTest COMMON boot/ssw-common/ssw-common-biz/src/test/java/ssw/common/util/IpWhitelistUtilTest.java JUNIT 13 - OUT-OF-SCOPE **IP 白名单**(CIDR / 全放 / 归一 / 畸形 fail-closed)⇒ 本仓**没有**该功能(入向鉴权只认内部令牌 + 会话令牌)
ssw.common.util.SswLLMClientTest COMMON boot/ssw-common/ssw-common-biz/src/test/java/ssw/common/util/SswLLMClientTest.java JUNIT 17 - OUT-OF-SCOPE **LLM 客户端**(内部代理 URL 解析 / OpenAI / Anthropic 后缀 / 业务错误 JSON)⇒ 本仓**没有** LLM 客户端