Magent Docs
V1.0.1

业务概念设计

业务概念与数据模型快速参考,面向业务人员

业务概念设计 (Business Concept Design)

📊 业务概念快速参考(面向业务人员)

本章节为业务人员提供数据模型的快速概览,以表格形式呈现各层概念、子模型及具体业务场景。

一、业务流程分层架构

层级层级名称核心实体核心问题业务价值
L1需求层 (Request)UserRequirementInput做什么?对谁做?用什么资源?将用户模糊需求结构化为可执行输入
L2策略层 (Strategy)Campaign怎么做?谁负责?什么目标?承接需求,规划具体营销活动
L3任务层 (Task)Task具体发什么?发到哪?何时发?拆解活动为可独立执行的工作单元
L4执行层 (Execution)ActionTodo调用 API、生成内容、发布驱动外部平台交互,回填结果
L5反馈层 (Feedback)PerformanceReport效果如何?下一步怎么优化?回收数据生成洞察,形成优化闭环
基座品牌 DNABrandDNA品牌是谁?核心资产是什么?所有内容与策略的"单一事实来源"

二、各层子模型概念说明

🟦 需求层 (UserRequirementInput) 子模型

子模型字段核心问题业务场景
Request (元信息)title; startAt / endAt; dueDate; assigneeId; rawQuery.text; rawQuery.files[]做什么?谁负责?何时生效?设定活动名称与时间窗口,指派负责人并自动提醒截止日期;支持自然语言输入,系统自动解析并补全结构化字段。
Target (目标与受众)goal.goal; creativeConcept.conceptText; event.eventName; personas为什么做?对谁做?要表达什么?选择营销目标自动调整渠道权重;设定创意概念作为 AI 生成约束;关联事件自动对齐时间;添加画像自动适配语气与 CTA。
Source (资源与商业输入)budget.amount; products[]; offerDiscount; collections[]; mediaKit有什么资源可用?推广什么产品?提供什么激励?设定预算自动拆分并预警超支;关联产品自动植入内容;启用折扣码统一注入并追踪转化;关联商品集合与模板自动生成素材。
Execution (执行计划)counts (distributionCounts); catalogVersion做哪些渠道?每种渠道做多少?设定各渠道任务数量,系统批量创建并分配发布时间;按渠道分组展示进度;记录配置版本并提示更新。

🟩 策略层 (Campaign) 子模型

子模型字段核心问题业务场景
Basic Info (活动定义)name; type; startAt / endAt这是什么活动?活动类型是什么?持续多久?1. 创建活动「New Year Launch」,类型选「promotion」,系统自动推荐适配模板。 2. 设定活动周期,系统校验子任务时间需落在此窗口内,超出则警告。 3. 选择「event」类型,自动启用签到、直播等扩展模块,与纯内容活动区分。
Management (执行治理)status; dueDate; assigneeId; budget谁负责?进度如何?资源(预算)是否充足?1. 活动状态从 todo 变更为 in_progress,看板实时同步,系统记录状态变更耗时。 2. 指派负责人并设截止日,系统在到期前推送多轮提醒,并汇总在团队日报。 3. 设定预算金额,系统自动对比子任务预估花费,实时展示「已分配/剩余/超支」三态进度。
Plan (营销规划)event.eventName; goal.goal; offer; personas[]; channels[]核心利益点是什么?对谁说?在哪说?1. 关联营销事件「New Year Week」,系统自动将任务排期对齐事件日期并在日历展示。 2. 选择目标「获取新客」,系统调整 KPI 仪表盘,并在复盘报告中对比目标达成率。 3. 设置优惠码「NY25OFF」,所有生成的任务内容自动植入该码,落地页自动预填。 4. 绑定画像与渠道,系统根据画像活跃度偏好(如 X/LinkedIn)推荐渠道权重。

🟨 任务层 (Task) 子模型

