📚 Harness 学习计划 / 第2周 / Day08_通读后台模块

Day 8 · 通读后台 Admin 各模块

属性
日期 2026-08-25
周次 第2周:动手体验+场景深挖
轨2 · 项目 Agent 落地调研
时间 1 小时
状态 ✅ 已完成

📋 Checklist


✍️ 学习笔记

第一层:全景图——27 个模块,6 大类

后台围绕电商运营核心链组织:商品 → 订单 → 用户 → 营销 → 内容 → 数据

分类 模块 核心职责
核心业务 goods, order, member 商品上下架、订单处理、会员管理
营销活动 marketing, point, popularize 优惠券、众筹、积分、Feed 投放
内容管理 cms, communityManage, discoverManage, dreamRigManage, coCreate, coCreateContent, codesign, interaction 页面搭建、社区审核、发现页、共创
数据与分析 dashboard, dataExport, search 看板、导出、搜索管理
系统配置 system, sys, seoManagement, labelManage, tool 站点/语言/仓库/SEO/物流
其他 kocard, material, home Ko 卡兑换、素材管理、首页设置

第二层:核心模块深挖

🔴 营销模块(marketing)—— 18 个子模块

marketing/
├── coupon/          → 6 种券:goodsCoupon/skuCoupon/freightCoupon/couponList/couponCodes/couponLogs
├── rule/            → 8 种规则:goods/order/member/members/freight/orderRule/memberRule/integralRuleLog
├── straightDown/    → 5 种:itemActivity/timeLimit/newActivities/log/common
├── formManage/      → 动态表单搭建(DynamicFormTool),8 种表单项
├── crowdfunding/    → 众筹管理
├── landingPage/     → 落地页搭建(LandingPageTool),30+ 组件
├── newActivities/   → 新品活动(videoActivity/reviewActivity/smallrigAwards)
├── inviteMember/    → 邀请有礼
├── luckyDraw/       → 抽奖
├── markDown/        → 降价
├── matchList/       → 赛事
├── modalManagement/ → 弹窗管理
├── packageManage/   → 套餐管理
├── packagedGoods/   → 打包商品
├── pointsPurchase/  → 积分兑换
├── redirectionManage/ → 跳转管理
├── tradeInForNew/   → 以旧换新
└── affiliate/       → 分销

核心痛点:多渠道 × 多币种 × 重复字段。 以优惠券为例,创建一张商品券需要填:

字段 复杂度来源
所属渠道 多站点(US/UK/EU/DE/JP/KR/AU),每个渠道币种不同
优惠券类型 满减券 vs 折扣券
门槛金额 每个渠道币种不同(USD/EUR/GBP/JPY)
优惠金额/折扣 币种换算
活动时间 站点时间 + UTC+8 双时间
商品使用范围 全部/指定商品/指定分类

运营人员要在 7 个渠道各创建一张券,每张券手动换算币种 → 10-15 分钟。

🔴 模板配置工具(LandingPageTool)—— 30+ 组件

LandingPageTool/
├── leftAside/treeComponents/  → 左侧:组件树
├── rightAside/attr/           → 右侧:属性面板(每个组件不同配置)
│   └── components/            → SelectProduct/SelectCoupon/SelectSku/SelectForm...
├── Header/                    → 顶部:保存/发布/预览
├── packages/                  → 30+ 种可拖拽组件
│   ├── lpProductCard/lpProductList/lpProductItem  → 商品展示
│   ├── lpCountdown/lpPrizeDraw/lpCoupon           → 营销组件
│   ├── lpSwiperItem/lpNavigation/lpRichText       → 布局组件
│   ├── lpDialog/lpSideBar/lpSubscribe             → 交互组件
│   └── lpFireworksVideo/lpMarquee/lpBlog...       → 特效/内容
└── types/template.ts          → 组件模板类型定义

核心痛点:新人面对 30+ 组件 + 每种组件不同的属性面板,学习曲线陡峭。搭一个促销页 30-60 分钟。

🔴 表单管理(formManage)—— DynamicFormTool

DynamicFormTool/
├── formItems/
│   ├── country.vue    → 国家选择
│   ├── email.vue      → 邮箱
│   ├── file.vue       → 文件上传
│   ├── image.vue      → 图片上传
│   ├── input.vue      → 文本输入
│   ├── select.vue     → 下拉选择
│   └── textarea.vue   → 多行文本
└── components/common/
    ├── inlinePropsPanel.vue  → 属性面板
    └── operation.vue         → 操作按钮

痛点同 LandingPageTool:多渠道搭建 + 逐字段配置。

