client-shenghang/commons
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

提交

Browse Source
This commit is contained in:
chendelian
2026-05-31 14:37:07 +08:00
commit 024e2a7d51
1 changed files with 546 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

546
READEME.md Normal file
View File

@@ -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 更新*