Commit Graph

3 Commits

Author SHA1 Message Date
浅念 dcf9d4b54c chore: Phase 4 收尾——部署工件齐备,项目四阶段完成
Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-14 13:45:14 +08:00
浅念 7808f8a299 docs: 手册审查修正(前缀同键空间表述/WS验证预期)
- .env PUSH_EXTERNAL_KEY_PREFIX 注释纠错: 两租户前缀与各自老项目完全
  相同(同键空间)——这正是切换/回滚不产生重复 UniService 线索的依据;
  原稿写成'与老项目隔离'方向反了。两租户之间互异即可, 勿改。
- WS 验证预期收敛为 HTTP/1.1 101(curl 已强制 --http1.1, 不可能是 HTTP/2),
  模板与手册 §3.5 同步。

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-14 09:52:23 +08:00
浅念 96131ebdec docs: 部署手册(继承jc血泪+切换runbook+备份演练)+ openresty模板
- docs/deploy-production.md: 环境前置(.env 逐项/Compose>=2.24 依据/容器自含
  pip 免装) → 首次部署(build/bootstrap/up/health 分级解读/domains=3 口径) →
  1Panel 反代(Host 透传/WS 单套升级头/client_max_body_size 5m/api public
  放行/include 行检查) → 存量迁移(停容器或 backup API 导出, 禁运行时裸 cp;
  经 data/ 卷喂 import_legacy) → 切换 runbook(隧道+hosts 全功能验证 → 逐域名
  切反代 → 观察一周日检 → 老项目归档; 30 秒回滚预案) → 日常运维(backup API
  备份+季度恢复演练/日志封顶+PII 现状如实记/archive 维护窗口/tag 发版纪律/
  加租户零容器操作/bootstrap 幂等) → 踩坑实录 13 条(jc 五条承继+本项目八条,
  含 Host 头漏传全站 404 与头像 413 两条新增预判)
- deploy/openresty-all-kefu.conf.template: upstream + 租户 server 块(WS 单套
  升级头/XFF/上传体积) + admin 形态 A/B(注释切换) + 1Panel 适配注记(include
  行位置/片段直写 IP/验证重载命令)
- CLAUDE.md: 文档索引落位(手册+模板已存在, 补 Phase 4 计划链接)

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-14 09:44:28 +08:00