haha/sbnews

Fork 0

Files

T

hajimi 2b2e3197be no message

2026-07-31 16:13:31 +08:00

24 KiB

Raw Permalink Blame History

Sport-Era 体育咨询AI平台 - 实现流程文档

版本：v1.1（Demo版）日期：2026-03-14 技术栈：ThinkPHP 8 + Vue 3 + UniApp + DeepSeek AI

一、技术架构总览

┌─────────────────────────────────────────────────┐
│                    客户端                         │
│  ┌──────┐  ┌──────┐  ┌──────┐  ┌──────┐        │
│  │ iOS  │  │Android│  │ 鸿蒙 │  │  H5  │        │
│  └──┬───┘  └──┬───┘  └──┬───┘  └──┬───┘        │
│     └─────────┴─────────┴─────────┘              │
│                UniApp (Vue 3)                     │
├─────────────────────────────────────────────────┤
│              管理后台: Vue 3 + Element Plus       │
├─────────────────────────────────────────────────┤
│              API层: ThinkPHP 8                    │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐        │
│  │ adminapi │ │   api    │ │ AI Service│        │
│  └──────────┘ └──────────┘ └─────┬────┘        │
├──────────────────────────────────┼──────────────┤
│              数据层               │              │
│  ┌──────┐  ┌──────┐  ┌──────┐  │              │
│  │MySQL │  │Redis │  │ 队列  │  │              │
│  └──────┘  └──────┘  └──────┘  │              │
├────────────────────────────────┼──────────────┤
│            外部服务              │              │
│  ┌──────────┐  ┌──────────┐   │              │
│  │体育数据API│  │DeepSeek AI│◄──┘              │
│  └──────────┘  └──────────┘                    │
└─────────────────────────────────────────────────┘

二、开发阶段规划

阶段一：基础架构（预计 2-3 周）

1.1 数据库建表 + 爬虫服务

创建所有业务表（约40张新表）
执行SQL迁移脚本
验证表结构和关联关系
开发爬虫服务(SportCrawlerService)，爬取网络真实数据填充数据库
爬虫服务与正式上线API服务共用数据清洗/入库逻辑，切换时仅替换数据源适配器

1.2 用户体系扩展

后端（server/app/）

app/common/model/user/
├── UserProfile.php          # 用户扩展资料模型
├── UserLevel.php            # 用户等级模型
├── UserVip.php              # VIP订阅模型
├── UserExpert.php           # 专家认证模型
└── UserCredit.php           # 信誉评分模型

app/api/controller/user/
├── UserProfileController.php
├── UserLevelController.php
└── UserVipController.php

app/api/logic/user/
├── UserProfileLogic.php
├── UserLevelLogic.php
└── UserVipLogic.php

前端（uniapp/src/）

pages/user/
├── profile/index.vue        # 个人资料页
├── level/index.vue          # 等级详情页
└── vip/index.vue            # VIP订阅页

开发顺序：

创建用户扩展表 → Model → Logic → Controller → API路由
前端个人资料页面
等级经验值计算逻辑
VIP订阅流程

1.3 头条资讯模块

后端开发

app/api/controller/article/
├── ArticleController.php     # 复用已有，扩展AI分析接口
└── ArticleCateController.php # 复用已有

app/api/logic/article/
└── ArticleAiLogic.php        # 新增 - AI导读分析逻辑

app/common/model/article/
└── ArticleAiAnalysis.php     # 新增 - AI分析结果模型

app/adminapi/controller/article/
└── ArticleController.php     # 复用已有 - 后台资讯管理

前端开发

uniapp/src/pages/
├── news/
│   ├── index.vue             # 资讯列表
│   ├── detail.vue            # 资讯详情
│   └── components/
│       ├── NewsCard.vue      # 资讯卡片组件
│       └── AiAnalysis.vue    # AI导读分析组件

开发顺序：