🟡 模板系统的两个维度

维度 当前实现 存储方式
组件级模板 SaveTemplateModal → 命名 + 置顶 → 拖入复用 后端 APImultilingualApi.getActivityTemplateCollectionPage 等)
页面级模板 目前靠"复制"已有页面,无正式的"存为页面模板"流程 暂无

关键发现:componentTemplateStore 是后端接口存储(非前端 localStorage)。 所有 CRUD 操作都调后端 API:getActivityTemplateCollectionPageissueActivityTemplateCollectionupActivityTemplateCollectiondeleteActivityTemplateCollection。支持服务端分页(totalhasMorecurrentPagepageSize)。

这对 Agent 设计是好消息——Agent 可以直接通过 Tool 查询可用模板、基于模板创建内容。


第三层:Agent 适配度评分

评分标准:操作可描述性 × 重复性 × 参数结构化 × 错误可容忍

⭐⭐⭐⭐⭐ 极高适配

模块 操作描述示例 可描述 重复性 参数结构化 容错 总分
marketing "在 US/UK/EU 创建满 100 减 20 的商品券,9.1-9.15" 5 5 5 4 24
landingPage "搭一个双十一促销页:轮播图+商品列表+优惠券" 5 4 4 5 23

⭐⭐⭐⭐ 高适配

模块 操作描述示例 总分
dataExport "导出上月 US 站订单数据,按 SKU 汇总" 21
communityManage "审核过去 24h 的帖子,标出含敏感词的" 20
cms/staticPage "创建一篇新品发布静态页,包含产品卡片和视频" 19
order "查最近 3 天待发货的 US 订单,按金额排序" 19

⭐⭐⭐ 中等适配

模块 说明
goods 商品创建涉及图片/多语言/规格,参数太多;但"查商品"很适合
member 列表查询/筛选适合,具体操作涉及隐私
search AI 搜索配置管理、热词管理适合 Agent 调优
dashboard "今天 US 站 GMV 多少?"适合,但更多是查询而非操作

⭐⭐ 低适配

模块 说明
system 基础设施配置(仓库/物流/汇率),改错后果大
sys 登录/权限/错误日志,不适合 Agent 操作
seoManagement sitemap 管理,频率低
interaction FAQ/问卷/联系我们,配置为主

两个核心 Agent 场景的详细方案

场景 1:营销活动创建 Agent

子场景:优惠券 + 规则活动 + 直降活动 + 表单管理,共 4 类。

👤 "帮我在 US/UK/EU 三个渠道创建满 100 减 20 的商品券,
    时间 9.1-9.15,适用所有兔笼类商品"

🤖 Agent 执行链:
  1. 查汇率:USD 100 → EUR ~92 → GBP ~78
  2. 查商品分类 ID:兔笼 → category_id
  3. 批量创建:
     - US 券:满 $100 减 $20
     - UK 券:满 £78 减 £16
     - EU 券:满 €92 减 €18
  4. 返回汇总:"3 个渠道已创建,汇总如下:..."

当前 10-15 分钟 → Agent 30 秒。

场景 2:模板配置 Agent

子场景:组件级模板复用 + 页面级智能搭建。

👤 "帮我搭一个新品发布页:顶部轮播图放新品图,下面商品卡片,
    再下面倒计时+优惠券,底部品牌故事"

🤖 Agent 执行链:
  1. 解析结构:轮播图 → 商品卡片 → 倒计时 → 优惠券 → 富文本
  2. 查询组件模板库 → 匹配最佳预设模板
  3. 调用 API 创建页面结构,填充组件属性
  4. 返回:"页面已搭建,预览链接:..."

当前 30-60 分钟 → Agent 1-2 分钟。


💡 关键认知

1. 后台 Agent 化的价值公式

价值 = 操作频次 × 单次耗时 × 渠道数 × 币种复杂度

营销活动创建在这个公式下得分最高:高频 × 高耗时 × 多渠道 × 多币种。

2. 搭建工具的 Agent 化本质是"描述→JSON"

LandingPageTool 和 DynamicFormTool 本质上都是"把 JSON 配置渲染成页面/表单"。Agent 的价值在于:把自然语言描述翻译成 JSON 配置,跳过拖拽+属性面板的手工操作。

3. 模板系统是 Agent 的加速器

componentTemplateStore 是后端 API,意味着 Agent 可以:

4. 不是所有模块都适合 Agent 化

系统配置(仓库/物流/汇率)改错后果大,不适合 Agent 直接操作。Agent 最适合的是"高频重复 + 参数结构化 + 容错度高"的场景。


