**影响** - `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]>
66 lines
2.9 KiB
Rust
66 lines
2.9 KiB
Rust
//! 业务常量(**业务层** —— 对位上游 `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);
|
||
}
|
||
}
|
||
}
|