扩展资讯分类（体育相关分类）
资讯列表/详情前端页面
AI导读分析接口（阶段三实现AI逻辑，此处先预留接口）

1.4 赛事基础模块

后端开发

app/common/model/sport/
├── SportType.php             # 运动类型
├── League.php                # 联赛
├── Team.php                  # 球队
├── Match.php                 # 赛事
├── MatchOdds.php             # 赔率
├── MatchStats.php            # 赛事统计
├── MatchHistory.php          # 历史交锋
├── Player.php                # 球员
└── PlayerInjury.php          # 伤停

app/api/controller/sport/
├── MatchController.php       # 赛事接口
├── LeagueController.php      # 联赛接口
└── TeamController.php        # 球队接口

app/api/logic/sport/
├── MatchLogic.php
├── LeagueLogic.php
└── TeamLogic.php

app/common/service/sport/
├── SportDataService.php      # 数据源统一接口（爬虫/API切换）
├── SportCrawlerService.php   # 爬虫服务（Demo阶段主要数据源）
└── DataCleanerService.php    # 数据清洗器（爬虫/API共用）

前端开发

uniapp/src/pages/
├── match/
│   ├── index.vue             # 赛事列表（按日期）
│   ├── detail.vue            # 赛事详情
│   └── components/
│       ├── MatchCard.vue     # 赛事卡片
│       ├── OddsPanel.vue     # 赔率面板
│       ├── ScoreBoard.vue    # 比分板
│       └── HistoryTable.vue  # 历史交锋表
├── league/
│   ├── index.vue             # 联赛列表
│   └── detail.vue            # 联赛详情（排名/赛程）

开发顺序：

运动类型/联赛/球队基础数据表和模型
赛事CRUD接口
爬虫服务开发（SportCrawlerService）爬取网络真实赛事数据
数据清洗器（DataCleanerService）统一入库格式
前端赛事列表/详情页面
赔率/盘口展示
SportDataService 统一接口（正式上线时切换数据源适配器）

阶段二：社区与互动（预计 2-3 周）

2.1 社区发帖系统

后端开发

app/common/model/community/
├── CommunityPost.php         # 帖子
├── CommunityPostImage.php    # 帖子图片
├── CommunityComment.php      # 评论
├── CommunityLike.php         # 点赞
├── CommunityTag.php          # 标签
├── CommunityPostTag.php      # 帖子标签关联
└── CommunityFollow.php       # 关注

app/api/controller/community/
├── PostController.php        # 帖子接口
├── CommentController.php     # 评论接口
├── FollowController.php      # 关注接口
└── TagController.php         # 标签接口

app/api/logic/community/
├── PostLogic.php
├── CommentLogic.php
└── FollowLogic.php

前端开发

uniapp/src/pages/
├── community/
│   ├── index.vue             # 社区首页（帖子列表）
│   ├── post_detail.vue       # 帖子详情
│   ├── publish.vue           # 发帖页面
│   └── components/
│       ├── PostCard.vue      # 帖子卡片
│       ├── CommentList.vue   # 评论列表
│       ├── ImageUpload.vue   # 图片上传
│       └── TagSelector.vue   # 标签选择器

开发顺序：

帖子CRUD → 评论 → 点赞 → 标签
关注系统
图片上传（战绩截图）
推荐方案发布（关联赛事）

2.2 跟单系统

后端开发

app/common/model/tipster/
├── TipsterPlan.php           # 推荐方案
├── TipsterFollow.php         # 跟单记录
├── TipsterStats.php          # 推手统计
└── TipsterProfitLog.php      # 盈亏日志

app/api/controller/tipster/
├── PlanController.php        # 方案接口
├── FollowController.php      # 跟单接口
└── StatsController.php       # 统计接口

app/api/logic/tipster/
├── PlanLogic.php
├── FollowLogic.php
└── StatsLogic.php

前端开发

