my_site/docs/agents/handoff.md

项目交接补充

更新时间：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 日志里是否已有真实请求

不要在没有确认链路问题前先改前端业务逻辑。