Files
tdc-rs/src/tdc/constant.rs
T
adminandClaude 1797aa0d64 refactor(b1b-c8): 配置分家 —— 平台 Config 零业务字段
**影响**
- `platform::config::Config` 不再持有 `identity_code` / `identity_name` /
  `identity_secret` / `bootstrap_admin_account` / `bootstrap_admin_password`;
  平台层**不认识**「本连接器是谁」。
- 新增业务层 `tdc::config::TdcConfig`(同五项)与 `tdc::constant`(默认值 + 业务 env 名清单)。
- 对外契约**零变化**(env 名、默认值、取值口径逐字不变)。

**改动**
- 新增 `src/tdc/config.rs`:`TdcConfig::from_env` / `from_raw`(纯函数,可单测)/
  `Default`;`src/tdc/constant.rs`:默认值 + 5 个业务 env 名(+ 撞名自检)。
- `src/platform/config.rs`:删 3 个业务常量与 5 个字段;`env_or_default` 转 `pub`
  (平台提供**机制**,业务提供**清单**)。
- `identity::bootstrap_identity(state, &tdc_config)`:业务配置改为**显式入参**
  (平台层不再持有它 ⇒ 装配层递进去)。
- `main.rs` 造 `TdcConfig::from_env()` 并递给引导与账号库;
  8 个测试文件同步改用 `TdcConfig`。
- `CLAUDE.md` + `.workbuddy/memory/2026-10-26.md` 同步。

**设计**
- `TdcConfig::from_raw(..)` 做成纯函数(不读进程全局 env)⇒ 与平台层同口径,
  测试不引入串行/并行竞态。

Co-Authored-By: Claude <[email protected]>
2026-10-26 20:57:38 +08:00

66 lines
2.9 KiB
Rust
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.
//! 业务常量(**业务层** —— 对位上游 `ssw.tdc.constant`)。
//!
//! 🔴 **为什么在业务层**(v3 spec §2.3.1 C8):身份码 / 身份名 / 引导管理员这些
//! 是**业务口径**,不是平台运行参数 ⇒ 平台层 `platform::config` 只保留
//! 「端口 / 数据目录 / 令牌 / 出向地址 / 单机模式 / 密钥守卫」。
//!
//! 平台层仍提供**机制**(`platform::config::env_or_default`:空白 ⇒ 回落默认值),
//! **清单**(环境变量名 + 默认值)归本模块 ⇒ 一处定义,平台与业务都不重复。
/// 本连接器的默认身份码(`TDC_IDENTITY_CODE`)。
pub const DEFAULT_IDENTITY_CODE: &str = "LOCAL-CONNECTOR";
/// 本连接器的默认身份名(`TDC_IDENTITY_NAME`)。
pub const DEFAULT_IDENTITY_NAME: &str = "本地连接器";
/// 首次启动引导的本地管理员**账号名**默认值(`TDC_BOOTSTRAP_ADMIN_ACCOUNT`)。
pub const DEFAULT_BOOTSTRAP_ADMIN_ACCOUNT: &str = "admin";
// ── 环境变量名(业务口径 ⇒ 归业务层;平台层的 env 名是「平台自己的」)──
/// 身份码的环境变量名。
pub const ENV_IDENTITY_CODE: &str = "TDC_IDENTITY_CODE";
/// 身份名的环境变量名。
pub const ENV_IDENTITY_NAME: &str = "TDC_IDENTITY_NAME";
/// 身份密钥的环境变量名(**不设** ⇒ 引导时随机签发一次)。
pub const ENV_IDENTITY_SECRET: &str = "TDC_IDENTITY_SECRET";
/// 引导管理员账号名的环境变量名。
pub const ENV_BOOTSTRAP_ADMIN_ACCOUNT: &str = "TDC_BOOTSTRAP_ADMIN_ACCOUNT";
/// 引导管理员口令的环境变量名(**不设** ⇒ 落回公开默认值 `admin`,仅限本地调试)。
pub const ENV_BOOTSTRAP_ADMIN_PASSWORD: &str = "TDC_BOOTSTRAP_ADMIN_PASSWORD";
#[cfg(test)]
mod tests {
use super::*;
/// 🔴 业务常量的**字面值**必须钉死(部署脚本 / 文档都按这两个值写)。
#[test]
fn business_defaults_are_pinned() {
assert_eq!(DEFAULT_IDENTITY_CODE, "LOCAL-CONNECTOR");
assert_eq!(DEFAULT_IDENTITY_NAME, "本地连接器");
assert_eq!(DEFAULT_BOOTSTRAP_ADMIN_ACCOUNT, "admin");
}
/// 🔴 环境变量名**不许**与平台层的 env 名撞车(撞车 ⇒ 平台/业务配置串味)。
#[test]
fn business_env_names_do_not_collide_with_platform_ones() {
let platform = [
"PORT",
"TDC_DATA_DIR",
"SSW_INTERNAL_TOKEN",
"SSW_TDS_INTERNAL_TOKEN",
"SSW_TDS_BASE_URL",
"TDC_LOCAL_STANDALONE",
"TDC_STANDALONE",
"TDC_STRICT_SECRETS",
];
for name in [
ENV_IDENTITY_CODE,
ENV_IDENTITY_NAME,
ENV_IDENTITY_SECRET,
ENV_BOOTSTRAP_ADMIN_ACCOUNT,
ENV_BOOTSTRAP_ADMIN_PASSWORD,
] {
assert!(!platform.contains(&name), "业务 env 名与平台 env 名撞车: {}", name);
}
}
}