uniapp/src/pages/
├── tipster/
│   ├── index.vue             # 推手列表/排行榜
│   ├── detail.vue            # 推手详情（历史方案/盈亏曲线）
│   ├── plan_detail.vue       # 方案详情
│   └── components/
│       ├── TipsterCard.vue   # 推手卡片
│       ├── PlanCard.vue      # 方案卡片
│       ├── ProfitChart.vue   # 盈亏曲线图
│       └── FollowButton.vue  # 跟单按钮

开发顺序：

推荐方案发布/展示
跟单功能
盈利统计和排行榜
盈亏曲线图表

2.3 专家认证

后端：UserExpert 模型 + 认证申请/审核接口 管理后台：认证审核页面 开发顺序：认证申请接口 → 后台审核页面 → 前端申请页面

阶段三：AI智能模块（预计 3-4 周）

3.1 AI基础服务层

后端开发

app/common/service/ai/
├── AiService.php             # AI服务基类
├── DeepSeekClient.php        # DeepSeek API客户端
├── AiCacheService.php        # AI结果缓存服务
└── AiQueueService.php        # AI异步队列服务

app/common/enum/
└── AiEnum.php                # AI相关枚举（分析类型/状态等）

config/
└── ai.php                    # AI配置文件（从 la_ai_config 表读取，后台可配置）

核心类设计：

// DeepSeekClient.php - 核心调用类
class DeepSeekClient
{
    private string $apiKey;       // 从 la_ai_config 表读取，后台可配置
    private string $baseUrl;      // 从 la_ai_config 表读取
    private string $model;        // deepseek-chat / deepseek-reasoner，后台可切换

    public function chat(string $systemPrompt, string $userMessage): array
    public function chatStream(string $systemPrompt, string $userMessage): Generator
}

// AiService.php - 业务封装
class AiService
{
    public static function analyzeArticle(int $articleId): array    // 资讯AI分析
    public static function predictMatch(int $matchId): array        // 赛事预测
    public static function analyzeCredibility(int $userId): array   // 可信度分析
    public static function analyzeLottery(array $params): array     // 彩票概率分析
}

3.2 AI资讯阅读助手

Prompt设计：

系统角色：你是一位专业的体育资讯分析师。

任务：对以下体育资讯文章进行深度分析，输出JSON格式结果：
{
    "summary": "3-5句话的摘要",
    "key_points": ["重点1", "重点2", ...],
    "risk_warnings": ["风险提示1", ...],
    "opposite_views": ["反向观点1", ...],
    "sentiment": {
        "label": "positive/neutral/negative",
        "confidence": 0.85
    }
}

开发顺序：

DeepSeekClient 封装（从 la_ai_config 读取配置）
后台AI配置页面（API Key / 模型选择 / 参数调整 / 调用限制）
资讯分析Prompt设计和调试
结果缓存策略
前端AI分析展示组件
后台AI调用日志查看页面

3.3 社区可信度分析模型

数据采集：

用户ID →
├── 历史推荐方案列表 → 命中率计算
├── 盈亏记录 → 波动率计算
├── 发帖时间序列 → 稳定性计算
├── 帖子编辑记录 → 事后编辑检测
└── 赛果对比 → 偏离程度计算

Prompt设计：

系统角色：你是体育社区内容审核AI。

输入数据：用户历史数据摘要（JSON格式）
任务：评估该用户的可信度，输出JSON：
{
    "credibility_score": 75,
    "risk_level": "medium",
    "is_suspicious": false,
    "analysis": "分析说明",
    "dimension_scores": {
        "hit_rate": 80,
        "volatility": 70,
        "stability": 85,
        "rationality": 65,
        "edit_integrity": 90,
        "deviation": 70
    }
}

定时任务：每日凌晨3点执行批量分析 开发顺序：

数据采集逻辑
Prompt设计和调优
定时任务配置
前端可信度标识展示

3.4 赛事预测模型

数据输入组装：

