JIZHONGTANG · CRM
客户管理系统 · 运维指南
内部文档 · 维护人：杰哥（熊再杰）15180110045
一、访问与账号
| 外网地址 | xzjcrm.site（HTTPS 已启用，Let's Encrypt 证书自动续期） |
| 内网地址 | http://115.159.76.40:8088 |
| 管理员 | 熊再杰 / 698161（原 123456，2026-10-06 改） |
| 测试账号 | 测试 / 1234 |
| H5 凭证 | jzt / JztH5@2026 |
二、服务器与容器
| 云服务器 | 腾讯云 115.159.76.40（SSH：ubuntu / Jzt@2026crm） |
| 项目目录 | /home/ubuntu/jizhongtang-crm |
| 数据备份区 | /home/ubuntu/数据备份（含密钥 CSV、总表备份） |
| Web 容器 | jizhongtang-crm-web-1（HTTP 8088） |
| 技术栈 | Flask + 原生 JS（app.js / m4.js）+ nginx 反代 + gunicorn |
三、部署流程（每次改动必走）
- ① 改前备份：核心文件加
.bak_时间戳，并对项目目录做整目录 tar 快照到数据备份区
- ② 拉当前运行版到本地，读懂真实代码再改（别靠猜）
- ③ 上传：用 SFTP
put（非 sudo cp）；index.html 在 templates/、静态文件在 static/
- ④ 重启：
docker restart jizhongtang-crm-web-1
- ⑤ 验证：grep 断言关键标记仍在 + Playwright 真机跑通核心链路 + JS 错误 0
- ⑥ 记录：写
ops-log.jsonl + 更新《个人云系统 CRM 手册》+ 补记忆
- ⑦ 清理：临时快照待确认后删（铁律⑤）
四、核心铁律（保命用）
别靠猜验证必须真跑功能链路手动改完必更新手册云端改动铁律只读巡检铁律数据写入三道断言前端死循环铁律全系统功能保护
- 别靠猜：前端/UI 问题先用无头浏览器渲染实测坐标/真实 DOM，再下刀
- 验证必须真跑：grep 全绿 ≠ 页面正常，必须注入真实数据跑完整流程
- 全系统功能保护：任何改动不得破坏在跑功能（登录→增改查→药方识别→发货→导出）
- 数据写入三道断言：ensure_rowids + align_master_data + rowid 是连接钥匙
五、常见问题
| 登录页卡死 | 加 ?nom4=1 临时规避，再排查 m4.js 死循环 |
| 客户总数没刷新 | 确认自动刷新开关已启用，总量=处方数非客户人数 |
| 药方识别空白 | 检查阿里云百炼 DashScope Key 路径；仅上传与 H5 登录手动 |
| H5 订单筛选 | 已完成 406 / 已发货 402 / 已退款 14 / 已取消 140（详见弹窗内计数） |
| 备案号 | 网站底部已挂 ICP：赣ICP备2026025046号（个人·熊再杰），公安备案审核中 |