# CLAUDE.md — 客迹（KEJI）项目约定

## 部署（唯一入口）

- 一键部署：`bash deploy/deploy.sh <server|admin|sdk|all> [--skip-tests] [--allow-dirty]`
- 用户说"部署到线上" = 执行上述命令（按改动范围选目标）并汇报验证结果与版本标识
- `all` 顺序固定 server → admin → sdk（SDK 新事件依赖 server 白名单先上线）
- 部署日志：deploy/logs/（gitignore）；线上真挂载点 /opt/cms-cj/{admin/dist, sdk/dist}（tar 真实路径直落，禁止 cp/暂存方案）
- 严格不触碰服务器其他项目（1Panel/OpenResty/其他容器）

## 红线（沿袭 spec §4.5 等）

- SDK 任何回调异常不得冒泡宿主页；业务代码禁 v-html（admin README-dev.md）
- 一切改动走 TDD；用中文交流