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
//! 个人设置(Personal Settings)服务
//!
//! 提供飞书个人设置的完整功能集,支持系统状态、个人偏好、通知设置、
//! 隐私配置等个人级设置管理能力。是用户个性化体验的核心服务。
//!
//! # 核心功能
//!
//! ## 系统状态管理
//! - 📊 用户在线状态查询和设置
//! - 🔔 状态消息自定义
//! - ⏰ 自动状态切换规则
//! - 📱 多设备状态同步
//! - 🎯 状态可见性控制
//!
//! ## 个人偏好设置
//! - 🎨 界面主题和外观设置
//! - 🌍 语言和地区偏好
//! - ⏰ 时区和时间格式
//! - 📱 移动端个性化配置
//! - 🔧 功能模块启用禁用
//!
//! ## 通知设置
//! - 🔔 消息通知偏好设置
//! - 📧 邮件通知配置
//! - 📱 移动推送设置
//! - ⏰ 免打扰时间段
//! - 🎯 通知分类和优先级
//!
//! ## 隐私配置
//! - 🔐 个人信息可见性
//! - 👥 联系人权限设置
//! - 📊 数据分享偏好
//! - 🛡️ 安全和隐私控制
//! - 🔍 搜索可见性配置
//!
//! # 使用示例
//!
//! ```rust
//! use open_lark::prelude::*;
//!
//! let client = LarkClient::builder("app_id", "app_secret")
//! .with_app_type(AppType::SelfBuild)
//! .build();
//!
//! // 获取个人设置服务
//! let settings = &client.personal_settings;
//!
//! // 查询系统状态
//! // let status_request = GetSystemStatusRequest::builder()
//! // .user_id("user_123")
//! // .build();
//! // let status = settings.v1.system_status.get(status_request, None).await?;
//!
//! // 更新系统状态
//! // let update_request = UpdateSystemStatusRequest::builder()
//! // .user_id("user_123")
//! // .status("busy")
//! // .status_text("专注工作中")
//! // .build();
//! // settings.v1.system_status.update(update_request, None).await?;
//!
//! // 设置免打扰模式
//! // let dnd_request = SetDoNotDisturbRequest::builder()
//! // .user_id("user_123")
//! // .start_time("09:00")
//! // .end_time("18:00")
//! // .build();
//! // settings.v1.do_not_disturb.set(dnd_request, None).await?;
//! ```
//!
//! # API版本
//!
//! 当前支持v1版本,提供基础的个人设置功能:
//! - 系统状态管理
//! - 个人偏好配置
//! - 通知设置管理
//! - 隐私权限控制
//!
//! # 个人设置特性
//!
//! - 🎨 丰富的个性化选项
//! - 🔐 细粒度隐私控制
//! - 📱 跨平台设置同步
//! - 🤖 智能推荐和建议
//! - ⚡ 实时设置生效
//!
//! # 用户体验
//!
//! - 🎯 精准的个性化推荐
//! - 🔔 智能通知管理
//! - 🌍 本地化用户体验
//! - 📊 使用习惯分析
//! - 🔄 设置备份和恢复
/// 数据模型定义
/// 个人设置服务 v1 版本
use crateConfig;
/// 个人设置服务
///
/// 个人级设置管理的统一入口,提供系统状态、个人偏好、
/// 通知设置、隐私配置等完整的个人设置管理能力。
///
/// # 服务架构
///
/// - **v1**: 个人设置API v1版本,提供基础功能集
/// - **models**: 数据模型和结构定义
///
/// # 核心特性
///
/// - 📊 全面的状态管理功能
/// - 🎨 丰富的个性化选项
/// - 🔔 智能的通知管理
/// - 🔐 细致的隐私控制
/// - 📱 无缝的跨平台同步
///
/// # 适用场景
///
/// - 用户个性化配置
/// - 工作状态管理
/// - 通知偏好设置
/// - 隐私权限控制
/// - 用户体验优化
///
/// # 最佳实践
///
/// - 合理设置通知偏好
/// - 保护个人隐私信息
/// - 定期更新状态信息
/// - 优化个性化体验
/// - 建立良好使用习惯