提交初始文档

agent-center.md

@@ -0,0 +1,65 @@
+# agent-center（Dify 智能体中心）功能点划分（开发指导）
+
+> 目标：承载智能决策与内容生成，不处理业务流程与渠道接入。
+
+---
+
+## 0. Dify 内部能力 vs Dify 外部能力
+
+### Dify 内部完成
+- Prompt 模板管理（版本/灰度/回滚）
+- Workflow 编排管理（多步任务）
+- FAQ / 模板 / LLM 路由策略
+- 多模型路由与降级（依赖 Dify 配置）
+- 输出结构化结果（Workflow 输出）
+- 调用日志与基础统计
+
+### Dify 外部需要补充
+- 业务侧输入标准化（渠道消息 → 统一结构）
+- 配置隔离（不同业务线/租户）
+- 成本控制策略（配额、超额限制）
+- 业务埋点统计（与业务指标结合）
+- 安全审计与内容风控（可选）
+
+---
+
+## 1. Prompt / Workflow 管理
+- Prompt 模板管理（版本/灰度/回滚）
+- Workflow 编排管理（多步任务）
+- 模板分类（标题/文案/脚本/话术）
+
+---
+
+## 2. 回复策略决策
+- FAQ 命中优先
+- 话术模板命中
+- LLM 生成兜底
+- 风险内容过滤与拒答策略
+
+---
+
+## 3. 模型治理与路由
+- 多模型路由（成本/效果/时延）
+- 失败降级（备用模型/重试）
+- 调用限额与成本控制
+
+---
+
+## 4. 输入输出标准化
+- 统一输入结构（渠道/用户/上下文）
+- 输出结构化结果（正文/建议动作/标签）
+- 结果置信度/命中来源标记
+
+---
+
+## 5. 监控与评估
+- 调用日志
+- 命中率统计（FAQ/模板/LLM）
+- 回复效果指标（延迟/通过率）
+
+---
+
+## 6. 不包含的职责（边界说明）
+- 不做业务编排
+- 不做渠道接入
+- 不直接落库业务数据（由编排层/内容中心处理）

content-center.md

@@ -0,0 +1,57 @@
+# content-center（内容资产中心）功能点划分（开发指导）
+
+> 目标：统一管理内容与素材资产，负责版本、权限、检索与状态回写，不涉及生成与投放编排。
+
+---
+
+## 1. 内容资产管理（核心）
+- 内容 CRUD（标题/文案/脚本/图文）
+- 内容类型管理（草稿/成品/模板/复刻版本）
+- 内容状态机（草稿 → 成品 → 已发布 → 归档）
+
+---
+
+## 2. 素材管理
+- 图片/视频/附件上传与存储
+- 素材标签与分类
+- 素材关联内容（内容-素材绑定）
+
+---
+
+## 3. 版本与历史
+- 版本号管理
+- 版本回滚
+- 生成来源记录（手动/AI/复刻）
+
+---
+
+## 4. 权限与隔离
+- 多角色权限控制（运营/销售/管理员）
+- 成交素材库子集（权限隔离）
+- 部门/项目隔离（可选）
+
+---
+
+## 5. 检索与筛选
+- 关键词检索
+- 标签筛选
+- 时间/状态过滤
+
+---
+
+## 6. 发布状态回写
+- 接收 `delivery-connector` 的发布结果
+- 更新内容状态（发布成功/失败/下架）
+- 记录发布渠道与时间
+
+---
+
+## 7. 对外依赖调用清单
+- 无（对外仅提供 API）
+
+---
+
+## 8. 不包含的职责（边界说明）
+- 不做内容生成（由 `agent-center` 负责）
+- 不做投放编排（由 `orchestration-service` 负责）
+- 不做渠道接入（由 `delivery-connector` 负责）

delivery-connector-douyin.md

