夜雨聆风---
**用户注册与登录**
手机号加密码注册，手机号长度5到20位，昵称2到12个字符。注册时可填写推荐码，系统校验推荐码有效且状态正常后将用户归属到对应推荐人名下。每个用户自动生成5位不重复数字编号，采用随机生成加数据库碰撞检测确保唯一。注册时系统读取后台配置的赠送积分数额（默认500），自动写入账户，同时插入注册奖励积分记录。密码使用bcrypt加密存储，采用可配置的盐轮数。登录后签发JWT双令牌，access token有时效（小时级），refresh token有更长时效（天级），支持令牌刷新。
**新用户引导**
首次登录展示5步引导：欢迎页、浏览赛事说明、竞猜教程、查看记录指引、完成页。每步完成后记录进度，全部完成可领取欢迎积分奖励。已完成用户不再展示。
**赛事浏览**
首页展示全部赛事，四个筛选标签：全部（默认显示即将开始和进行中）、进行中、即将开始、往期。已登录用户额外显示"我的关注"标签。排序规则为进行中优先置顶，其余按比赛时间升序。每场比赛卡片展示队名、国旗色块、比分（如有）、比赛时间、倒计时、阶段标签。支持下拉刷新和滚动分页。
**赛事详情与竞猜选项**
点击赛事进入详情页，顶部显示双方队名和国旗色块。进行中或已结束的比赛显示实时比分，未开始的显示日期和倒计时。已登录且在可竞猜状态下展示竞猜区域，包含七种玩法标签切换。
七种玩法逐一说明如下。
第一，胜平负。预测比赛最终结果，三种选项（主胜、平局、客胜）各自对应一个倍率。数据源来自外部实时数据，对所有来源的开盘和即时数据分别取均值后生成。选项旁显示开盘倍率对比及涨跌箭头。
第二，让球盘。含让球数的胜负预测，支持多线盘口切换。每条线代表一个让球数（如0球、0.25球、0.5球、1球等），展示主客双方的倍率并标注数据来源数量。外部原始数据为港式格式，后端自动转为标准格式。结算时根据实际比分加让球差判定结果，恰好走水平退全额。
第三，大小球。预测全场总进球数大于或小于某个门槛值，同样多线切换（如2.5球、3球、3.5球等）。每条线展示大盘口和小盘口的倍率及来源数量。进球数恰好等于门槛值时走水平退。
第四，精确比分。预测全场精确比分。提供25种常见比分的倍率（主队0至4球以上、客队0至4球以上，共5乘5矩阵），如1比0、2比1、3比3等。每种比分独立倍率，结算时严格比对实际比分。
第五，总进球数。预测全场总进球数落在哪个区间。选项为0球、1球、2球、3球、4球、5球、6球、7球或以上，共8个选项。每个选项独立倍率，精确匹配方为正确，7球以上为范围匹配（大于等于7球均算正确）。
第六，双方得分。预测双方是否都能取得进球，选项为"是"和"否"。此玩法的倍率并非从外部直接获取，而是根据精确比分的倍率矩阵反向推导得出：遍历全部25种比分的倍率换算为概率，累加双方均有进球和至少一方零封的概率，归一化后反算倍率，上限50。结算时比对实际比分，双方均有进球选"是"正确，至少一方零封选"否"正确。
第七，角球数。预测全场角球总数大于或小于某个门槛值，多线盘口。外部数据为港式格式自动转标准格式，提供大盘口和小盘口选项。结算时因暂无可用统计数据源，统一执行平退处理，退还全额积分。
**选项倍率降幅**
后台可设置全局倍率降幅，支持固定值减扣和百分比减扣两种模式。开启后所有面向用户的倍率在返回前实时应用降幅计算，最低不低于1.01。降幅配置30秒缓存，修改后即时生效。
**赛事收藏**
用户可收藏关注的赛事，在列表卡片和详情页右上角均有星标按钮，点击切换。收藏数据持久化，在"我的关注"标签中查看。
**竞猜确认与下单**
用户在详情页选择玩法和选项后，弹出确认面板。面板顶部显示比赛对阵、玩法类型、选项名称和倍率。中间为金额输入区，支持手动输入和快捷调整（减100、加100），下方提供快速金额选择（50、100、500、1000）和全投按钮（一键填入当前全部可用积分）。底部显示预估收益（金额乘以倍率减去本金等于净收益）。
下单时执行多重校验：校验比赛状态是否为可竞猜，校验比赛是否已封盘，校验金额不低于10积分，校验积分余额充足，从数据库读取该玩法该盘口的倍率数据，对比用户提交的倍率与当前最新倍率差异超过0.1则拒绝并提示倍率已变化。通过限额检查（单场限额、每日限额、总额），任一超额则拒绝。所有校验通过后，在数据库事务中完成扣减积分、创建记录、写入流水、记录限额使用量四步操作。
**竞猜记录**
用户可在"我的竞猜"页面查看全部历史，按状态分为待结算、正确、未正确、已平退四个标签。每条展示比赛对阵、竞猜选项、金额、倍率、预估收益、订单号、时间。已结算的显示实际收益。
**积分流水**
用户在"积分明细"中查看全部积分变动，包括注册奖励、竞猜支出、正确收益、平退、充值、扣减等类型。不同类型用不同颜色标签区分。
**排行榜**
公开排行，无需登录。支持本日、本周、全程三个时间维度切换。按净收益降序排列，展示排名、昵称、总次数、正确次数、正确率、总金额、总收益、净收益。已登录用户可看到自己的排名。
**个人中心**
查看和编辑个人资料，包括头像、昵称、性别、简介。展示当前积分余额、用户编号。统计总竞猜次数和正确率。修改密码。查看推荐人信息。账号注销和退出登录。
**推荐人体系**
管理员后台创建推荐人账号，设置用户名、密码、昵称、手机号、QQ号、微信号、初始积分和3位数字推荐码。推荐码创建和编辑时后端校验必须恰好3位且不可重复。管理员可给推荐人充值积分。
推荐人拥有独立后台，用户名密码登录。看板展示：名下会员总数、今日新增、今日充值总额、今日扣减总额、累计充值总额、累计扣减总额、当前可用积分、近期操作流水。可查看名下全部会员列表。可对名下会员进行充值和扣减操作，充值时从推荐人余额扣出，扣减时积分回收到推荐人余额。可重置名下会员的登录密码。后台已做移动端响应式适配。
**管理后台**
管理后台用户名密码登录，支持角色权限控制。看板展示：四张统计卡片（总用户数及今日新增、总竞猜数及今日新增、总金额及今日金额、待结算数及进行中比赛数）。ECharts近7天趋势图，支持次数和金额维度切换。快捷操作按钮和风控预警卡片。
赛事管理页面支持搜索筛选，可执行封盘解封操作，封盘后用户无法竞猜。
用户管理页面支持手机号、昵称、编号搜索，可编辑昵称、重置密码、启用禁用账号。
竞猜管理页面多条件筛选（赛事、玩法、状态、用户搜索、日期范围），支持批量导出Excel文件（含明细表、用户汇总表、赛事汇总表三个工作表）。
结算中心三个标签页：结算记录展示已完成结算的赛事，待处理展示已结束但尚未结算的比赛可一键自动结算，手工结算支持正常比分结算和异常平退结算（赛事取消、延期、腰斩三种类型全额退还积分）。所有结算操作在数据库事务中完成。结算回滚功能支持对已结算的竞猜执行回滚。
系统设置包含多个标签：数据源设置管理外部数据连接的配置和手动同步、倍率降幅设置（开关、模式、数值）、线路管理（多线路域名增删改查含配置教程）、系统状态监控、角色权限管理、操作日志查看。
**自动运营调度**
赛前自动封盘每5分钟执行，扫描即将开赛且未封盘的比赛自动封盘。倍率异常检测每2小时执行。数据同步每4小时执行（需配置外部数据地址），拉取最新比赛信息、比分和倍率并更新数据库。实时比分轮询每60秒更新进行中比赛的比分。自动结算每2分钟执行，处理已结束且存在未结算竞猜的比赛。每日凌晨3点清理过期会话、30天前的请求日志和设备指纹记录。正常运行报告每小时输出一次。
**风控体系**
竞猜限额三级控制：单场限额、每日限额、总额，任一达到后无法继续竞猜。限额使用量按日累计。后台可配置三级限额数值并可查看超额用户列表。
风控告警逐场扫描未封盘比赛，统计该场所有待结算竞猜的各选项总额和潜在赔付，计算总收入与最大赔付之间的敞口。敞口大于零或最大赔付超过总收入50%时触发告警，在后台看板展示风险等级。
订单超时监控pending状态过长的竞猜（默认30分钟），定时扫描（5分钟间隔）超时且比赛仍为即将开赛或已缺失的竞猜，自动触发平退处理。
设备指纹在关键操作时采集设备信息，使用SHA256哈希生成指纹。同一指纹关联多个账号超过阈值时触发风控告警。30天前的指纹数据自动清理。
倍率校验对同步进入系统的倍率进行检查：范围校验、热门球队异常偏低告警、变化幅度校验（单次变化超过20%告警）、异常自动标记并记录日志。
异常处理捕获系统运行异常，提取类型、消息、堆栈、关联用户和操作动作，写入异常记录表并按错误类型分级。
批量操作支持对比赛和竞猜进行批量处理，单次最多100条。支持类型包括批量封盘、批量解封、批量取消竞猜并平退、批量结算、批量平退。
**多线路域名防护**
后台线路管理支持增删改查多条域名线路，每条包含名称、完整URL、排序编号、启用状态。公开接口无需登录即可获取所有已启用线路列表。H5端首页顶部显示滚动公告条，自动滚动展示当前线路名称和全部备用域名地址，提示用户截图保存。公告条内容从接口获取同时缓存到本地（有效期1小时），接口暂不可用时仍可展示缓存。用户可点击关闭按钮隐藏。
**冠军预测**
独立的冠军预测玩法，用户可对特定球队预测其将获得世界杯冠军。金额范围100到50000积分。每个用户仅允许有一个pending状态的冠军预测记录。采用数据库事务确保扣减积分和创建记录的原子性。
