"""平台配置的消费视图单入口，Phase 3 编辑器/试金石与这里对接。 Task 10(清理单 #3)收拢: 六个 resolver 原散在各服务模块—— resolve_email_settings ← email_service / resolve_push_settings ← lead_push_service / resolve_ai_settings ← ai_service / resolve_contact_flags + context_seed_map ← conversation / name_to_region_extras ← ConversationManager.__init__ 内联取值。函数体原样搬入,行为不变;服务层 与测试一律经本模块 import(单一定义点纪律,旧定义已删)。 Phase 4 Task 5A 起 email/ai 两组的回退链为三级: 租户槽位 → 平台设置快照 (settings_store,键名对齐 admin 平台设置页: smtp.host/smtp.port/smtp.user/ smtp.password 与 ai.api_key/ai.base_url/ai.model)→ env settings(env 键名 不变做最终兜底)。push 无平台推荐键(平台设置页只有 ai.*/smtp.* 两组), 保持租户槽位 → env 两级;contact_flags/context_seed_map/name_to_region_extras 无 env 兜底,不涉回退链。 依赖方向: 本模块在 platform 层,只 import engine 的 env settings (app.engine.config,与各服务原状一致)与同层 settings_store,无新循环; 不得反向 import 服务模块——resolver 是纯消费视图,不触服务逻辑。 """ from app.engine.config import settings from app.platform import settings_store # 平台默认发件人显示名(Task 9 前的硬编码值, 租户未配 sender_name 时沿用) _DEFAULT_SENDER_NAME = "HESUPIPE" # model 的出厂默认值——视同"未设置"哨兵: 租户未定制(merged 值 == 出厂默认) # 时回退 env AI_MODEL,部署级模型选择不因接线失效。显式配了其他值则用租户的。 _FACTORY_DEFAULT_MODEL = "glm-4-flash" def _platform_smtp_port(): """平台设置快照的 smtp.port 取值(容错归一): int 原样;数字串转 int (自由 KV 手工 API 可存字符串);其余(空串/None/非法)视同未设置 → None, 由 ``or`` 链条落到 env SMTP_PORT。""" raw = settings_store.get("smtp.port") if isinstance(raw, bool): # bool 是 int 子类,先排除 return None if isinstance(raw, int): return raw if isinstance(raw, str) and raw.strip().lstrip("+").isdigit(): return int(raw.strip()) return None def resolve_email_settings(config_data: dict | None) -> dict: """租户 config.email → 发信参数(三级回退: 租户槽位 → 平台设置快照 smtp.* → env SMTP_*)。 回退规则(语义钉在 test_config_merge: 显式 None = 清空/未设置): - smtp 缺省或显式 None → 整段走 平台设置快照 → env; - smtp 给了 dict → 段内逐键回退(缺键/空串 → 平台设置快照对应键 → env 对应值, 租户可只改密码/只换 host); - sender_name 空 → 平台默认(_DEFAULT_SENDER_NAME); - notify_emails 空列表 → env NOTIFY_EMAIL 单元素。 """ email = ((config_data or {}).get("email")) or {} smtp = email.get("smtp") or {} notify = [e for e in (email.get("notify_emails") or []) if e] return { "host": (smtp.get("host") or settings_store.get("smtp.host") or settings.SMTP_HOST), "port": (smtp.get("port") or _platform_smtp_port() or settings.SMTP_PORT), "user": (smtp.get("user") or settings_store.get("smtp.user") or settings.SMTP_USER), "password": (smtp.get("password") or settings_store.get("smtp.password") or settings.SMTP_PASS), "sender_name": email.get("sender_name") or _DEFAULT_SENDER_NAME, "notify_emails": notify or ( [settings.NOTIFY_EMAIL] if settings.NOTIFY_EMAIL else []), } def resolve_push_settings(config_data: dict | None) -> dict: """租户 config.push → 推送参数(Task 9 接线; env settings 回退)。 平台设置页无 push 推荐键(只有 ai.*/smtp.* 两组,Phase 4 Task 5A 接线范围),本组保持租户槽位 → env 两级回退。 空槽回退哨兵(审查 Important-1, 与 ai.model 同款纪律): - 布尔/字符串: falsy 出厂默认(False/空串)视同"未设置"→ 回退 env PUSH_*——部署级 .env 开关是平台默认集的一部分,租户未配置时继承, 不静默关停; - 数值字段(timeout/max_attempts/retry_backoff_base): 出厂 None = "未设置"→ 回退 env(settings 自带默认 10.0/3/1.0,最终行为与出厂 truthy 默认时一致),租户显式数值(含显式 0)优先于 env。 config_data=None 路径仅供测试直调,生产调用一律传 runtime.config.data。 已知边界: env 开 + 租户显式 false 无法区分于未配置(布尔空槽只有 False),Phase 2 admin 落地时以"平台清 env、配置显式写 false"解决。 """ p = ((config_data or {}).get("push")) or {} return { "enabled": bool(p.get("enabled") or settings.PUSH_ENABLED), "url": p.get("url") or settings.PUSH_API_URL, "api_key": p.get("api_key") or settings.PUSH_API_KEY, "prefix": p.get("prefix") or settings.PUSH_EXTERNAL_KEY_PREFIX, # 数值哨兵: None(出厂/显式清空)→ env;显式数值优先 "timeout": (p.get("timeout") if p.get("timeout") is not None else settings.PUSH_TIMEOUT_SECONDS), "max_attempts": (p.get("max_attempts") if p.get("max_attempts") is not None else settings.PUSH_MAX_ATTEMPTS), "retry_backoff_base": (p.get("retry_backoff_base") if p.get("retry_backoff_base") is not None else settings.PUSH_RETRY_BACKOFF_BASE), } def resolve_ai_settings(config_data: dict | None) -> dict: """租户 config.ai → provider 实例化参数(三级回退: 租户槽位 → 平台 设置快照 ai.* → env)。 api_key/base_url 空槽(None/空串)→ 平台设置快照 → env 智谱凭据 (平台默认集团 key,spec §5.5 "用平台默认"状态下租户侧不存密钥); model 空或等于出厂默认 → 平台设置 ai.model(显式存储,不做出厂哨兵 检查)→ env AI_MODEL。provider 无平台键,租户槽位 → env AI_PROVIDER。 已知边界: provider 出厂 "glm" 同样遮 env AI_PROVIDER——当前单 provider 无实害,多 provider 接入时再改哨兵结构(与 push 数值同款纪律)。 config_data=None 路径仅供测试直调,生产调用一律传 runtime.config.data。 """ ai = ((config_data or {}).get("ai")) or {} model = ai.get("model") if not model or model == _FACTORY_DEFAULT_MODEL: model = (settings_store.get("ai.model") or settings.AI_MODEL or _FACTORY_DEFAULT_MODEL) return { "provider": ai.get("provider") or settings.AI_PROVIDER, "api_key": (ai.get("api_key") or settings_store.get("ai.api_key") or settings.ZHIPU_API_KEY), "base_url": (ai.get("base_url") or settings_store.get("ai.base_url") or settings.ZHIPU_BASE_URL), "model": model, } def resolve_contact_flags(config_data: dict | None) -> dict: """租户 config.contact → 联系方式行为开关。 cc_completion: 号码区号补全(判定树/确认状态机/CC 强制墙总闸); email_light_ask: 邮箱轻补(缺失渠道一次性追问)。False = 该行为整体 跳过(引擎级门控: 不建状态/不注入/不写计数键)。 (template_languages 暂无运行期消费方, 不在此解析——Phase 2 后台批次 再接。) """ contact = ((config_data or {}).get("contact")) or {} return { "cc_completion": bool(contact.get("cc_completion", True)), "email_light_ask": bool(contact.get("email_light_ask", True)), } def context_seed_map(config_data: dict | None) -> dict: """context 种子映射 = config.engine.context_seed_keys(ctx_key → raw_key)。 Task 9 前白名单(product_name/product_id)硬编码在 conversation——两租户 差异(auto 是 vehicle_*)由此配置化;create_conversation 是唯一消费口(按 映射值写 raw_info,白名单 = 本映射的键集合——审查 Minor-4: 单一取值 路径,不留第二条内联读法)。 """ engine = ((config_data or {}).get("engine")) or {} return dict(engine.get("context_seed_keys") or {}) def name_to_region_extras(config_data: dict | None) -> dict | None: """租户 misc.name_to_region_extras → CC 国名映射扩表(dict 或 None)。 Task 10 前是 ConversationManager.__init__ 的内联取值——``or None`` 语义原样保留(缺省/空 dict → None),manager 构造期消费一次,cc 判定树 经 extras 参数逐轮取用(空表与 None 对查表方等价,均可 falsy 跳过)。 """ misc = ((config_data or {}).get("misc")) or {} return misc.get("name_to_region_extras") or None