会员插件

feat(withdraw): 优化提现设置条件显示逻辑

• 在提现设置中添加条件判断，仅当余额账户开启时显示
• 修改提现手续费率字段配置，去除不必要的number验证
• 更新版本号至1.2.0-alpha1以反映新功能调整

feat(api): 更新API文档和集成设置以支持产品订单积分兑换

• 将余额相关术语统一替换为储值账户
• 在MemberLevelRecord查询参数中添加startTimeEmpty和endTimeEmpty过滤选项
• 在MemberTransactionRecord查询参数中添加businessId过滤选项
• 新增产品订单积分兑换API接口供控制台和公开访问
• 新增获取会员插件设置的API接口
• 添加ProductOrderPointsRedemptionRequest和Result数据模型
• 在设置结果中新增余额账户和收藏设置配置
• 添加产品插件集成设置和验证令牌功能
• 实现产品订单积分兑换的安全访问控制和令牌验证
• 更新交易类型枚举添加PRODUCT_ORDER和SCORE_PRODUCT_REDEMPTION
• 配置角色模板允许产品订单积分兑换操作
• 在设置界面添加产品插件集成配置表单组件

feat(register): 支持可选的邀请码注册配置

• 添加了邀请码必填/选填配置选项，默认为必填
• 更新了前端模型定义，在InviteRegister接口中新增required字段
• 修改邀请码输入页面逻辑，支持可选模式下的不同提示文案和表单行为
• 实现跳过邀请码注册的功能，当邀请码设置为选填时可通过参数跳过
• 添加相关单元测试验证必填和选填场景的不同行为
• 更新API文档同步新增的required字段
• 在设置页面添加邀请码必填开关的配置界面

docs(api): 添加推荐功能API测试示例和相关配置文档

• 添加完整的API测试示例文档，包含curl命令、JavaScript示例和Postman集合
• 更新项目依赖版本，halo平台版本从2.24.0升级至2.25.0，插件版本从2.25.0升级至2.25.3
• 新增PRODUCT_ORDER业务类型枚举值，扩展业务类型支持
• 添加邀请访问限制配置分析与优化建议文档
• 添加设备指纹集成指南文档，提供前端集成方案和后端验证说明
• 添加充值防重复提交功能说明文档，详细解释防重复机制和技术实现
• 添加Excel批量导入会员等级功能文档，说明模板下载和批量导入流程

fix(member): 优化用户注册邀请过滤器行为和错误处理

• 将版本号更新为 1.2.0-alpha2
• 在 UserRegisterWebFilter 中加入对异常的 onErrorResume 处理，避免配置获取失败导致过滤失败
• 修改清理邀请码 Cookie 逻辑，避免响应已提交时重复操作和异常抛出
• 使用 UTF-8 显式编码邀请码输入页面内容，提升安全性和兼容性
• 调整过滤器执行顺序，确保邀请注册检查优先于主题/域名路由过滤器
• 增加多项单元测试覆盖异常场景和行为边界
• 优化测试中对于响应已提交状态和异常处理的模拟验证

feat(core): 优化会员插件的积分和储值账户功能

• 添加积分兑换作为默认合规路径的架构决策文档
• 添加余额提现由显式开关控制的架构决策文档
• 添加产品订单承载积分兑换的架构决策文档
• 升级 halo 插件开发工具版本到 0.8.0
• 配置 OpenAPI 使用现有服务器模式
• 将前端代码中的余额相关显示名称改为可配置的储值账户名称
• 在会员充值通知模板中使用动态的账户名称
• 添加控制台端点用于获取会员插件设置
• 更新后端接口描述从余额改为储值账户额度
• 实现储值账户功能的启用验证逻辑
• 添加储值账户相关的单元测试
• 重构余额扣除服务方法以支持自定义显示名称
• 在签到组件中集成可配置的余额显示名称

feat(widget): 添加会员签到小部件功能

