浅念
7d16ae6318
- app/main.py: lifespan registry 装配按 env TENANT_SOURCE 切换（db|file， 默认 db）——db 走 TenantRegistry(DbTenantSource(platform_engine)) + schema 就绪后 async load_all；file 回退旧 load_from_dir。空 platform.db 冷启动不炸：显式预检 tenants 表（非捕 ValueError——坏数据同样抛 ValueError，一揽子吞会把数据损坏静默成空平台），空表保持空注册表 （域名全 404 直到 bootstrap 导入），清扫循环对空 runtimes() 安全。 非法值在创建任何 engine 前显性炸。conftest 预置缝优先于 env 装配， 既有 558 测试零改动全绿。 - scripts/bootstrap_platform.py: init（schema+超管，env/.env 凭据，空表 才建）+ 出厂档案幂等导入（已存在 slug 跳过；FileTenantSource.read_tenant 同构快照 → Tenant+sites+domains+版本1，版本走 write_config_version 单一 路径；域名 _normalize_host 归一）。不建租户管理员——导入是存量迁移 形态，租户管理员按需走后台创建向导补。CLI 照 extract_config.py 的 argparse 风格（--db/--profiles/--seed）。 - tests/test_bootstrap_script.py: 幂等两遍零变化（行数/版本数逐项断言）、 超管 env 凭据、未知档案显性炸、bootstrap→DbTenantSource→registry 两租户 resolve 冒烟（jc 蓝/17 条/ai-kefu-jc，auto 橙/13 条/ai-kefu，es 覆盖层）、 TENANT_SOURCE 三态装配（db 空/库冷启动、file 回退、非法值炸）。 Co-Authored-By: Claude Code <noreply@anthropic.com>
all-kefu
统一多租户 AI 客服平台：一套引擎 + 租户配置包，消除此前"每客户复制一套代码"的分叉模式。项目由 ai-kefu / ai-kefu-jc 两个复制分叉项目合并而来（jc 为主线），Phase 1 引擎合并与租户化改造已完成。
现状能力（Phase 1 收尾时点）：
- 多租户引擎：TenantRuntime 隔离边界，engine 包不感知平台层，可整体拎走独立部署。
- 站点模型：一租户多站点（品牌/主题/站点级覆盖），词表、提示词、品牌全部配置化（seed_profiles 出厂包 + 文件级 registry_reload 热加载，Phase 2 升级为 platform.db）。
- Host 路由：按域名解析租户，未知 Host 404；WS 通道租户化客户端 key 防串库，另有限流与每 IP 连接上限。
- 引擎行为：cc 区号补全判定树、多语言墙（中/西/葡借道/俄/阿）、dual-contact 分步双要、CC 强制墙、lead 邮件推送。
本地跑法与工作约定：见 CLAUDE.md（含 uvicorn 启动命令、Host 访问方式、Windows PYTHONUTF8 要求、全量回归基线 459）。
设计文档（spec）：docs/superpowers/specs/2026-10-12-unified-kefu-platform-design.md