sino-bc-cli 1.8.12 → 1.8.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/README.md +139 -542
  2. package/dist/api-doc/oapi/dashboard.md +18 -18
  3. package/dist/api-doc/oapi/delivery.md +13 -8
  4. package/dist/api-doc/oapi/im.md +5 -2
  5. package/dist/api-doc/oapi/project.md +17 -8
  6. package/dist/api-doc/oapi/task.md +10 -10
  7. package/dist/generated/api-catalog.json +568 -274
  8. package/dist/index.js +1 -1
  9. package/package.json +1 -1
package/dist/api-doc/oapi/dashboard.md CHANGED
@@ -24,8 +24,8 @@
24
24
 
25
25
  | 字段 | 类型 | 位置 | 必填 | 说明 |
26
26
  | --- | --- | --- | --- | --- |
27
- | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
28
- | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
27
+ | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
28
+ | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
29
29
 
30
30
  ## 2. 媒体预算占比
31
31
 
@@ -45,8 +45,8 @@
45
45
 
46
46
  | 字段 | 类型 | 位置 | 必填 | 说明 |
47
47
  | --- | --- | --- | --- | --- |
48
- | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
49
- | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
48
+ | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
49
+ | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
50
50
 
51
51
  ## 3. 项目类型预算分布
52
52
 
@@ -66,8 +66,8 @@
66
66
 
67
67
  | 字段 | 类型 | 位置 | 必填 | 说明 |
68
68
  | --- | --- | --- | --- | --- |
69
- | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
70
- | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
69
+ | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
70
+ | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
71
71
 
72
72
  ## 4. 区域预算占比
73
73
 
@@ -87,8 +87,8 @@
87
87
 
88
88
  | 字段 | 类型 | 位置 | 必填 | 说明 |
89
89
  | --- | --- | --- | --- | --- |
90
- | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
91
- | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
90
+ | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
91
+ | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
92
92
  | `dimension` | string | body | 否 | 区域维度：COUNTRY 按国家、REGION 按大区；不传默认 COUNTRY |
93
93
 
94
94
  ## 5. 预算排行榜
@@ -109,8 +109,8 @@
109
109
 
110
110
  | 字段 | 类型 | 位置 | 必填 | 说明 |
111
111
  | --- | --- | --- | --- | --- |
112
- | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
113
- | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
112
+ | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
113
+ | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
114
114
  | `dimension` | string | body | 否 | 排行榜维度：PROJECT 按项目、BUSINESS_LINE 按业务线 |
115
115
  | `topN` | integer | body | 否 | 展示 Top 条数，默认 5 |
116
116
 
@@ -132,8 +132,8 @@
132
132
 
133
133
  | 字段 | 类型 | 位置 | 必填 | 说明 |
134
134
  | --- | --- | --- | --- | --- |
135
- | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
136
- | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
135
+ | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
136
+ | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
137
137
  | `dimension` | string | body | 否 | 占比维度：SOURCE 市场范围（t_project.market_scope），SEGMENT 渠道类型（t_project_budget.dim_type=SOURCE）；不传默认 SOURCE |
138
138
 
139
139
  ## 7. 关键项目时间轴
@@ -154,8 +154,8 @@
154
154
 
155
155
  | 字段 | 类型 | 位置 | 必填 | 说明 |
156
156
  | --- | --- | --- | --- | --- |
157
- | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
158
- | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
157
+ | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
158
+ | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
159
159
  | `topN` | integer | body | 否 | 展示条数，默认 5 |
160
160
 
161
161
  ## 8. 核心卡片指标
@@ -176,8 +176,8 @@
176
176
 
177
177
  | 字段 | 类型 | 位置 | 必填 | 说明 |
178
178
  | --- | --- | --- | --- | --- |
179
- | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
180
- | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
179
+ | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
180
+ | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
181
181
 
182
182
  ## 9. 项目分布
183
183
 
@@ -197,6 +197,6 @@
197
197
 
198
198
  | 字段 | 类型 | 位置 | 必填 | 说明 |
199
199
  | --- | --- | --- | --- | --- |
200
- | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
201
- | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年 |
200
+ | `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
201
+ | `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
202
202
  | `dimension` | string | body | 否 | 分布维度：STAGE 按当前阶段、LEVEL 按项目等级、TYPE 按项目类型 |
package/dist/api-doc/oapi/delivery.md CHANGED
@@ -105,8 +105,8 @@
105
105
  | 字段 | 类型 | 位置 | 必填 | 说明 |
106
106
  | --- | --- | --- | --- | --- |
