1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
//! 审批（Approval）服务
//!
//! 提供飞书审批应用的完整功能集，支持审批流程管理、审批实例处理、
//! 任务分配等企业级工作流程管理能力。是企业数字化办公的核心服务模块。
//!
//! # 核心功能
//!
//! ## 审批流程管理
//! - 📋 审批定义的创建和配置
//! - 🔄 审批流程设计和编辑
//! - 🎯 审批节点和条件设置
//! - 📊 流程模板管理
//!
//! ## 审批实例处理
//! - 📝 审批实例的创建和提交
//! - ✅ 审批操作（同意/拒绝/转交）
//! - 🔍 审批状态查询和跟踪
//! - 📋 审批历史记录管理
//!
//! ## 任务管理
//! - 📋 待办任务查询和处理
//! - 👥 任务分配和委托
//! - ⏰ 任务提醒和超时处理
//! - 📊 任务统计和分析
//!
//! ## 外部集成
//! - 🔗 外部审批系统对接
//! - 📊 第三方数据同步
//! - 🔄 审批状态双向同步
//! - 🛠️ 自定义集成接口
//!
//! ## 文件和消息
//! - 📎 审批附件管理
//! - 💬 审批评论和消息
//! - 🔔 审批通知推送
//! - 📧 邮件和短信提醒
//!
//! # 使用示例
//!
//! ```rust
//! use open_lark::prelude::*;
//!
//! let client = LarkClient::builder("app_id", "app_secret")
//! .with_app_type(AppType::SelfBuild)
//! .build();
//!
//! // 获取审批服务
//! let approval = &client.approval;
//!
//! // 创建审批实例
//! // let instance_request = CreateInstanceRequest::builder()
//! // .approval_code("approval_code")
//! // .form("{\"field1\":\"value1\"}")
//! // .build();
//! // let instance = approval.v4.instance.create(instance_request, None).await?;
//!
//! // 查询待办任务
//! // let task_request = ListTaskRequest::builder()
//! // .page_size(20)
//! // .build();
//! // let tasks = approval.v4.task.list(task_request, None).await?;
//!
//! // 审批操作
//! // let approve_request = ApproveTaskRequest::builder()
//! // .approval_code("approval_code")
//! // .instance_code("instance_code")
//! // .task_id("task_id")
//! // .build();
//! // approval.v4.task.approve(approve_request, None).await?;
//! ```
//!
//! # API版本
//!
//! 当前支持v4版本，是最新的稳定版本，提供：
//! - 完整的审批流程管理
//! - 高性能的实例处理
//! - 丰富的集成能力
//! - 企业级安全控制
//!
//! # 工作流特性
//!
//! - 🔄 灵活的流程配置
//! - 👥 多级审批支持
//! - 🔀 条件分支和并行处理
//! - ⏰ 超时和升级机制
//! - 📊 审批数据统计分析
//!
//! # 集成能力
//!
//! - 📱 移动端审批支持
//! - 🔗 第三方系统集成
//! - 📧 多渠道消息通知
//! - 📊 BI和报表集成
use crateConfig;
/// 数据模型定义
/// 审批服务 v4 版本
use V4;
/// 审批服务
///
/// 企业级审批流程管理的统一入口，提供完整的工作流程设计、
/// 审批实例处理、任务管理等核心功能。
///
/// # 服务架构
///
/// - **v4**: 最新版本API，提供完整的审批功能集
/// - **models**: 数据模型和结构定义
///
/// # 核心特性
///
/// - 🚀 高性能审批引擎
/// - 🔄 灵活的流程配置
/// - 👥 多角色权限管理
/// - 📊 实时数据统计
/// - 🔗 丰富的集成接口
///
/// # 适用场景
///
/// - 企业日常审批流程
/// - 财务费用报销
/// - 人事请假申请
/// - 采购合同审批
/// - 项目立项审核
///
/// # 最佳实践
///
/// - 设计清晰的审批流程
/// - 合理设置审批权限
/// - 及时处理审批任务
/// - 定期分析审批数据
/// - 优化审批效率