43 lines
1.9 KiB
Markdown
43 lines
1.9 KiB
Markdown
# Hera 后端
|
|
|
|
Spring Boot 后端，提供微信小程序登录、手机号验证码绑定、用户资料、协议、关注我们和吉分兑换状态接口。
|
|
|
|
命理计算使用 `cn.6tail:lunar` 根据公历生日和时辰生成四柱八字，再计算五行分布、日主、喜用和忌用。
|
|
|
|
元宝页提供今日卡牌、每日生活小贴士、卡牌置顶等接口。
|
|
|
|
## 本地启动
|
|
|
|
```bash
|
|
export WECHAT_APP_ID=wxa76a2ef9e8ba612e
|
|
export WECHAT_APP_SECRET=266bb34a7186a4b835186141516efb78
|
|
export DB_URL='jdbc:mysql://101.43.139.56:3306/hera?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true'
|
|
export DB_USERNAME=hera_user
|
|
export DB_PASSWORD='请通过部署环境配置'
|
|
mvn spring-boot:run
|
|
```
|
|
|
|
默认地址：`http://localhost:8080`
|
|
|
|
## 开发说明
|
|
|
|
- 当前已默认关闭微信 mock，并接入微信 `jscode2session`。
|
|
- 数据持久层使用 MyBatis Mapper XML，首次启动会执行 `schema.sql` 创建缺失的数据表。
|
|
- 数据库连接默认指向 `101.43.139.56:3306/hera`，生产部署建议通过 `DB_URL`、`DB_USERNAME`、`DB_PASSWORD` 覆盖。
|
|
- `WECHAT_APP_SECRET` 请优先使用服务器环境变量配置，不建议提交到公开仓库。
|
|
- `/api/auth/sms` 开发阶段返回 `mockCode`，接入短信厂商后移除返回值。
|
|
- 正式上线前需要替换 `hera.jwt-secret`、短信服务实现和协议正文。
|
|
|
|
## 数据表 CRUD
|
|
|
|
以下接口均需要携带 `Authorization: Bearer <token>`，并支持统一操作：
|
|
|
|
- `GET /api/data/{resource}/{id}`：按主键查询
|
|
- `GET /api/data/{resource}?offset=0&limit=20`：分页列表，`limit` 最大为 100
|
|
- `POST /api/data/{resource}`：新增
|
|
- `PUT /api/data/{resource}/{id}`：更新
|
|
- `DELETE /api/data/{resource}/{id}`：删除
|
|
|
|
`resource` 可取 `nfc-chips`、`user-accounts`、`user-profiles`、`virtual-items`、
|
|
`user-virtual-items`、`offerings`、`transfers`。
|