kangshifu-board/docs/showcase/deploy.md

运维001：产品创新看板与系统介绍部署

本包v4包含企业微信姓名展示、成员归一、中文裁切修复及导航纠正，替代此前r1、r2、r3包，勿先后叠加发布。本包尚未部署。本节只更新34个静态文件；企业微信后端和首次同步按同包docs/wecom-identity-integration-20261103.md执行。静态发布不改数据库、首页、nginx、Schema、ACL、Skill或wrapper，不需要OBS凭据或重启。

包与目录

发布版本：ksf.workshop-board.20261103.v4。脚本需要Node.js 20或以上，无npm安装步骤。

将zip解压到站点以外的新目录，例如/opt/ksf-workshop-board-20261103-r4/。不要解压到站点内。进入解包根目录，执行sha256sum -c FILES.sha256，必须全部通过。

此前维护人核实的站点为/opt/kangshifu-web，执行前再次从生效的nginx配置确认真实root。若不同，向脚本传入实际绝对路径，不猜目录。

先计划，再执行

node scripts/publish-five-views.mjs --target-dir /opt/kangshifu-web
node scripts/publish-five-views.mjs --target-dir /opt/kangshifu-web --apply

第一条默认只读，核对filesChecked=34、changes清单与manifest一致。第二条会在站点外创建独立备份目录，先备份全部旧文件，再替换。留存两次完整stdout/stderr/exitcode。任何失败即停，不覆盖未知版本、不改manifest绕过检查。

脚本要求首页SHA256为dfeb6a6d0b63e8e1190f9308bf6619a5ca523a5a2f91af5f7ca5ad5fc9642db3；保留既有公开机会卡、评分、报告与证据修复的五个文件指纹。既有共享文件接受已核验的LF归一化旧指纹；包内新文件及执行后文件使用原始字节SHA256精确核对。

生产/data/返回403，所以浏览器JSON部署于src/assets/showcase/，不得改回/data/或把资料灌进生产表。

外部HTTPS与浏览器验收

1. 按manifest对34个文件做HTTPS GET并计算原始SHA256；JSON应为JSON、JS应为JS，不能把SPA的200 HTML兜底当作文件成功。首页哈希保持不变。
2. 打开并刷新/showcase与其五个介绍页：/showcase/leadership、/showcase/research、/showcase/collaboration、/showcase/validation、/showcase/classroom。五张图与系统入口均可用。
3. 打开/cockpit、/intel、/coop、/review、/class。驾驶舱12项目/36人/24卡/44报告/3受阻；情报页12,000声音/720商品/360引文；课堂18单作业。基线334条，扩展16,446条另计。
4. 用模拟卡验证本机状态和评分、同名重评，打开来源、报告、四条价格，刷新保留，重置后只清本机演示修改。用浏览器网络日志确认新路由没有生产业务请求。
5. 检查报告中心标题与五类名称的上下笔画完整，点击分类后页标题正确，再检查P01/P03/P10动线、小组/成员筛选、分页、手机布局和旧看板入口。旧报告错误链接应自动恢复；原公开卡详情应正常。对生产状态/评分只检查入口与合同，未经另外指示不为验收改真实记录。
6. 现有看板桌面侧栏和手机导航保持原范围，无新增独立演示集合入口；介绍页和交互页按功能命名。

本机验证结果详见docs/showcase/validation-result.json。本机回归中的旧公开操作由浏览器拦截并本地回放，生产请求实际发送数为0。本机验证不等于生产验收：部署回执和生产浏览器验收后才能记录browserVerified=true。

回退

仅使用本次stdout返回的backup绝对目录。先只读核对，确认后执行：

node scripts/publish-five-views.mjs --target-dir /opt/kangshifu-web --rollback /opt/ksf-five-views-backup-实际编号
node scripts/publish-five-views.mjs --target-dir /opt/kangshifu-web --rollback /opt/ksf-five-views-backup-实际编号 --apply

回退工具先校验全部当前文件仍为本次发布版本和备份哈希，然后恢复旧文件、删除本包新增文件。发现他人修改即停，不覆盖并发更新。备份和journal保留。

课堂链原有S5/completed、三份报告及13项未决问题无需重跑。模拟状态、课堂完成、员工确认、正式发布、企业审批及真实验证分别处理。