chore: track root project files and subrepos

01-产品方案文档.md

@@ -0,0 +1,399 @@
+# Sport-Era 体育咨询AI平台 - 产品方案文档
+
+> 版本：v1.1（Demo版）
+> 日期：2026-03-14
+> 技术栈：ThinkPHP 8 + Vue 3 + UniApp + DeepSeek AI
+
+---
+
+## 〇、当前阶段说明
+
+**当前目标：构建一个无限接近真实的 Demo 版本**
+
+| 维度 | Demo阶段 | 正式上线 |
+|------|----------|----------|
+| 赛事数据 | 网络爬取真实数据（免费源） | 接入付费第三方API（稳定+实时） |
+| 赔率/盘口 | 网络爬取真实赔率数据 | 接入实时赔率API |
+| 资讯文章 | 爬取体育新闻 + AI生成分析 | 运营团队 + AI生成 + 聚合 |
+| AI分析 | DeepSeek真实接入（Key后台配置） | 同左 |
+| 用户/社区 | 种子用户 + AI生成社区内容 + 真实注册流程 | 真实用户 |
+| 钱包/提现 | 完整流程（虚拟金额） | 接入真实支付 |
+| 分销 | 完整逻辑（虚拟数据验证） | 真实运营 |
+
+**核心原则**：所有功能逻辑、UI交互、API接口与正式版完全一致。赛事/赔率/资讯等数据通过爬取网络真实数据填充，接入付费API后切换数据源即可发布。
+
+---
+
+## 一、平台定位
+
+以 **数据深度** 为核心竞争力的体育咨询AI平台，通过 AI论坛/赛事评估分析 提供智能化体育资讯服务，采用 **流量共享分润模式** 实现商业化。
+
+**目标用户**：体育爱好者、足球/篮球球迷、体育数据分析爱好者
+
+**平台特色**：
+- AI驱动的赛事分析与预测
+- 社区化的跟单与方案分享
+- 可信度模型保障内容质量
+- 多端覆盖（iOS / Android / 鸿蒙 / H5）
+
+---
+
+## 二、功能模块总览
+
+| 模块 | 核心功能 | AI介入 |
+|------|----------|--------|
+| 平台首页 | 聚合展示/推荐流 | ✅ 个性化推荐 |
+| 足球/篮球模块 | 赛程/比分/盘口/赔率 | ✅ 赛事预测 |
+| 头条资讯 | 分类/列表/详情 | ✅ AI导读分析 |
+| 社区系统 | 发帖/跟单/标签 | ✅ 可信度分析 |
+| AI智能模块 | 预测/摘要/分析 | ✅ 核心模块 |
+| 个人中心 | 资料/钱包/分销 | ❌ |
+
+---
+
+## 三、模块详细设计
+
+### 3.1 平台首页
+
+#### 功能清单
+- **今日赛事/开奖聚合**：展示当日重要赛事和开奖结果
+- **热门推荐**
+  - 赛事推荐：根据热度和AI分析推荐赛事
+  - 彩票推荐：AI概率模型推荐
+  - 新闻资讯推荐：基于用户偏好推荐
+- **论坛帖子盈利榜**：展示近期盈利最多的社区推手
+- **AI精选分析**：AI自动生成的赛事分析精选
+- **风险提示**：平台风险提醒和免责声明
+- **个性化推荐流（AI驱动）**：基于用户行为的个性化内容推荐
+
+#### 数据来源
+- **Demo阶段**：首页数据通过爬取网络真实数据填充（赛事/资讯/排行榜等）
+- **正式上线**：付费数据API + DeepSeek AI推荐算法 + 社区实时统计
+
+---
+
+### 3.2 足球/篮球模块
+
+#### 赛程
+| 功能 | 说明 |
+|------|------|
+| 实时比分 | 赛事进行中实时更新比分 |
+| 盘口数据 | 亚盘/欧赔/大小球盘口展示 |
+| 赔率变化 | 赔率走势图，记录各时间点赔率变动 |
+| 历史交锋 | 两队历史对阵记录和统计 |
+
+#### 主流赛事覆盖
+- 足球：英超、西甲、德甲、意甲、法甲、欧冠、中超等
+- 篮球：NBA、CBA、欧洲篮球联赛等
+
+#### AI协助分析
+| 模型 | 输出 |
+|------|------|
+| 球队攻防模型 | 球队攻防能力评估图表 |
+| 进球期望值模型 | xG(预期进球)分析 |
+| 盘口盈亏模型 | 盘口价值分析 |
+| 伤停影响模型 | 伤停对比赛结果的影响评估 |
+| 胜平负概率 | AI预测胜/平/负概率 |
+| 大小球概率 | AI预测大/小球概率 |
+| 让球赢盘概率 | AI预测让球盘赢盘概率 |
+| 风险等级评估 | 综合风险等级（低/中/高） |
+
+#### 数据来源方案
+
+**Demo阶段（爬取网络真实数据）**：
+- 爬取公开体育网站的真实赛事数据（联赛/球队/赛程/比分/赔率/历史交锋）
+- 数据源：懒球帝、雷速体育、球探网、TheSportsDB等公开页面
+- API-Football 免费版（100次/天，补充数据）
+- 后端定时任务爬取 → 清洗入库 → 前端读取本地数据
+- 覆盖足球（英超/西甲/德甲等）和篮球（NBA/CBA）
+
+**正式上线**：
+- 切换为付费第三方API（纳米数据 / 雷速体育 / API-Football）
+- 数据表结构与Demo阶段一致，仅切换数据源适配器即可
+
+---
+
+### 3.3 头条资讯
+
+#### 功能清单
+- **资讯分类**：赛事新闻、转会动态、球队资讯、数据分析等
+- **热点导读**：编辑精选/AI推荐的热门资讯
+- **资讯列表**：分类浏览、搜索
+- **资讯详情**：文章阅读
+- **AI导读分析**：对资讯内容进行AI智能分析
+
+#### AI导读分析功能
+- 自动生成文章摘要
+- 重点信息提取
+- 风险提示标注
+- 反向观点对比
+- 情绪倾向分析（正面/中性/负面）
+
+#### 内容来源方案
+
+**Demo阶段**：
+- 爬取体育新闻网站的真实资讯文章（懒球帝/虎扑/腾讯体育等）
+- AI基于爬取的真实赛事数据自动生成分析文章
+- 后台可手动发布新文章
+- AI导读分析功能接入真实 DeepSeek
+
+**正式上线**：
+| 来源 | 说明 |
+|------|------|
+| 后台手动发布 | 运营/编辑发布原创内容 |
+| AI生成 | DeepSeek基于赛事数据自动生成赛前/赛后分析 |
+| 新闻聚合API | 接入新闻聚合服务获取体育资讯 |
+| 社区UGC精选 | 社区优质内容升级为资讯 |
+
+---
+
+### 3.4 社区系统
+
+#### 发帖系统
+| 功能 | 说明 |
+|------|------|
+| 图文发布 | 支持图文混排帖子 |
+| 战绩截图上传 | 用户上传投注战绩截图 |
+| 推荐方案发布 | 发布赛事推荐方案（关联赛事） |
+| 标签系统 | 帖子打标签便于分类和搜索 |
+
+#### 跟单系统
+| 功能 | 说明 |
+|------|------|
+| 一键跟单 | 用户可一键跟随推手方案 |
+| 盈利统计 | 跟单盈利汇总展示 |
+| 盈亏曲线图 | 可视化盈亏走势 |
+
+#### 用户体系
+| 功能 | 说明 |
+|------|------|
+| 等级体系 | 经验值升级系统 |
+| VIP订阅 | 付费会员特权 |
+| 专家认证 | 推手资质认证 |
+| 信誉评分 | AI驱动的可信度评估 |
+
+---
+
+### 3.5 AI智能模块（DeepSeek接入）
+
+#### 3.5.1 AI资讯阅读助手
+| 功能 | 实现方式 |
+|------|----------|
+| 自动摘要 | 文章全文 → DeepSeek → 结构化摘要（3-5句话） |
+| 重点提取 | 提取关键数据点、核心观点 |
+| 风险提示 | 识别文章中的风险因素并标注 |
+| 反向观点对比 | 自动搜索相反立场的观点对比 |
+| 情绪倾向分析 | 分析文章情绪：正面/中性/负面，置信度百分比 |
+
+#### 3.5.2 社区可信度分析模型
+| 维度 | 权重 | 说明 |
+|------|------|------|
+| 历史命中率 | 30% | 历史推荐的准确率 |
+| 盈亏波动率 | 15% | 盈亏的稳定程度 |
+| 发帖稳定性 | 15% | 发帖频率的稳定性 |
+| 预测合理性 | 15% | 推荐理由是否合理（AI判断） |
+| 是否事后编辑 | 15% | 检测赛后修改行为 |
+| 与赛果偏离度 | 10% | 预测结果与实际结果的差距 |
+
+**输出**：可信度评分（0-100）、风险等级、是否疑似"马后炮"标记
+
+**更新策略**：每日凌晨AI批量计算更新
+
+#### 3.5.3 赛事预测模型
+| 输入数据 | 输出结果 |
+|----------|----------|
+| 历史战绩 | 胜平负概率区间 |
+| xG数据 | 大小球概率 |
+| 盘口变化 | 让球赢盘概率 |
+| 伤停信息 | 盈利期望值 |
+| 赔率走势 | 风险等级（低/中/高） |
+
+#### 3.5.4 彩票概率模型
+| 功能 | 说明 |
+|------|------|
+| 统计分布分析 | 历史开奖数据的统计特征分析 |
+| 冷热号分析 | 号码出现频率和遗漏值分析 |
+| 概率可视化 | 图表展示各号码出现概率 |
+| 随机模拟 | 蒙特卡洛模拟生成推荐组合 |
+
+#### AI技术架构
+```
+用户请求 → PHP后端(AIService) → DeepSeek API
+                ↓
+          结果缓存(Redis)
+                ↓
+          存储(MySQL) → 前端展示
+```
+
+**AI配置管理（通过后台管理系统）**：
+- DeepSeek API Key：后台「AI配置」页面录入，存储在 la_ai_config 表
+- 模型选择：deepseek-chat / deepseek-reasoner，后台可切换
+- 调用参数：temperature、max_tokens 等，后台可调整
+- 调用限制：每日API调用上限、单用户调用频次，后台可配置
+- 调用日志：所有AI调用记录可在后台查看
+
+**调用策略**：
+- 缓存优先：相同输入在缓存有效期内直接返回
+- 异步处理：大量分析任务通过队列异步执行
+- 成本控制：设置每日API调用上限，VIP用户优先
+
+---
+
+### 3.6 个人中心
+
+#### 个人资料
+- 头像设置
+- 昵称修改
+- 手机号注册/绑定
+
+#### 分销管理
+| 功能 | 说明 |
+|------|------|
+| 邀请 | 邀请链接/二维码生成、邀请记录查看 |
+| 团队管理 | 团队列表、用户设置 |
+| 结算报表 | 佣金统计和结算明细 |
+
+**分销模式**：二级分销
+- 一级佣金：被邀请人消费金额的 15%
+- 二级佣金：被邀请人的邀请人消费金额的 8%
+- 佣金来源：VIP订阅、付费方案购买
+- 结算周期：月结（每月1日结算上月佣金）
+- **Demo阶段**：完整分销逻辑，使用虚拟金额验证流程
+
+#### 钱包管理
+| 功能 | 说明 |
+|------|------|
+| 钱包统计 | 总收入、可用余额 |
+| 账单记录 | 收入记录、提现记录 |
+| 钱包地址管理 | USTD钱包地址绑定 |
+| 提现 | USTD提现（支持TRC20） |
+
+**提现流程**：
+1. 用户发起提现申请
+2. 系统校验余额和地址
+3. 管理员后台审核
+4. 审核通过后执行打款
+5. 到账通知
+
+**Demo阶段**：完整提现流程UI和逻辑，后台审核页面，但不接入真实支付（审核通过仅更新状态）
+
+#### 关于平台
+- 平台协议（用户协议、隐私政策、免责声明）
+- 平台版本信息
+
+---
+
+## 四、用户等级体系
+
+### 等级设定
+
+| 等级 | 名称 | 经验值 | 权益 |
+|------|------|--------|------|
+| Lv1 | 新手 | 0 | 基础浏览、查看资讯 |
+| Lv2 | 球迷 | 100 | 发帖、评论、收藏 |
+| Lv3 | 达人 | 500 | 查看AI基础分析报告 |
+| Lv4 | 专家 | 2000 | 发布推荐方案、申请专家认证 |
+| Lv5 | 大师 | 5000 | 查看AI高级分析、历史数据导出 |
+
+### 经验值获取
+
+| 行为 | 经验值 | 每日上限 |
+|------|--------|----------|
+| 每日签到 | +5 | 1次 |
+| 发帖 | +10 | 5次 |
+| 评论 | +3 | 10次 |
+| 被点赞 | +2 | 无上限 |
+| 被跟单 | +5 | 无上限 |
+| 推荐命中 | +20 | 无上限 |
+| 邀请新用户 | +50 | 无上限 |
+
+---
+
+## 五、VIP订阅
+
+| VIP等级 | 价格 | 权益 |
+|---------|------|------|
+| 普通用户 | 免费 | 基础浏览、社区发帖 |
+| VIP月卡 | ¥28/月 | AI分析报告、跟单提醒、去广告 |
+| VIP季卡 | ¥68/季 | 月卡权益 + 专家方案优先查看 |
+| VIP年卡 | ¥198/年 | 季卡权益 + 专属客服 + 数据导出 |
+
+**Demo阶段**：VIP订阅页面和权限逻辑完整实现，可通过后台手动设置用户VIP状态
+
+---
+
+## 六、专家认证
+
+### 认证条件
+- 近30天发帖 ≥ 10篇
+- 推荐方案命中率 ≥ 60%
+- 信誉评分 ≥ 80分
+- 提交实名认证资料
+
+### 专家权益
+- 专属认证标识
+- 方案可设置收费查看
+- 参与分销分成
+- 优先展示在推荐流中
+
+### 认证流程
+1. 用户提交认证申请 + 实名资料
+2. 系统自动校验数据条件
+3. 管理员人工审核
+4. 审核通过/拒绝通知
+
+---
+
+## 七、Demo阶段数据采集方案
+
+### 7.1 爬取真实数据（定时任务）
+
+| 数据类型 | 数据源 | 爬取策略 |
+|----------|--------|----------|
+| 联赛/球队基础数据 | TheSportsDB(API) / 球探网 | 初始化爬取一次，定期更新 |
+| 赛程/比分 | 雷速体育 / 懒球帝公开页 | 每日定时爬取当日赛程 |
+| 赔率/盘口 | 球探网 / 雷速体育 | 赛前定时爬取赔率变化 |
+| 历史交锋 | TheSportsDB(API) / 球探网 | 查询时拉取并缓存 |
+| 球员/伤停 | 懒球帝 / 转会市场 | 每日定时爬取 |
+| 体育资讯 | 懒球帝 / 虎扑 / 腾讯体育 | 每日定时爬取最新资讯 |
+
+### 7.2 AI生成内容
+
+| 内容类型 | 生成方式 |
+|----------|----------|
+| 赛事分析文章 | DeepSeek基于爬取的真实赛事数据自动生成 |
+| 社区帖子 | AI基于真实赛事生成推荐方案/分析帖 |
+| 用户评论 | AI生成多样化的评论内容 |
+
+### 7.3 种子数据（脚本创建）
+
+| 数据类型 | 数量 | 说明 |
+|----------|------|------|
+| 种子用户 | 20个 | 含普通用户/VIP/专家，各种等级 |
+| 跟单方案 | 20个 | 基于真实赛事AI生成，含命中/未命中 |
+
+### 7.4 爬取架构设计
+
+```
+后端定时任务 → 爬虫服务(SportCrawlerService)
+                        ├── 联赛球队Crawler  → la_league / la_team
+                        ├── 赛事比分Crawler  → la_match / la_match_stats
+                        ├── 赔率盘口Crawler  → la_match_odds
+                        ├── 球员伤停Crawler  → la_player / la_player_injury
+                        ├── 资讯Crawler      → la_article
+                        └── 数据清洗器      → 统一格式入库
+```
+
+**架构优势**：爬虫服务和正式上线的第三方API服务共用同一套数据清洗和入库逻辑，切换时仅需替换数据源适配器。
+
+---
+
+## 八、正式上线待对接事项
+
+| # | 事项 | 说明 | 状态 |
+|---|------|------|------|
+| 1 | 赛事数据API | 纳米数据/雷速体育，替换爬虫数据源 | 上线前对接 |
+| 2 | DeepSeek API Key | 后台配置页面已就绪，录入Key即可 | 上线前配置 |
+| 3 | USTD提现链路 | TRC20，接入真实链上转账 | 上线前对接 |
+| 4 | 短信服务 | 后台已有短信配置，录入服务商Key | 上线前配置 |
+| 5 | 支付对接 | VIP订阅的真实支付渠道 | 上线前对接 |