@@ -0,0 +1,52 @@
+# delivery-connector-douyin（抖音连接器）功能点划分（开发指导）
+
+> 目标：负责抖音渠道的接入、授权、消息/评论回调、发布与数据回流，不做业务编排与 AI 生成。
+
+---
+
+## 1. 账号授权与管理
+- 账号 OAuth 授权流程
+- Token 刷新与失效处理
+- 账号状态与可用性监控
+
+---
+
+## 2. 回调接入与事件标准化
+- 评论/私信/互动回调接收
+- 回调鉴权与签名校验
+- 事件标准化输出（统一消息结构）
+- 回调失败重试
+
+---
+
+## 3. 内容发布能力
+- 发布接口封装（视频/图文/评论回复）
+- 发布结果回写
+- 发布失败原因记录
+
+---
+
+## 4. 数据回流采集
+- 播放/点赞/评论/转发等指标拉取
+- 数据拉取频率控制
+- 回流数据标准化并推送编排层
+
+---
+
+## 5. 事件推送机制
+- 事件入消息队列
+- 向 `orchestration-service` 推送标准事件
+- 支持事件重放与补偿
+
+---
+
+## 6. 对外依赖调用清单
+- 抖音开放平台 API
+- 消息队列（事件投递）
+
+---
+
+## 7. 不包含的职责（边界说明）
+- 不做业务编排
+- 不做 AI 决策与生成
+- 不负责内容存储（交给 `content-center`）

gateway-bff.md

@@ -0,0 +1,76 @@
+# gateway-bff 功能点划分（开发指导）
+
+> 目标：统一入口 + 轻量适配，不承载业务编排
+
+---
+
+## 1. 访问入口与路由
+- 统一 API 入口（REST/GraphQL/WS 任选）
+- 路由转发到内部服务（`orchestration-service` / `content-center` / `delivery-connector-douyin`）
+- 支持服务发现或静态路由配置
+- 支持灰度路由（可选）
+
+---
+
+## 2. 认证与授权
+- 登录与会话管理（JWT/Session）
+- 角色权限（管理员/运营/销售/客服）
+- API 权限校验（RBAC）
+- 接口级访问控制（按功能/模块）
+
+---
+
+## 3. 请求参数校验与标准化
+- 参数格式校验
+- 字段清洗/默认值填充
+- 统一错误码与错误结构
+
+---
+
+## 4. 字段裁剪与响应适配
+- 对前端屏蔽后端细节字段
+- 统一字段命名规范（camelCase 或 snake_case）
+- 支持版本化响应（v1/v2）
+
+---
+
+## 5. 统一日志与审计
+- 请求日志（用户/时间/接口/耗时）
+- 操作审计（发布/删除/配置变更）
+- 失败告警埋点
+
+---
+
+## 6. 限流与防护
+- 基础限流（用户级/接口级）
+- 防重放/签名校验（对外开放接口时）
+- 黑白名单（IP/账号）
+
+---
+
+## 7. 渠道配置入口（管理后台）
+- 渠道账号绑定/解绑
+- 回调地址配置
+- 渠道启用/停用
+- 自动回复开关
+- 权限控制（谁可以配置哪些渠道）
+
+---
+
+## 8. 会话入口（H5 / Web）
+- H5 对话接口入口（消息发送/拉取）
+- 会话 ID 创建/绑定
+- 消息上报与回执
+
+---
+
+## 9. 版本与兼容策略
+- API 版本管理（/v1 /v2）
+- 兼容旧客户端的字段映射
+
+---
+
+## 10. 不包含的职责（边界说明）
+- 不做业务编排逻辑
+- 不做 AI 决策与生成
+- 不做跨服务数据聚合（仅字段适配）

orchestration-service.md