❓ 疑问与解答

Q1:componentTemplateStore 是前端本地存储还是后端接口?

答:后端接口。 所有 CRUD 操作(加载/创建/更新/删除)都调 multilingualApi 的后端 API,支持服务端分页。模板数据跨用户共享。

Q2:页面级模板是否存在?

答:目前只有"复制"已有页面,没有正式的"存为页面模板"→"从模板创建"流程。 已发布页面可作为参考,但需要手动复制后修改内容。

Q3:formManage 的痛点是否和 coupon 一样?

答:是。 formManage 也是多渠道搭建 + 逐字段配置。表单结构相同但语言/渠道不同时,需要重复搭建。应纳入营销活动创建 Agent 的子场景。


📤 产出


🧪 Day 8 自测题

第 1 题:模块分类

后台 Admin 27 个模块可以分成 6 大类。以下哪个分类是错误的?

A. 核心业务:goods, order, member
B. 营销活动:marketing, point, popularize
C. 内容管理:cms, communityManage, discoverManage
D. 数据与分析:dashboard, dataExport, goods

点击看答案

D。 goods 属于核心业务类,不是数据与分析类。数据与分析类包含 dashboard、dataExport、search。


第 2 题:营销活动创建的痛点

以下哪个不是营销活动创建的核心痛点?

A. 多渠道(US/UK/EU/DE/JP/KR/AU)需要分别创建
B. 各渠道币种不同,需要手动换算金额
C. 每个活动的优惠券码需要人工随机生成
D. 同一个活动要在 7 个渠道重复填写相同字段

点击看答案

C。 优惠券码由系统自动生成(generateCouponCodes API),不需要人工随机生成。A、B、D 都是真实痛点。


第 3 题:LandingPageTool 架构

LandingPageTool 是一个完整的拖拽式页面搭建器。以下关于它的架构描述,哪个是正确的?

A. 左侧是属性面板,右侧是组件树,中间是预览区
B. 左侧是组件树,右侧是属性面板,每个组件的属性面板配置相同
C. 左侧是组件树,右侧是属性面板,每个组件有专属的配置项
D. LandingPageTool 只支持 PC 端页面搭建

点击看答案

C。 左侧组件树(30+ 种组件),右侧属性面板,每个组件有专属配置(如商品卡片需要选 SKU,倒计时需要设结束时间)。B 错在"每个组件属性面板相同",D 错在支持 PC 和 Mobile 两端。


第 4 题:componentTemplateStore

关于 componentTemplateStore 的存储方式,以下哪个描述是正确的?

A. 前端 localStorage 存储,刷新浏览器后数据丢失
B. 前端 IndexedDB 存储,支持离线使用
C. 后端 API 存储,所有 CRUD 操作调 multilingualApi 接口
D. 混合存储:模板元数据在后端,模板内容在前端

点击看答案

C。 所有操作(加载/创建/更新/删除)都调后端 API(getActivityTemplateCollectionPageissueActivityTemplateCollectionupActivityTemplateCollectiondeleteActivityTemplateCollection),支持服务端分页。模板数据跨用户共享。


第 5 题:Agent 适配度最高场景

根据今天的分析,后台 Agent 化价值最高的两个场景是什么?

A. 系统配置(仓库/物流)和 SEO 管理
B. 营销活动创建和模板配置工具
C. 会员管理和数据看板
D. 权限管理和错误日志

点击看答案

B。 营销活动创建(优惠券/规则/直降/表单,多渠道×多币种×重复字段)和模板配置工具(LandingPageTool 30+ 组件,学习曲线陡峭)是价值最高的两个场景。A 和 D 改错后果大,C 更多是查询而非操作。


第 6 题:场景应用题

如果要把 LandingPageTool 的搭建过程 Agent 化,以下哪个 Tool 设计是最合理的第一步?

A. 让 Agent 直接生成完整的 HTML/CSS 代码替代 LandingPageTool
B. 让 Agent 查询已有的组件模板库,匹配最接近的模板,然后基于模板创建页面
C. 让 Agent 训练一个新模型来替代人工拖拽
D. 放弃 LandingPageTool,让运营人员直接写 JSON 配置

点击看答案

B。 componentTemplateStore 是后端 API,Agent 可以直接查询模板库、匹配最接近的、基于模板创建。这比从零生成 JSON 更可靠(减少幻觉)。A 过于激进(LandingPageTool 已有成熟的渲染引擎),C 成本过高,D 体验太差。


⏭️ 完成后:更新 当前进度