灿因全流程管理系统 · 运维端口服务器部署信息

📘 新手请看：《服务器登录与运行查看手册 · 图文步骤版》——手把手教你登录服务器、看懂黑色命令行窗口里的系统运行状态。

系统三层架构：腾讯文档智能表格 = 数据库 ｜ 本服务器 nginx = 网页应用（2026-08-29 起全部自托管，CloudStudio 仅作历史备用） ｜ 云服务器 cron = 搬运工（同步脚本） ｜ 云端 launcher = 手动执行入口。
同步任务已全部迁移至腾讯云轻量服务器，cron 定时 + 立即运行按钮双重保障，主机关闭也能正常运作。
信息更新日期：2026-09-04

---

系统运作逻辑（本地主机 · 云服务器 · 数据流）

① 三大块的分工

② 数据是怎么流动的（核心逻辑）

1. 你和同事在腾讯文档里录生产工单（三车间完成一个订单、一车间领用胶料）；
2. cron 到点或你在导航页点「立即运行」（同一个脚本，两条触发路径，殊途同归）→ 服务器上的同步脚本启动；
3. 脚本通过腾讯文档开放 API 读取《入库流水》《出库流水》有效行（2026-08-29 起车间生产表与仓库解耦，入库由《入库流水》手动登记）;
4. 脚本汇总计算仓库库存（入库 − 出库）→ 更新模具台账等派生表；
5. 你在文档页、导航页、打印中心看到的就是最新数据。

③ 本地主机的定位（已「退居二线」）

本地主机（你的电脑）现在只承担开发和维护职责：改脚本、改页面、通过 SSH 连服务器部署。它关机时——cron 照常跑、立即运行照常点、数据照常同步，整套系统零影响。只有「改代码、发新版本」这种事需要它开机。换电脑/用手机：浏览器打开导航页即可，一切功能都在云端，本地工作空间目录和服务器 cron 不跟随账号，改代码需在新电脑重建工作目录。

④ 日常使用速查

一句话总结：文档存数据，服务器干活，浏览器只负责「看」和「点」——所以主机（本页读者）关机、换电脑、多人同时用，系统都不受影响。

---

〇、云端 launcher 入口

无需登录主机，在浏览器里就能立即触发任一同步脚本：

---

一、服务器信息

二、部署结构（服务器上的关键路径）

三、定时任务一览（cron，每天 08:00–08:20 依次执行）

四、常用运维命令

登录服务器（Windows 可用 PowerShell / CMD 自带 ssh，或任意 SSH 工具）：

ssh root@110.40.188.103

查看各同步任务实时日志：

ssh root@110.40.188.103 "tail -f /opt/canyin_scripts/logs/*.log"

查看定时任务定义 / 手动运行某个同步任务（以仓库为例）：

cat /etc/cron.d/canyin-sync
source /etc/canyin.env && cd /opt/canyin_scripts && python3 server_deploy/run_sync.py warehouse

任务名对照：warehouse（仓库）、yi_workshop（一车间胶料）、mould_ledger（模具台账）、warehouse3d（3D仓库）、quote（报价）、purchase（采购）。

云端 launcher 诊断

# 查看 launcher 服务状态
systemctl status canyin-launcher

# 实时查看 launcher 日志
journalctl -u canyin-launcher -f

# 测试 API（应返回 {"ok": true, ...}）
curl -sk https://127.0.0.1:8843/api/ping

# 触发一次仓库同步（无需浏览器）
curl -sk -X POST https://127.0.0.1:8843/api/run \
  -H "X-Access-Token: 888888" \
  -H "Content-Type: application/json" \
  -d '{"id":"warehouse"}'

# 重启 launcher（配置变更后）
systemctl restart canyin-launcher

# 查看 nginx 反代日志
tail -f /var/log/nginx/canyin_*.log

五、部署验证记录