子模型字段核心问题业务场景
Identity (任务身份)taskType; title; category; channel; funnelStage这是什么任务?属于哪个渠道和漏斗阶段?1. 创建「social_publish」任务,系统自动匹配执行引擎并调用对应平台 API。 2. 设定分类为「social」,看板视图按分类自动分栏,便于跨渠道管理。 3. 选定「conversion」阶段,系统在仪表盘汇总转化层任务产出与效果占比。
Delivery (分发排期)schedule.mode; publishAt; destinations; count何时发布?发到哪个账号?分发多少次?1. 设定定时发布模式,系统将其加入队列,到点自动执行并记录状态。 2. 指定 TikTok 官方号为目的地,系统校验授权状态,未连接则禁用发布。 3. 设定分发数为 3,系统自动复制内容并适配各平台(如 TikTok vs Reels)规格。
Content (内容生产)caption; body; creativeConcept; context; assets; outputSpec表达什么创意?使用什么素材?输出规格是什么?1. 输入创意概念「快节奏 + 强 CTA」,AI 生成时将其作为核心约束确保风格一致。 2. 添加参考链接或视频,AI 提取背景知识并参考视频风格指导内容生成。 3. 关联素材库文件,发布时自动作为附件上传;设定输出语言,AI 强制执行。
Workflow (流程协作)status; priority; dueDate; assigneeId; needsApproval谁来做?当前到哪一步?是否需要审批?1. 任务状态从 todo 流转至 published,失败进入 failed,看板分栏展示。 2. 设高优先级并指派设计师,系统在看板高亮显示,临期推送紧急提醒。 3. 启用审批流程,主管审核通过后方可进入发布队列,否则标记驳回并记录意见。
Integrations (连接)required[]; bindings[]执行前需绑定哪些平台?连接是否正常?1. 检查 TikTok 绑定状态,若缺失则禁用发布按钮并引导用户前往集成页面。 2. 检测到 Token 过期导致状态变「error」,系统阻止发布并推送重新授权提醒。 3. 校验多平台连接一致性,任一平台缺失则整体阻塞,确保同步发布的可靠性。
Commerce (商业绑定)discountEnabled; offer; products[]; collections[]关联什么优惠?推广哪些产品或集合?1. 启用折扣并绑定优惠码,内容生成时自动在 CTA 区域植入,落地页自动预填。 2. 关联具体产品,内容中自动提及产品名,广告投放时使用产品 Feed 实现直达。 3. 关联商品集合,针对轮播/画册类内容自动拉取集合内图片,减少人工选图工作量。
ActionTodo (执行单元)taskType; inputs; result具体执行什么原子指令?结果与消耗如何?1. 执行「内容生成」操作,引擎调用 API 并返回结果写入 Task 对应的 Body 字段。 2. 执行「社媒发布」操作,成功后回填平台 ID,失败则记录错误消息与 TraceID。 3. 记录任务的积分消耗,用于业务部门进行成本核算与 ROI 分析。

🟧 反馈层 (PerformanceReport) 子模型

子模型字段核心问题业务场景
Timeframe (时间口径)startAt / endAt; comparison统计的时间窗口是什么?对比上一周期还是自定义基准?1. 设定统计周期为「新年活动周」,所有渠道数据基于此窗口聚合,确保口径一致。 2. 对比基准选「上一周期」,系统自动计算增长率卡片(如「触达 +15%」)。 3. 选择「自定义」对比去年同期,用于年度同比分析,评估 YoY 增长趋势。
Output (执行产出)postsCount; status; channels (distribution)本周期产出了多少?执行状态如何?各渠道占比如何?1. 仪表盘顶部展示「产出卡片」,显示本期发布 12 条内容,完成率达 80%。 2. 按「已发布」状态过滤报告,便于诊断尚未发布的活动对整体数据的延迟影响。 3. 自动生成各渠道产出占比饼图(如 Instagram 50%),评估执行是否按计划均衡。
Channels & Metrics (渠道表现)instagram / emails; metaAds / blog; reach / spend; interactions / ctr各渠道核心指标表现如何?ROI 是否达标?是否有优化点?1. Instagram 计算互动率为 4.5%,与行业基准对比,自动生成「表现良好」洞察。 2. 邮件打开率高但点击率低,系统触发建议「优化邮件内 CTA 按钮文案」。 3. 计算 Meta Ads 的 CPC 为 $5.96,若高于目标则预警「建议优化素材或定向」。 4. 统计博客停留时长,若低于 30s 则提示「内容质量或相关性待提升,用户跳出快」。

