SmartLive 视觉导览
这份文档聚焦“项目全景与关键链路怎么串起来”。它承接 网站首页 的核心入口，帮助第一次看到 SmartLive 的人，在几分钟内看清项目全景、核心页面和关键链路。
第一次建议先看： 项目全景 -> 用户进入、发现与找店 -> 决策、交易与增长
- 网站首页只保留精选入口，这页继续承接“全景 + 页面 + 链路”的完整视觉走查。
- 这页偏“系统与链路视角”，适合先建立整体认知；如果想逐页细看产品页面，可以跳去 页面导览。
- 如果你想看得更快：用户端建议从
3 -> 6顺读，商家端建议从7.1 -> 7.6顺读，后台治理建议从8.1 -> 8.5顺读，链路图建议从9.1 -> 9.12选读。
视觉总览数据
按目标看图：
2. 项目全景
- 用户端 App、商家端 Web、平台管理端 Web 通过网关统一进入微服务体系。
- 中间层覆盖用户、店铺、商品、订单、互动、AI、IM、审核、积分、钱包等业务域。
- 基础设施层包含 Redis、RabbitMQ、Elasticsearch、Milvus、MinIO、XXL-JOB 等中间件。
3. 用户进入、发现与找店
3.1 登录入口
统一登录入口，负责建立移动端用户身份。
3.2 首页入口
首页承接分类、优惠专区、秒杀和后续榜单跳转。
3.3 热门内容流
热门页集中展示内容流与分区切换。
3.4 本地必吃榜（店铺热榜）
独立店铺热榜页展示本地必吃商户。
3.5 抢手好券榜
独立好券热榜页展示热门优惠商品。
3.6 抢手团购榜
独立团购热榜页展示热门团购套餐与排行。
3.7 搜索结果
搜索结果承接全文检索、热词和排序策略。
3.8 搜索与地图
地图模式把关键词搜索延伸到附近找店和位置分布。
4. 决策、交易与增长
这一组按真实用户决策链路展示：先看活动入口，再进入店铺与商品决策，随后承接订单、支付与资产增长。
4.1 秒杀专区
秒杀专区对应 Redis Lua 和 MQ 异步削峰链路。
4.2 优惠专区
优惠专区承接折扣商品、团购券和活动聚合入口。
4.3 店铺详情
店铺详情承接介绍、商品、评价和互动信息。
4.4 商品详情
商品详情承接下单、收藏和评价入口。
4.5 订单中心
订单中心展示待支付、进行中和已完成订单。
4.6 订单待支付
待支付订单详情承接立即支付、取消订单和剩余支付时限展示。
4.7 钱包中心
钱包中心承接余额、支付记录和资产入口。
4.8 积分中心
积分中心承接签到、抽奖和成长体系。
4.9 签到抽奖
连续签到与抽奖是增长玩法入口。
5. 内容创作、社交关系、用户偏好与消息
这一组按“创作发布 -> 内容互动 -> 关系沉淀 -> 消息触达”的顺序组织，不再只是把社交页面平铺摆放。
5.1 发布与编辑
| 发布页 | 编辑页 |
|---|---|
 |  |
| 新内容创建入口 | 已有笔记编辑与改稿 |
发布与编辑页共同承接图文创作、改稿和草稿管理。
5.2 我的发布与草稿箱
| 我的发布 | 草稿箱 |
|---|---|
 |  |
| 个人主页查看已发布内容 | 草稿内容继续编辑与发布 |
已发布内容和草稿箱共同构成创作后的内容管理入口。
5.3 评价互动
| 评价列表页 | 评价发布页 | 评价修改页 |
|---|---|---|
 |  |  |
| 商品页内查看网友评价 | 评分、文案、媒体上传与 AI 辅助生成 | 已发布评价再次编辑 |
| 评价详情页 | 评论区 | 我的评价页 |
|---|---|---|
 |  |  |