// 组装赛事分析数据
$matchData = [
    'home_team' => [...],      // 主队近期数据
    'away_team' => [...],      // 客队近期数据
    'head_to_head' => [...],   // 历史交锋
    'odds' => [...],           // 当前赔率
    'injuries' => [...],       // 伤停信息
    'xg_data' => [...],        // xG数据
];

开发顺序：

赛事数据组装逻辑
预测Prompt设计
预测结果存储和展示
前端预测报告页面

3.5 彩票概率模型

实现方式：统计算法为主 + DeepSeek辅助分析

历史开奖数据 →
├── PHP统计计算（频率/遗漏值/冷热号）
├── DeepSeek分析趋势和异常模式
└── 蒙特卡洛模拟生成推荐组合

3.6 个性化推荐流

推荐因子：

用户浏览历史（赛事/资讯偏好）
关注的推手和球队
AI分析结果质量评分
时效性（优先最新内容）

阶段四：变现与运营（预计 2-3 周）

4.1 钱包管理

后端开发

app/common/model/wallet/
├── Wallet.php                # 钱包
├── WalletLog.php             # 钱包流水
├── WalletWithdraw.php        # 提现记录
└── WalletAddress.php         # 钱包地址

app/api/controller/wallet/
├── WalletController.php      # 钱包接口
└── WithdrawController.php    # 提现接口

app/api/logic/wallet/
├── WalletLogic.php
└── WithdrawLogic.php

app/adminapi/controller/wallet/
└── WithdrawController.php    # 后台提现审核

前端开发

uniapp/src/pages/
├── wallet/
│   ├── index.vue             # 钱包首页
│   ├── bill.vue              # 账单记录
│   ├── withdraw.vue          # 提现页面
│   └── address.vue           # 地址管理

开发顺序：

钱包余额管理
流水记录
提现申请和审核流程
USTD地址管理

4.2 分销管理

后端开发

app/common/model/distribution/
├── DistributionConfig.php    # 分销配置
├── DistributionInvite.php    # 邀请记录
├── DistributionTeam.php      # 团队关系
└── DistributionSettlement.php # 结算记录

app/api/controller/distribution/
├── InviteController.php      # 邀请接口
├── TeamController.php        # 团队接口
└── SettlementController.php  # 结算接口

app/api/logic/distribution/
├── InviteLogic.php           # 邀请码生成/绑定逻辑
├── TeamLogic.php             # 团队树形结构逻辑
└── SettlementLogic.php       # 佣金计算/结算逻辑

前端开发

uniapp/src/pages/
├── distribution/
│   ├── index.vue             # 分销中心
│   ├── invite.vue            # 邀请页面（含二维码）
│   ├── team.vue              # 团队列表
│   └── settlement.vue        # 结算报表

开发顺序：

邀请码/链接生成
注册绑定上级关系
团队树形管理
佣金计算逻辑
月度自动结算定时任务

4.3 平台首页聚合

开发顺序：

今日赛事聚合接口
热门推荐接口
盈利排行榜接口
AI精选分析展示
首页UI整合

三、后台管理扩展

需要新增的管理后台页面

admin/src/views/
├── sport/                    # 赛事管理
│   ├── type/index.vue        # 运动类型管理
│   ├── league/index.vue      # 联赛管理
│   ├── team/index.vue        # 球队管理
│   ├── match/index.vue       # 赛事管理
│   └── data_sync.vue         # 数据同步管理
├── community/                # 社区管理
│   ├── post/index.vue        # 帖子管理（审核/删除）
│   ├── comment/index.vue     # 评论管理
│   ├── tag/index.vue         # 标签管理
│   └── report.vue            # 举报处理
├── tipster/                  # 跟单管理
│   ├── plan/index.vue        # 方案管理
│   ├── expert/index.vue      # 专家认证审核
│   └── ranking.vue           # 排行榜管理
├── ai/                       # AI管理
│   ├── config.vue            # AI配置（API Key/参数）
│   ├── analysis_log.vue      # 分析日志
│   └── model_config.vue      # 模型参数配置
├── wallet/                   # 钱包管理
│   ├── withdraw/index.vue    # 提现审核
│   └── log.vue               # 流水查看
├── distribution/             # 分销管理
│   ├── config.vue            # 分销配置
│   ├── team.vue              # 团队查看
│   └── settlement.vue        # 结算管理
└── user_ext/                 # 用户扩展管理
    ├── level_config.vue      # 等级配置
    ├── vip_config.vue        # VIP配置
    └── credit.vue            # 信誉评分查看