• 实现了浮动和内联两种显示模式的签到小部件
• 添加了可拖拽定位的浮动窗口支持
• 集成了签到状态查询和签到操作API
• 实现了用户认证和权限检查功能
• 添加了积分和余额奖励显示
• 更新了依赖版本号到最新发布版
• 修复了角色模板中的重复路径配置问题

新特性

• 新增文章收藏功能；
• 个人中心可以管理文章收藏记录；
• 文章页面自动挂载收藏功能；

优化

• 修复签到奖励重复处理的问题；
• 修复用户签到记录查询数据异常的问题；
• 修复插件配置项展示异常问题；
• 重构签到统计卡片组件的样式和布局设计；

新特性

• 日历签到面板；
• 连续签到奖励；
• 补签功能、补签扣除积分/余额；补签奖励；
• 签到功能动态配置：
  • 每日签到基础积分；
  • 每日签到基础余额；
  • 启用连续签到奖励；
  • 连续签到奖励；
  • 启用补签功能；
  • 补签方式；
  • 每月最大补签次数；
  • 补签日期范围；

优化

• 更新版本依赖，兼容Halo 2.24.0；

新特性

• 在设置页面添加自动处理奖励开关配置项；
• 实现默认等级角色的自动分配机制；
• 新增批量设置会员等级功能；
• 实现会员等级记录功能并优化注册流程；
• 添加提现功能开关控制；
• 添加邀请注册功能开关控制；
• 添加邀请访问功能开关控制；
• 添加邀请购买功能开关控制；

优化

• 修改推荐奖励计算逻辑，统一使用积分作为奖励单位；
• 重构交易记录创建方法，支持自动处理奖励的状态设置；
• 更新推荐记录处理流程，移除重复的自动处理检查逻辑；
• 统一前端界面显示，将奖励值统一显示为积分格式；
• 修复注册推荐记录的奖励处理状态设置问题；
• 添加永久会员判断和续费功能控制；
• 添加推荐注册防刷和频率限制功能；
• 添加邀请访问防刷机制；
• 优化推荐记录奖励值设置和通知发送逻辑；
• 修复交易记录处理逻辑；

核心功能模块

1. 会员信息管理 (MemberInfo)

功能特性：

• 会员基础信息维护（用户ID、积分、余额、等级等）
• 会员状态管理（正常/冻结）
• 推荐统计（累计推荐人数）
• 登录时间跟踪

2. 会员等级系统 (MemberLevel)

功能特性：

• 多层级会员等级定义
• 等级权益配置（折扣、推荐奖励、访问权限等）
• 等级价格和有效期设置
• 角色权限绑定

3. 等级订阅记录 (MemberLevelRecord)

功能特性：

• 会员等级购买记录追踪
• 等级有效期管理
• 订阅状态监控（正常/过期/取消）
• 金额和备注信息记录

4. 推荐系统

推荐码管理 (MemberReferralCode)

功能特性：

• 个性化推荐码生成
• 使用次数限制和统计
• 推荐效果数据分析（访问/注册/购买）
• 推荐码有效期控制

推荐记录 (MemberReferralRecord)

功能特性：

• 推荐行为全程追踪
• 多种推荐类型支持（访问/注册/购买）
• 奖励自动计算和发放
• 推荐来源分析

业务逻辑：

• 推荐链接点击自动记录访问
• 用户注册时关联推荐码
• 购买行为触发推荐奖励
• 防重复推荐机制
• IP 和 User-Agent 追踪

5. 交易记录系统 (MemberTransactionRecord)

功能特性：

• 完整的资金流水记录
• 多种交易类型支持
• 交易状态实时跟踪
• 业务关联和扩展数据

6. 充值卡系统 (MemberRechargeCard)

功能特性：

• 批量充值卡生成
• 多种卡密类型（余额卡/积分卡）
• 卡密状态管理
• 使用记录追踪