| 单条评价详情与评论承接 | 评论与评价承接互动计数 | 评价状态筛选 |
| 待评价页 | 评价草稿页 |
|---|---|
 |  |
| 履约后去评价 | 待发布评价继续编辑 |
评价相关页面已经收拢为完整的评价链路分组。
5.4 动态流
动态流展示关注内容与推荐内容混合分发。
5.5 我的关注
独立关注页按用户、店铺、商品三类关系组织关注资产。
5.6 我的收藏
独立收藏页承接店铺、笔记和商品三类收藏资产。
5.7 用户偏好搜索与添加朋友
| 用户搜索 | 添加朋友页 |
|---|---|
 |  |
| 检索用户关注 / 收藏 / 点赞过的博客、店铺与商品 | 个人中心点击“添加朋友”后的加好友入口 |
用户偏好搜索与添加朋友分别承接“兴趣检索”和“建立关系”两类入口。
5.8 粉丝明细页
粉丝明细页承接个人主页下钻后的社交关系查看。
5.9 会话列表
会话列表承接私聊入口与未读状态。
5.10 系统通知
审核结果和系统提醒会通过站内通知下发。
5.11 IM 私聊
私聊详情展示实时聊天与消息流转。
6. AI 与个人资产
6.1 AI 助手浮层
点击小精灵后会先进入 AI 助手浮层，承接快捷问题和历史能力入口。
6.2 AI 快捷提问页
快捷提问页展示建议问题、搜索引导和继续对话入口。
6.3 AI 店铺推荐卡片
店铺推荐结果会以卡片方式返回附近店铺与经营信息。
6.4 AI 商品推荐卡片
商品推荐结果会把团购券和套餐直接卡片化返回，支持继续追问和转下单。
6.5 AI 下单结果与订单卡片
下单结果会直接展示订单号、状态反馈和订单详情跳转入口。
6.6 AI 会话列表
会话列表承接历史会话、新建对话和上下文恢复。
6.7 AI 博客生成
AIGC 可直接生成探店文案草稿，并回填到发布页继续编辑。
6.8 AI 评价生成
AIGC 可根据评分和消费体验生成评价草稿，减少手动输入成本。
6.9 个人中心
个人中心聚合资料、内容和资产入口。
6.10 设置密码页
首次设置密码页用于补齐密码登录能力。
6.11 修改密码页
修改密码页承接旧密码校验和账号安全修改。
7. 商家端 Web 页面走查
这一组按“登录进入 -> 看总览 -> 建店与上架 -> 履约处理 -> AI 辅助经营”的顺序组织，更贴近商家真实操作流。
7.1 登录入口
商家端先从统一后台登录页进入，再进入自有经营工作台。
7.2 经营总览
经营总览负责承接店铺、订单、代金券、用户和评价的总体数据看板。
7.3 店铺建档与经营维护
| 店铺列表页 | 新增店铺页 | 编辑店铺页 | 店铺详情页 |
|---|---|---|---|
 |  |  |  |
| 店铺列表与状态管理 | 创建店铺、基础信息与地图定位 | 维护店铺资料、图片与定位 | 查看审核状态、经营信息与相册 |
7.4 商品配置与营销管理
| 商品列表页 | 新建商品页 | 编辑商品页 | 商品详情页 |
|---|---|---|---|
 |  |  |  |
| 商品列表、上下架与活动筛选 | 配置价格、活动类型与使用规则 | 调整库存、有效期与营销字段 | 查看售价、库存与时间设置 |
7.5 订单履约与核销处理
| 订单管理 | 订单详情页 |
|---|---|
 |  |
| 订单状态筛选、核销流转与售后入口 | 订单进度、支付信息、商品信息与用户信息查看 |
7.6 AI 经营建议与商家助手
AI 商家助手先承接统一会话入口，再按评价回复、经营分析、营销文案和经营改进四类能力继续下钻。
| 评价回复页 | 经营状况分析页 | 商品营销文案页 | 经营改进建议页 |
|---|---|---|---|
 |  |  |  |