@@ -0,0 +1,67 @@
+# orchestration-service 功能点划分（开发指导）
+
+> 目标：承载获客/成交/复盘的业务流程编排与状态管理，不做 AI 决策与渠道适配细节。
+
+---
+
+## 1. 流程编排能力
+- 业务流程编排（获客、成交、复盘）
+- 同步链路编排（前端触发 → 多服务调用 → 返回）
+- 异步链路编排（事件触发 → 条件判断 → 后续动作）
+- 流程状态机（草稿/成品/已发布/复刻中）
+
+---
+
+## 2. 会话与接管控制
+- 会话生命周期管理（创建/关闭/超时）
+- 自动/人工模式切换
+- 人工接管与交还逻辑
+- 会话上下文聚合（用户、渠道、内容）
+
+---
+
+## 3. 事件驱动与规则触发
+- 消费渠道事件（如爆款、评论、私信）
+- 规则判断（阈值触发、时间触发）
+- 触发后续动作（复刻、跟进、提醒）
+- 事件标准化与审计日志
+
+---
+
+## 4. 轻量 CDP 与画像（P0 内嵌）
+- 客户 ID 统一
+- 基础标签与意向评分
+- 互动行为记录
+- 评分查询接口
+
+> 注：P1 可拆分为独立 `cdp-service`。
+
+---
+
+## 5. 轻量调度能力（P0 内嵌）
+- 定时任务调度（发布/跟进）
+- 延迟任务执行（排期）
+- 失败重试与补偿
+
+> 注：P1 可拆分为独立 `workflow-engine`。
+
+---
+
+## 6. 业务聚合与 API 提供
+- 为前端提供业务 API（内容生成、发布、复盘）
+- 聚合内容/投放/客户数据形成业务视图
+- 统一错误码与业务校验
+
+---
+
+## 7. 对外依赖调用清单
+- `agent-center`：内容生成/回复生成
+- `content-center`：内容/素材存储与状态
+- `delivery-connector-douyin`：发布/回流/渠道事件
+
+---
+
+## 8. 不包含的职责（边界说明）
+- 不做模型选择与 Prompt 决策
+- 不做渠道接入细节（由连接器负责）
+- 不负责服务发现与网关能力

services-with-nacos.md

@@ -0,0 +1,99 @@
+# 基于 Nacos 的服务拆分与职责（5 服务版本）
+
+> 目标：用 Nacos 承载服务发现与配置中心，业务服务保持原子正交。
+
+---
+
+## 基础设施（Nacos 承载）
+
+### Nacos 负责的能力
+- 服务注册与发现
+- 配置中心（动态路由、开关、限流阈值）
+- 健康检查与实例管理
+
+> 说明：服务治理能力下沉到 Nacos，业务服务只关注自身职责。
+
+---
+
+## 服务拆分与每个服务需要完成的行为
+
+### 1) `gateway-bff`（统一接入层）
+**核心行为**
+- 作为 Spring Cloud Gateway 入口（路由转发由 Nacos 动态配置）
+- 鉴权与权限校验（JWT/Session + RBAC）
+- 限流与黑白名单（结合 Nacos 配置）
+- 请求参数校验/清洗
+- 返回结构统一与字段裁剪
+
+**不做**
+- 不做业务编排
+- 不做 AI 决策
+
+---
+
+### 2) `orchestration-service`（业务编排层）
+**核心行为**
+- 业务流程编排（获客/成交/复盘）
+- 会话状态控制（自动/人工）
+- 事件消费与触发（爆款复刻等）
+- 轻量规则引擎（仅负责流程开关与触发条件）
+- P0 内嵌轻量 CDP/调度模块
+
+**不做**
+- 不直接调用模型供应商
+- 不承担渠道适配细节
+
+---
+
+### 3) `agent-center`（Dify 智能体中心）
+**核心行为**
+- Prompt/Workflow 管理
+- AI 回复策略决策（FAQ/模板/LLM）
+- 模型路由与降级
+- 输出结果标准化（仅输出，不落库）
+
+**不做**
+- 不处理业务流程
+- 不管理外部渠道
+
+---
+
+### 4) `content-center`（内容资产中心）
+**核心行为**
+- 内容/素材 CRUD
+- 版本管理与检索
+- 成交素材库子集管理（权限隔离）
+- 发布状态与结果回写
+
+**不做**
+- 不调用模型
+- 不做渠道对接
+
+---
+
+### 5) `delivery-connector-douyin`（抖音连接器）
+**核心行为**
+- 抖音账号授权与管理
+- 评论/私信/发布的回调接入
+- 内容发布与回填
+- 数据回流采集（播放/点赞/评论/转发）
+- 事件标准化后推送给编排层
+
+**不做**
+- 不做 AI 决策
+- 不做业务编排
+
+---
+
+## Nacos 与服务的协作方式
+
+- `gateway-bff` 通过 Nacos 获取路由与限流配置
+- `orchestration-service`/`content-center`/`delivery-connector` 等通过 Nacos 进行服务发现
+- 配置变更（如渠道开关、限流阈值）走 Nacos 动态下发
+
+---
+
+如需下一步，我可以补充：
+- Nacos 配置清单模板
+- 网关路由样例（Spring Cloud Gateway）
+- 服务发现调用示例

