kangshifu-board/docs/board-local-release-20261111/DEPLOY.md

看板本地累计改动统一发布

本次保存当前工作区所有未忽略的项目代码、测试、Skill维护稿、说明与历史交付档案。工作目录、数据库副本、依赖、凭据仍按.gitignore留在本机。生产看板发布范围由deploy/board-local-20261111.json限定，不能把整个仓库复制到站点。

发布范围

• 117个前端运行文件：包括登录、成员名册、小组成果表格、直接查看报告、评分与决策、筛选与视觉优化、行业资料和研发参考页面，以及完整模块依赖。
• 2个分组接口只补入成员名册和相同的稳定身份解析代码。保留服务器当前函数的其他代码、入口包装、名称、路径、ACL及已有分组配置。
• 其余服务源码、研究维护工具、Skill和操作手册一并提交归档，本次看板部署脚本不重新发布这些独立组件，不重跑迁移或历史采集。

前端发布前会核对已读回的现网基线；未知改动停止，不强行覆盖。现网index.html原字节SHA-256为dfeb6a6d0b63e8e1190f9308bf6619a5ca523a5a2f91af5f7ca5ad5fc9642db3，本次保留。新文件0644，备份及journal位于站点以外。

运维命令

使用交接正文中给出的固定Git提交，checkout到新目录；不要对生产站点直接git pull。Node.js至少20，沿用服务器现有Node。

从既有康师傅应用私有配置加载部署认证。脚本读取KSF_DEPLOY_AUTH_FILE指定的服务器私有JSON文件，要求appId为FKieRbIoGt_main，masterKey为该应用现有部署密钥，parseUrl可省略或为https://kangshifu.fmode.cn/parse。密钥不放命令行、不回显、不提交仓库；若已有配置为其他结构，在站点之外生成0600的临时适配文件。不要另发新凭据或让用户重新提供密钥。

export KSF_DEPLOY_AUTH_FILE=/服务器现有私有应用配置的实际路径
bash scripts/deploy-board-local.sh /opt/kangshifu-web

此命令先执行.mjs MIME只读预检，再按序执行部署器测试、分组接口plan、前端dry、分组接口apply、前端apply、两端no-op、外网117文件SHA、JavaScript响应类型和模块依赖检查。回执保存到/opt/ksf-board-local-20261111-results-*。备份路径在frontend-apply.json和member-apply.json中。

MIME预检位于所有发布写入之前：检查/etc/nginx/mime.types中的JavaScript映射，并核对目标目录内已部署.mjs文件的公网响应类型与内容。新文件尚未部署时明确标记延后公网核验，发布后的全文件和模块检查继续负责验证。缺少映射、错误响应类型或响应内容不符均停止。预检不自动修改或重载nginx；仅在实际静态服务.mjs且缺配置的站点，由运维备份配置、补充映射、nginx -t通过后reload。

不运行旧scripts/deploy.sh prod：它面向历史OBS子路径，当前站点是根路径。不要覆盖首页，不修改nginx或数据库配置，不重启研究服务，不重装数字人Skill。

验收与回传

浏览器用1440、1024、768、390、320实际CSS像素视口检查，保留截图和未捕获异常数：

1. /workshop仅按小组筛选，每组独立表格；有成果的格子只有查看报告；无成果的格子没有虚假按钮。
2. 查看报告直接进入/report，原记录信息在报告信息与引用和关联中可读；正文缺失显示正文待补；返回保持原小组。
3. /pool机会卡直接打开报告；报告右侧评分与决策正常展示。不为验收提交虚假评分或改变真实状态。
4. /reports分类条、用户筛选和统一筛选样式正常；/members显示27位已核验名册及原参与者，未参与账号为未开始；分组可选名单与前端成员编号一致。不为验收修改已有分组。
5. /login公开查看可用，账号登录入口与退出正常；不要在回执中保存密码或会话令牌。
6. /library商品详情弹窗、多选复制、品牌与店铺双向限制、/industry菜单正常；研究数据沿现有正式接口读取，不回退旧SQLite。

回传固定Git提交、dry/apply/no-op原始结果、函数与静态文件回读、备份位置、模块检查、浏览器截图及明确的productionDeployed和browserAcceptancePassed。执行命令成功不能替代浏览器验收；如遇未知基线，保留错误与现场并回传，不改清单绕过。

本地验证

本机215项前端测试、82项服务端测试、4项部署测试通过；干净检出后的正式前端203项测试通过（本机额外包含已忽略的旧演示测试）。静态检查和115个运行模块依赖通过。报告入口28项浏览器检查通过；此前登录和成员名册等核验材料已随各自任务档案提交。

运维现已回传固定提交11ba2290部署及桌面/390/320浏览器通过，用户已确认截图。生产曾因nginx未映射.mjs而白屏，运维备份后补充映射并reload，幂等复验通过。独立公开回读117文件及5项接口检查通过。生产结果与后续MIME预检固化分别记录于production-status.json；已上线的本版不必为归档再部署。原运维补丁仍为服务器原件，本仓库预检依据相同故障独立实现和测试，不声称两者逐字相同。