| AI 辅助生成评价回复建议 | 汇总订单、评分和差评关键词做阶段分析 | 生成商品推广文案与营销表达 | 输出经营改进方向与执行建议 |
8. 平台管理端 Web 页面走查
这一组按“审核受理 -> 内容治理 -> 用户运营 -> 权限审计 -> 调度运维”的顺序组织，更接近平台管理端的后台职责分工。
8.1 审核受理与处理流
| 审核中心 | 审核详情页 |
|---|---|
 |  |
| 待审内容汇总、状态筛选与进入审核动作 | 单条审核内容、附件、关联目标与通过 / 驳回动作 |
8.2 内容发布与治理
| 博客管理列表 | 博客详情页 | 评价管理列表 | 评价详情页 |
|---|---|---|---|
 |  |  |  |
| 博客内容治理与状态筛选 | 单篇博客详情、内容与状态查看 | 评价治理、筛选与批量处理 | 单条评价详情、评分维度与附件查看 |
| 评论管理列表 | 评论详情页 |
|---|---|
 |  |
| 评论清理、来源筛选与状态治理 | 单条评论内容、来源内容与审核状态查看 |
8.3 业务用户与积分运营
| 业务用户 | 业务用户详情页 | 抽奖配置 | 积分记录 |
|---|---|---|---|
 |  |  |  |
| 业务用户列表与平台查看入口 | 用户资料、头像与基础信息查看 | 奖品配置、概率与上下架管理 | 积分变动流水与业务类型审计 |
8.4 系统权限与运行审计
| 用户管理 | 角色管理 | 菜单权限 |
|---|---|---|
 |  |  |
| 系统账号与权限管理 | 角色与权限字符维护 | 菜单树与按钮权限配置 |
| 参数设置 | 在线监控 | 登录日志 | 操作日志 |
|---|---|---|---|
 |  |  |  |
| 系统参数与开关配置 | 在线用户与强退 | 登录审计与状态追踪 | 后台操作留痕与行为审计 |
8.5 调度后台与执行器运维
| 调度总览 | 任务管理 | 执行器管理 |
|---|---|---|
 |  |  |
| 任务、执行器与运行状态总览 | 按执行器查看 JobHandler、CRON 和状态 | 执行器配置与在线节点查看 |
| 店铺模块执行器 | 商品模块执行器 | 订单模块执行器 | 互动模块执行器 |
|---|---|---|---|
 |  |  |  |
