37 lines
1.4 KiB
Markdown
37 lines
1.4 KiB
Markdown
# 项目交接补充
|
||
|
||
更新时间：2026-04-06
|
||
|
||
这份文档只记录补充性的交接和运维提示；一切当前状态仍优先以 `memory.md`、`docs/architecture.md`、`docs/api-reference.md` 为准。
|
||
|
||
## 当前主线
|
||
|
||
- 产品方向已经从旧教务切到“网盘 + 快传 + 管理台 + Android 壳”
|
||
- 前端静态站发布走 `node scripts/deploy-front-oss.mjs`
|
||
- Android APK 发包走 `node scripts/deploy-android-apk.mjs`
|
||
- 后端交付仍是 `cd backend && mvn package` 后手动上传 jar 并重启服务
|
||
|
||
## 本地配置整理
|
||
|
||
- 根目录 `.env` 已收口多吉云 API 凭据、服务器 SSH 信息和常用部署元信息
|
||
- `.env.example` 作为模板保留在仓库中
|
||
- 旧的 `.env.oss.local` 仅作为兼容回退读取，不再是主入口
|
||
|
||
## 线上运维关键信息
|
||
|
||
- 后端服务名：`my-site-api.service`
|
||
- 后端 jar 路径：`/opt/yoyuzh/yoyuzh-portal-backend.jar`
|
||
- 后端环境变量文件：`/opt/yoyuzh/app.env`
|
||
- 后端额外配置文件：`/opt/yoyuzh/application-prod.yml`
|
||
- API 域名：`https://api.yoyuzh.xyz`
|
||
- 主站域名：`https://yoyuzh.xyz`
|
||
|
||
## 遇到线上登录/网络异常时先看什么
|
||
|
||
1. 前端当前生产包是否是最新资源
|
||
2. `api.yoyuzh.xyz` 的 DNS / TLS / 反向代理是否正常
|
||
3. `my-site-api.service` 是否正常运行
|
||
4. 服务端和 Nginx 日志里是否已有真实请求
|
||
|
||
不要在没有确认链路问题前先改前端业务逻辑。
|