health-admin/README-AppletUser-Config.md

# 小程序用户实体类配置说明

## 配置目标
完善小程序用户实体类，直接使用AppletUser作为登录对象，实现与后台用户体系的完全分离。

## 实现方案

### 1. 完善AppletUser实体类

#### 1.1 修改文件
- `jeecg-boot/jeecg-boot-module/jeecgboot-boot-applet/src/main/java/org/jeecg/modules/appletBackground/appletUser/entity/AppletUser.java`

#### 1.2 新增字段
```java
// 基础信息
private String username;        // 用户名
private String password;        // 密码
private String realname;        // 真实姓名
private Date birthday;          // 生日
private Integer sex;            // 性别（1：男 2：女）
private String email;           // 邮箱
private Integer status;         // 状态(1：正常 2：冻结)
private Integer delFlag;        // 删除标志（0代表存在 1代表删除）
private Integer userIdentity;   // 用户身份（1 普通用户 2 VIP用户）

// 健康信息
private BigDecimal height;      // 身高(cm)
private BigDecimal weight;      // 体重(kg)
private Integer age;            // 年龄

// 联系信息
private String address;         // 地址
private String emergencyContact;    // 紧急联系人
private String emergencyPhone;      // 紧急联系人电话

// 会员信息
private String memberLevel;     // 会员等级
private Integer points;         // 积分

// 系统信息
private Date lastLoginTime;     // 最后登录时间
private String deviceId;        // 设备ID
private String loginIp;         // 登录IP
private String remark;          // 备注
```

### 2. 直接使用AppletUser作为登录对象

#### 2.1 配置说明
- 直接使用`AppletUser`实体类作为登录对象
- 不需要额外的VO类转换
- 简化了代码结构，减少了维护成本

#### 2.2 核心特性
```java
@Data
@TableName("applet_user")
@Accessors(chain = true)
@EqualsAndHashCode(callSuper = false)
@Schema(description="小程序用户")
public class AppletUser implements Serializable {
    // 基础信息
    private String id;              // 用户ID
    private String username;        // 用户名
    private String realname;        // 真实姓名
    private String name;            // 昵称
    private String password;        // 密码
    private String openid;          // 第三方认证id
    private String avatar;          // 头像
    
    // 健康信息
    private BigDecimal bmi;         // 体总指数
    private BigDecimal fat;         // 脂肪
    private BigDecimal height;      // 身高
    private BigDecimal weight;      // 体重
    private Integer age;            // 年龄
    
    // 其他信息
    private Integer userIdentity;   // 用户身份
    private String memberLevel;     // 会员等级
    private Integer points;         // 积分
    private String deviceId;        // 设备ID
    // ... 其他字段
}
```

### 3. 修改小程序Realm

#### 3.1 修改文件
- `jeecg-boot/jeecg-boot-base-core/src/main/java/org/jeecg/config/shiro/AppletShiroRealm.java`

#### 3.2 配置变更
```java
@Override
protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principals) {
    if (principals != null) {
        AppletUser appletUser = (AppletUser) principals.getPrimaryPrincipal();
        username = appletUser.getUsername();
        userId = appletUser.getId();
    }
    // 小程序专用的权限认证逻辑
    return info;
}

@Override
protected AuthenticationInfo doGetAuthenticationInfo(AuthenticationToken auth) throws AuthenticationException {
    // 直接使用AppletUser进行身份认证
    AppletUser loginUser = this.checkAppletUserTokenIsEffect(token);
    return new SimpleAuthenticationInfo(loginUser, token, getName());
}
```

## 用户体系分离效果

### 1. 后台管理系统用户
- **实体类**：`SysUser`
- **登录对象**：`LoginUser`
- **Realm**：`ShiroRealm`
- **适用场景**：后台管理系统的所有用户

### 2. 小程序用户
- **实体类**：`AppletUser`
- **登录对象**：`AppletUser`（直接使用实体类）
- **Realm**：`AppletShiroRealm`
- **适用场景**：小程序相关的所有用户

## 配置优势

### 1. 完全独立的用户体系
- 小程序和后台使用不同的用户表
- 可以配置不同的用户属性和业务逻辑
- 支持不同的用户管理策略

### 2. 更好的业务适配
- 小程序用户包含健康相关的字段（BMI、身高、体重等）
- 支持会员等级和积分系统
- 包含紧急联系人等小程序特有功能

### 3. 便于维护和扩展
- 小程序用户相关的逻辑独立管理
- 可以独立升级和配置
- 便于调试和问题排查