| 店铺域执行器承接上架、审核与同步类任务 | 商品域执行器承接预热、库存与数据同步任务 | 订单域执行器承接到期、提醒与退款兜底任务 | 互动域执行器承接热榜重建、互动同步与广播任务 |
9. 核心链路图集
这里直接展示主链路预览图，详细实现继续保留 详细版 SVG 入口。
9.1 交易与履约
| 链路 | 重点看什么 | 展示图 | 详细版入口 |
|---|---|---|---|
| 秒杀抢购全链路 | Redis Lua 防超卖、RabbitMQ 异步落单、延迟队列兜底 |  | 查看详细 SVG |
| 普通下单：订单创建与状态流转 | 下单创建、异步落单、支付生效后的状态流转 |  | 查看详细 SVG |
| 统一支付：支付受理、回调与账务分发 | 支付受理、回调分发、PaymentRecord 与充值入账 / 订单记账 |  | 查看详细 SVG |
| 订单超时取消与库存回滚 | 下单后发送延迟消息、超时未支付自动取消、库存与资格回滚 |  | 查看详细 SVG |
| 主动取消 / 退款与钱包补偿 | 用户主动取消或退款后的库存回滚、退款 MQ 与钱包流水 |  | 查看详细 SVG |
| 订单核销、店铺销量与积分奖励 | verifyShopId 校验、核销后销量增长、消费积分异步发放 |  | 查看详细 SVG |
9.2 积分与用户激励
| 链路 | 重点看什么 | 展示图 | 详细版入口 |
|---|---|---|---|
| 每日签到积分 | 签到、积分发放、幂等与奖励计算 |  | 查看详细 SVG |
| 积分抽奖 | 扣减积分、抽奖结果、奖品发放 |  | 查看详细 SVG |
9.3 账户与基础设施
| 链路 | 重点看什么 | 展示图 | 详细版入口 |
|---|---|---|---|
| 登录鉴权与网关透传 | 短信/密码登录、Redis 登录态、Gateway 请求头透传 |  | 查看详细 SVG |
| 头像上传与文件替换 | 文件类型校验、MinIO 上传、旧文件删除、登录缓存刷新 |  | 查看详细 SVG |
9.4 内容审核与搜索
| 链路 | 重点看什么 | 展示图 | 详细版入口 |
|---|---|---|---|
| 发布审核与搜索 / 向量同步 | 提交待审、审核责任链、回调源服务、ES/Milvus/热榜更新 |  | 查看详细 SVG |
| 审核中心责任链与业务回写 | 审核任务落库、敏感词 / AI / 人工审核、驳回通知 |  | 查看详细 SVG |
| 搜索读链路与热词沉淀 | ES 检索、LBS 排序、搜索历史与热搜榜 |  | 查看详细 SVG |
9.5 社交与消息
| 链路 | 重点看什么 | 展示图 | 详细版入口 |
|---|---|---|---|
| 关注 Feed 推送与滚动读取 | 粉丝信箱写入、Pipeline 批量 ZSet、ScrollResult 读取聚合 |  | 查看详细 SVG |
| IM 私聊可靠投递 | 长连接、消息持久化、ACK / 重试 |  | 查看详细 SVG |
| 系统通知入库与 IM 推送 | 多业务通知汇聚、通知落库、在线实时推送 |  | 查看详细 SVG |
9.6 排行、热度与推荐
| 链路 | 重点看什么 | 展示图 | 详细版入口 |
|---|---|---|---|
| 首页热门面板与热门博客读取链路 | 首页顶部热门面板按 activeHotTab 读取店铺榜 / 好券榜 / 团购榜，热门博客列表独立读取 |  | 查看详细 SVG |
| 首页热门面板算分与热榜维护链路 | 店铺榜、好券榜、团购榜和热门博客内容流如何进入 calcQueue，经过增量洗牌与凌晨全量重建后持续写回 Redis 热榜 |  | 查看详细 SVG |
| 互动数据回刷与双轨同步（业务视角） | Redis 热数据变化如何驱动回刷、检索同步与热度重算 |  | 查看详细 SVG |
| 热榜增量维护与全量重建（业务视角） | calcQueue、Top N merge、榜单更新与凌晨全量兜底 |  | 查看详细 SVG |
9.7 AI 与经营
| 链路 | 重点看什么 | 展示图 | 详细版入口 |
|---|---|---|---|
| AI 对话链路 | SSE 流式响应、意图路由、卡片事件 |  | 查看详细 SVG |
| 店铺经营分析与 AI 经营建议 | 订单分析、评价分析、经营建议与差评关键词抽取合在同一组看 |   | 分析详细 / AI 建议详细 |
9.8 商家端经营链路图
这里把商家端真正会看到的“经营、履约、核销、AI 建议”单独收拢，避免它们只散在交易图和 AI 图里不够直观。
| 链路 | 重点看什么 | 展示图 | 详细版入口 |
|---|---|---|---|
| 商家订单履约与核销 | 店员核销、店铺销量累积、消费积分奖励如何从订单完成后联动触发 | | 查看详细 SVG |
| 商家经营分析聚合链路 | 店铺订单、评价、差评、销量和经营指标如何聚合成经营分析输入 | | 查看详细 SVG |
| 商家 AI 经营建议链路 | 差评关键词、经营指标和店铺画像如何驱动改进建议与营销策略输出 | | 查看详细 SVG |
| 商家订单生命周期兜底 | 临期提醒、自动过期、退款补偿和库存回滚如何由调度链路统一收口 |  | 查看详细 SVG |
9.9 平台管理端治理链路图
这一组对应后台管理端最核心的治理职责：内容审核、业务回写、检索同步和调度编排。
| 链路 | 重点看什么 | 展示图 | 详细版入口 |
|---|---|---|---|
| 审核中心责任链与业务回写 | 审核中心如何承接待审任务，经过规则、AI、人工后再回写业务源头 | | 查看详细 SVG |
| 发布审核与搜索 / 向量同步 | 内容审核通过后如何同步 ES、Milvus、热榜和搜索可见结果 | | 查看详细 SVG |
| 平台调度总览 | XXL-JOB 如何统一承接审核回刷、热榜重建、订单兜底和库存校准 |  | 查看详细 SVG |
9.10 缓存与性能专题
| 链路 | 重点看什么 | 展示图 | 详细版入口 |
|---|---|---|---|
| Redis 缓存分层设计 | 列表、详情、计数、状态、热榜 / Feed 五层缓存拆分 |  | 查看详细 SVG |
| Feed / 列表 ZSet 缓存链路 | ZSet 排序视图、滚动分页、批量详情回填 |  | 查看详细 SVG |
| 详情页缓存读写链路 | 逻辑过期、空值缓存、互斥锁重建、写后删缓存 |  | 查看详细 SVG |
9.11 调度与定时任务
这组主要看订单兜底、秒杀预热、互动回刷、热榜重建和销量同步如何由调度体系统一承接。真实后台页、任务列表和执行器截图可以继续看 页面导览 - XXL-JOB 调度后台。
9.11.1 第一层：总览图
| 链路 | 重点看什么 | 展示图 | 详细版入口 |
|---|---|---|---|
| XXL-JOB 定时任务体系总览 | 28 个定时任务如何拆到订单、秒杀、互动、热榜和销量同步六大类 | | 查看详细 SVG |
9.11.2 第二层：4 张子图
| 链路 | 重点看什么 | 展示图 | 详细版入口 |
|---|---|---|---|
| 秒杀预热与库存校准链路 | 预热库存和详情缓存，后续再按订单销量校准 MySQL 与缓存 |  | 查看详细 SVG |
| 热榜增量维护与全量重建链路（调度视角） | HotRankJobHandler / FullRebuildJobHandler 如何分发增量维护与全量重建 | | 查看详细 SVG |
| 互动数据回刷与双轨同步链路（调度视角） | InteractionSyncXxlJob / SyncDataServiceImpl 如何回刷 MySQL 并联动热榜 | | 查看详细 SVG |
| 订单生命周期兜底处理链路 | 临期提醒、过期处理、库存销量回滚与退款补偿兜底 | | 查看详细 SVG |
9.12 历史详细图补充
| 链路 | 重点看什么 | 展示图 | 详细版入口 |
|---|---|---|---|
| UGC 异步审核与分发 | 审核消息投递、责任链处理、回调源服务 |  | 查看详细 SVG |
| Feed 动态扇出 | 发布动态、粉丝分发、读扩散 / 写扩散 |  | 查看详细 SVG |
| 搜索与向量库同步 | ES 索引同步、Milvus 向量写入、异步一致性 |  | 查看详细 SVG |
10. 如何继续阅读
- 想按页面继续看用户端 App / 商家端 Web / 平台管理端 Web：看 页面导览
- 想把项目跑起来：看 开源接入
- 想做本地或服务器部署：看 部署指南
- 想参与贡献：看 GitHub · CONTRIBUTING.md
- 想了解安全和密钥边界：看 GitHub · SECURITY.md