零 Node 部署、超级管理员,并完善本地构建发布文档。
- FastAPI 单进程托管 frontend/dist,systemd 替代 PM2 - 超级管理员 admin、注册开关与用户管理 - README/DEPLOY/USAGE 说明:改代码须本地构建 dist 后 push,服务器 update.sh - 提交 frontend/dist 与 build-frontend 脚本
This commit is contained in:
+61
-11
@@ -16,7 +16,7 @@
|
||||
- 错题库:拍照上传 → OCR 识别 → AI 生成解法(可编辑)
|
||||
- 成绩 CSV 导出
|
||||
|
||||
部署方式见 [DEPLOY.md](./DEPLOY.md)(PM2,端口 23566)。
|
||||
部署与代码发布见 [DEPLOY.md](./DEPLOY.md)(systemd 零 Node,端口 **23566**)。
|
||||
|
||||
---
|
||||
|
||||
@@ -25,12 +25,23 @@
|
||||
### 2.1 登录与注册
|
||||
|
||||
1. 浏览器打开 `http://<服务器IP>:23566`
|
||||
2. 首次使用点击 **注册**,设置用户名(≥3 字符)和密码(≥6 字符)
|
||||
3. 注册成功后自动登录
|
||||
2. **首次部署**默认超级管理员:**admin / admin123**(请登录后立即修改)
|
||||
3. 若管理员已**开放注册**,可在登录页 **注册** 新账号(用户名 ≥3 字符,密码 ≥6 字符)
|
||||
4. 若管理员已**关闭注册**,登录页不显示注册入口,需联系管理员在「系统设置 → 用户管理」中添加账号
|
||||
|
||||
> 系统无默认管理员账号,首个注册用户即为普通用户,数据仅本人可见。
|
||||
> 普通用户数据仅本人可见;普通用户**不能**自行修改用户名或密码。
|
||||
|
||||
### 2.2 添加学生
|
||||
### 2.2 系统设置(超级管理员)
|
||||
|
||||
首页右上角 **系统设置**(仅超级管理员可见):
|
||||
|
||||
| 功能 | 说明 |
|
||||
|------|------|
|
||||
| 注册开关 | 开启后用户可自行注册;关闭后仅管理员添加用户 |
|
||||
| 管理员账号 | 修改超级管理员的用户名、密码(修改密码需输入当前密码) |
|
||||
| 用户管理 | 添加用户、重置密码、删除普通用户 |
|
||||
|
||||
### 2.3 添加学生
|
||||
|
||||
1. 首页点击 **添加学生**
|
||||
2. 填写:
|
||||
@@ -40,7 +51,7 @@
|
||||
- **班级**:如「3班」(可选)
|
||||
3. 保存后在卡片上可看到学段标签
|
||||
|
||||
### 2.3 录入成绩
|
||||
### 2.4 录入成绩
|
||||
|
||||
进入学生详情 → **成绩录入** 标签:
|
||||
|
||||
@@ -130,13 +141,49 @@
|
||||
|
||||
---
|
||||
|
||||
## 7. 常见问题
|
||||
## 7. 维护人员:修改代码后如何更新线上
|
||||
|
||||
**服务器不在本地构建前端。** 维护或二次开发时,请严格按以下流程发布:
|
||||
|
||||
### 只改后端
|
||||
|
||||
```bash
|
||||
git add backend/
|
||||
git commit -m "说明"
|
||||
git push
|
||||
# 服务器
|
||||
bash /opt/secondary-school-grade-archive/deploy/update.sh
|
||||
```
|
||||
|
||||
### 改前端(或前后端都改)
|
||||
|
||||
```powershell
|
||||
# Windows:先构建
|
||||
.\deploy\build-frontend.ps1
|
||||
```
|
||||
|
||||
```bash
|
||||
# Linux / macOS:先构建
|
||||
bash deploy/build-frontend.sh
|
||||
|
||||
git add frontend/ frontend/dist
|
||||
git commit -m "说明"
|
||||
git push
|
||||
# 服务器
|
||||
bash /opt/secondary-school-grade-archive/deploy/update.sh
|
||||
```
|
||||
|
||||
详细说明见 [DEPLOY.md §2](./DEPLOY.md#2-代码修改与发布流程重要) 与 [README](../README.md#修改代码后如何发布必读)。
|
||||
|
||||
---
|
||||
|
||||
## 8. 常见问题
|
||||
|
||||
**Q:忘记密码怎么办?**
|
||||
A:当前版本无找回密码功能,需管理员在数据库中重置或重新注册(生产环境建议后续增加找回流程)。
|
||||
A:普通用户请联系超级管理员,在「系统设置 → 用户管理」中重置密码。超级管理员忘记密码需通过数据库或 `.env` 中的 `ADMIN_DEFAULT_*` 配合运维处理。
|
||||
|
||||
**Q:多人能否共用一台服务器?**
|
||||
A:可以。每人注册独立账号,数据互不可见。
|
||||
A:可以。每人独立账号,数据互不可见。
|
||||
|
||||
**Q:能否同时管理初中和高中孩子?**
|
||||
A:可以。添加学生时分别选择学段即可。
|
||||
@@ -145,11 +192,14 @@ A:可以。添加学生时分别选择学段即可。
|
||||
A:可以。使用同一服务器地址与账号登录即可。
|
||||
|
||||
**Q:HTTPS 和域名怎么配置?**
|
||||
A:本项目不包含反向代理配置,请参考 [DEPLOY.md 第 7 节](./DEPLOY.md#7-反向代理用户自行配置) 自行设置。
|
||||
A:本项目不包含反向代理配置,请参考 [DEPLOY.md §8](./DEPLOY.md#8-反向代理用户自行配置) 自行设置。
|
||||
|
||||
**Q:改了代码但服务器页面没变化?**
|
||||
A:很可能未在开发机执行 `npm run build` 或未将 `frontend/dist` 推送到仓库。见上文第 7 节。
|
||||
|
||||
---
|
||||
|
||||
## 8. 技术支持与版权
|
||||
## 9. 技术支持与版权
|
||||
|
||||
| 项目 | 内容 |
|
||||
|------|------|
|
||||
|
||||
Reference in New Issue
Block a user