commit 024e2a7d510c90ddced1ded1d29387d5ceec7577 Author: chendelian <116870791@qq.com> Date: Sun May 31 14:37:07 2026 +0800 提交 diff --git a/READEME.md b/READEME.md new file mode 100644 index 0000000..1a46693 --- /dev/null +++ b/READEME.md @@ -0,0 +1,546 @@ +# 广东升航物流 · AI 智能体平台架构文档 + +> 版本：v1.0.0　　项目代号：client-shenghang　　文档类型：总体设计 + +--- + +## 目录 + +1. [项目概述](#1-项目概述) +2. [整体架构图](#2-整体架构图) +3. [技术原理图](#3-技术原理图) +4. [业务域划分](#4-业务域划分) +5. [技能规划总图](#5-技能规划总图) +6. [各域详细技能说明](#6-各域详细技能说明) +7. [数据流转图](#7-数据流转图) +8. [RPA 集成说明](#8-rpa-集成说明) +9. [部署与运行说明](#9-部署与运行说明) + +--- + +## 1. 项目概述 + +### 1.1 背景 + +广东升航物流有限公司日常运营涉及订单接收、运力调度、货物追踪、财务管理、人事管理等多个环节，大量工作依赖人工重复操作，效率低、易出错。 + +### 1.2 目标 + +通过 **AI 智能体 + RPA 自动化** 的组合方案，将 15 项日常业务流程转化为可自动运行的 Skill（技能），部署至智能体平台，实现： + +- ✅ 减少人工重复劳动 +- ✅ 降低操作失误率 +- ✅ 提升客户响应速度 +- ✅ 实现 7×24 小时无人值守运行 + +### 1.3 技术栈 + +| 层级 | 技术 | +|------|------| +| AI 大模型 | Claude / GPT（意图理解、内容生成、决策推理） | +| RPA 引擎 | 浏览器 / 桌面 / 手机三端自动化 | +| 智能体平台 | 森相伴（Skill 调度与编排） | +| 代码仓库 | Gitea（git.jc2009.com/client-shenghang） | +| 开发语言 | Python 3.x | +| 触达渠道 | 企业微信 / 短信 / 邮件 | + +--- + +## 2. 整体架构图 + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ 客户触点层 │ +│ 微信群消息 电话（人工） 邮件 │ +└───────────────┬─────────────────────────┬───────────────────────┘ + │ │ + ▼ ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ 智能体平台（调度层） │ +│ │ +│ 意图识别 → Skill 路由 → 任务编排 → 结果回传 │ +│ │ +└──────┬──────────┬──────────┬──────────┬──────────┬─────────────┘ + │ │ │ │ │ + ▼ ▼ ▼ ▼ ▼ + ┌─────────┐ ┌──────────┐ ┌────────┐ ┌────────┐ ┌────────────┐ + │订单中心 │ │运力调度 │ │货物追踪│ │财务中心│ │人事/市场 │ + │ 3 Skills│ │ 4 Skills │ │3 Skills│ │4 Skills│ │ 6 Skills │ + └────┬────┘ └────┬─────┘ └───┬────┘ └───┬────┘ └─────┬──────┘ + │ │ │ │ │ + └───────────┴───────────┴───────────┴─────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ RPA 执行层 │ +│ │ +│ 货拉拉 运满满 顺丰 京东物流 税务系统 招聘平台 │ +│ (手机端) (手机端) (网页端) (网页端) (桌面端) (网页端) │ +│ │ +└─────────────────────────────────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ 数据存储层 │ +│ │ +│ 订单库 运单库 财务库 员工库 │ +│ │ +└─────────────────────────────────────────────────────────────────┘ +``` + +--- + +## 3. 技术原理图 + +``` + ┌──────────────────────┐ + │ 输入触发源 │ + │ 微信群 / 邮件 / 定时 │ + └──────────┬───────────┘ + │ + ▼ + ┌──────────────────────┐ + │ AI 大模型 │ + │ · 意图识别 │ + │ · 信息提取 │ + │ · 内容生成 │ + │ · 异常判断 │ + └──────────┬───────────┘ + │ + ┌────────────────┼────────────────┐ + │ │ │ + ▼ ▼ ▼ + ┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐ + │ 直接执行 │ │ RPA 执行 │ │ 人工介入 │ + │ · 发送通知 │ │ · 操作第三方 │ │ · 异常审批 │ + │ · 写入数据库 │ │ 平台界面 │ │ · 关键决策 │ + │ · 生成报表 │ │ · 浏览器/桌面 │ │ · 回执确认 │ + │ · 推送消息 │ │ /手机三端 │ └──────────────────┘ + └─────────────────┘ └──────────────┘ + │ │ + └────────┬───────┘ + │ + ▼ + ┌─────────────────────┐ + │ 输出结果 │ + │ · 通知客户/司机 │ + │ · 更新系统状态 │ + │ · 生成报表文件 │ + │ · 推送异常工单 │ + └─────────────────────┘ +``` + +--- + +## 4. 业务域划分 + +``` +client-shenghang/ +│ +├── 📦 域一：订单中心 (3 Skills) +│ 接收、录入、分配订单 +│ +├── 🚛 域二：运力调度中心 (4 Skills) +│ 通知司机、对接货拉拉/运满满/顺丰/京东 +│ +├── 📍 域三：货物追踪中心 (3 Skills) +│ 查询进度、推送状态、处理异常 +│ +├── 💰 域四：财务中心 (4 Skills) +│ 报销审核、财务对账、开票、催款 +│ +├── 👥 域五：人事管理中心 (4 Skills) +│ 招聘、绩效收集、绩效督促、优秀评比 +│ +└── 📈 域六：市场助手中心 (2 Skills) + 线索收集、客户档案 +``` + +**合计：6 大业务域 / 20 个 Skill** + +--- + +## 5. 技能规划总图 + +``` +┌─────────────────────────────────────────────────────────────────────────┐ +│ 20 个 Skill 全景图 │ +├──────────────────┬──────────────────────────────────────────────────────┤ +│ 域 │ Skill 列表 │ +├──────────────────┼──────────────────────────────────────────────────────┤ +│ │ receive-order ← 监听微信群/邮件，提取订单信息 │ +│ 📦 订单中心 │ record-order ← 订单结构化录入内部系统 │ +│ │ assign-transport ← 智能判断运力渠道分配 │ +├──────────────────┼──────────────────────────────────────────────────────┤ +│ │ notify-driver ← 向司机发送派车通知 │ +│ 🚛 运力调度 │ dispatch-huolala ← RPA 操作货拉拉自动下单 │ +│ │ dispatch-yunmanman ← RPA 操作运满满自动下单 │ +│ │ dispatch-shunfeng ← RPA 操作顺丰自动下单 │ +│ │ dispatch-jingdong ← RPA 操作京东物流自动下单 │ +├──────────────────┼──────────────────────────────────────────────────────┤ +│ │ track-shipment ← 定时查询各平台运单状态 │ +│ 📍 货物追踪 │ push-progress ← 主动推送货物状态给客户 │ +│ │ handle-exception ← 识别异常，生成工单推送负责人 │ +├──────────────────┼──────────────────────────────────────────────────────┤ +│ │ review-reimbursement ← 核对报销单据，生成审核意见 │ +│ 💰 财务中心 │ reconcile-finance ← 收付款与订单数据自动对账 │ +│ │ issue-invoice ← RPA 操作税务系统自动开票 │ +│ │ urge-payment ← 监控账期，到期自动催款提醒 │ +├──────────────────┼──────────────────────────────────────────────────────┤ +│ │ publish-recruitment ← 发布招聘，筛简历，发通知 │ +│ 👥 人事管理 │ collect-performance ← 抓取员工数据，生成绩效报表 │ +│ │ evaluate-performance ← 绩效排名，督促落后员工 │ +│ │ reward-employee ← 生成优秀员工评比结果并公告 │ +├──────────────────┼──────────────────────────────────────────────────────┤ +│ 📈 市场助手 │ collect-leads ← 抓取潜在客户信息，归档线索库 │ +│ │ build-customer-profile ← 汇总客户订单/偏好/账期画像 │ +└──────────────────┴──────────────────────────────────────────────────────┘ +``` + +--- + +## 6. 各域详细技能说明 + +### 6.1 📦 订单中心 + +#### `receive-order` · 接收订单 + +| 项目 | 内容 | +|------|------| +| **触发方式** | 企业微信群新消息 / 邮件到达 | +| **输入** | 微信消息文本 / 邮件正文 | +| **处理逻辑** | AI 提取：客户名、货物信息、起止地址、要求时间、联系人 | +| **输出** | 结构化订单 JSON，传递给 `record-order` | +| **异常处理** | 信息不完整时，自动回复客户补充缺失字段 | + +#### `record-order` · 录入订单 + +| 项目 | 内容 | +|------|------| +| **触发方式** | 由 `receive-order` 传入结构化数据后触发 | +| **输入** | 结构化订单 JSON | +| **处理逻辑** | 写入内部订单管理系统，生成订单编号 | +| **输出** | 订单编号，传递给 `assign-transport` | +| **异常处理** | 写入失败时告警，推送人工处理 | + +#### `assign-transport` · 分配运力 + +| 项目 | 内容 | +|------|------| +| **触发方式** | 由 `record-order` 传入订单编号后触发 | +| **输入** | 订单详情（重量、线路、时效要求） | +| **处理逻辑** | 按规则判断：同城→货拉拉/自有司机；省内→运满满；全国→顺丰/京东 | +| **输出** | 分配结果，触发对应 dispatch-xxx Skill | + +--- + +### 6.2 🚛 运力调度中心 + +#### `notify-driver` · 通知司机 + +| 项目 | 内容 | +|------|------| +| **触发方式** | `assign-transport` 判定走自有司机时触发 | +| **输入** | 司机信息、订单详情 | +| **处理逻辑** | 发送派车通知（企业微信/短信），等待司机回执确认 | +| **输出** | 司机确认状态；超时未回复自动切换备用方案 | + +#### `dispatch-huolala` · 货拉拉派单 + +| 项目 | 内容 | +|------|------| +| **触发方式** | `assign-transport` 判定走货拉拉时触发 | +| **输入** | 取货/送货地址、货物类型、时间要求 | +| **处理逻辑** | **RPA 手机端**自动打开货拉拉App，填写信息，确认下单 | +| **输出** | 货拉拉订单号，写入系统 | + +#### `dispatch-yunmanman` · 运满满派单 + +| 项目 | 内容 | +|------|------| +| **触发方式** | `assign-transport` 判定走运满满时触发 | +| **输入** | 起止城市、货物重量/体积、时效 | +| **处理逻辑** | **RPA 手机/网页端**自动操作运满满，发布货源，匹配司机 | +| **输出** | 运满满订单号，写入系统 | + +#### `dispatch-shunfeng` · 顺丰下单 + +| 项目 | 内容 | +|------|------| +| **触发方式** | `assign-transport` 判定走顺丰时触发 | +| **输入** | 寄件/收件信息、货物参数、服务类型 | +| **处理逻辑** | **RPA 浏览器端**登录顺丰官网，填写寄件信息，完成下单 | +| **输出** | 顺丰运单号，写入系统 | + +#### `dispatch-jingdong` · 京东物流下单 + +| 项目 | 内容 | +|------|------| +| **触发方式** | `assign-transport` 判定走京东物流时触发 | +| **输入** | 寄件/收件信息、货物参数 | +| **处理逻辑** | **RPA 浏览器端**登录京东物流平台，完成下单 | +| **输出** | 京东运单号，写入系统 | + +--- + +### 6.3 📍 货物追踪中心 + +#### `track-shipment` · 追踪货物 + +| 项目 | 内容 | +|------|------| +| **触发方式** | 定时触发（每 30 分钟） | +| **输入** | 系统内所有进行中的运单号 | +| **处理逻辑** | RPA 登录各平台查询最新状态，汇总写入系统 | +| **输出** | 更新后的运单状态，触发 `push-progress` 或 `handle-exception` | + +#### `push-progress` · 推送进度 + +| 项目 | 内容 | +|------|------| +| **触发方式** | `track-shipment` 检测到状态变更时触发 | +| **输入** | 最新货物状态、客户联系方式 | +| **处理逻辑** | AI 生成友好通知文案，通过企业微信/短信发送给客户 | +| **输出** | 消息发送成功/失败记录 | + +#### `handle-exception` · 处理异常 + +| 项目 | 内容 | +|------|------| +| **触发方式** | `track-shipment` 检测到异常状态时触发（超时/拒收/丢货等） | +| **输入** | 异常类型、订单信息 | +| **处理逻辑** | AI 判断异常类型，生成异常工单，推送对应负责人处理 | +| **输出** | 异常工单，人工确认处理结果 | + +--- + +### 6.4 💰 财务中心 + +#### `review-reimbursement` · 审核报销 + +| 项目 | 内容 | +|------|------| +| **触发方式** | 员工提交报销申请时触发 | +| **输入** | 报销单据（金额、类别、票据图片） | +| **处理逻辑** | AI 核对金额、类别合规性，OCR 识别票据，生成审核意见 | +| **输出** | 审核意见推送给负责人，待人工批复 | + +#### `reconcile-finance` · 财务对账 + +| 项目 | 内容 | +|------|------| +| **触发方式** | 定时触发（每日/每月） | +| **输入** | 收付款流水、订单数据 | +| **处理逻辑** | 自动匹配收付款与订单，标记未匹配差异项 | +| **输出** | 对账报表，差异项推送财务人员 | + +#### `issue-invoice` · 开具发票 + +| 项目 | 内容 | +|------|------| +| **触发方式** | 客户申请开票时触发 | +| **输入** | 客户税务信息、开票金额、订单号 | +| **处理逻辑** | **RPA 桌面端**操作税务系统，自动填写并开具发票 | +| **输出** | 发票文件，自动发送给客户邮箱 | + +#### `urge-payment` · 催款提醒 + +| 项目 | 内容 | +|------|------| +| **触发方式** | 定时触发（每日检查账期） | +| **输入** | 客户账期信息、未付款订单 | +| **处理逻辑** | 到期前 7 天、3 天、当天分别发送不同等级提醒 | +| **输出** | 提醒消息发送给客户（微信/短信/邮件） | + +--- + +### 6.5 👥 人事管理中心 + +#### `publish-recruitment` · 发布招聘 + +| 项目 | 内容 | +|------|------| +| **触发方式** | 人事提交招聘需求时触发 | +| **输入** | 职位信息、要求、薪资范围 | +| **处理逻辑** | AI 生成 JD 文案，RPA 发布至各招聘平台，自动筛选符合简历，发送面试通知 | +| **输出** | 候选人名单推送给人事负责人 | + +#### `collect-performance` · 收集绩效 + +| 项目 | 内容 | +|------|------| +| **触发方式** | 定时触发（每日/每周） | +| **输入** | 各系统员工操作数据 | +| **处理逻辑** | 自动抓取：订单处理量、响应时长、异常率等指标，汇总生成报表 | +| **输出** | 绩效数据报表，存入员工档案 | + +#### `evaluate-performance` · 绩效督促 + +| 项目 | 内容 | +|------|------| +| **触发方式** | `collect-performance` 完成后触发 | +| **输入** | 绩效数据报表 | +| **处理逻辑** | AI 识别指标落后员工，生成排名，对落后员工发送督促提醒 | +| **输出** | 绩效排名报表，督促通知 | + +#### `reward-employee` · 优秀评比 + +| 项目 | 内容 | +|------|------| +| **触发方式** | 定时触发（每月） | +| **输入** | 月度绩效汇总数据 | +| **处理逻辑** | AI 根据多维度指标综合评分，生成优秀员工排名与评语 | +| **输出** | 优秀员工公告，推送全员企业微信 | + +--- + +### 6.6 📈 市场助手中心 + +#### `collect-leads` · 收集线索 + +| 项目 | 内容 | +|------|------| +| **触发方式** | 定时触发 / 手动触发 | +| **输入** | 目标渠道（行业网站/平台/地图） | +| **处理逻辑** | RPA 抓取潜在客户信息，AI 去重、分类、评分 | +| **输出** | 线索列表推送给业务员 | + +#### `build-customer-profile` · 客户画像 + +| 项目 | 内容 | +|------|------| +| **触发方式** | 定时触发（每月更新） | +| **输入** | 客户历史订单、付款记录、沟通记录 | +| **处理逻辑** | AI 汇总分析，生成客户偏好、货量趋势、信用等级等画像 | +| **输出** | 客户画像报告，存入客户档案 | + +--- + +## 7. 数据流转图 + +``` +客户下单 + │ + ▼ +receive-order ──→ record-order ──→ assign-transport + │ + ┌─────────────────────┼──────────────────────┐ + │ │ │ + ▼ ▼ ▼ + notify-driver dispatch-huolala/ dispatch-shunfeng/ + （自有司机） dispatch-yunmanman dispatch-jingdong + │ │ │ + └─────────────────────┼──────────────────────┘ + │ + ▼ + track-shipment（定时轮询） + │ + ┌──────────────┴──────────────┐ + │ │ + ▼ ▼ + push-progress handle-exception + （正常推进） （异常处理） + │ + ▼ + urge-payment（到期催款） + │ + ▼ + issue-invoice（开票） + │ + ▼ + reconcile-finance（对账） +``` + +--- + +## 8. RPA 集成说明 + +### 8.1 三端覆盖 + +| 端 | 覆盖场景 | +|----|---------| +| 🌐 浏览器端 | 顺丰官网、京东物流、税务系统、招聘平台 | +| 🖥️ 桌面端 | 税务开票软件、内部 ERP 系统 | +| 📱 手机端 | 货拉拉 App、运满满 App | + +### 8.2 无需 API，RPA 直接操作 + +``` +无 API 接口的第三方平台 + │ + ▼ + RPA 模拟人工操作 + · 识别界面元素 + · 填写表单字段 + · 点击确认按钮 + · 截图记录结果 + │ + ▼ + 返回操作结果给智能体 +``` + +### 8.3 异常容错机制 + +- 界面变更导致元素识别失败 → 推送人工介入 +- 平台登录失效 → 自动重新登录，失败则告警 +- 操作超时 → 重试 3 次，仍失败则生成异常工单 + +--- + +## 9. 部署与运行说明 + +### 9.1 仓库结构 + +``` +client-shenghang/ +├── commons/ # 公共模块 +│ └── references/ +│ ├── ADAPTER.md # 平台适配说明 +│ ├── CLI.md # 命令行使用 +│ ├── CONFIG.md # 配置说明 +│ ├── RPA.md # RPA 操作规范 +│ ├── SCHEMA.md # 数据结构定义 +│ └── RUNTIME.md # 运行环境要求 +├── receive-order/ +├── record-order/ +├── assign-transport/ +├── notify-driver/ +├── dispatch-huolala/ +├── dispatch-yunmanman/ +├── dispatch-shunfeng/ +├── dispatch-jingdong/ +├── track-shipment/ +├── push-progress/ +├── handle-exception/ +├── review-reimbursement/ +├── reconcile-finance/ +├── issue-invoice/ +├── urge-payment/ +├── publish-recruitment/ +├── collect-performance/ +├── evaluate-performance/ +├── reward-employee/ +├── collect-leads/ +└── build-customer-profile/ +``` + +### 9.2 上线计划 + +| 阶段 | 时间 | 内容 | 目标 | +|------|------|------|------| +| **第一期** | Week 1-3 | 订单中心 + 运力调度 + 催款提醒 | 核心业务自动化，直接减少人工 | +| **第二期** | Week 4-6 | 货物追踪 + 财务对账 + 开票 | 降低出错率，提升客户体验 | +| **第三期** | Week 7-9 | 人事管理 + 市场助手 | 管理效率全面提升 | + +### 9.3 各角色关注点速查 + +| 角色 | 重点阅读章节 | +|------|------------| +| **客户/决策层** | 第 1、4、5 章（概述、业务域、技能总图） | +| **产品/需求** | 第 6 章（各域详细技能说明） | +| **技术开发** | 第 2、3、7、8、9 章（架构、原理、数据流、RPA、部署） | +| **测试** | 第 6 章（输入/输出/异常处理）+ 第 8.3 节（容错机制） | + +--- + +*文档由 AI 辅助生成，如有调整请在 Gitea 仓库提交 MR 更新* \ No newline at end of file