107
107
  | `projectId` | integer | body | 否 | 项目id |
108
- | `startDate` | string | body | 否 | 统计开始时间 |
109
- | `endDate` | string | body | 否 | 统计结束时间 |
108
+ | `startDate` | string | body | 否 | 统计开始时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-16 14:30:00 |
109
+ | `endDate` | string | body | 否 | 统计结束时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-16 14:30:00 |
110
110
  | `granularity` | string | body | 否 | 时间粒度 DAY / WEEK；默认 WEEK，周期不足 2 周时默认 DAY |
111
111
  | `stageId` | integer | body | 否 | 投放阶段 ID（取自 stage-tabs）；>0 为阶段主键；0 强制项目总览； |
112
112
  | `indicators` | array | body | 否 | 选择指标 key 有序列表（来自 KA 指标卡配置） |
@@ -151,11 +151,16 @@
151
151
 
152
152
  查询项目成效列表
153
153
 
154
+ ### 日期字段说明（代码同步）
155
+ 入参 startDate/endDate 继承自 ICenter QueryParameter，格式 yyyy-MM-dd，例如 2026-09-16、2026-09-30。响应 DataView 的 data/dataList 为动态维度值，日期列按 ICenter 原样透传，以 header 及实际粒度为准，不统一转换日期格式。
156
+
154
157
  **输入参数（--data）**
155
158
 
156
159
  | 字段 | 类型 | 位置 | 必填 | 说明 |
157
160
  | --- | --- | --- | --- | --- |
158
161
  | `projectId` | integer | body | 否 | 项目id |
162
+ | `startDate` | string | body | 否 | 统计开始日期；继承自 ICenter QueryParameter；JSON 字符串，格式 yyyy-MM-dd，仅日期；示例：2026-09-16 |
163
+ | `endDate` | string | body | 否 | 统计结束日期；继承自 ICenter QueryParameter；JSON 字符串，格式 yyyy-MM-dd，仅日期；示例：2026-09-30 |
159
164
 
160
165
  ## 7. 维度分布
161
166
 
@@ -176,8 +181,8 @@
176
181
  | 字段 | 类型 | 位置 | 必填 | 说明 |
177
182
  | --- | --- | --- | --- | --- |
178
183
  | `projectId` | integer | body | 否 | 项目id |
179
- | `startDate` | string | body | 否 | 统计开始时间 |
180
- | `endDate` | string | body | 否 | 统计结束时间 |
184
+ | `startDate` | string | body | 否 | 统计开始时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-16 14:30:00 |
185
+ | `endDate` | string | body | 否 | 统计结束时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-16 14:30:00 |
181
186
  | `granularity` | string | body | 否 | 时间粒度 DAY / WEEK；默认 WEEK，周期不足 2 周时默认 DAY |
182
187
  | `stageId` | integer | body | 否 | 投放阶段 ID（取自 stage-tabs）；>0 为阶段主键；0 强制项目总览； |
183
188
  | `dimensionTab` | string | body | 否 | REGION / MEDIA / GOAL |
@@ -203,8 +208,8 @@ KPI 进度与走势
203
208
  | 字段 | 类型 | 位置 | 必填 | 说明 |
204
209
  | --- | --- | --- | --- | --- |
205
210
  | `projectId` | integer | body | 否 | 项目id |
206
- | `startDate` | string | body | 否 | 统计开始时间 |
207
- | `endDate` | string | body | 否 | 统计结束时间 |
211
+ | `startDate` | string | body | 否 | 统计开始时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-16 14:30:00 |
212
+ | `endDate` | string | body | 否 | 统计结束时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-16 14:30:00 |
208
213
  | `granularity` | string | body | 否 | 时间粒度 DAY / WEEK；默认 WEEK，周期不足 2 周时默认 DAY |
209
214
  | `stageId` | integer | body | 否 | 投放阶段 ID（取自 stage-tabs）；>0 为阶段主键；0 强制项目总览； |
210
215
 
@@ -227,8 +232,8 @@ KPI 进度与走势
227
232
  | 字段 | 类型 | 位置 | 必填 | 说明 |
228
233
  | --- | --- | --- | --- | --- |
229
234
  | `projectId` | integer | body | 否 | 项目id |
230
- | `startDate` | string | body | 否 | 统计开始时间 |
231
- | `endDate` | string | body | 否 | 统计结束时间 |
235
+ | `startDate` | string | body | 否 | 统计开始时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-16 14:30:00 |
236
+ | `endDate` | string | body | 否 | 统计结束时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-16 14:30:00 |
232
237
  | `granularity` | string | body | 否 | 时间粒度 DAY / WEEK；默认 WEEK，周期不足 2 周时默认 DAY |