🟪 品牌 DNA (BrandDNA) 子模型

子模型字段核心问题业务场景
Identity (身份与基础)name; description; industries; logo; salesDistribution品牌是谁?做什么生意?1) 统一品牌信息作为事实源。2) 语言/语气约束生成输出。3) Logo 用于水印与一致性。
Audience (受众与市场)target; demographics; needsDiscovery目标受众?偏好痛点?1) 分群驱动文案语气与 CTA。2) 地域指导投放定向。3) 痛点库驱动选题优先级。
Core (品牌内核)usp; mission; values; emotionalBenefits独特卖点?意义价值观?1) USP 贯穿产品表达。2) 使命价值观用于品牌故事。3) 证据点提升可信度。
Expression (品牌表达)personalityTraits品牌语气性格?1) 性格标签约束 AI 语气。2) 控制 emoji 与口语化程度。
Visual (视觉识别)styleSliders; colorPalette; fonts视觉风格规范?1) 风格滑杆指导图片生成。2) 主色/字体确保跨渠道一致。
Products (产品与商业)overview; integrations产品与电商集成?1) 畅销品优先植入内容。2) 电商同步自动生成购买链接。
SEO & CompetitorsseedKeywords; competitors关键词与竞品?1) 种子词指导 SEO 选题。2) 竞品监控提供差异化参考。
Content Strategyguardrails; pillars内容红线与支柱?1) 红线用于合规检测。2) 支柱统计诊断内容偏科。
Events (营销日历)marketingEvents营销节点日历?1) 事件提醒创建 Campaign。2) 预置节点一键启用排期。

业务全景视图 (Business Overview)

以下图表展示了业务流程的层级流转、各层核心概念维度以及底层支撑关系。

┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                       业务全景视图 (Business Overview)                            │
├──────────────────────┬──────────────────────┬──────────────────────┬─────────────────────────────┤
│      1. 需求层       │       2. 策略层       │       3. 任务层       │      4. 执行 & 反馈层       │
│  (Request Layer)     │   (Strategy Layer)   │     (Task Layer)     │   (Exec & Feedback Layer)   │
├──────────────────────┼──────────────────────┼──────────────────────┼─────────────────────────────┤
│                      │                      │                      │                             │
│ [Request] 元信息      │ [Basic] 活动定义      │ [Identity] 任务身份   │ [ActionTodo] 执行单元        │
│  (Title/Status/Due)  │  (Name/Type/Time)    │  (Type/Category)     │  (Generate/Publish/Outreach)│
│                      │                      │                      │                             │
│ [Target] 目标受众     │ [Management] 治理     │ [Delivery] 分发排期   │ [Execution] 执行结果        │
│  (Goal/Persona)      │  (Status/Budget)     │  (Channel/Platform)  │  (Result/Status)            │
│                      │                      │                      │                             │
│ [Source] 资源输入     │ [Plan] 营销规划       │ [Content] 内容生产    │ [Feedback] 效果反馈          │
│  (Budget/Offer)      │  (Goal/Offer/Chan)   │  (Body/Assets/Spec)  │  (Metrics/Insights)         │
│                      │                      │                      │                             │
│ [Execution] 计划     │                      │ [Workflow] 流程协作   │                             │
│  (Dist.Counts)       │                      │  (Assignee/Review)   │                             │
│                      │                      │                      │                             │
└──────────┬───────────┴──────────┬───────────┴──────────┬───────────┴──────────────┬──────────────┘
           │                      │                      │                          │
           ▼                      ▼                      ▼                          ▼
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                   底层支撑 (Foundation)                                           │
│  [Brand DNA] 品牌身份 • [Shared] 通用实体 (Persona/Goal) • [Base] 基础类型 (Time/Money)           │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘

层间关系与数据流转 (Layer Relationships & Data Flow)

本节描述各层之间的动态交互与核心数据流动逻辑。

       User (用户/系统)

         │ 1. 输入需求 (Raw Query + Context)

