You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.
# 数字人民币教学仿真后端
## 登录方式
- 主平台单点登录：主平台跳转至 `GET /api/v1/auth/sso?token=...` 。后端以主平台教师或学生档案的 `add_time` 动态 HMAC 密钥验证 Token， `code` 并跳转至前端回调地址。
- 独立访问：浏览器访问 `GET /api/v1/auth/cas/login` ，跳转学校 CAS； `code` 。
- 会话兑换：`POST /api/v1/auth/session/exchange`，请求体为 `{"code":"..."}` ，返回本系统访问 JWT 和刷新令牌。
本系统只接受教师和学生两类身份。平台账号与角色只能通过内部投影写入；没有用户、角色或用户角色的管理接口。
## 必需配置
生产环境通过环境变量配置：
| 变量 | 说明 |
| --- | --- |
| `DIGITAL_RMB_DB_URL` | 本系统 MySQL JDBC 地址 |
| `DIGITAL_RMB_DB_USERNAME` | 本系统数据库账号 |
| `DIGITAL_RMB_DB_PASSWORD` | 本系统数据库密码 |
| `DIGITAL_RMB_JWT_SECRET` | 至少 64 字符的应用 JWT 密钥 |
| `DIGITAL_RMB_PLATFORM_DB_URL` | 主平台 MySQL JDBC 地址 |
| `DIGITAL_RMB_PLATFORM_DB_USERNAME` | 主平台只读数据库账号 |
| `DIGITAL_RMB_PLATFORM_DB_PASSWORD` | 主平台只读数据库密码 |
| `DIGITAL_RMB_CAS_LOGIN_URL` | 学校 CAS 登录地址 |
| `DIGITAL_RMB_CAS_VALIDATE_URL` | CAS `serviceValidate` 地址 |
| `DIGITAL_RMB_CAS_CALLBACK_URL` | 本系统固定 CAS 回调地址 |
| `DIGITAL_RMB_FRONTEND_CALLBACK_URL` | 前端接收一次性 code 的固定回调地址 |
主平台数据库账号必须仅授予 `SELECT` 权限。不要将主平台 Token 写入日志、数据库或前端最终 URL。
## 本地运行
```powershell
mvn spring-boot : run -Dspring-boot . run . profiles = local -Dspring-boot . run . arguments =- -server . port = 8081
```
本地 Swagger： < http: // localhost:8081 / swagger-ui / index . html >
生产环境不启用用户名/密码登录；仅 `local` 与 `test` 配置保留脚手架的 Bootstrap Admin 入口。