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

工程整体分析

更新时间：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，不要在命令行写入账号密码。