hera/README.md

Hera 后端

Spring Boot 后端，提供微信小程序登录、手机号验证码绑定、用户资料、协议、关注我们和吉分兑换状态接口。

命理计算使用 cn.6tail:lunar 根据公历生日和时辰生成四柱八字，再计算五行分布、日主、喜用和忌用。

元宝页提供今日卡牌、每日生活小贴士、卡牌置顶等接口。

本地启动

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。