wangsli/hyb-oa
1
0
派生 0
代码 工单 合并请求 工作流 8 软件包 项目 发布 百科 活动

feat(server): 单域托管 client/dist 与 SPA 回退（E12）

浏览代码 
- 新增 SERVE_CLIENT_DIST/CLIENT_DIST_DIR 配置
- 开启后注册 @fastify/static 并对非 /api GET(html) 回退 index.html
- docker-compose.yml 与 README 补充用法
这个提交包含在：
wangsli
2026-02-09 00:06:59 +08:00
父节点 75d5b3d5de
当前提交 89c0ed2ec1
共修改 5 个文件，包含 41 行新增和 2 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件
issues/2026-02-08_21-50-09-p4-trialrun-ready.csv
+1 -1
查看文件
@@ -10,7 +10,7 @@ E8,默认账号与失败体验收敛,补dev seed默认账号文档并让前端
E9,DB索引补强（试运行性能）,为列表分页与筛选补组合索引以降低试运行慢查询风险,迁移可重复执行且回归全绿,cd server && npm run prisma:migrate:deploy && ./scripts/regression-all.sh,manual,DONE,TODO,TODO,server/prisma/schema.prisma | server/prisma/migrations/*,"[""E1""]",新增组合索引仅增不破回滚成本低
E10,后端安全基线（上线级）,增加安全头与关键接口限流并完善上传校验与日志脱敏约定,限流触发行为正确安全头存在上传非法类型被拒绝且不泄露token,"manual: curl压测login并验证429与headers并做一次上传非法类型校验",manual,DONE,TODO,TODO,server/src/app.js | server/src/config.js | server/src/routes/auth.js | server/src/routes/invoicePool.js | server/README.md | server/package.json,"[""E1""]",优先使用@fastify/helmet与@fastify/rate-limit并写回滚说明
E11,可观测性基线（ready与作业统计）,新增/ready进行DB探活并为OCR与委派回收作业输出结构化统计,ready可反映db状态且作业日志输出claimed updated audited等计数便于排障,"manual: 启动服务curl /ready并触发一次job观察日志字段",manual,DONE,TODO,TODO,server/src/app.js | server/src/jobs/delegationRevokeJob.js | server/src/jobs/ocrJob.js | server/README.md,"[""E10""]",不引入外部监控先提供最小可观测字段
E12,单域部署（server托管client静态）,支持server托管client dist实现同域cookie并提供开关与SPA回退,开启后通过server根路径访问前端且登录刷新正常,"manual: cd client && npm run build 然后SERVE_CLIENT_DIST=true启动server访问http://127.0.0.1:3000完成登录",manual,TODO,TODO,TODO,server/src/app.js | server/src/config.js | server/README.md | docker-compose.yml,"[""E10""]",优先复用@fastify/static并用正则fallback避开/api
E12,单域部署（server托管client静态）,支持server托管client dist实现同域cookie并提供开关与SPA回退,开启后通过server根路径访问前端且登录刷新正常,"manual: cd client && npm run build 然后SERVE_CLIENT_DIST=true启动server访问http://127.0.0.1:3000完成登录",manual,DONE,TODO,TODO,server/src/app.js | server/src/config.js | server/README.md | docker-compose.yml,"[""E10""]",优先复用@fastify/static并用正则fallback避开/api
E13,部署与运维包（试运行）,提供deploy/trialrun含env模板compose示例反向代理示例与启动停止runbook,按runbook可在新机器完成启动升级迁移与回滚演练一次,"manual: 按deploy/trialrun/runbook执行docker compose启动并验证ready与登录与回归入口",manual,TODO,TODO,TODO,deploy/trialrun/* | docker-compose.yml | server/.env.example | server/README.md | client/README.md,"[""E12""]",先覆盖试运行环境后续再细化生产
E14,备份与恢复演练（DB+文件）,提供DB(pg_dump)与文件存储(票据上传目录)备份恢复脚本并把演练步骤写入runbook,可生成DB+文件备份并在空库与空存储恢复后通过smoke与登录验证,"manual: 执行备份脚本后restore到新库与新存储目录并跑smoke-test",manual,TODO,TODO,TODO,scripts/backup-db.sh | scripts/restore-db.sh | scripts/backup-storage.sh | scripts/restore-storage.sh | deploy/trialrun/* | server/README.md,"[""E13""]",脚本读取DATABASE_URL与STORAGE_DIR不写死密码并输出可审计日志
E15,Playwright E2E（上线门禁）,引入Playwright覆盖主链路登录待办审批报销提交票据上传OCR轮询绑定预览支付登出,本地与CI均可稳定跑通且失败输出可定位trace与截图,cd client && npm run test:e2e,manual,TODO,TODO,TODO,client/playwright.config.ts | client/tests/e2e/* | client/package.json | client/README.md | client/src/pages/*,"[""E12"",""E4"",""E5"",""E6"",""E8""]",测试环境OCR_PROVIDER=mock且OCR_POLL_CRON改为秒级以保证E2E稳定
1 ID Title Description Acceptance Test_Method Tools Dev_Status Review1_Status Regression_Status Files Dependencies Notes
10 E9 DB索引补强（试运行性能） 为列表分页与筛选补组合索引以降低试运行慢查询风险 迁移可重复执行且回归全绿 cd server && npm run prisma:migrate:deploy && ./scripts/regression-all.sh manual DONE TODO TODO server/prisma/schema.prisma | server/prisma/migrations/* ["E1"] 新增组合索引仅增不破回滚成本低
11 E10 后端安全基线（上线级） 增加安全头与关键接口限流并完善上传校验与日志脱敏约定 限流触发行为正确安全头存在上传非法类型被拒绝且不泄露token manual: curl压测login并验证429与headers并做一次上传非法类型校验 manual DONE TODO TODO server/src/app.js | server/src/config.js | server/src/routes/auth.js | server/src/routes/invoicePool.js | server/README.md | server/package.json ["E1"] 优先使用@fastify/helmet与@fastify/rate-limit并写回滚说明
12 E11 可观测性基线（ready与作业统计） 新增/ready进行DB探活并为OCR与委派回收作业输出结构化统计 ready可反映db状态且作业日志输出claimed updated audited等计数便于排障 manual: 启动服务curl /ready并触发一次job观察日志字段 manual DONE TODO TODO server/src/app.js | server/src/jobs/delegationRevokeJob.js | server/src/jobs/ocrJob.js | server/README.md ["E10"] 不引入外部监控先提供最小可观测字段
13 E12 单域部署（server托管client静态） 支持server托管client dist实现同域cookie并提供开关与SPA回退 开启后通过server根路径访问前端且登录刷新正常 manual: cd client && npm run build 然后SERVE_CLIENT_DIST=true启动server访问http://127.0.0.1:3000完成登录 manual TODO DONE TODO TODO server/src/app.js | server/src/config.js | server/README.md | docker-compose.yml ["E10"] 优先复用@fastify/static并用正则fallback避开/api
14 E13 部署与运维包（试运行） 提供deploy/trialrun含env模板compose示例反向代理示例与启动停止runbook 按runbook可在新机器完成启动升级迁移与回滚演练一次 manual: 按deploy/trialrun/runbook执行docker compose启动并验证ready与登录与回归入口 manual TODO TODO TODO deploy/trialrun/* | docker-compose.yml | server/.env.example | server/README.md | client/README.md ["E12"] 先覆盖试运行环境后续再细化生产
15 E14 备份与恢复演练（DB+文件） 提供DB(pg_dump)与文件存储(票据上传目录)备份恢复脚本并把演练步骤写入runbook 可生成DB+文件备份并在空库与空存储恢复后通过smoke与登录验证 manual: 执行备份脚本后restore到新库与新存储目录并跑smoke-test manual TODO TODO TODO scripts/backup-db.sh | scripts/restore-db.sh | scripts/backup-storage.sh | scripts/restore-storage.sh | deploy/trialrun/* | server/README.md ["E13"] 脚本读取DATABASE_URL与STORAGE_DIR不写死密码并输出可审计日志
16 E15 Playwright E2E（上线门禁） 引入Playwright覆盖主链路登录待办审批报销提交票据上传OCR轮询绑定预览支付登出 本地与CI均可稳定跑通且失败输出可定位trace与截图 cd client && npm run test:e2e manual TODO TODO TODO client/playwright.config.ts | client/tests/e2e/* | client/package.json | client/README.md | client/src/pages/* ["E12","E4","E5","E6","E8"] 测试环境OCR_PROVIDER=mock且OCR_POLL_CRON改为秒级以保证E2E稳定