业务调用逻辑.md

@@ -0,0 +1,285 @@
+# 业务需求的服务调用逻辑（详细版）
+
+> 基于 5 服务架构：`gateway-bff` / `orchestration-service` / `agent-center` / `content-center` / `delivery-connector-douyin`
+
+---
+
+## 总体时序图（示例：内容生成与发布）
+
+```mermaid
+sequenceDiagram
+  participant U as 用户/前端
+  participant G as gateway-bff
+  participant O as orchestration-service
+  participant A as agent-center
+  participant C as content-center
+  participant D as delivery-connector-douyin
+
+  U->>G: 提交内容生成请求
+  G->>O: 转发并鉴权
+  O->>A: 生成标题/文案/脚本
+  A-->>O: 返回生成结果
+  O->>C: 保存草稿/成品
+  C-->>O: 返回内容ID
+  O-->>G: 返回结果
+  G-->>U: 展示生成内容
+
+  U->>G: 发起发布请求
+  G->>O: 转发发布指令
+  O->>D: 发布到抖音
+  D-->>C: 回写发布状态
+  D-->>O: 发布结果
+  O-->>G: 返回发布结果
+  G-->>U: 展示发布状态
+```
+
+---
+
+## 1. 爆款标题生成器（P0）
+
+### 目标
+生成标题并保存为草稿，供运营二次编辑。
+
+### 调用流程
+1. 前端提交主题与约束 → `gateway-bff`
+2. `gateway-bff` 鉴权后转发 → `orchestration-service`
+3. `orchestration-service` 组装上下文 → 调用 `agent-center`
+4. `agent-center` 根据模板生成标题
+5. 结果回到 `orchestration-service`
+6. `orchestration-service` 将标题写入 `content-center`（状态=草稿）
+7. 返回前端
+
+### 输出
+- 草稿内容 ID
+- 标题候选列表
+
+---
+
+## 2. 多平台文案生成（P0）
+
+### 目标
+基于不同平台规范生成文案。
+
+### 调用流程
+1. 前端选择平台与主题 → `gateway-bff`
+2. `gateway-bff` → `orchestration-service`
+3. `orchestration-service` 调用 `agent-center`（带平台模板参数）
+4. `agent-center` 输出平台适配文案
+5. `orchestration-service` 保存到 `content-center`（草稿）
+6. 返回前端
+
+---
+
+## 3. AI 图文创作（P0）
+
+### 目标
+生成图文内容并入库。
+
+### 调用流程
+1. 前端提交主题 → `gateway-bff`
+2. `gateway-bff` → `orchestration-service`
+3. `orchestration-service` → `agent-center` 生成文案/描述
+4. 如有外部生图服务 → `orchestration-service` 调用生成图片
+5. `orchestration-service` → `content-center` 保存图文成品
+6. 返回前端
+
+---
+
+## 4. 视频脚本生成（P0）
+
+### 目标
+生成结构化脚本，便于后续制作。
+
+### 调用流程
+1. 前端提交脚本类型 → `gateway-bff`
+2. `gateway-bff` → `orchestration-service`
+3. `orchestration-service` → `agent-center`
+4. `agent-center` 输出脚本结构（分镜/台词）
+5. `orchestration-service` → `content-center` 保存脚本
+6. 返回前端
+
+---
+
+## 5. 智能发布（P1）
+
+### 目标
+将内容发布到抖音并记录状态。
+
+### 调用流程
+1. 前端选择内容并发布 → `gateway-bff`
+2. `gateway-bff` → `orchestration-service`
+3. `orchestration-service` 拉取内容详情 → `content-center`
+4. `orchestration-service` → `delivery-connector-douyin` 发起发布
+5. `delivery-connector-douyin` 回写发布状态 → `content-center`
+6. 返回前端
+
+---
+
+## 6. 内容日历排期（P1）
+
+### 目标
+按排期定时发布内容。
+
+### 调用流程
+1. 前端创建排期 → `gateway-bff`
+2. `gateway-bff` → `orchestration-service`（内嵌调度）
+3. 到达时间点 → `orchestration-service` 调用 `delivery-connector-douyin`
+4. 发布状态回写 → `content-center`
+
+---
+
+## 7. 多账号管理（P1）
+
+### 目标
+完成抖音账号授权与可用性管理。
+
+### 调用流程
+1. 前端绑定账号 → `gateway-bff`
+2. `gateway-bff` → `delivery-connector-douyin`
+3. `delivery-connector-douyin` 完成 OAuth 授权
+4. 账号素材信息 → `content-center` 存储
+
+---
+
+## 8. 数据监控看板（P1）
+
+### 目标
+展示投放效果指标。
+
+### 调用流程
+1. `delivery-connector-douyin` 定时拉取数据
+2. `orchestration-service` 汇总并生成聚合指标
+3. 前端访问 → `gateway-bff` → `orchestration-service`
+
+---
+
+## 9. 爆款内容复刻（P0）
+
+### 目标
+发现爆款后自动复刻生成。
+
+### 调用流程
+1. `delivery-connector-douyin` 发现爆款 → 事件入队
+2. `orchestration-service` 消费事件并判断规则
+3. `orchestration-service` → `agent-center` 触发复刻 Workflow
+4. 复刻内容写入 `content-center`
+5. 返回通知/状态
+
+---
+
+## 10. 智能客服（P1）
+
+### 目标
+自动回复客户消息。
+
+### 调用流程
+1. 渠道消息进入 → `gateway-bff`
+2. `gateway-bff` → `orchestration-service`
+3. `orchestration-service` 判断会话状态（自动/人工）
+4. 自动模式下 → `agent-center` 生成回复
+5. `orchestration-service` 发送回复（通过渠道或 H5）
+
+---
+
+## 11. 话术推荐引擎（P1）
+
+### 目标
+为客服提供推荐话术。
+
+### 调用流程
+1. 客服请求推荐 → `gateway-bff`
+2. `gateway-bff` → `orchestration-service`
+3. `orchestration-service` → `agent-center` 生成话术
+4. 返回推荐话术
+
+---
+
+## 12. 客户意向评分（P1）
+
+### 目标
+基于行为给出意向等级。
+
+### 调用流程
+1. 行为事件进入 → `orchestration-service`（轻量 CDP）
+2. 评分计算与更新
+3. 对外提供查询接口
+
+---
+
+## 13. 自动留资引导（P1）
+
+### 目标
+自动引导客户留资。
+
+### 调用流程
+1. `orchestration-service` 触发引导
+2. `agent-center` 生成引导话术
+3. 通过渠道发送
+
+---
+
+## 14. 人工接管（P1）
+
+### 目标
+从机器人切换到人工。
+
+### 调用流程
+1. 客服发起接管 → `gateway-bff`
+2. `gateway-bff` → `orchestration-service`
+3. `orchestration-service` 更新会话状态
+4. 通知 `agent-center` 停止自动回复
+
+---
+
+## 15. 客户旅程设计器（P1）
+
+### 目标
+配置客户旅程流程。
+
+### 调用流程
+1. 前端配置 → `gateway-bff`
+2. `gateway-bff` → `orchestration-service`
+3. `orchestration-service` 持久化旅程定义
+
+---
+
+## 16. 自动跟进任务（P1）
+
+### 目标
+根据旅程状态自动创建跟进任务。
+
+### 调用流程
+1. 旅程触发 → `orchestration-service`
+2. 创建跟进任务并通知
+
+---
+
+## 17. 成交素材库（P2）
+
+### 目标
+为成交流程提供素材。
+
+### 调用流程
+1. 素材管理 → `gateway-bff`
+2. `gateway-bff` → `content-center`
+3. `orchestration-service` 按权限调用
+
+---
+
+## 18. 数据复盘看板（P0）
+
+### 目标
+综合展示内容与投放效果。
+
+### 调用流程
+1. `orchestration-service` 汇总投放/内容/行为数据
+2. 前端查询 → `gateway-bff` → `orchestration-service`
+
+---
+
+## 统一交互原则
+- 入口统一通过 `gateway-bff`
+- 业务流程统一在 `orchestration-service`
+- 智能决策统一在 `agent-center`
+- 内容与素材统一在 `content-center`
+- 渠道接入统一在 `delivery-connector-douyin`