# 德木 JsonRpc 协议数据对接文档

## 服务中心

> 📌 **服务中心为 Nacos**  
> 通过 `composer require hyperf/service-governance-nacos` 组件实现。  
> 详细用法参考 [Hyperf 文档](https://hyperf.io)。

🔹 一个服务可以同时作为 **服务提供者** 或 **消费者**  
🔹 作为消费者时，可提供回调服务

---

## 公共接口服务

### 🧠 AI 服务 - `AiService`
- 提供查询、数据分析等功能
  - **查询功能**：支持对多种类型的数据进行高效查询，涵盖结构化数据（如数据库表）和非结构化数据（如日志文件）。用户可以根据不同的条件快速筛选和检索所需信息。
  - **数据分析**：提供全面的数据分析能力，包括基础统计分析、趋势预测、聚类分析等。帮助用户从海量数据中提取有价值的见解，为决策提供有力支持。

### 📱 EasyApp 服务 - `EasyAppService`
- 提供微信、钉钉、公众号等服务
  - **微信小程序服务**：支持小程序接口、消息订阅号等功能，包括消息推送、用户管理、菜单管理等。
  - **钉钉服务**：支持钉钉机器人、钉钉消息推送等功能，包括消息发送、开放平台接口等。
  - **公众号服务**：支持公众号消息推送、用户管理、菜单管理等功能，包括消息发送、用户管理、菜单管理等。
  - **开放平台**：支持开放平台接口。

### ☁️ OSS 服务 - `OssService`
- 文件上传、签名、回调
- 文件下载、删除等常规操作
  - **文件上传**：支持文件上传功能，包括文件上传、文件签名、文件回调等功能。
  - **文件下载**：支持文件下载功能，包括文件下载、文件删除等功能。
  - **文件签名**：支持文件签名功能，包括文件签名、文件回调等功能。
  - **文件回调**：支持文件回调功能，包括文件回调、文件删除等功能。

### 🖨️ 云打印服务 - `PrintService`
- 快麦云打印机支持
- 打印回调、参数配置
  - **打印回调**：支持打印回调功能，包括打印回调、打印参数配置等功能。
  - **打印参数配置**：支持打印参数配置功能，包括打印参数配置、打印回调等功能。
- *后续将接入更多打印机型号*

### 📨 短信服务 - `SmsService`
- 阿里云短信发送
- 短信签名、模板配置
  - **短信签名**：支持短信签名功能，包括短信签名、短信模板配置等功能。
  - **短信模板配置**：支持短信模板配置功能，包括短信模板配置、短信签名等功能。
- *后续将接入更多短信服务*

### ⚙️ 系统配置服务 - `SysConfigService`
- 各系统的第三方接口对接秘钥管理
  - **系统秘钥管理**：支持系统秘钥管理功能，包括系统秘钥管理、系统配置等功能。

### 👥 用户管理服务 - `UserAuthService`
- 公共用户逻辑服务
- 子系统可调用统一用户服务
  - **用户管理**：支持用户管理功能，包括用户管理、用户登录、用户注册等功能。

### 🌐 WebSocket 服务 - `WebSocketService`
- 公共 WS 服务模块
- 子系统可调用统一 WS 服务
  - **WebSocket 服务**：支持 WebSocket 服务功能，包括 WebSocket 服务、WebSocket 消息推送等功能。

---

## 合同服务

### 📝 e签宝合同 - `ContractService`
- 签署业务合同常规流程对接
- 支持多系统调用
  - **合同服务**：支持合同服务功能，包括合同服务、合同签署等功能。
  - **合同模版**：支持合同模版功能，包括合同模版、合同签署等功能。

### 📑 单据模版 - `OrderTempService`
- 模版处理服务
- 根据业务需求动态生成文档
  - **单据模版**：支持单据模版功能，包括单据模版、单据生成等功能。

---

## 回调服务

> 🔄 **回调机制说明**
- 消费者端定义服务回调接口
- 服务端成功执行后触发回调消费者服务