商家移动端 eapp(最新架构)
eapp/ 是 lyshop 的商家专用移动端,覆盖 H5 + 微信小程序 + App 三端,承担「订单履约、商品运营、营销活动、客户与店铺管理」的成熟移动端商家工作台能力。
在线演示
npm run dev:h5 -- --mode demo 启动后即为 mock 演示模式,账号 admin / admin123 自动登录。生产模式连接后端 /admin/api/*。
顶层结构
- 4 个底部 Tab:工作台 / 订单 / 客服 / 我的,各带常态与选中态线性 PNG 图标
- 自定义导航:登录、工作台、订单、客服、我的、商品列表以及营销域 6 个页面(营销中心 / 秒杀 / 拼团 / 砍价 / 优惠券 / 活动详情)使用
navigationStyle: custom,由PageHeader统一渲染标题、辅助文案与右侧图标按钮 - 图表能力:基于
ly-charts (qiun-data-charts)跨端集成,业务方用ChartPanel + AreaChart / RingChart / BarChart统一调用 - 商家高阶组件库:
components/biz/提供 PageHeader / SectionHeader / EntryList / MetricCard / ActionGrid / TodoCenter / AnnouncementBar / FilterDrawer / BatchBar / BatchResultPopup / Timeline / EmptyState / OrderCard / ProductCard / AfterSaleCard / SkuMatrixEditor / CategoryTreePicker / RichTextEditor / ShipPopup / RepricingPopup / RemarkPopup - 通用组件:
components/common/提供 AppIcon / SkeletonCard / StatusTag / StatCard / TodoCard - composables:
useDashboard / useOrderList / useProductList / useBatchSelection / useFilter / useRequest / useCouponList / useActivityCenter - 营销组件:
components/marketing/提供FormSheet / ActivityListPage / ActivityCard / ActivityFormPopup / ActivityProductCard / ActivityProductFormPopup / CouponForm / CouponSendPopup
视觉与交互规范
界面采用沉稳品牌红 + 中性石板灰,所有颜色、圆角、阴影、字阶、间距都从 App.vue 的 CSS 变量取值,页面与组件不硬编码颜色。
商家端主色为品牌红 #c62f24(深色态 #8f2018、浅底 #fdf0ee、描边 #f4cbc5),用于主操作、品牌区、选中态与图标强调;uview-plus 的 --up-* / --u-*、tabBar selectedColor、tabBar 选中态 PNG、图表首色与 ICON_COLORS.primary 全部同步该红色。信息类提示改用中性石板灰,避免与红色危险操作混淆;危险语义色仍为深红 #b42318,以「淡底描边按钮」与「实心主按钮」区分层级。
| 令牌组 | 变量 | 用途 |
|---|---|---|
| 品牌 | --eapp-primary (#c62f24) / --eapp-primary-deep (#8f2018) / --eapp-primary-soft (#fdf0ee) | 主操作、品牌区、图标底 |
| 语义 | --eapp-success / --eapp-warning / --eapp-danger / --eapp-accent | 状态、趋势、预警(低饱和) |
| 中性 | --eapp-bg / --eapp-card / --eapp-text* / --eapp-border* | 背景、表面、文字、描边 |
| 形状 | --eapp-radius* / --eapp-shadow* / --eapp-space-* | 圆角、阴影、间距 |
- uview-plus 桥接:
--up-*/--u-*变量在App.vue统一定义,up-*组件自动继承同一主题;uni.scss只引入uview-plus/theme.scss,不重复声明颜色。 - 图标系统:
utils/icons.ts维护一套 24×24、1.7 描边的线性图标,运行时生成 base64 SVG data URI,由AppIcon.vue以<image>渲染,兼容 H5 / 微信小程序 / App;不使用 emoji,也不使用内联<svg>标签。 - 统一组件:卡片用 1rpx 描边 + 极淡阴影;状态用带圆点的低饱和标签;区块标题用
SectionHeader(左侧主色竖条 + 可选「查看全部」);入口列表用EntryList;加载态用SkeletonCard;点击反馈统一hover-class="eapp-hover"。 - 图表色板:
utils/ly-charts.ts的EAPP_CHART_COLORS与主题同源(品牌红 → 青 → 绿 → 琥珀 → 深红 → 石板灰),坐标轴与网格线使用中性灰,避免高饱和彩虹配色。实现约束:本项目内置的
uni_modules/ly-charts是 26.1.4 旧副本,其 line / bar / pie 组件不读取 ECharts 顶层的option.color,只按series.color、series.itemStyle.color、饼图数据项的color/itemStyle.color取色,未指定时会回退到组件内置的 ECharts 高饱和默认色板。因此所有 option 构造函数除了设置顶层color,还必须通过paletteColor(index)给每条 series、每个扇区显式着色,否则截图里仍会出现淡紫面积图和彩虹环形图。新增图表类型时同样处理。上游组件库
D:\Repos\xyito\open\lyCharts已修复该缺陷(Vue / uvue / uni-app x 全端支持顶层option.color,取色优先级为显式色 →itemStyle.color→option.color[index]→ 内置色板)。待本项目把uni_modules/ly-charts升级到含该修复的版本后,可保留顶层color并移除逐项显式着色;在升级之前不要删除paletteColor逻辑,也不要直接改项目内的第三方组件副本。 - 数字排版:金额、指标、编号使用
.eapp-num等宽数字对齐;MetricCard/StatCard按数值字符数自适应字号,避免 393px 手机三列布局下长金额(如¥28960.50)被省略号截断。 - 表单弹层:营销与优惠券表单统一用
FormSheet外壳 +App.vue的.eapp-form-*全局类;长表单内容区用scroll-view并显式给bodyHeight,不在view上依赖overflow-y: auto(小程序端不生效)。标题、标签、必填标记、分段控件、picker 选择行、提示条的样式与间距全部由全局类提供。
构建与静态资源
scripts/gen-tabbar-icons.cjs用纯 Node 光栅化生成static/tabbar/下 8 张 tabBar PNG(4 个入口 × 常态/选中态),修改图标后重新执行node scripts/gen-tabbar-icons.cjs。scripts/normalize-theme.cjs用于把页面里遗留的硬编码颜色批量收敛到设计令牌,新增页面后可复跑。vite.config.ts的copyStaticAssets插件在 H5 构建时把static/复制到产物根目录:uni 的 Vite 构建默认不复制该目录,而 tabBar 的iconPath在 H5 端会解析为/static/...绝对路径,缺少这一步会导致图标 404。小程序与 App 端由 uni 自行处理静态资源。- 部署 H5 时按
manifest.json的h5.router.base(默认/eapp/)配置静态站点与 history 回退。
官网截图维护
官网首页的商家端手机截图位于 docs-site/docs/public/showcase/eapp-*.png,共 5 张(工作台 / 订单 / 商品 / 营销中心 / 秒杀活动),由 docs-site/scripts/capture-showcase.js 生成。改动商家端视觉后按以下顺序更新:
- 在
docs-site/执行npm run eapp-demo:build,把最新 eapp 源码构建到docs/public/eapp-demo/(hash 路由 +base="./")。 - 执行
npm run showcase:capture -- --only=eapp-,只重截商家端 5 张图,避免覆盖买家端 H5 与 PC 演示截图。
- 视口固定
390×844、deviceScaleFactor=2,输出780×1688,与首页.phone-frame img的aspect-ratio: 390/844对齐;不要改成桌面视口。 - 脚本自动注入商家端 mock 登录态(
eapp_admin_token),避免首帧闪登录页;每张图带expect文案断言,页面未渲染出预期内容时直接报错而不是写入白屏图。 - uni-app H5 demo 存在轮询请求,因此等待策略是
domcontentloaded+ 页面文本,不能用networkidle。 - 浏览器优先使用 Playwright 自带 Chromium;本机未执行
npx playwright install时自动回退系统 Chrome / Edge。也可通过LYSHOP_SHOWCASE_PORT改本地服务端口。
接口与配置
- 数据交互统一走
/admin/api/*,界面层不持有独立接口,mock 模式由VITE_MOCK=true切换。 - 运行与部署无需额外环境变量;构建产物包含
static/tabbar/,需随站点一起发布。
工作台(Dashboard)
页面按「店铺状态 → 核心指标 → 待办 → 公告 → 入口 → 分析 → 预警」组织,区块标题统一使用 SectionHeader。
- 顶部
PageHeader:店铺名(来自/shops/current)+ 扫码 + 消息入口(带未读红点) - 店铺概览条:店铺标识、营业状态、当前日期、经营报表入口
- 今日营业概览:今日营收 / 今日订单 / 客单价三列
MetricCard,附环比趋势 - 待办中心:待发货 / 待审售后 / 未读消息 / 库存预警四项,点击直达对应业务页并自动应用筛选
- 公告通知:
AnnouncementBar按通知 / 提醒 / 紧急分类,点击查看详情 - 快捷入口:订单 / 商品 / 售后 / 评价 / 装修 / 数据报表 / 仓储,统一线性图标
- 营销中心:优惠券 / 秒杀 / 拼团 / 砍价 / 会员 / 消息群发 / 装修 / 规格模板 / 分销 / 积分商城
- 经营分析:营收趋势(近 7 / 30 日
AreaChart)、订单状态分布(RingChart)、商品销量 Top5(BarChart) - 库存预警列表:显示预警阈值与当前库存,点击跳转商品列表「预警」页签
- 扫码结果写入订单关键词,跳转到订单列表后自动作为搜索条件生效
订单
列表
- 顶部 7 状态 tabs:全部 / 待付款 / 待发货 / 已发货 / 已完成 / 已取消 / 售后中
- 快捷搜索:订单号 / 买家 / 商品,支持回车提交与一键清空;工作台扫码结果可直接作为关键词
- 高级筛选抽屉:关键词、金额区间、物流公司、收货省份、支付方式
- 卡片操作:详情 / 改价 / 催付 / 发货 / 备注 / 打单
- 勾选进入批量模式:批量发货 / 批量备注 / 批量关闭;结果弹窗分别列出成功与失败项
- 首次加载用
SkeletonCard骨架屏,空态提供「清除筛选」快捷操作
详情
- 顶部订单进度 Timeline(下单→支付→发货→签收→完成)
- 操作 ActionSheet(改价 / 备注 / 打单 / 催付)
- 物流卡片、商品明细、操作日志
批量操作集中页 /pages/order/batch
- 由列表「批量发货」或工作台「扫码发货」进入
- 支持统一选择快递公司,按行填写运单号
- 提交后展示成功/失败结果
面单预览 /pages/order/print-preview
- 服务端模板 HTML 通过
rich-text渲染(演示模式 mock 静态模板)
售后
- 列表:6 状态 tabs + 售后类型筛选
- 详情:5 步进度条 / 协商沟通时间线(双向带头像气泡)/ 商家凭证上传 / 双向物流卡片 / 操作按钮按状态机启用
商品
列表
- 4 状态 tabs:在售 / 仓库 / 预警 / 全部
- 筛选:关键词 + 排序(销量 / 库存 / 价格 / 最新)
- 卡片:缩略图 + 多指标 + 状态徽标 + 操作
- 批量:批量上下架 / 批量分类 / 批量调价(百分比)
- FAB:新建 / AI 提示
编辑
- 分段表单:基础信息 / 主图轮播 / 详情(演示期只读 RichTextEditor)/ 价格库存 / 规格 SKU / 分类与标签 / 物流与营销 / 状态控制
- 多规格 SKU 矩阵编辑器:动态规格组 + 全组合矩阵 + 批量赋价/赋库存
分类管理 /pages/product/category-tree
- 三级树展开/折叠 + 改名 / 删除 / 增子
营销
营销域采用「营销中心 → 活动列表 → 活动详情」三层结构;营销域 6 个页面全部使用 navigationStyle: custom + PageHeader,工作台「营销中心」区块的「进入营销中心」可直达中心页。
统一元数据与数据层
utils/marketing.ts:ACTIVITY_META(秒杀 / 拼团 / 砍价的标题、图标、路由、价格语义)、MARKETING_ROUTES(10 个营销入口,工作台与营销中心共用)、activityState/activityProgress/activityTimeRange/formatMoney/parseSkuLabel。- 活动状态由「
status+ 当前时间」共同推导:已停用 / 未开始 / 进行中 / 已结束 / 待排期,前端不依赖后端下发状态文案。 composables/useActivityCenter.ts是活动列表与活动商品的数据层,统一处理请求、错误提示与防重复提交;api/marketing.ts提供getActivities / createActivity / updateActivity / deleteActivity / getActivityProducts / upsertActivityProducts,按 kind 映射到/seckill、/group-buy、/bargain前缀。ACTIVITY_KINDS是唯一的活动类型清单;新增活动类型只需扩元数据,不再维护多份路由表。
营销中心 /pages/marketing/index
- 深蓝概览卡:进行中活动数、待开始、优惠券数、活动总数,由三个活动接口与优惠券接口并发聚合。
- 「活动管理」2×2 宫格:秒杀 / 拼团 / 砍价 / 优惠券;活动卡显示「进行中 / 总数」,优惠券卡显示可用张数。
- 「全部功能 / 会员与运营 / 内容与工具」三组
EntryList,与工作台快捷入口共用MARKETING_ROUTES。
活动列表(秒杀 / 拼团 / 砍价)
pages/marketing/seckill.vue、group-buy.vue、bargain.vue 是薄壳,统一渲染 components/marketing/ActivityListPage.vue:
- 顶部概览(全部 / 进行中 / 未开始 / 已停用)、名称搜索、状态筛选 chips(全部 / 进行中 / 未开始 / 已结束 / 已停用)。
ActivityCard展示状态标签、活动周期、周期进度条、活动商品数与「编辑 / 启停 / 删除」操作;删除有二次确认。ActivityFormPopup基于FormSheet,按「基础信息 / 活动周期」分组,校验名称、起止时间与「结束晚于开始」;同类型活动时间段冲突由 mock / 后端返回业务错误并统一提示一次。- 点击卡片进入详情页;加载态用
SkeletonCard,空态用EmptyState。
活动详情 /pages/marketing/activity-detail
- 通过
?kind=&id=&name=传参;概要卡展示状态、周期进度、商品数、累计已售与预估销售额。 ActivityProductCard展示封面、SKU、活动价 / 原价(砍价展示起砍价 / 底价)、折扣、限购 / 库存 / 已售。ActivityProductFormPopup按 kind 切换价格字段,选择商品后联动加载 SKU,校验重复 SKU、价格与库存合法性。- 后端
PUT /activities/:id/products是整表替换,因此提交时回传product_title / product_cover / sku_price / sku_stock / sku_attrs / sold_qty冗余字段;mock 侧也会按product_id + sku_id从旧行继承,避免卡片退化成「商品 #ID」。
优惠券 /pages/marketing/coupon
- 概览统计、名称搜索、启用状态筛选;券卡片用「面额块 + 信息区 + 标签区 + 操作区」结构。
CouponForm按「基础信息 / 优惠规则 / 发放设置」分组,使用分段控件与统一 picker,含完整校验;CouponSendPopup用步进器与快捷数量发放。- 所有弹层复用
FormSheet(底部抽屉 +scroll-view滚动区 + 取消 / 提交),解决小程序端view的overflow不生效、长表单无法滚动的问题。
表单组件库
components/marketing/ 提供 FormSheet / ActivityCard / ActivityFormPopup / ActivityProductCard / ActivityProductFormPopup / ActivityListPage;App.vue 提供全局 .eapp-form-* 类(分组标题、标签、输入框、选择行、分段控件、提示条),营销与优惠券表单共用,避免每个弹层重复定义样式。
其他营销能力
- 优惠券:全字段 CRUD + 叠加规则(互斥 / 同类可叠 / 跨类可叠)+ 定向发券(全部用户 / 会员等级 / 新用户)
- 秒杀 / 拼团 / 砍价:见上方活动列表与活动详情
- VIP 会员:套餐 / 等级 / 领券规则 / SKU 专属价 4 页 CRUD
- 店铺装修:简化版可视化编辑器,8 种组件类型,卡片列表排序 + 属性编辑弹窗 + 多副本管理
- 规格模板:预定义属性组 + 应用分类,可在商品编辑中一键应用生成 SKU 笛卡尔积
- 分销管理:分销商管理 / 佣金管理 / 分销配置
- 积分商城:积分商品 CRUD / 兑换记录 / 签到管理入口
VIP 会员管理
| 页面 | 功能 |
|---|---|
| 会员套餐 | 月卡/季卡等订阅套餐,设置时长、价格、状态 |
| 会员等级 | 成长等级体系(银卡/金卡),设置成长值门槛与折扣率 |
| 领券规则 | 按等级配置每月自动领券,关联优惠券与限领次数 |
| SKU专属价 | 按商品 SKU + 等级设置专属价格,支持筛选 |
移动端装修编辑器
轻量化方案,无拖拽、无 iframe 预览:
- 8 种组件:轮播图 / 分类导航 / 商品网格 / 公告 / 图片广告 / 富文本 / 营销区 / 间距
- 操作:添加组件 → 上下箭头排序 → 点击编辑属性 → 保存/发布
- 副本管理:复制 / 重命名 / 删除
优惠券深度
- 全字段 CRUD:名称、类型(满减/折扣/立减)、面额、有效期、发行量等
- 叠加规则
stack_rule:exclusive(互斥)/same_type(同类可叠)/cross_type(跨类可叠) - 定向发券
target_type:all(全部)/vip_level(会员等级)/new_user(新用户) - 发券操作:选择数量后确认发放,自动累加
used_count
规格模板
- 模板包含:名称、适用分类(多选)、属性组(动态增删,每组含名称 + 逗号分隔值)
- 在商品编辑页 SKU 区域点击「应用规格模板」→ 选择模板 → 自动生成笛卡尔积填充 SKU 矩阵
我的
- 账号卡:头像、登录账号、认证状态
- 店铺管理:店铺设置 / 管理员 / 角色权限(按 RBAC 权限动态过滤)
- 客服与消息:自动回复 / 消息群发 / 客服会话(tabBar 页面用
switchTab跳转) - 经营工具:数据分析 / 店铺装修 / 仓储管理
- 退出登录带二次确认
仓储管理(WMS)
仓储管理模块提供仓库、库存、出入库单与库存流水的移动端管理能力:
| 页面 | 路径 | 功能 |
|---|---|---|
| 仓储首页 | /pages/wms/index | 4 个功能入口卡片 |
| 仓库管理 | /pages/wms/warehouse-list | 仓库 CRUD(名称/编码/地址/联系人/状态) |
| 库存台账 | /pages/wms/stock-ledger | 仓库筛选 + SKU 搜索 + 安全库存编辑 + 预警标识 |
| 出入库单 | /pages/wms/doc-list | 类型 tabs(全部/入库/出库)+ 状态过滤 |
| 单据编辑 | /pages/wms/doc-editor | 单据创建/编辑/完成/取消,商品明细行管理 |
| 库存流水 | /pages/wms/movement-list | 仓库/SKU/单据号多维搜索,变动量着色 |
IM 客服
IM 模块提供客服会话管理、实时聊天与自动回复能力:
| 页面 | 路径 | 功能 |
|---|---|---|
| 客服会话 | /pages/me/im-sessions | 未读计数、最后消息、状态标签(等待/进行/关闭),点击进入聊天 |
| 聊天详情 | /pages/im/chat | 消息气泡(买家/客服),底部输入栏,自动滚底 |
| 自动回复 | /pages/im/auto-replies | 规则 CRUD,精确/包含匹配,启用/禁用 |
消息分级
消息中心支持按分组和优先级管理:
- 分组 tabs:全部 / 系统 / 订单 / 营销 / 客服
- 优先级指示:紧急(红点)/ 重要(琥珀点)/ 普通(无点)
- 标记已读:单条标记已读操作
mock 演进
- 所有 mock 路由与示例数据集中维护在
admin/src/mock/index.ts,eapp 通过import.meta.env.VITE_MOCK==='true'触发matchMock - mock 写入型接口(改价、批量发货、协商消息、商家凭证、商品批量、分类 CRUD)会修改内存源数组,刷新后保留状态
- 批量接口返回
success_ids[] / fail[{id,reason}]结构,含部分失败示例
平台兼容
- H5:主跑 demo,
env(safe-area-inset-top)在桌面自然降级为 0;vite.config.ts负责把static/复制到产物 - 微信小程序:
AppIcon以 base64 SVG data URI 渲染<image>,不依赖内联<svg>;ly-charts 自带 canvas 兼容;富文本编辑器演示期只读 - App:面单预览用
rich-text/web-view渲染 - 安全区:抽屉、批量操作条、页面底部留白统一用
env(safe-area-inset-bottom)处理 - 旧机型:快捷入口 4 列、营销中心 5 列,公告按条展示不做横滑
分销管理
分销管理模块提供二级分销体系的移动端管理能力:
| 页面 | 路径 | 功能 |
|---|---|---|
| 分销总览 | /pages/distribution/index | 3 指标卡(总分销商/待结算佣金/已结算总额)+ 3 入口 |
| 分销商管理 | /pages/distribution/distributor-list | 关键词搜索 + 状态 tabs(全部/待审核/启用/禁用),审核激活与启用/禁用切换 |
| 佣金管理 | /pages/distribution/commission-list | 状态 tabs(全部/待结算/已结算/已退回),结算/退回操作 |
| 分销配置 | /pages/distribution/config | 一级/二级佣金比例设置 |
分销商接口为 /admin/api/distribution/distributors,状态使用 pending、active、disabled;列表展示 real_name、available_amount、total_earnings,状态更新复用 PUT /admin/api/distribution/distributors/:id。配置中的 level1_rate、level2_rate 直接以百分数传递(10 表示 10%),页面输入、保存和演示数据使用同一单位。商家端与管理后台共用 Mock 数据,部署时需同步更新对应前端产物,无新增后端接口或配置项。
积分商城
积分商城模块提供积分商品、兑换记录与签到管理的移动端能力:
| 页面 | 路径 | 功能 |
|---|---|---|
| 积分总览 | /pages/points/index | 3 指标卡(发放积分/消耗积分/商品数)+ 3 入口(商品/兑换/签到) |
| 积分商品 | /pages/points/product-list | 类型 tabs(全部/实物/虚拟/优惠券)+ CRUD 弹窗 |
| 兑换记录 | /pages/points/exchange-list | 状态 tabs(全部/待发货/已完成),发货/完成操作 |
签到管理
签到管理依托已有 mock 路由,提供签到规则与日志的移动端管理:
| 页面 | 路径 | 功能 |
|---|---|---|
| 签到规则 | /pages/checkin/rules | 动态增删规则行(天数+积分),保存提交 |
| 签到记录 | /pages/checkin/logs | 只读列表:用户/日期/连续天数/获得积分 |
后续 Phase
- P5:客户列表/标签/分群/会员卡 / 群发推送 / 账户/流水/对账/提现 / 盘点/调拨
评价管理
- 列表页
/pages/review/list:3 状态 tabs(全部/待回复/已回复)+ 关键词搜索 - 评价卡片:商品缩略图 + 星级评分 + 内容摘要 + 图片行 + 回复状态标签 + 追评计数
- 详情弹窗:完整内容/图片(点击预览)/追评列表/已有回复
- 回复弹窗:文本输入 + 提交,支持新增和修改回复
- mock 层:
reply_status过滤(pending/replied),POST /reviews/:id/reply写入
数据分析
5 个专题页,统一使用 useAnalytics composable + DateRangePicker 日期切换:
| 页面 | 路径 | 指标卡 | 图表 |
|---|---|---|---|
| 销售分析 | /pages/analytics/sales | GMV / 订单数 / 客单价 | 营收趋势(AreaChart) + 订单趋势(AreaChart) + 支付方式(RingChart) + 时段分布(BarChart) |
| 商品分析 | /pages/analytics/products | SKU总数 / 动销率 / 库存周转 | SKU排行(BarChart horizontal) + 分类销售(RingChart) + 价格段(RingChart) + 库存状态(RingChart) |
| 客户分析 | /pages/analytics/customers | 总客户 / 复购率 / 客均消费 | 新老客占比(RingChart) + 客单价分布(BarChart) + 购买频次(BarChart) + RFM雷达(RadarChart) |
| 流量分析 | /pages/analytics/traffic | PV / UV / 平均停留 / 跳出率 | PV/UV趋势(AreaChart) + 渠道分布(RingChart) + 设备分布(RingChart) + 页面停留(BarChart) |
| 转化分析 | /pages/analytics/conversion | 总转化率 / 弃购率 | 转化漏斗(FunnelChart) + 步骤趋势(AreaChart) + 总转化率仪表盘(GaugeChart) |
入口:工作台快捷入口「数据报表」→ 分析首页 5 卡片 → 各专题页