四、API路由规划

前台API（app/api）

// 赛事模块
Route::group('sport', function () {
    Route::get('match/list', 'sport.Match/list');
    Route::get('match/detail', 'sport.Match/detail');
    Route::get('match/odds', 'sport.Match/odds');
    Route::get('match/history', 'sport.Match/history');
    Route::get('league/list', 'sport.League/list');
    Route::get('team/detail', 'sport.Team/detail');
});

// 社区模块
Route::group('community', function () {
    Route::get('post/list', 'community.Post/list');
    Route::get('post/detail', 'community.Post/detail');
    Route::post('post/publish', 'community.Post/publish');
    Route::post('post/like', 'community.Post/like');
    Route::post('comment/add', 'community.Comment/add');
    Route::post('follow/toggle', 'community.Follow/toggle');
});

// 跟单模块
Route::group('tipster', function () {
    Route::get('plan/list', 'tipster.Plan/list');
    Route::get('plan/detail', 'tipster.Plan/detail');
    Route::post('plan/publish', 'tipster.Plan/publish');
    Route::post('plan/follow', 'tipster.Follow/follow');
    Route::get('stats/ranking', 'tipster.Stats/ranking');
});

// AI模块
Route::group('ai', function () {
    Route::get('article/analysis', 'ai.Article/analysis');
    Route::get('match/prediction', 'ai.Match/prediction');
    Route::get('user/credibility', 'ai.User/credibility');
    Route::get('lottery/analysis', 'ai.Lottery/analysis');
});

// 钱包模块
Route::group('wallet', function () {
    Route::get('info', 'wallet.Wallet/info');
    Route::get('log/list', 'wallet.Wallet/logList');
    Route::post('withdraw/apply', 'wallet.Withdraw/apply');
    Route::get('withdraw/list', 'wallet.Withdraw/list');
    Route::post('address/save', 'wallet.Wallet/saveAddress');
});

// 分销模块
Route::group('distribution', function () {
    Route::get('invite/code', 'distribution.Invite/code');
    Route::get('invite/list', 'distribution.Invite/list');
    Route::get('team/list', 'distribution.Team/list');
    Route::get('settlement/list', 'distribution.Settlement/list');
});

五、定时任务清单

任务	Cron表达式	Demo阶段	说明
赛事数据爬取	/30 * * *	✅ 爬虫服务	每30分钟爬取赛事数据（Demo用爬虫，正式用API）
赔率数据爬取	0 /2 * *	✅ 爬虫服务	每2小时爬取赔率变化
赛果更新	0 /1 * *	✅ 爬虫服务	每小时检查并更新赛果
资讯爬取	0 /4 * *	✅ 爬虫服务	每4小时爬取最新体育资讯
推荐方案结算	0 /1 * *	✅ 需要	每小时结算已结束赛事的方案
AI可信度计算	0 3 * * *	✅ 需要	每日凌晨3点批量计算信誉评分
用户等级计算	0 4 * * *	✅ 需要	每日凌晨4点更新用户等级
分销佣金结算	0 2 1 * *	✅ 需要	每月1日凌晨2点结算上月佣金
AI分析报告生成	0 8 * * *	✅ 需要	每日早8点生成当日赛事AI分析
盈利排行榜更新	0 /2 * *	✅ 需要	每2小时更新盈利排行

六、第三方服务集成