┌──────────────────────────────────────────────┐
│             1. 需求层 (Request)               │
│  • 解析意图 (Intent)                          │
│  • 注入资源 (Source)                          │
└──────────────────────┬───────────────────────┘

                       │ 2. 转化为 (Map to Campaign)

┌──────────────────────────────────────────────┐
│             2. 策略层 (Strategy)              │
│  • 规划活动 (Plan)                            │
│  • 治理资源 (Management)                      │
└──────────────────────┬───────────────────────┘

                       │ 3. 拆解为 (Decompose to Tasks)

┌──────────────────────────────────────────────┐
│             3. 任务层 (Task)                  │
│  • 任务编排 (Orchestration)                   │
│  • 上下文传递 (Context Passing)                │
└──────────┬─────────────────────────▲─────────┘
           │                         │
           │ 4. 生成执行单元           │ 6. 回填结果
           │ (ActionTodo)            │ (Result/Status)
           ▼                         │
┌──────────────────────┐    ┌──────────────────┐
│ 4. 执行层 (Execution) │    │  外部平台 (API)   │
│  • 驱动执行 (Drive)   │───►│ (OpenAI, Meta...)│
└──────────┬───────────┘    └──────────────────┘

           │ 7. 聚合数据 (Aggregate Metrics)

┌──────────────────────────────────────────────┐
│             5. 反馈层 (Feedback)              │
│  • 指标快照 (Performance Snapshot)            │
│  • 洞察生成 (Insights)                        │
└──────────┬───────────────────────────────────┘

           │ 8 & 9. 闭环优化 (Optimization Loop)
           └──────────────────────────────────────► 回到 需求/策略层

1. 需求层 → 策略层 (Intent Resolution & Mapping)

  • 关系:解析与映射。
  • 流转逻辑
    • 意图解析:将用户的自然语言需求 (raw_query) 结合 Target(目标)解析为结构化的 Campaign.BasicCampaign.Plan
    • 资源注入:将需求层的 Source(预算、商品、折扣)注入到策略层的 Management(预算治理)与 Plan(Offer/Product Context)中。
  • 核心动作UserRequirement -> Create Campaign

2. 策略层 → 任务层 (Decomposition & Orchestration)

  • 关系:拆解与编排。
  • 流转逻辑
    • 任务拆解:根据 Campaign.Plan 中的渠道选择 (Channels) 和营销目标,拆解为具体的任务列表 (Task List)。例如,选择了 "Social" 渠道可能拆解为 "Instagram Post Task" 和 "TikTok Video Task"。
    • 上下文传递:将 Campaign 级别的 PersonasOfferTheme 下发到每个 Task 的 Content 上下文中,确保执行一致性。
  • 核心动作Campaign Plan -> Generate Tasks

3. 任务层 → 执行层 (Action & Execution)

  • 关系:驱动与回填。
  • 流转逻辑
    • 生成执行单元:Task 转换为标准化的 ActionTodo(如 content_generate, social_publish)。
    • 执行驱动:执行引擎消费 ActionTodo,调用外部 API(如 OpenAI, Meta API)。
    • 状态同步:执行结果 (Result) 和消耗 (Credits) 回填至 Task 实体,更新 Task 状态 (todo -> done/failed)。
  • 核心动作Task -> Execute Todo -> Update Task

4. 执行层 → 反馈层 (Aggregation & Insight)

  • 关系:聚合与分析。
  • 流转逻辑
    • 指标快照:定期或按事件触发,从各平台拉取执行后的 Performance Data(如 Views, Clicks)。
    • 标准化聚合:将不同平台的异构数据归一化为标准 Metrics(如 Reach, Engagement),生成 PerformanceReport
  • 核心动作Execution Data -> Create PerformanceReport

5. 反馈层 → 需求/策略层 (Optimization Loop)

  • 关系:闭环与反哺。
  • 流转逻辑
    • 洞察生成:基于 Report 数据生成文本洞察("Instagram 互动率下降 10%")。
    • 策略调整:建议调整下一轮 Campaign 的 TargetBudget 分配,形成优化闭环。

On this page