233
238
  | `stageId` | integer | body | 否 | 投放阶段 ID（取自 stage-tabs）；>0 为阶段主键；0 强制项目总览； |
234
239
 
package/dist/api-doc/oapi/im.md CHANGED
@@ -112,6 +112,9 @@ taskId / logId 二选一。
112
112
 
113
113
  必填 chatId。
114
114
 
115
+ ### 日期字段说明（代码同步）
116
+ 必填 chatId。可选 senderOpenId、消息时间 startTime/endTime（yyyy-MM-dd HH:mm:ss，含边界）、keyword 模糊匹配 display_text 展示摘要。按 message_create_time 新→旧标准分页（pageNum/pageSize）。出参标明 MAIN/THREAD 归属；话题内回复回 threadRootMessageId。不含引用标记、表情回复。
117
+
115
118
  **输入参数（--data）**
116
119
 
117
120
  | 字段 | 类型 | 位置 | 必填 | 说明 |
@@ -122,8 +125,8 @@ taskId / logId 二选一。
122
125
  | `sortDirection` | string | body | 否 | 排序方向 ASC/DESC |
123
126
  | `chatId` | string | body | 否 | 飞书会话 ID |
124
127
  | `senderOpenId` | string | body | 否 | 发送者 open_id |
125
- | `startTime` | string | body | 否 | 消息创建时间起（含） |
126
- | `endTime` | string | body | 否 | 消息创建时间止（含） |
128
+ | `startTime` | string | body | 否 | 消息创建时间起（含）；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-01 00:00:00 |
129
+ | `endTime` | string | body | 否 | 消息创建时间止（含）；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-02 23:59:59 |
127
130
  | `keyword` | string | body | 否 | 内容关键字，模糊匹配 display_text 展示摘要 |
128
131
 
129
132
  ## 6. 按引用链根查询根消息及全部回复
package/dist/api-doc/oapi/project.md CHANGED
@@ -67,8 +67,8 @@
67
67
  | `projectInfo` | string | body | 否 | 项目信息（最多2000字，纯富文本内容，附件通过t_nexus_document管理） |
68
68
  | `stageTemplateId` | integer | body | 否 | 创建时选用的阶段模板来源（运营统计） |
69
69
  | `projectLevel` | string | body | 否 | S/A/B/C |
70
- | `startDate` | string | body | 否 | 项目开始时间 |
71
- | `endDate` | string | body | 否 | 项目结束时间 |
70
+ | `startDate` | string | body | 否 | 项目开始时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
71
+ | `endDate` | string | body | 否 | 项目结束时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
72
72
  | `projectType` | string | body | 否 | 项目类型 |
73
73
  | `businessLine` | string | body | 否 | 所属业务线编码 |
74
74
  | `marketScope` | string | body | 否 | 市场范围编码 |
@@ -122,6 +122,9 @@
122
122
 
123
123
  对客项目详情（平铺 JSON：ext_json values + 业务组装字段）
124
124
 
125
+ ### 日期字段说明（代码同步）
126
+ 业务日期字段以 ProjectVO 组装结果覆盖动态表单同名字段：startDate/endDate/projectChangeTime 为 yyyy-MM-dd HH:mm:ss.SSSSSS，例如 2026-09-16 14:30:00.123456；createTime/updateTime 及 deliveryStages 内起止时间为 yyyy-MM-dd HH:mm:ss，例如 2026-09-16 14:30:00。业务字段为空时不覆盖表单原值；其他动态日期字段保留表单原值，以表单 schema 为准。
127
+
125
128
  **输入参数（--data）**
126
129
 
127
130
  | 字段 | 类型 | 位置 | 必填 | 说明 |
@@ -228,6 +231,9 @@
228
231
 
229
232
  Formily 平铺 JSON 创建对客项目（从 body 取 templateType/templateId；响应同详情平铺）
230
233
 
234
+ ### 日期字段说明（代码同步）
235
+ 业务日期入参建议使用 yyyy-MM-dd HH:mm:ss，例如 startDate=2026-09-16 00:00:00；动态表单日期按 schema 提交，由 Fastjson 转换至业务 DTO。响应日期口径见 /project/detail，项目起止/变更时间示例 2026-09-16 00:00:00.000000，其他动态字段原样保留。
236
+
231
237
  ## 11. Formily 平铺 JSON 编辑对客项目（从 body 取 id/templateType/templateId；响应同详情平铺）
