2026-09-21 dy-dashboard 云端部署文档编制

旭东 → OpenClaw：

我现在要把这这些代码部署到云端服务器里面，帮我生成一个部署文档

OpenClaw 响应：

已生成 云端部署指南.md（项目根目录，13.5KB），并先做实测核对再把本次待部署差异写进文档。未执行任何部署动作。

目标环境实测（2026-09-21）

SSH ubuntu@82.156.135.91，域名 gyl.dieya.net.cn，项目 /opt/dy-dashboard（非 Git 仓库）
磁盘 40G，23G 已用 / 16G 可用（60%）；服务 dy-dashboard.service active；Python 3.12.3；Gunicorn 18888
数据库 dy_data / dy_app；52 张表，本地 985 列 vs 云端 986 列

文档包含的十四个章节

授权与边界、部署前检查、备份与恢复、代码同步（定向 rsync 推荐 + 打包文件谨慎）、数据库结构增量迁移、代码自检与缓存、服务重载、验证探针、回滚、本次待部署内容、记录同步、常见故障速查、SSH 多行脚本写法约束。

写进文档的关键红线

不覆盖云端 config.py（内含云端专属 VAULT_PATH）、不删除云端独有列或表、不覆盖 static/uploads、不动备份目录、不在云端执行 git
磁盘满会表现为「页面能开、点登录没反应」，要求先看 df -h /
改了 static/js/app.js 必须重新生成 app.js.gz，否则前端改动看不到效果
手工 SQL 导入后必须 refresh_all_caches()，否则数据显示旧值
改单元文件本身时必须 daemon-reload + restart，kill -HUP 不会应用新 ExecStart

本次实测待部署内容

代码差异 15 项：run.py、update_data.py、backup.sh、routes/（ai、inventory、planning、products、purchase 共 5 个）、services/（ai_datasources、db、field_perms 共 3 个）、static/js/app.js 与 app.js.gz
数据库结构无需迁移：云端多出 1 列 finished_products.待提数量（int），按规则保留不删
另发现 bom_packaging.updated_at、packaging_orders.计划下单时间 仅列顺序有差异、定义相同，文档中已提醒不要用不带 ordinal_position 的裸 diff 判断

明确未做：未部署、未改云端任何文件、未操作 11.79 生产环境。