产品概述
直播电商平台是一套前后端分离、按业务域模块化的直播电商产品：后端 Spring Boot 单体多模块（live/circle/mall/member/pay/system 各司其职，API 与实现分层），一套代码覆盖移动端（UniApp 3.0 + Vue3 + Pinia，App/小程序/H5 多端发行）、管理后台（Vben Admin 5.7 + Vue3 + Ant Design Vue，20+ 业务视图）与后端服务（Docker 部署）三端交付。九大功能模块共享同一套用户、订单与数据，直播、电商、会员、社区四条增长线机制级打通——观播能换积分、直播能归因订单、社区能挂商品。社区版 MIT 开源免费无数量限制，Pro 版叠加运营增值与企业级能力，同一套代码经 Maven Profile 切换构建。
核心功能详解
一、直播系统（yudao-module-live）
- 功能：直播间/场次全生命周期 CRUD、推流签名与 OBS 推流码生成、直播带货商品挂载与讲解状态机（标记「正在讲解」）、IM 群组/禁言/在线人数/系统消息群发、观看心跳换积分、推流与录制事件回调；Pro 增值：录播回放与点播治理、礼物打赏（金币联动）、观众列表与 6 种榜单、流失预警、画像每日聚合（04:00）、业务数据大屏、AI 剧本生成与内容审核
- 场景：商家日常带货开播、品牌发布会直播、MCN 多场次运营、直播内容回放二次分发
- 痛点解决：没有它，商家要分别采购云直播、IM 与直播业务系统，三者无联动——推流事件无人处理、互动无法管理、直播商品与商城订单两张皮；本产品三者合一，直播下单原生归因到场次与主播
- 技术亮点：腾讯云直播 + IM 配置化接入（LiveProperties/ImProperties）；云能力经 LiveProviderSPI/ImProviderSPI/VodProviderSPI 三大接口抽象，条件装配注入，多云扩展业务代码零改动；观看激励走心跳 → MQ → 幂等消费异步链路，不阻塞直播主链路；Pro 能力 @ConditionalOnClass 优雅降级
二、会员系统（yudao-module-member）
- 功能：手机注册与三方登录统一建号、等级 + 经验双轨、积分收支全留痕、签到阶梯奖励、标签与分组、点赞/关注/粉丝社交关系；Pro 增值：VIP 套餐 + 充值订单 + 交易流水、金币体系、发票管理、成长任务中心（签到/观播/分享/邀请/下单五类任务统一编排，reportProgress/claimReward/checkIn 三接口闭环）
- 场景：把直播流量与商城访客沉淀为可运营的会员资产；等级权益、积分任务、签到激励驱动留存与复购；VIP 充值与金币打赏虚拟资产经营
- 痛点解决：用户下完单就流失、不知道谁是高价值客户、促销只能全场打折；三轴联动（经验驱动等级、积分可消费可兑换）让商家对「谁」做精细化运营，观播时长自动兑换积分把「看直播」变成「攒资产」
- 技术亮点：积分/经验/等级变动全部经记录表留痕账实可查；socialLogin 统一建号多端账号不分裂；member-api 接口层隔离，Community 构建物理不含 Pro 代码；积分 MQ 幂等发放防重复
三、电商中台（yudao-module-mall）
- 功能：SPU/SKU 双层模型、品牌/类目/属性、评论含商家回复、收藏/浏览历史/会员限购；营销 8 玩法（秒杀/拼团/砍价/优惠券/满减/折扣/积分商城/三级分销含直播归因）；购物车下单、支付回调、快递发货、自提门店 + 核销、运费模板、售后退货退款全流程；页面 DIY 装修、Banner/文章、在线客服；经营统计五大维度离线跑批
- 场景：单店铺 B2C 商城完整经营：商品上架 → 营销造势 → 下单支付 → 发货自提 → 售后 → 复盘；连锁门店线上下单到店自提核销
- 痛点解决：商品/营销/订单/对账多系统切换、外挂营销插件超卖对不上账、直播订单无法归因；本产品四域一体，营销活动、订单、会员共享同一套数据
- 技术亮点：秒杀 Redis + Lua 原子预扣（SeckillStockRedisService）+ 参与资格前置校验，超卖率归零，峰值 5000 TPS（示例）；订单读写分离（Query/Update 职责分治），结算/支付回调/拼团回填/可购校验下单主链路事务化编排；拼团过期自动关团 Job；按域拆 product/promotion/trade/statistics + trade-api 跨模块接口层
四、圈子社区（yudao-module-circle，Pro 专属）
- 功能：圈子 CRUD 与成员关系、图文动态与时间序 Feed、评论与点赞/收藏/分享互动聚合、24h 半衰期指数衰减 + 互动五维加权（发布 10/评论 5/分享 4/收藏 3/点赞 2）热度算法、Redis ZSET 实时热度榜、每小时全量重算兼底
- 场景：在商城与直播之上构建兴趣社区（母婴/户外/数码），UGC 延长停留时长，社区种草反哺直播观看与商品转化
- 痛点解决：平台只有「货」没有「人」，买完即走；下播后流量无处安放；种草依赖外部平台流量外溢
- 技术亮点：circle/trends 双子模块 + 薄 API 松耦合；热度事件驱动实时更新 + 定时重算双保险，刷屏操纵防得住；ZSET 榜单查询 O(logN)，管理台与 App 双端消费
五、支付中心（yudao-module-pay）
- 功能：微信支付/支付宝统一收单、支付单统一创建与状态追踪、回调统一处理与订单状态联动、钱包余额支付与充值、退款与售后联动
- 场景：商城下单、VIP 充值、礼物打赏、分销提现等一切资金流转场景
- 痛点解决：各业务模块各自对接渠道、回调处理五花八门、对账靠人工、掉单重复发货风险；独立支付域让业务只面向「支付单」编程，渠道切换对业务透明
- 技术亮点：回调驱动订单状态机幂等推进（重复回调不重复处理），支付状态与业务状态事务化联动资金强一致，支持主动查单兼容
六、BI 看板 / CRM / IM 客服 / AI 矩阵（数据与智能层，Pro 为主）
- BI 数据看板：五大维度跑批沉淀日报（查询不压业务库）、企业级看板、异步导出任务、每日汇总聚合 Job、直播业务大屏分钟级聚合、统计模式 job/cdc 双模可切换为实时数仓演进预留接口
- CRM 精准营销：RFM 三维打分每日 03:00 跑批（Redis 分布式锁防重）、人群圈选、营销活动与旅程编排三件套，针对直播观众行为建模支持开播提醒与直播间召回
- IM 与智能客服：商城客服会话内置（社区版）；Pro 机器人 AOP 零侵入拦截 + 三层降级应答保证消息永不掉地，ImBotAiProvider 可对接任意大模型
- AI 能力矩阵：仅 Pro 构建档引入；直播剧本 Provider + 服务编排分层大模型可插拔；内容审核路由与违规记录联动留痕
模块联动机制（产品真正的护城河）
- 观播激励链路：观看心跳上报 → MQ 消息 → 幂等发放积分 + 任务进度同步，全程异步，断线重连不重复发放
- 秒杀推送直播间：运营创建秒杀活动 → 一键系统消息推送至直播间 IM 群组 → 观众端实时活动卡片直达下单
- 直播成交归因：订单创建即携带 liveId/主播上下文 → 成交、佣金、售后全链路追溯到场次与人 → 主播绩效按数据结算
- 社区热度链路：互动事件触发热度分实时重算 → Redis ZSET 榜单 → 每小时全量重算兼底，榜单永远反映真实热度
版本边界（Community vs Pro）
- 社区版完整保留三条闭环：单店铺电商闭环（商品/订单/支付/售后 + 全套营销玩法）、单商户直播闭环（推拉流/IM/带货/观看积分/营销推送）、基础会员体系（用户/等级/积分/签到/标签/分组）——永不收费，无用户数/商品数限制，MIT 许可可商用
- Pro 专属：圈子社区整域、录播回放、礼物打赏、观众分析、直播大屏、VIP/金币/发票/任务中心、BI 看板/导出/汇总、CRM、IM 机器人/AI 模块、多租户隔离、读写分离、链式哈希审计、SSO、License 校验
- 升级零迁移：同源同构，Maven Profile 切换构建 + 配置授权 Key 即可；Pro 试用到期自动降级社区版能力，历史数据完整保留
技术架构
- 总体架构：前后端分离的模块化单体（可按域拆分演进）——接入层（UniApp 多端 + Vben Admin）/ 业务层（live/mall/member/circle/pay + crm-pro/bi-pro/im-pro/ai）/ 框架层（yudao-framework starters：web/security/mybatis/redis/websocket/protection/job/mq/tenant…）/ 基础设施层（MySQL + Redis + 腾讯云直播/IM/点播 + MQ + Docker）
- 按域拆模块，边界即防火墙：每域拆 -api 接口层 + 基座实现 + Pro 增强三层，跨模块只依赖 API 层；ArchUnit CI 强制 Community 禁止 import *-pro 包
- SPI 抽象去云锁定：直播/IM/点播三大 Provider SPI，腾讯实现就位，新增厂商实现接口 + 条件装配即可
- Pro 即插即用优雅降级：@ConditionalOnClass/@Autowired(required=false) 注入，缺失自动回退社区版实现，无 fork 无双仓维护
- 高并发加固：秒杀 Lua 原子预扣、拼团关团 Job、积分 MQ 幂等、RFM 跑批分布式锁；限流/幂等/XSS/报文加密四件套内置
- 安全合规内建：统一错误码、敏感字段加密（EncryptTypeHandler）、Pro 链式哈希审计 + @Audited 声明式留痕、License JWT+RSA 启动校验
- 工程质量：OpenAPI → 前端 SDK 自动生成、13 个 Feature Flag 双层保护、社区版剥离脚本 + 残留扫描门禁、种子数据脱敏
部署与集成
- 最小三件套：应用 + MySQL + Redis，仓库内置 Docker Compose 编排一条命令拉起全栈；4 核 8G 单机可跑通全功能；直播流量由腾讯云 CDN 承担，业务压力集中于下单链路可水平扩容
- 移动端多端发行：UniApp 一套代码覆盖 App、微信小程序、H5，按业务域分包（pkg-live/pkg-mall/pkg-order/pkg-coupon/pkg-mine…）
- 管理后台：Vben Admin Web 应用浏览器即用，Feature Flag 路由守卫按版本/租户控制功能可见性
- SaaS 托管：官方云托管开通即用当天开播，按 GMV 弹性计费，SLA 99.9%（示例），官方统一滚动升级客户无感
- 私有化：数据 100% 自有环境，Pro Enterprise 源码交付 + 驻场实施 + LTS 18 个月安全维护；灰度迁移可分阶段（并行运行 → 批量导入 → 切流 → 旧系统归档）
- 可观测：Prometheus 指标端点默认开启，SLF4J + Logback 统一日志，SkyWalking 探针接入位预留
目标客户与应用场景
- 中小商家/单店店主（社区版）：低成本上线直播带货商城——主播开播挂载商品 → 秒杀推送直播间群组 → 观众下单自动归因 → 数据完整自有不抽佣
- 品牌方/零售企业（Pro Business）：大促前 CRM 圈选高价值人群定向发券 → 直播秒杀拼团联动 → 观播积分与任务中心沉淀会员 → BI 日报输出 GMV/转化漏斗复盘
- MCN/直播机构（Pro Business）：多直播间批量管理 → 榜单识别核心粉丝 → 流失预警召回 → 画像聚合指导选品 → 礼物打赏变现 → 回放二次分发 → 佣金按归因结算
- 连锁零售/本地生活（Pro Business）：总部统一商品与运费模板 → 门店自提扫码核销 → 多店铺中台按店铺隔离数据与权限 → 分销发展周边客群
- 内容型平台/社群运营（Pro）：兴趣圈子沉淀 UGC → 热度算法让优质内容浮出 → 种草引导直播与商城成交 → 会员积分反哺，留存与转化双轮驱动
- 技术团队/软件服务商（社区版起步）：MIT 源码全量开放按域二开，OpenAPI 自动生成前端 SDK 降低集成成本，客户规模化后平滑升级 Pro 授权