Initial commit

2026-04-23 16:58:11 +08:00
commit 267eba1eca
2582 changed files with 273338 additions and 0 deletions
--- a/doc/业务数据表整理.md
+++ b/doc/业务数据表整理.md
@@ -0,0 +1,177 @@
+区分动态数据表和静态数据表，动态数据表是网站运行过程中用户产生的数据记录，重置网站时，可以清理掉。
+静态数据表是网站功能需要的基础数据，不能清理掉，清理掉会让网站不能运行。
+
+# 系统表
+gen_table                         
+gen_table_column                  
+qrtz_blob_triggers                
+qrtz_calendars                    
+qrtz_cron_triggers                
+qrtz_fired_triggers               
+qrtz_job_details                  
+qrtz_locks                        
+qrtz_paused_trigger_grps          
+qrtz_scheduler_state              
+qrtz_simple_triggers              
+qrtz_simprop_triggers             
+qrtz_triggers                     
+sys_config                        
+sys_dept                          
+sys_dict_data                     
+sys_dict_type                     
+sys_job                           
+sys_job_log                       
+sys_logininfor                    
+sys_menu                          
+sys_notice                        
+sys_oper_log                      
+sys_post                          
+sys_role                          
+sys_role_dept                     
+sys_role_menu                     
+sys_user                          
+sys_user_post                     
+sys_user_role 
+
+
+# 开箱游戏
+tt_box            开箱游戏共用的箱子数据, boxType字段用来区分是哪种开箱游戏的
+tt_box_ornaments  箱子中的饰品数据，主要是开出概率。
+tt_box_records    动态数据表，开箱记录。箱子id-饰品id-开出人-拥有人
+tt_box_third_explosive_user 开箱三级爆率用户，拥有特殊的开箱奖池
+tt_box_type       开箱
+tt_ornament       饰品元信息，所有开箱游戏共享相同的饰品信息，如名字，价格等
+tt_ornaments_level                
+tt_comp_record     箱子的补偿奖池记录？
+
+# 百变竞技
+tt_robot_fight_group               
+tt_robot_fight_group_box
+tt_fight                 动态数据表
+tt_fight_ranking_reward  对战排行榜奖励       
+tt_fight_result          动态数据表    
+tt_fight_round           动态数据表    
+tt_fight_user            动态数据表
+
+# 指数盲盒
+tt_exponent                       
+tt_exponent_user                  
+tt_exponent_user_box
+
+# roll房
+tt_roll                            
+tt_roll_jackpot                    
+tt_roll_jackpot_ornaments          
+tt_roll_user                      
+tt_roll_user_prize
+tt_time_roll                       
+tt_time_roll_user
+
+# 极速永痕
+game_sugar_record             动态数据表    
+game_sugar_spin                   
+game_sugar_spin_free              
+game_sugar_spin_super             
+game_sugar_step_info              
+game_sugar_step_info_free         
+game_sugar_step_info_super        
+game_sugar_user              动态数据表             
+game_sugar_win               动态数据表
+
+# 疯狂转盘
+game_wheel_round            动态数据表     
+game_wheel_round_bet        动态数据表          
+game_wheel_user             动态数据表
+
+# 充值支付系统  包含CDK
+tt_order                动态数据表。用户购买的充值订单
+tt_recharge_card        充值卡密
+tt_recharge_config                
+tt_recharge_prod                  
+tt_recharge_ranking_reward  对战排行榜奖励       
+tt_recharge_record
+tianxin_order            无用
+
+# 提货与转增
+tt_box_transfer_record   动态数据表。 转增记录
+
+# 发货记录
+tt_delivery_record     动态数据表
+
+# 公告 ApiAnnouncementController
+tt_announcement                    
+tt_announcement_read
+
+# 签到记录
+tt_attendance_record
+
+# 首页大屏广告banner
+tt_advertisement
+
+# 网站设置 -- 更偏向于网页功能
+tt_banner              和tt_advertisement功能一模一样
+tt_content             文章                        
+tt_content_type        文章
+
+# 推广
+tt_commission_record   动态数据表，推广佣金记录 无用
+tt_promotion_level     动态数据表
+tt_promotion_record    动态数据表         
+tt_promotion_update    动态数据表
+
+# 后台操作向用户消息
+tt_message                        
+tt_message_send
+
+# 系统异步向用户推送结果通知
+tt_notice                前端的消息通知是这个
+
+## 福利红包 
+与CDK相比福利红包不记录到充值流水。
+
+tt_red_pack               动态数据表，红包模板       
+tt_red_packet             动态数据表，红包数据  
+tt_red_packet_record      动态数据表，红包领取记录
+         
+# 任务中心
+tt_task_center                    
+tt_task_center_user
+
+# 黄金装备                
+tt_upgrade_fail_ornaments
+tt_upgrade_ornaments               
+tt_upgrade_record   
+
+# 用户系统
+tt_user                       动态数据表。删除数据需谨慎               
+tt_user_avatar                用户头像表    
+tt_user_blend_ercash          动态数据表。流水日志
+
+tt_user_amount_records        淘汰。被tt_user_blend_ercash替换了
+tt_user_credits_records       淘汰。被tt_user_blend_ercash替换了
+
+# vip系统
+tt_vip_level                  用户VIP等级配置
+
+# 福利系统                     
+tt_welfare                         
+tt_welfare_monthly_recharges
+tt_welfare_record                  
+tt_welfare_vip_level
+
+# 奖金
+tt_bonus                 福利元信息
+tt_bonus_receive_record  福利领取记录
+
+# 首充赠送
+tt_first_recharge
+
+# 无用
+tt_replacement_record     汰换记录    
+tt_ornament_yy          yy市场的饰品信息
+tt_ornament_zbt         zbt市场的饰品信息
+tt_box_open_chance      开箱机会，可以干掉
+tt_user_box_open_chance 
+tt_user_label
+tt_game_mould       未知
+tt_game_mould_box   未知
--- a/doc/修复图片地址错误.md
+++ b/doc/修复图片地址错误.md
--- a/doc/开发标准/多环境配置文件.md
+++ b/doc/开发标准/多环境配置文件.md
@@ -0,0 +1,12 @@
+application.yml 是项目的通用配置文件
+application-{profile}.yml 是项目不同环境的配置文件，如果与application.yml配置内容重复，则以application-{profile}.yml配置为准
+
+当前有三个环境的配置文件：
+- application-dev.yml 开发环境配置。本地测试用
+- application-test.yml 测试环境配置。服务器上测试环境用
+- application-pro.yml 生产环境配置
+
+
+application.yml中默认启用的是application-dev.yml。可以通过环境变量进行修改。
+
+在IDEA中，编辑启动配置，添加环境变量`SPRING_PROFILES_ACTIVE=test`, 即可启用application-test.yml配置。以此类推
--- a/doc/开发标准/安全.md
+++ b/doc/开发标准/安全.md
@@ -0,0 +1,3 @@
+任何被用户使用的接口，都是用POST方法，并使用加密传输。
+
+这里的用户包括游戏用户，也包括主播用户。
--- a/doc/开发标准/时间.md
+++ b/doc/开发标准/时间.md
@@ -0,0 +1,70 @@
+JDK与时间相关的包和API:
+
+# 包
+
+包      | 引入   | 描述 
+-------|------|-------------
+java.time | 1.8+ | 推荐使用
+java.util | 旧版   | 不推荐
+java.text | 旧版   | 日期字符串格式化相关，不推荐使用
+java.sql  | 1.1  | 数据库相关，业务不推荐使用
+java.time.chrono| 1.8 | 可选，能不用就不用。支持非 ISO 历法系统
+
+# java.time包中的类
+| 类/接口                | 用途                    |
+| ------------------- | --------------------- |
+| `LocalDate`         | 日期（年-月-日）             |
+| `LocalTime`         | 时间（时:分:秒.纳秒）          |
+| `LocalDateTime`     | 日期+时间                 |
+| `ZonedDateTime`     | 带时区的日期时间              |
+| `Instant`           | 时间戳（从1970-01-01的秒/毫秒） |
+| `Duration`          | 时间间隔（基于秒和纳秒）          |
+| `Period`            | 日期间隔（基于年月日）           |
+| `DateTimeFormatter` | 日期时间格式化               |
+LocalDate,LocalTime，LocalDateTime都是指表示一个时间数字，没有时区概念。比如LocalTime表示8:20，并不能表示出具体的时间，需要结合时区才能知道是哪里的8:20。
+
+
+java.time.format
+DateTimeFormatter 及其相关类
+用于格式化与解析日期时间
+java.time.temporal
+   时间访问和调整的底层接口
+   包含 Temporal, TemporalField, TemporalUnit 等 
+
+java.time.zone
+   时区相关类
+   ZoneId, ZoneOffset, ZoneRules 等
+
+# java.util包中的类
+| 类          | 说明                |
+| ---------- |-------------------|
+| `Date`     | 传统日期类（已不推荐），不带时区  |
+| `Calendar` | 日历计算（已不推荐），默认系统时区 |
+| `TimeZone` | 时区信息              |
+
+# java.text包中的类
+SimpleDateFormat - 旧版日期格式化（线程不安全）
+
+# java.sql
+这些也都没有时区概念，只表示时间值
+| 类           | 用途      |
+| ----------- | ------- |
+| `Date`      | SQL 日期  |
+| `Time`      | SQL 时间  |
+| `Timestamp` | SQL 时间戳 |
+
+# 最佳实践
+
+关于时区：
+1. 系统内部应该只用java.time下的LocalDate,LocalTime,LocalDateTime这些不带时区的概念。
+2. 只有与外部交互时，才应该转成带时区的概念。 比如把前端请求的日期转成LocalDateTime，返回给前端的时间应该转成前端对应时区的时间。或者请求外部依赖时，需要传递时间，应该确定好时区的概念。
+3. 定时任务的时间设置应该带上时区，否则将会按照系统所在时区执行，切换服务器时，时区会变，定时任务的执行时间也会变。
+作为中国开发者，应该都用东八区时间。`@Scheduled(cron = "2 15 0 * * ?", zone = "Asia/Shanghai")`
+4. 服务器的时区都设置成东八区时间
+
+查看时区:`timedatectl`
+列出可支持的时区:`timedatectl list-timezones | grep Shanghai`
+设置时区:`sudo timedatectl set-timezone Asia/Shanghai`
+
+关于存储时间的格式：
+1. 系统中只允许使用LocalDateTime，或者Long时间戳存储时间。优先用LocalDateTime，既拥有时间戳的所有信息，也有丰富的API操作时间。
--- a/doc/开发标准/标准.md
+++ b/doc/开发标准/标准.md
@@ -0,0 +1,19 @@
+# controller 请求参数
+使用一个自定义的Request类来接收参数。
+
+# controller 返回的类型
+现状：目前返回的类型有R,AjaxResult,PageDataInfo等
+标准：统一返回R<具体类型>类型。
+
+# mapper
+mapper继承Mybatis-Plus的BaseMapper。
+```java
+@Mapper
+public interface AdminGameSugarUserMapper extends BaseMapper<GameSugarUser> {
+}
+```
+
+单表查询时，使用mybatis-plus的Lambda查询方式。
+
+要执行复杂的查询逻辑时，用Lambda查询不好实现，或者很复杂时，可以使用@Select注解，在mapper类中写sql实现。
+
--- a/doc/开箱玩法/Roll房/Roll房.md
+++ b/doc/开箱玩法/Roll房/Roll房.md
@@ -0,0 +1,3 @@
+1.查询roll房的基本信息，是否存在，是否开奖，是否有参与者
+2.查看是否有系统指定用户获取饰品，调用rollSurplusOrnaments()方法，传入全部参与用户和饰品，将该饰品指定给需要指定的用户，扣除该饰品并返回剩下的饰品，并且将指定用户过滤出
+3.获取没有指定获取饰品的用户，再将这些没指定的用户打乱顺序，再去遍历有库存饰品，按顺序给随机用户，每人一件，保存结果，更新roll房状态
--- a/doc/开箱玩法/极速永恒/极速永恒.md
+++ b/doc/开箱玩法/极速永恒/极速永恒.md
@@ -0,0 +1,8 @@
+1.先效验传入的下注金额是否正确，再去给每个用户申请一把锁，根据用户id去redis中读取游戏缓存数据，缓存为空，扣费并且更新用户累计的投注，在去更新用户的总投注额，再去查找今天0点的统计记录，不存在则创建，否则将今日统计表中下注金额累计，再将redis中的全局奖励池累加
+再去初始化缓存数据，再去通过selectGame()方法去挑选一局游戏
+    1.1selectGame()方法，首先去查询用户的历史数据（历史投钱数，游戏多少次），查询不到就去初始化一条全新数据，再去redis中读取游戏的配置信息，在去读取配置表（有rtp=0.8），再从redis中拿到全局的奖励池（所有玩家总投注，所有玩家总获奖），再将StrategyContext对象组装
+    再去执行三个策略，分别是：普通旋转，免费旋转，超级旋转，三个旋转只是查询条件不同，最后封装GameSpin对象返回
+2.处理免费旋转，再去更新缓存，再去检测并且去累加S出现的次数，再去累加倍数到累计赢取额，然后写回缓存保存更新
+3.判断游戏是否结束，去计算最终的奖励，总得分(score) × 单注(bet) = 本局实际奖励金额，若计算结果≤0，强制设为0.01保底，再将赢取的金额加到玩家账号
+4.本局游戏结束之后，将该用户的redis缓存为空，去更新用户累计的输赢金额，再去更新统计表和Redis的全局奖励池
+5.构建完整数据并且返回
--- a/doc/开箱玩法/疯狂转盘/疯狂转盘.md
+++ b/doc/开箱玩法/疯狂转盘/疯狂转盘.md
@@ -0,0 +1,10 @@
+1.开奖算法：决定转盘停在哪个格子
+    1.1 无人下注的话，过滤特殊效果S，从剩下的格子里面随机选择一个
+    1.2 有人下注的话，需要去计算每个格子的纯利润，需要去遍历每个格子符号，去获取每个格子的位置，将特殊符号S过滤，去计算需要赔付多少钱payoutIf（）方法，计算出赔付金额，
+        通过本局的总注额减去赔付金额就能计算出净利润，再将格子下标和净利润加入列表
+        1.2.1payoutIf（）方法，根据下注的符号，去计算需要赔付多少钱，赔付金额是 = 总下注额*赔率
+    1.3 判断是否触发特殊效果S，生成一个0到1的随机数，如果小于特殊效果S的概率，则触发特殊效果S，然后再去随机选择一种特殊效果，记录特殊效果名
+        1.3.1 如果是系统赢，随机找一个非s的下标，将下标和:S0组装表示为系统赢，直接返回
+        1.3.2 免费旋转，默认是1次，随机找一个非s的下标，将下标和:S1组装表示为免费旋转1次,可以旋转3次
+    1.4 普通开奖，计算出净利润大于0的格子的集合，再从盈利的格子随机选一个，如果没有净利润大于0的格子就去选亏得最少的格子，将结果加入
+
--- a/doc/开箱玩法/百变竞技/百变竞技.md
+++ b/doc/开箱玩法/百变竞技/百变竞技.md
@@ -0,0 +1,10 @@
+1.创建对战房间，先效验创建房间参数，0是欧皇，1是非酋，几人对战，配置宝箱的信息以及费用，回合数是1-15次，验证余额是否足够，初始化座位，
+再去构建对战对象，再去扣减房主的报名费，房主自动入第一个座，再去保存对战人员的信息，创建房间成功通过异步WebSocket广播通知大厅有新房间
+2.玩家加入对战房间，先获取锁，防止并发加入，再去效验对战信息joinFightCheck（）方法，方法首先查询未对战信息，
+再去查询是否报名，再去检查余额是否足够，再去寻找空位入座，检查是否重复加入，更新对战座位信息，扣除加入人员报名费，保存参与记录，异步WebSocket广播用户加入房间
+3.fightBegin开始游戏方法，获取锁防止重复开始，检查游戏是否开始，执行多回合的抽奖newComputerFight()方法，再去计算胜负computerWinner()方法，该方法包含对战模式，座位信息，抽奖结果，
+去分配奖品，如果是多个赢家，失败者的奖品价值平分，赢家的奖品归自己，失败者的奖品累计，去平分失败者的总价值，如果是单个玩家或全员平局，单个赢家，将失败者奖品分给赢家，全员平局的话就轮流分配，
+最后再去批量保存开箱记录，更新对战状态为进行中，在异步WebSocket广播，构建开箱结果，广播给房间用户和大厅
+    3.1.newComputerFight()方法，获取宝箱配置，获取所有玩家的id，设置回合计数器，外层遍历每一个宝箱，内层记录宝箱开启的次数，执行一回合的抽奖roundLottery()方法，将对局结果addAll全部加入宝箱记录集合中，回合数累加，再去更新宝箱历史开箱统计，在补充对战的id
+        3.1.1.roundLottery()方法，遍历当前回合所有的玩家，再去使用经典开箱方法singleLottery(),获取饰品详情，再去构建开箱的记录
+    3.2 computerWinner()方法，有两个模式，欧皇模式（总价值最高者胜）和非酋模式（总价值最低者胜），欧皇模式去累加该玩家获得的所有的饰品价值，比较是否为最高或者平局，非酋模式是否为最低或者平局
--- a/doc/开箱玩法/经典开箱/经典开箱饰品分配.md
+++ b/doc/开箱玩法/经典开箱/经典开箱饰品分配.md
@@ -0,0 +1,12 @@
+1.根据用户类型确定使用哪个奖池，普通奖池，补偿奖池，三级爆率奖池，
+在再根据宝箱id和用户类型获取锁，防止同一个宝箱同一个用户类型的并发抽奖，持续10秒，重试三次
+2.获取三个奖池对象，判断三个奖池是否为空，如果为空，就初始化创建空奖池
+3.查询用户是否拥有三级爆率，如果不为空，说明有三级爆率
+4.根据是否有三级爆率权限，选择使用哪个奖池，checkPool() 方法首先查看当前prizePool对象是否有数据，
+是直接返回，否则去redis中查看是否有数据，有则将数据加入prizePool对象中，
+否则去数据库中查询，并加入prizePool对象中，有三级爆率就使用thirdExplosivePrizePool，否则使用prizePool
+5.补偿机制，先查询用户的补偿记录是否有值，如果是补偿箱并且没有补偿记录，创建空的补偿记录，如果有补偿记录，查看是否到达补偿阈值，
+如果是补偿箱并且补偿值>=阈值，将切换到补偿奖池，并将补偿值清楚，将补偿记录删除
+6.执行抽奖的算法doLottery（）方法，箱子里面包含饰品及其数量，获取饰品总数量，并且随机五次并记录最后一次的值，
+然后循环每个饰品的位置，如果这个位置的值和记录的最后一次的值相同，拿到当前饰品的id，
+如果循环多次没有拿到，就取饰品的第一个（按序给），库存减一
--- a/doc/数据库变更.md
+++ b/doc/数据库变更.md
@@ -0,0 +1,6 @@
+添加机器人爆率
+
+ALTER TABLE `tt_box_ornaments` ADD COLUMN `robot_odds` int DEFAULT '0' COMMENT '机器人数量' AFTER `anchor_odds`;
+
+ALTER TABLE game_sugar_record
+ADD COLUMN multiplier decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '倍率';
--- a/doc/数据库备份.md
+++ b/doc/数据库备份.md
@@ -0,0 +1,6 @@
+mysqldump -ufire -piTSJSPPZM3LSGAPC fire --no-tablespaces game_sugar_spin > game_sugar_spin.sql
+
+mysqldump -ufire -piTSJSPPZM3LSGAPC fire --no-tablespaces game_sugar_step_info > game_sugar_step_info.sql
+
+
+mysql -u fire -piTSJSPPZM3LSGAPC fire < game_sugar_spin.sql
--- a/doc/新手环境搭建文档/img.png
+++ b/doc/新手环境搭建文档/img.png
--- a/doc/新手环境搭建文档/环境搭建文档.md
+++ b/doc/新手环境搭建文档/环境搭建文档.md
@@ -0,0 +1,29 @@
+1.本地安装jdk21
+    配置jdk环境变量，idea官网下载版本2024.3.3  破解版  ——》 https://docs.qq.com/doc/DWkdRQVZRV0RoZHdh
+2.本地安装maven3.6.1
+    配置settings.xml文件
+    1). 复制<localRepository>标签，粘贴到注释的外面（55行）左右
+        <localRepository>D:\software\apache-maven-3.6.1\local_repo</localRepository> //自己的maven安装路径
+    2）. 打开settings.xml文件，定位到160行左右
+    2). 在<mirrors>标签下为其添加子标签<mirror>，内容如下：
+        <mirror>  
+            <id>alimaven</id>  
+            <name>aliyun maven</name>  
+            <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
+            <mirrorOf>central</mirrorOf>          
+        </mirror>
+    3）.配置Maven环境变量，MVN -V 查看是否配置成功
+3.安装docker for windows
+    1).配置教程 https://developer.aliyun.com/article/1604556  
+    2).国内镜像加速 ![img.png](img.png) 图片所示 加速器链接 "https://docker.1ms.run"
+4.下载git 拉取代码
+    1).创建文件夹存放项目，git init初始化，使用git clone http://39.107.124.211:13000/cocos/ruoyi.git 拉取代码
+    2).账号密码是 cocos02 cocos02@163.com
+    3).在ruoyi项目docker目录下cmd，使用命令docker compose up -d启动mysql，redis，rabbitmq
+    4).导入sql文件
+5.安装vs code 
+    1).安装node.js 版本 node v22.22.0  npm版本 10.9.4  安装教程——》https://blog.csdn.net/Natsuago/article/details/145567734
+    2).npm run dev
+
+
+
--- a/doc/清理数据.md
+++ b/doc/清理数据.md
@@ -0,0 +1,57 @@
+"game_sugar_record",
+"game_sugar_user",
+"game_wheel_round_bet",
+"game_wheel_user",
+"tt_announcement_read",
+"tt_attendance_record",
+"tt_bonus_receive_record",
+"tt_box_records",
+"tt_commission_record",
+"tt_delivery_record",
+"tt_exponent_user",
+"tt_exponent_user_box",
+"tt_fight",
+"tt_fight_user",
+"tt_notice",
+"tt_order",
+"tt_promotion_record",
+"tt_recharge_record",
+"tt_red_packet",
+"tt_red_packet_record",
+"tt_roll",
+"tt_roll_user",
+"tt_task_center_user",
+"tt_time_roll_user",
+"tt_upgrade_record",
+"tt_user_blend_ercash",
+"tt_welfare_record",
+"tt_recharge_record",
+"game_sugar_win",
+"game_wheel_round",
+"tt_recharge_card",
+
+
+
+
+
+```python
+tables = [
+    "tt_box",
+    "tt_box_open_chance",
+    "tt_box_ornaments",
+    "tt_box_records",
+    "tt_ornament",
+    "tt_upgrade_fail_ornaments",
+    "tt_upgrade_ornaments",
+    "tt_upgrade_record",
+    "tt_roll",
+    "tt_roll_jackpot",
+    "tt_roll_jackpot_ornaments",
+    "tt_roll_user_prize"
+]
+
+for table in tables:
+    print(f"""CREATE TABLE {table}_new LIKE {table};
+RENAME TABLE {table} TO {table}_old, {table}_new TO {table};""")
+
+```
--- a/doc/网站迁移.md
+++ b/doc/网站迁移.md
@@ -0,0 +1,23 @@
+服务器时区设置sudo timedatectl set-timezone Asia/Shanghai
+数据库时区设置：
+查看时区：SHOW GLOBAL VARIABLES LIKE '%time_zone%';
+SET GLOBAL time_zone = '+08:00';
+
+同步的文件资源：
+图片
+数据库文件
+
+
+安装依赖：
+docker/nginx/mysql/redis/git
+jdk21/maven3.6.3
+
+需要启动的服务
+docker rabbitmq coder-doc
+ruoyi
+nginx admin zhubo
+
+
+
+需要加白的服务：
+支付/发货