浅念
6cd343e24a
- 全量回归 566 passed（根目录与 tests/ 双跑一致），基线数字刷新（459→566） - 零同步 IO 审计复查：app/ 无 requests/urllib/time.sleep/open，scrypt CPU 注记在案 - 安全自查全过：platform 层零 logger（凭据不进日志）、gitignore 覆盖实证 （tenants/*.db* / platform.db* / data/）、登录限流在 /api/platform 豁免 路径仍生效（豁免只跳过租户解析，测试钉位在）、上传目录不可执行 （魔数+uuid 重命名，avatar 下发防路径穿透，content-type 按扩展名映射） - CLAUDE.md：新增 Phase 2 完成状态（基线/审计/安全/平台层能力一览/ admin API 速览）、Phase 2 沉淀取舍 10 项 + Phase 3 清理单（旧 12 项中 #1#2#3 Task 10、#10 Task 7 已完成划除）、Phase 4 部署记档、 Phase 3 计划编写注意（conftest 三坑 + db_source_app/super_client 夹具 + config_views 单入口 + stats 口径表） - README：现状刷新至 Phase 2 收尾时点 Co-Authored-By: Claude Code <noreply@anthropic.com>
16 lines
1.9 KiB
Markdown
16 lines
1.9 KiB
Markdown
# all-kefu
|
||
|
||
统一多租户 AI 客服平台：一套引擎 + 租户配置包，消除此前"每客户复制一套代码"的分叉模式。项目由 ai-kefu / ai-kefu-jc 两个复制分叉项目合并而来（jc 为主线），Phase 1 引擎合并与租户化改造、Phase 2 平台层（platform.db + admin API）已完成。
|
||
|
||
**现状能力**（Phase 2 收尾时点）：
|
||
|
||
- 多租户引擎：TenantRuntime 隔离边界，engine 包不感知平台层，可整体拎走独立部署。
|
||
- 站点模型：一租户多站点（品牌/主题/站点级覆盖），词表、提示词、品牌全部配置化；配置存 platform.db 版本快照（分组校验 / 回滚 / 热加载），seed_profiles 为出厂档案与测试形态。
|
||
- Host 路由：按域名解析租户，未知 Host 404；WS 通道租户化客户端 key 防串库，另有限流与每 IP 连接上限。
|
||
- 引擎行为：cc 区号补全判定树、多语言墙（中/西/葡借道/俄/阿）、dual-contact 分步双要、CC 强制墙、lead 邮件推送。
|
||
- 平台层（Phase 2）：scrypt 认证 + 内存 token + 登录限流；租户管理（创建向导 / 站点 / 域名 / 停用）；配置版本管线（整组替换 / 回滚 / 重置出厂 / 试金石）；头像上传（魔数校验 + uuid 重命名）；数据视图（会话 / 推送日志 / 删除，租户 scope 强制）；统计（卡片 / 漏斗 / 趋势 / 分布 / 推送健康，逐库聚合禁 ATTACH）；DB 源生产装配（TENANT_SOURCE=db 默认 + bootstrap_platform.py 引导）。admin API 全在 `/api/platform` 前缀（Host 豁免、路由依赖守护），端点清单见 [CLAUDE.md](CLAUDE.md)。
|
||
|
||
**本地跑法与工作约定**：见 [CLAUDE.md](CLAUDE.md)（含 uvicorn 启动命令、Host 访问方式、Windows PYTHONUTF8 要求、全量回归基线 566）。
|
||
|
||
设计文档（spec）：[docs/superpowers/specs/2026-10-12-unified-kefu-platform-design.md](docs/superpowers/specs/2026-10-12-unified-kefu-platform-design.md)
|