232
238
 
233
239
  `POST /sino-bc-nexus/project/form-update`
@@ -242,6 +248,9 @@ Formily 平铺 JSON 创建对客项目（从 body 取 templateType/templateId；
242
248
 
243
249
  Formily 平铺 JSON 编辑对客项目（从 body 取 id/templateType/templateId；响应同详情平铺）
244
250
 
251
+ ### 日期字段说明（代码同步）
252
+ 业务日期入参建议使用 yyyy-MM-dd HH:mm:ss，例如 endDate=2026-09-30 23:59:59；动态表单日期按 schema 提交，由 Fastjson 转换至业务 DTO。响应日期口径见 /project/detail，项目起止/变更时间示例 2026-09-30 23:59:59.000000，其他动态字段原样保留。
253
+
245
254
  ## 12. 批量修改项目分组（将指定项目移动到目标分组）
246
255
 
247
256
  `POST /sino-bc-nexus/project-group/batch-update-projects`
@@ -526,10 +535,10 @@ Formily 平铺 JSON 编辑对客项目（从 body 取 id/templateType/templateId
526
535
  | `projectTypeList` | array | body | 否 | 项目类型多选 |
527
536
  | `stageNameList` | array | body | 否 | 当前阶段名称多选（与仪表盘阶段分布 code 一致） |
528
537
  | `projectStatus` | string | body | 否 | 项目状态（可选，空=全部） |
529
- | `createTimeStart` | string | body | 否 | 项目创建时间开始（非必填） |
530
- | `createTimeEnd` | string | body | 否 | 项目创建时间结束（非必填） |
531
- | `startDate` | string | body | 否 | 项目开始时间（非必填，筛选 start_date >= startDate） |
532
- | `endDate` | string | body | 否 | 项目结束时间（非必填，筛选 end_date <= endDate） |
538
+ | `createTimeStart` | string | body | 否 | 项目创建时间开始（非必填）；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
539
+ | `createTimeEnd` | string | body | 否 | 项目创建时间结束（非必填）；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
540
+ | `startDate` | string | body | 否 | 项目开始时间（非必填，筛选 start_date >= startDate）；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
541
+ | `endDate` | string | body | 否 | 项目结束时间（非必填，筛选 end_date <= endDate）；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
533
542
 
534
543
  ## 25. 更新对客项目状态
535
544
 
@@ -576,8 +585,8 @@ Formily 平铺 JSON 编辑对客项目（从 body 取 id/templateType/templateId
576
585
  | `projectInfo` | string | body | 否 | 项目信息（最多2000字，纯富文本内容） |
577
586
  | `stageTemplateId` | integer | body | 否 | 创建时选用的阶段模板来源（运营统计） |
578
587
  | `projectLevel` | string | body | 否 | S/A/B/C |
579
- | `startDate` | string | body | 否 | 项目开始时间 |
580
- | `endDate` | string | body | 否 | 项目结束时间 |
588
+ | `startDate` | string | body | 否 | 项目开始时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
589
+ | `endDate` | string | body | 否 | 项目结束时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
581
590
  | `projectStatus` | string | body | 否 | 项目状态 |
582
591
  | `projectType` | string | body | 否 | 项目类型 |
583
592
  | `businessLine` | string | body | 否 | 所属业务线编码 |
package/dist/api-doc/oapi/task.md CHANGED
@@ -54,7 +54,7 @@
54
54
  | `taskId` | integer | body | 否 | 任务ID |
55
55
  | `name` | string | body | 否 | 任务名称 |
56
56
  | `taskInfo` | string | body | 否 | 任务信息，富文本 |
57
- | `dueAt` | string | body | 否 | 截止时间 |
57
+ | `dueAt` | string | body | 否 | 截止时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
58
58
  | `members` | array | body | 否 | 任务成员列表（userId + role） |
59
59
  | `uploadRecordIdList` | array | body | 否 | 附件上传记录ID列表（来自文件上传接口返回的uploadRecordId） |
60
60
  | `skipPendingExecution` | boolean | body | 否 | 是否跳过待执行：true-跳过 false-不跳过；不传沿用任务已有值 |
@@ -126,7 +126,7 @@
126
126
  | `stageId` | integer | body | 否 | 阶段ID |
127
127
  | `name` | string | body | 否 | 任务名称 |
128
128
  | `taskInfo` | string | body | 否 | 任务信息，富文本 |