## 使用示例

### 1. 小程序用户注册
```java
@PostMapping("/register")
@Operation(summary = "小程序用户注册")
public Result<AppletUser> register(@RequestBody AppletUser appletUser) {
    // 小程序用户注册逻辑
    return Result.OK(appletUser);
}
```

### 2. 小程序用户登录
```java
@PostMapping("/login")
@Operation(summary = "小程序用户登录")
public Result<AppletUser> login(@RequestBody LoginRequest request) {
    // 小程序用户登录逻辑
    AppletUser loginUser = appletUserService.login(request);
    return Result.OK(loginUser);
}
```

### 3. 获取小程序用户信息
```java
@GetMapping("/user/info")
@Operation(summary = "获取小程序用户信息")
public Result<AppletUser> getUserInfo() {
    // 获取当前登录的小程序用户信息
    AppletUser user = (AppletUser) SecurityUtils.getSubject().getPrincipal();
    return Result.OK(user);
}
```

## 数据库表结构

### applet_user表字段
```sql
CREATE TABLE `applet_user` (
  `id` varchar(32) NOT NULL COMMENT '主键',
  `create_by` varchar(32) DEFAULT NULL COMMENT '创建人',
  `create_time` datetime DEFAULT NULL COMMENT '创建日期',
  `update_by` varchar(32) DEFAULT NULL COMMENT '更新人',
  `update_time` datetime DEFAULT NULL COMMENT '更新日期',
  `sys_org_code` varchar(64) DEFAULT NULL COMMENT '所属部门',
  `name` varchar(100) DEFAULT NULL COMMENT '昵称',
  `openid` varchar(100) DEFAULT NULL COMMENT '第三方认证id',
  `phone` varchar(45) DEFAULT NULL COMMENT '手机号',
  `bmi` decimal(10,2) DEFAULT NULL COMMENT '体总指数',
  `fat` decimal(10,2) DEFAULT NULL COMMENT '脂肪',
  `avatar` varchar(255) DEFAULT NULL COMMENT '头像',
  `username` varchar(100) DEFAULT NULL COMMENT '用户名',
  `password` varchar(255) DEFAULT NULL COMMENT '密码',
  `realname` varchar(100) DEFAULT NULL COMMENT '真实姓名',
  `birthday` date DEFAULT NULL COMMENT '生日',
  `sex` int DEFAULT NULL COMMENT '性别（1：男 2：女）',
  `email` varchar(45) DEFAULT NULL COMMENT '邮箱',
  `status` int DEFAULT NULL COMMENT '状态(1：正常 2：冻结)',
  `del_flag` int DEFAULT NULL COMMENT '删除标志（0代表存在 1代表删除）',
  `user_identity` int DEFAULT NULL COMMENT '用户身份（1 普通用户 2 VIP用户）',
  `height` decimal(10,2) DEFAULT NULL COMMENT '身高(cm)',
  `weight` decimal(10,2) DEFAULT NULL COMMENT '体重(kg)',
  `age` int DEFAULT NULL COMMENT '年龄',
  `address` varchar(500) DEFAULT NULL COMMENT '地址',
  `emergency_contact` varchar(100) DEFAULT NULL COMMENT '紧急联系人',
  `emergency_phone` varchar(45) DEFAULT NULL COMMENT '紧急联系人电话',
  `member_level` varchar(50) DEFAULT NULL COMMENT '会员等级',
  `points` int DEFAULT NULL COMMENT '积分',
  `last_login_time` datetime DEFAULT NULL COMMENT '最后登录时间',
  `device_id` varchar(100) DEFAULT NULL COMMENT '设备ID',
  `login_ip` varchar(100) DEFAULT NULL COMMENT '登录IP',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='小程序用户表';
```

## 注意事项

1. **用户体系隔离**：小程序和后台使用完全不同的用户表
2. **字段差异**：小程序用户包含健康相关的字段
3. **业务逻辑**：小程序用户支持会员等级和积分系统
4. **安全策略**：可以为小程序配置不同的安全策略
5. **缓存策略**：可以为小程序用户配置独立的缓存策略

## 后续开发建议

1. **实现getAppletUser方法**：需要根据实际的AppletUser服务来实现
2. **添加小程序用户服务**：创建AppletUserService来处理用户相关业务
3. **配置小程序用户权限**：为小程序用户配置独立的角色和权限体系
4. **添加健康数据管理**：实现BMI、体重等健康数据的计算和管理
5. **实现会员系统**：实现会员等级和积分系统