功能介绍

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

商品管理 product

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

订单系统 order

• 购物车（Redis 高性能存储）
• H5 购物车支持候选商品推荐与底部结算栏
• PC/H5/小程序/App 购物车支持单商品勾选、全选、按勾选商品结算（默认全选，未勾选时禁止结算）
• 完整下单流程（地址选择 → 支付方式 → 创建订单）
• 地址管理支持新增、编辑、删除与默认地址切换（H5 / PC）
• 订单状态机（待付款 → 待发货 → 待收货 → 已完成 → 售后 / 已取消）
• 订单库存交易下沉 WMS：下单预占、支付确认、取消释放（单仓优先）
• 统一支付对接（微信支付 / 支付宝，一行代码切换）
• 发货管理支持首发 + 补发，订单详情展示完整物流轨迹
• 物流驱动化：支持快递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

• 后台导航收敛为四个入口：/wms/warehouse、/wms/docs、/wms/stock、/wms/movements
• 仓库管理：支持列表查询、创建、编辑、启停用
• 出入库单：统一单据模型，支持草稿编辑、完成、作废
• 出入库单明细支持多 SKU，完成后统一写入库存变更
• 库存台账支持按仓库 / SKU / 预警状态筛选
• 安全库存支持按库存记录维护 safe_qty
• 库存流水支持按仓库 / SKU / 业务类型 / 单号 / 时间区间追溯
• 部署/配置影响：无新增依赖与配置项

AI 生图 ai_image

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

店铺装修 decor

• 可视化拖拽编辑器
• 9 种装修组件：轮播图、分类导航、商品瀑布流、公告栏、广告图、富文本、营销区块等
• 公告栏支持多条纵向轮播，前台可直接跳转到活动或页面
• JSON 配置驱动，前台动态渲染
• 首页装修支持多副本（如春节版、618版），可复制副本并分别编辑
• 副本发布采用单活策略：同一页面同一时刻仅一个已发布副本
• 草稿保存 + 一键发布
• 前台轮播与瀑布流在 H5 端保持静态资源可用与演示态稳定渲染
• PC 首页装修支持页面级样式系统（背景、布局、默认外观）与组件级样式覆盖（间距、内边距、背景、边框、圆角、阴影）
• PC 装修数据结构为 PcDecorPage：components = { pageStyle, components }
• PC 顶部导航新增“产品场景”下拉，内置综合商城、商超便利、生鲜优选、珠宝奢品、农场直供、糕点烘焙、母婴用品 7 个演示场景的重点页面截图与场景介绍
• 产品场景文档已拆分为独立页面：/guide/scenes/mall、/guide/scenes/supermarket、/guide/scenes/fresh、/guide/scenes/jewelry、/guide/scenes/farm、/guide/scenes/cake、/guide/scenes/mother
• 接口变化：无新增后端接口，继续使用既有 demo 查询参数切换前端演示行业预设
• 部署/配置影响：无新增环境变量与部署步骤，仅新增前端静态截图资源

支付驱动

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

用户与认证

• 手机号 + 短信验证码登录
• App 登录页已升级为轻拟物卡片风格，优化品牌区、输入区层次与主操作按钮反馈
• App 登录前端新增手机号格式校验、验证码倒计时禁用态、登录防重复提交提示
• 接口变化：无，仍使用 /api/v1/auth/sms/send 与 /api/v1/auth/sms/login
• 部署/配置影响：无新增依赖与配置项
• 微信小程序 code2session 登录
• H5/App 微信 OAuth2 登录
• JWT 鉴权，Redis 支持主动失效
• H5 个人中心将“注销账号”下沉到“账号与安全”二级菜单，降低误触风险
• H5 个人中心新增“会员中心”入口，可查看会员状态、成长值与本月可领券，并支持一键领取
• 会员中心接口使用 /api/v1/vip/profile、/api/v1/vip/coupons/monthly、/api/v1/vip/coupons/monthly/:rule_id/claim
• 会员中心部署/配置影响：无新增依赖与环境变量（当前以前端与 mock 骨架为主）

文件存储

• 存储路由 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
• 深色侧边栏，卡片式数据展示
• 菜单由后端根据已启用插件动态下发
• 左侧导航升级为“双列分组”：左列一级 TAB，右列分组菜单
• 一级 TAB 改为 hover 即切换，鼠标移出整块分组区域后回退到当前路由所属分组
• 首页作为固定入口提升到一级 TAB 层展示，不再单独占用右侧菜单位
• 侧栏滚动条采用深色主题，与导航背景保持一致
• AI 生图能力已内嵌到商品编辑页，不再占用独立菜单位
• 首页首屏：订单统计、销售趋势、库存预警
• 新增评价管理模块：支持评价列表、详情、商家回复（可覆盖更新）
• 后台商品列表支持“管理评价”弹窗直达：按商品ID自动过滤评价，并支持关键词检索、详情查看、追评查看、商家回复
• 后台统一交互提示通道：notify 已支持全局 Toast 展示（默认右上角），并保留可扩展的提示适配能力
• VIP 菜单聚焦会员套餐、会员等级、会员领券规则；会员 SKU 价改为内嵌在商品编辑页 SKU 区配置（仅在启用 VIP 插件时显示）

商家移动端 eapp

• 独立工程：eapp/（与用户端 app/ 解耦）
• 支持端：H5 / 微信小程序 / App
• 主导航：工作台、订单、商品、营销、我的
• 接口策略：复用后台接口 /admin/api/*，不新增商家专属前缀

多端覆盖

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

移动端商家工作台

eapp/ 为商家专用移动端，覆盖 H5 / 微信小程序 / App，提供完整的订单履约、商品运营、营销与店铺管理：

• 工作台首屏：多指标卡 + 营收趋势图 + 订单状态环形 + 待办中心 + 9 状态订单 tabs + 销量榜 + 库存预警
• 订单：高级筛选抽屉 / 批量发货 / 改价 / 备注 / 面单预览 / 操作日志
• 售后：5 步进度条 + 协商时间线 + 凭证上传 + 双向物流
• 商品：多规格 SKU 矩阵 + 分类树 + 批量上下架 / 批量分类 / 批量调价 + 三级分类管理
• 图表：基于 ly-charts 跨端实现
• mock 模式：npm run dev:h5 -- --mode demo 即开即用 | 商家移动端 | uni-app + uview-plus | 商家运营管理（eapp） |