129
- | `dueAt` | string | body | 否 | 截止时间 |
129
+ | `dueAt` | string | body | 否 | 截止时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
130
130
  | `members` | array | body | 否 | 任务成员列表（userId + role） |
131
131
  | `uploadRecordIdList` | array | body | 否 | 附件上传记录ID列表（来自文件上传接口返回的uploadRecordId） |
132
132
  | `skipPendingExecution` | boolean | body | 否 | 是否跳过待执行：true-跳过 false-不跳过；不传默认true |
@@ -198,7 +198,7 @@
198
198
  | `taskId` | integer | body | 否 | 任务ID |
199
199
  | `name` | string | body | 否 | 任务名称 |
200
200
  | `taskInfo` | string | body | 否 | 任务信息，富文本 |
201
- | `dueAt` | string | body | 否 | 截止时间 |
201
+ | `dueAt` | string | body | 否 | 截止时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
202
202
  | `members` | array | body | 否 | 任务成员列表（userId + role） |
203
203
  | `uploadRecordIdList` | array | body | 否 | 附件上传记录ID列表（来自文件上传接口返回的uploadRecordId） |
204
204
  | `skipPendingExecution` | boolean | body | 否 | 是否跳过待执行：true-跳过 false-不跳过；不传不修改 |
@@ -229,8 +229,8 @@
229
229
  | `status` | string | body | 否 | 任务状态 |
230
230
  | `statusList` | array | body | 否 | 任务状态列表 |
231
231
  | `todoFlag` | boolean | body | 否 | 仅查询待办任务标识 |
232
- | `dueAtStart` | string | body | 否 | 截止时间-起 |
233
- | `dueAtEnd` | string | body | 否 | 截止时间-止 |
232
+ | `dueAtStart` | string | body | 否 | 截止时间-起；LocalDateTime，JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；包含时分秒，精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
233
+ | `dueAtEnd` | string | body | 否 | 截止时间-止；LocalDateTime，JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；包含时分秒，精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
234
234
 
235
235
  ## 10. 协同任务列表（分页）
236
236
 
@@ -262,11 +262,11 @@
262
262
  | `status` | string | body | 否 | 任务状态 |
263
263
  | `statusList` | array | body | 否 | 任务状态列表，元素为 TaskStatusTypeEnum.type。 |
264
264
  | `todoFlag` | boolean | body | 否 | 仅查询待办任务标识 |
265
- | `dueAtStart` | string | body | 否 | 截止时间-起 |
266
- | `dueAtEnd` | string | body | 否 | 截止时间-止 |
265
+ | `dueAtStart` | string | body | 否 | 截止时间-起；LocalDateTime，JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；包含时分秒，精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
266
+ | `dueAtEnd` | string | body | 否 | 截止时间-止；LocalDateTime，JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；包含时分秒，精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
267
267
  | `projectStatus` | string | body | 否 | 项目状态（可选，空=全部），与 /project/page 一致：PENDING/IN_PROGRESS/FINISHED |
268
- | `projectStartDate` | string | body | 否 | 项目开始日期（格式 yyyy-MM-dd；与 projectEndDate 同时传入才启用项目时间筛选，不传则无时间限制） |
269
- | `projectEndDate` | string | body | 否 | 项目结束日期（格式 yyyy-MM-dd；与 projectStartDate 同时传入才启用项目时间筛选，不传则无时间限制） |
268
+ | `projectStartDate` | string | body | 否 | 项目开始日期（格式 yyyy-MM-dd；与 projectEndDate 同时传入才启用项目时间筛选，不传则无时间限制）；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
269
+ | `projectEndDate` | string | body | 否 | 项目结束日期（格式 yyyy-MM-dd；与 projectStartDate 同时传入才启用项目时间筛选，不传则无时间限制）；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
270
270
 
271
271
  ## 11. 暂停任务
272
272
 
@@ -310,7 +310,7 @@
310
310
  | `deliveryId` | integer | body | 否 | 交付记录ID |
311
311
  | `confirmComment` | string | body | 否 | 驳回原因 |
312
312
  | `taskInfo` | string | body | 否 | 修改后的任务信息，富文本 |
313
- | `dueAt` | string | body | 否 | 修改后的截止时间 |
313
+ | `dueAt` | string | body | 否 | 修改后的截止时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
314
314
  | `members` | array | body | 否 | 修改后的任务成员列表（userId + role） |
315
315
  | `uploadRecordIdList` | array | body | 否 | 驳回附件上传记录ID列表（来自文件上传接口返回的uploadRecordId） |
316
316