• 2026-08-28 服务器 cron 部署完成：Python 3.11.6 + pip3 + crond，7 项定时任务运行正常。
• 2026-08-28 手动运行仓库同步成功：耗时 114.6 秒，入库流水新增 12 / 变更 2，仓库 31 个产品、总库存 1648。
• 2026-08-28 腾讯文档 API 直连验证通过（Bearer Token 认证，返回格式与本地 connector 完全兼容）。
• 2026-09-04 全站统一口令门上线：导航首页打开即要求口令（原仅「立即运行」触发）；6 个打印页口令门恢复启用（曾停用直接进入）；报价页、客户 3D 地图、3D 仓库、3D 模具页新加口令门。全站口令 888888（地图页兼用 777888），存 localStorage（键 canyin_access_token），同一浏览器输一次全站通用，兼容手机/微信。服务器 .tmp 下 6 个页面模板已同步打补丁，cron 重新生成不丢失。备份：本地 .tmp/backup_gate_20260904/、服务器 /opt/canyin_scripts/.tmp/backup_gate_20260904/。
• 2026-09-04 域名入口 auth_basic 当日移除：上线初版用 HTTP Basic 账号门禁（canyin），手机/微信内置浏览器不支持 Basic 认证弹窗，收到 401 直接显示错误页（被误认为 404）。已移除账号门禁，改为与 8843 完全一致的页面口令体系（888888），手机/微信均可直接打开。htpasswd 文件保留在 /etc/nginx/.htpasswd_canyin 备用（配置备份 canyin_domain.conf.bak0904-2）。
• 2026-09-04 域名入口 nav.caninind.com 正式上线：DNS A 记录解析至本服务器 → Let's Encrypt 证书签发（有效期至 2026-12-03，acme.sh 每日 cron 自动续期）→ 443 端口 vhost（含 auth_basic 账号门禁，htpasswd 位于 /etc/nginx/.htpasswd_canyin）→ 80 端口 301 跳转 443。导航页全部卡片链接已切换为域名版。手机浏览器访问正常（正式证书无警告）。备用 IP 入口 8843 保留不动。
• 2026-08-29 云端 launcher 上线：server_launcher.py systemd 守护 + nginx HTTPS 8843 反代 + 自签证书，导航中心「立即运行」按钮在主机关闭后照常使用。
• 2026-08-29 云防火墙 TCP 8843 规则已添加；服务器内部 firewalld 已永久放行 8843（firewall-cmd --permanent --add-port=8843/tcp），公网 HTTPS 访问验证通过。
• 2026-08-29 导航页自动化卡片不渲染问题修复（index.html 丢失 </script> 闭标签导致整段 JS 未执行），12 个「立即运行」卡片 + 11 个链接卡片全部恢复。
• 2026-08-29 系统运作逻辑章节录入本页（三大块分工 / 数据流 / 本地主机定位 / 日常速查）。
• 2026-08-29 一车间打印中心 + 客户 3D 地图迁移至本服务器（摆脱 CloudStudio 宕机影响）：https://110.40.188.103:8843/print_yi 与 /customer_map/；一车间生产表 3 条打印链接已改写；新增 cron 每小时 2 分自动刷新打印页。客户导航表「端口」列已被删除，地图入口仅保留导航页。
• 2026-08-29 系统优化 P0 全部完成：① 核心脚本运行环境自适应（Windows/Linux 通用，弃用 patch 机制）+ deploy_to_server.py 一键部署；② launcher 新增 /api/last_runs，导航页自动化卡片显示红绿灯（定时/一键运行状态与时间）；③ 全部打印页与 3D 页自托管（/print_san /print_out /print_quote /print_po /warehouse3d /mould3d），三车间 80 条打印链接已重写为服务器地址，摆脱 CloudStudio 依赖；④ 关键表每日 00:30 自动备份至 /backup/canyin/（18 表，保留 30 天）；⑤ 三车间打印页新增每小时 25 分自动刷新。cron 任务现为 11 项。
• 2026-08-29 车间生产与仓库解耦（用户指令）：《三车间生产》《一车间生产》订单完成不再自动写入《入库流水》；仓库唯一数据入口 = 《入库流水》手动登记，sync_warehouse.py 改为纯「入库流水 + 出库流水 → 重算仓库」。历史自动生成的流水行保留计入。本地试跑：仓库 39 个产品、总库存 1522，重算 0 变更（幂等验证通过）。
• 2026-08-29 销售子系统上线：新建《销售单（试用）》bSHIv3 +《销售明细（试用）》dzMesb（销售单号手动编辑不自动生成，明细关联样品档案）；sync_sales.py 自动带出产品名称/规格型号 + 计算含税金额/总价；新增销售订单打印中心 https://110.40.188.103:8843/print_so/（口令 888888）+ cron 每日 00:20 自动刷新 + 导航页打印入口与「销售子系统一键刷新」卡片。cron 任务现为 12 项。