功能介绍

LYShop 零云商城以电商交易链路为核心，通过插件化架构提供以下业务能力。所有功能模块均为独立插件，可按需启用。

商品管理 product

• 商品 CRUD（标题、描述、主图、轮播图、详情 JSON Blocks）
• 多规格 SKU（颜色/尺寸等属性组合，独立价格/库存）
• 多级商品分类树
• 商品相册（多图管理，拖拽排序）
• 商品详情自定义编辑器（version + blocks 结构化存储，支持 text/image）
• AI 一键生成封面图、轮播图、详情图，支持参考图（按模型能力控制）

订单系统 order

• 购物车（Redis 高性能存储）
• H5 购物车支持候选商品推荐与底部结算栏
• PC/H5/小程序/App 购物车支持单商品勾选、全选、按勾选商品结算（默认全选，未勾选时禁止结算）
• 完整下单流程（地址选择 → 支付方式 → 创建订单）
• 地址管理支持新增、编辑、删除与默认地址切换（H5 / PC）
• 订单状态机（待付款 → 待发货 → 待收货 → 已完成 → 售后）
• 统一支付对接（微信支付 / 支付宝，一行代码切换）
• 发货管理支持首发 + 补发，订单详情展示完整物流轨迹
• 物流驱动化：支持快递100与快递鸟双驱动，运单首次同步后自动绑定渠道并固定后续查询
• 物流同步支持后台手动刷新与自动轮询（可配置开关与频率）
• PC/H5 订单详情按时间线展示物流方向、业务类型、状态、时间、备注与关联售后单
• 标准售后流程支持退货与换货（申请、审核、回寄、收货、退款/补发、完结）
• 售后详情沉淀状态日志与关联物流，支持后台和用户端双向跟踪
• PC/H5 售后详情按时间线展示物流方向、业务类型、状态、时间、备注与关联售后单
• 前台订单列表支持“去付款、评价”动作并实时刷新状态
• PC/H5/后台 订单列表支持从“最近售后单”直接进入售后进度页
• PC/H5/后台 订单列表展示最新物流状态摘要、最近售后单状态摘要，并对含补发订单标注“含补发”
• 前台与后台统一订单/售后/物流状态中文文案映射（含轨迹状态、售后状态、日志状态）
• PC/H5/后台 订单列表与详情的物流状态优先展示后端标签字段（logistics_status_label），缺失时回退本地映射
• PC/H5/后台 订单详情中的售后摘要优先展示后端返回 latest_status_label，缺失时回退本地状态映射
• 后台售后列表/详情优先展示返回的状态标签字段，缺失时自动回退本地状态映射
• PC/H5 售后详情优先展示后端返回的标签字段（status_label/case_type_label/from_status_label/to_status_label/action_label/logistics_status_label），缺失时回退本地映射
• 订单列表/详情统一返回商品明细与金额分解（items + amount_breakdown）
• 管理后台、PC、H5 均支持订单详情页
• 管理后台、PC、H5 支持售后申请入口与售后进度页
• 订单评价升级为独立结构：根评价可修改，支持追评（根评价子级），支持商家单条回复
• H5 / PC 订单评价改为独立评价页（商品评分 + 物流评分 + 文本 + 图片）
• 追评仅在对应根评价发布后开放，避免在未发布根评价状态直接追评
• 商品详情页新增“评价 Tab”，可查看评分摘要、追评与商家回复

营销活动 marketing

• 优惠券（满减券、折扣券、无门槛券）
• 限时秒杀（Redis 原子扣减库存）
• 满减活动
• 积分系统（消费获取、兑换消耗）

IM 客服 im

• WebSocket 实时通信
• 多客服坐席，会话分配/转接
• 消息类型：文字、图片、商品卡片、订单卡片
• 离线消息存储，重连自动推送
• 关键词自动回复
• H5 与 PC 客服入口统一收敛，支持页面内弹窗会话与输入发送
• H5 个人中心客服入口图标统一为 kefu-ermai（含顶部入口、快捷入口、菜单入口）

仓储管理 wms

• 多仓库管理
• 入库单 / 出库单 / 库存调拨
• 库存盘点（盈亏记录）
• 库存流水追溯
• 低库存预警（短信通知）

AI 生图 ai_image

• 多模型聚合（通义万象 / 文心一格 / 腾讯混元 / OpenAI DALL-E）
• 商品轮播图生成（横版）
• 商品详情图生成（竖版长图）
• 生成记录管理，一键应用到商品
• 后台可视化配置模型和 API Key
• 已集成到商品编辑页，后台不再单独展示 AI 生图菜单入口

店铺装修 decor

• 可视化拖拽编辑器
• 9 种装修组件：轮播图、分类导航、商品瀑布流、公告栏、广告图、富文本、营销区块等
• 公告栏支持多条纵向轮播，前台可直接跳转到活动或页面
• JSON 配置驱动，前台动态渲染
• 首页装修支持多副本（如春节版、618版），可复制副本并分别编辑
• 副本发布采用单活策略：同一页面同一时刻仅一个已发布副本
• 草稿保存 + 一键发布
• 前台轮播与瀑布流在 H5 端保持静态资源可用与演示态稳定渲染

支付驱动

• 微信支付 wechat_pay — JSAPI（小程序）/ H5 / App 三场景
• 支付宝 alipay — APP / H5 / PC 三场景
• 统一驱动接口，业务代码零改动切换支付方式

用户与认证

• 手机号 + 短信验证码登录
• 微信小程序 code2session 登录
• H5/App 微信 OAuth2 登录
• JWT 鉴权，Redis 支持主动失效
• H5 个人中心将“注销账号”下沉到“账号与安全”二级菜单，降低误触风险

文件存储

• 存储路由 storage_router（后台配置默认驱动）
• 本地存储 storage_local
• 阿里云 OSS storage_oss
• 腾讯云 COS storage_cos
• 七牛云 storage_qiniu
• 统一驱动接口，支持多个驱动并存，后台可配置默认驱动
• storage_oss / storage_cos / storage_qiniu 已实现真实云端上传、URL 访问与删除能力（不再是仅拼接 URL 的占位实现）
• 上传接口支持通过 driver 参数指定驱动（如 local/oss/cos/qiniu，兼容 aliyun_oss/qcloud_cos/qiniu_kodo）

短信服务 sms

• 阿里云短信 / 腾讯云短信
• 后台配置切换，模板管理
• 验证码发送、库存预警通知

管理后台

• Vue3 + TailwindCSS + shadcn-vue
• 深色侧边栏，卡片式数据展示
• 菜单由后端根据已启用插件动态下发
• AI 生图能力已内嵌到商品编辑页，不再占用独立菜单位
• Dashboard 首屏：订单统计、销售趋势、库存预警
• 新增评价管理模块：支持评价列表、详情、商家回复（可覆盖更新）

多端覆盖

端	技术	说明
PC Web	Vue3 + UnoCSS	桌面端商城
H5	uni-app + uview-plus	手机浏览器
微信小程序	uni-app	微信生态
App	uni-app	iOS + Android
管理后台	Vue3 + TailwindCSS	商家管理