2026-05-19-23-10-56 修改简历PDF下载文件名

工程分析/工程整体分析.md

@@ -0,0 +1,32 @@
+# 工程整体分析
+
+更新时间：2026-05-19-23-10-56
+
+## 项目定位
+
+本项目用于部署和维护个人 Reactive Resume 服务，服务公网访问地址为 `https://me.huijutec.cn`，公开简历入口为 `/audience/resume`。
+
+## 当前结构
+
+- `README.md`：部署、访问、安装包说明。
+- `compose.yml`：本机 Docker Compose 部署，包含 Postgres、Reactive Resume、frpc。
+- `compose-Nas.yml`：QNAP/NAS 部署版本。
+- `scripts/patch-reactive-resume-filename.sh`：对运行中 Reactive Resume 容器打补丁，控制 PDF 下载文件名，并修正静态资源 cache bust 与 Nitro manifest。
+- `scripts/patch-reactive-resume-glalie-layout.sh`：简历布局补丁。
+- `scripts/patch-reactive-resume-service-worker-cache.sh`：Service Worker 缓存补丁。
+- `packages/`：安装包目录。
+- `dist/`：发布归档。
+- `生成简历/`：简历源数据、备份、生成 PDF 和展示素材。
+
+## 当前运行环境
+
+- Docker 容器 `reactive-resume-reactive-resume-1` 运行 Reactive Resume，映射 `127.0.0.1:3003 -> 3000`。
+- 容器 `reactive-resume-frpc-1` 负责公网映射。
+- `origin` 远端为 Gitea HTTP 地址：`http://192.168.31.5:5002/admin/Reactive_Resume.git`。
+
+## 维护注意事项
+
+- 下载文件名由容器内打补丁脚本控制，不是普通业务源码直接控制。
+- 修改 PDF 文件名后需要更新 cache bust，防止浏览器继续使用旧静态资源。
+- 补丁脚本会修改容器内 `/app/apps/web/.output` 文件并重启容器，执行后必须等待健康检查通过。
+- Gitea HTTP 远端可能缺少交互式凭据，推送失败时应保留本地 commit，不要在命令行写入账号密码。