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
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
//! 组织架构（Directory）服务
//!
//! 提供飞书组织架构的完整功能集，支持员工管理、部门管理、组织架构维护、
//! 人员信息同步等企业级组织管理能力。是企业人力资源和组织管理的核心工具。
//!
//! # 核心功能
//!
//! ## 员工管理
//! - 👥 员工信息创建、更新和删除
//! - 📋 员工列表查询和筛选
//! - 🔍 员工信息搜索和检索
//! - 📊 员工统计和分析
//! - 🏷️ 员工标签和分类
//!
//! ## 部门管理
//! - 🏢 部门结构创建和维护
//! - 📊 部门层级关系管理
//! - 👑 部门负责人设置
//! - 📋 部门信息查询和更新
//! - 🔄 部门合并和调整
//!
//! ## 组织架构
//! - 🌳 组织架构树形结构
//! - 📈 组织层级关系维护
//! - 🔄 组织变更和调整
//! - 📊 组织统计和分析
//! - 🎯 组织目标和KPI
//!
//! ## 数据同步
//! - 🔄 人员信息自动同步
//! - 📊 数据一致性校验
//! - 🔔 变更通知和提醒
//! - 📋 同步日志和审计
//! - 🛠️ 数据修复和维护
//!
//! # 使用示例
//!
//! ```rust
//! use open_lark::prelude::*;
//!
//! let client = LarkClient::builder("app_id", "app_secret")
//! .with_app_type(AppType::SelfBuild)
//! .build();
//!
//! // 获取组织架构服务
//! let directory = &client.directory;
//!
//! // 创建员工
//! // let employee_request = CreateEmployeeRequest::builder()
//! // .name("张三")
//! // .email("zhangsan@company.com")
//! // .mobile("13800138000")
//! // .department_id("dept_123")
//! // .job_title("软件工程师")
//! // .build();
//! // directory.v1.employee.create(employee_request, None).await?;
//!
//! // 查询员工列表
//! // let list_request = ListEmployeesRequest::builder()
//! // .department_id("dept_123")
//! // .page_size(20)
//! // .build();
//! // let employees = directory.v1.employee.list(list_request, None).await?;
//!
//! // 创建部门
//! // let department_request = CreateDepartmentRequest::builder()
//! // .name("技术部")
//! // .parent_id("parent_dept_123")
//! // .leader_id("leader_user_123")
//! // .build();
//! // directory.v1.department.create(department_request, None).await?;
//!
//! // 更新部门信息
//! // let update_request = UpdateDepartmentRequest::builder()
//! // .department_id("dept_123")
//! // .name("产品技术部")
//! // .description("负责产品技术研发")
//! // .build();
//! // directory.v1.department.update(update_request, None).await?;
//! ```
//!
//! # API版本
//!
//! 当前支持v1版本，提供基础的组织架构功能：
//! - 员工全生命周期管理
//! - 部门结构管理
//! - 组织架构维护
//! - 数据同步和校验
//!
//! # 组织管理特性
//!
//! - 🏢 灵活的组织架构设计
//! - 👥 完善的人员管理体系
//! - 📊 实时数据同步更新
//! - 🔐 权限控制和安全保障
//! - 📱 移动端管理支持
//!
//! # 人力资源集成
//!
//! - 💼 HR系统深度集成
//! - 📋 人事流程自动化
//! - 📊 人力资源数据分析
//! - 🎯 绩效考核支持
//! - 📈 组织发展规划
use crateConfig;
/// 组织架构服务 v1 版本
/// 组织架构服务
///
/// 企业级组织管理的统一入口，提供员工管理、部门管理、
/// 组织架构维护、数据同步等完整的组织管理能力。
///
/// # 服务架构
///
/// - **v1**: 组织架构API v1版本，提供基础功能集
///
/// # 核心特性
///
/// - 👥 全面的员工管理功能
/// - 🏢 灵活的部门管理系统
/// - 🌳 完整的组织架构维护
/// - 🔄 智能的数据同步机制
/// - 📊 丰富的统计分析功能
///
/// # 适用场景
///
/// - 企业组织架构管理
/// - 人员信息管理和维护
/// - 部门结构调整和优化
/// - HR系统数据同步
/// - 组织变更管理
///
/// # 最佳实践
///
/// - 建立清晰的组织层级
/// - 定期维护人员信息
/// - 合理设置部门权限
/// - 监控数据同步状态
/// - 保护员工隐私信息
///
/// # 示例用法
///
/// ```rust,ignore
/// use open_lark::LarkClient;
///
/// let client = LarkClient::builder("app_id", "app_secret").build();
///
/// // 创建员工
/// let response = client.directory.v1.employee.create(request, None).await?;
///
/// // 创建部门
/// let response = client.directory.v1.department.create(request, None).await?;
/// ```