# 工程整体分析

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