服务	用途	Demo阶段	正式上线
DeepSeek API	AI分析核心	✅ 真实接入（Key后台配置）	同左
体育数据API	赛事/赔率/比分	✅ 爬虫爬取真实数据	切换为付费API
短信服务	注册/登录验证码	✅ 通用验证码0000	接入短信服务商
文件存储	图片/截图上传	✅ likeadmin已集成	同左(OSS)
微信SDK	小程序/公众号登录	✅ likeadmin已集成	同左
支付服务	VIP订阅/方案购买	❌ 后台手动设置	接入支付渠道
USTD提现	钱包提现	❌ 仅状态更新	接入链上转账

七、部署与同步流程

开发流程

本地开发(IDE) → Git Push(Gitee) → 服务器 Git Pull → 生效

Git 部署（主要方式）

远程仓库：https://gitee.com/phperbylyh/sport-era-service.git
分支：develop
服务器更新命令（宝塔定时任务）：

cd /www/wwwroot/sportera.gs-z.cn && chattr -i public/.user.ini 2>/dev/null && git -c safe.directory=/www/wwwroot/sportera.gs-z.cn fetch --all && echo "----- 更新内容 -----" && git -c safe.directory=/www/wwwroot/sportera.gs-z.cn log HEAD..origin/develop --oneline 2>&1 && echo "----- 变更文件 -----" && git -c safe.directory=/www/wwwroot/sportera.gs-z.cn diff --stat HEAD origin/develop 2>&1 && git -c safe.directory=/www/wwwroot/sportera.gs-z.cn reset --hard origin/develop 2>&1 && chattr +i public/.user.ini 2>/dev/null && echo "===== 部署完成: $(date) ====="

SFTP 配置（辅助方式）

配置文件：.winsurf/sftp.json
自动上传：保存即同步
忽略文件：.git, .env, runtime, vendor

前端构建部署

# Admin后台
cd admin && npm run build    # 输出到 server/public/admin/

# UniApp H5
cd uniapp && npm run build:h5  # 输出到 server/public/mobile/

# UniApp App
cd uniapp && npm run build:app  # 生成原生App包

八、里程碑节点

里程碑	阶段	预计完成	交付物
M1	基础架构	第3周	数据库+爬虫服务+用户体系+资讯+赛事基础数据
M2	社区上线	第6周	社区发帖+跟单+专家认证
M3	AI上线	第10周	AI分析全功能+后台AI配置管理
M4	商业闭环	第13周	钱包+分销+VIP+首页聚合
Demo交付	全部	第13周	完整功能Demo + 虚拟数据
M5	正式上线	第15周	接入真实数据API+支付+USTD
M6	优化迭代	持续	性能优化+数据积累+模型调优

24 KiB Raw Permalink Blame History Unescape Escape

Sport-Era 体育咨询AI平台 - 实现流程文档

一、技术架构总览

二、开发阶段规划

阶段一：基础架构（预计 2-3 周）

1.1 数据库建表 + 爬虫服务

1.2 用户体系扩展

1.3 头条资讯模块

1.4 赛事基础模块

阶段二：社区与互动（预计 2-3 周）

2.1 社区发帖系统

2.2 跟单系统

2.3 专家认证

阶段三：AI智能模块（预计 3-4 周）

3.1 AI基础服务层

3.2 AI资讯阅读助手

3.3 社区可信度分析模型

3.4 赛事预测模型

3.5 彩票概率模型

3.6 个性化推荐流

阶段四：变现与运营（预计 2-3 周）

4.1 钱包管理

4.2 分销管理

4.3 平台首页聚合

三、后台管理扩展

需要新增的管理后台页面

四、API路由规划

前台API（app/api）

五、定时任务清单

六、第三方服务集成

七、部署与同步流程

开发流程

Git 部署（主要方式）

SFTP 配置（辅助方式）

前端构建部署

八、里程碑节点

24 KiB

Raw Permalink Blame History