sino-bc-cli 1.0.0-beta.0

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 (123) hide show
  1. package/README.md +256 -0
  2. package/dist/affordance/auth.md +31 -0
  3. package/dist/affordance/bill.md +48 -0
  4. package/dist/affordance/biz-line-ai-strategy.md +35 -0
  5. package/dist/affordance/biz-line-metrics.md +47 -0
  6. package/dist/affordance/biz-line.md +84 -0
  7. package/dist/affordance/common-file.md +25 -0
  8. package/dist/affordance/dashboard.md +75 -0
  9. package/dist/affordance/dict.md +28 -0
  10. package/dist/affordance/document.md +67 -0
  11. package/dist/affordance/im.md +91 -0
  12. package/dist/affordance/invoice.md +49 -0
  13. package/dist/affordance/media.md +17 -0
  14. package/dist/affordance/organization.md +47 -0
  15. package/dist/affordance/project-analysis.md +95 -0
  16. package/dist/affordance/project.md +321 -0
  17. package/dist/affordance/quota.md +19 -0
  18. package/dist/affordance/reconciliation.md +41 -0
  19. package/dist/affordance/report.md +75 -0
  20. package/dist/affordance/sso-team-group.md +30 -0
  21. package/dist/affordance/task.md +148 -0
  22. package/dist/affordance/tenant.md +17 -0
  23. package/dist/affordance/user.md +41 -0
  24. package/dist/affordance/wallet.md +100 -0
  25. package/dist/api-doc/README.md +67 -0
  26. package/dist/api-doc/custom/template.md +0 -0
  27. package/dist/api-doc/oapi/auth.md +61 -0
  28. package/dist/api-doc/oapi/bill.md +130 -0
  29. package/dist/api-doc/oapi/biz-line-ai-strategy.md +119 -0
  30. package/dist/api-doc/oapi/biz-line-metrics.md +419 -0
  31. package/dist/api-doc/oapi/biz-line.md +382 -0
  32. package/dist/api-doc/oapi/common-file.md +50 -0
  33. package/dist/api-doc/oapi/dashboard.md +218 -0
  34. package/dist/api-doc/oapi/dict.md +49 -0
  35. package/dist/api-doc/oapi/document.md +182 -0
  36. package/dist/api-doc/oapi/im.md +278 -0
  37. package/dist/api-doc/oapi/invoice.md +129 -0
  38. package/dist/api-doc/oapi/media.md +17 -0
  39. package/dist/api-doc/oapi/organization.md +94 -0
  40. package/dist/api-doc/oapi/project-analysis.md +364 -0
  41. package/dist/api-doc/oapi/project.md +1114 -0
  42. package/dist/api-doc/oapi/quota.md +21 -0
  43. package/dist/api-doc/oapi/reconciliation.md +98 -0
  44. package/dist/api-doc/oapi/report.md +254 -0
  45. package/dist/api-doc/oapi/sso-team-group.md +54 -0
  46. package/dist/api-doc/oapi/task.md +528 -0
  47. package/dist/api-doc/oapi/tenant.md +17 -0
  48. package/dist/api-doc/oapi/user.md +98 -0
  49. package/dist/api-doc/oapi/wallet.md +275 -0
  50. package/dist/generated/api-catalog.json +39681 -0
  51. package/dist/generated/api-directory-index.json +1509 -0
  52. package/dist/index.js +2 -0
  53. package/dist/skill-manifest.json +336 -0
  54. package/dist/skills/biz-line-strategy-generate/SKILL.md +122 -0
  55. package/dist/skills/biz-line-strategy-generate/references/ai-strategy-prompt.md +50 -0
  56. package/dist/skills/biz-line-strategy-generate/references/api-flow.md +155 -0
  57. package/dist/skills/biz-line-strategy-generate/references/four-strategies.md +58 -0
  58. package/dist/skills/biz-line-strategy-generate/references/metrics.md +119 -0
  59. package/dist/skills/biz-line-strategy-generate/references/output-excel.md +63 -0
  60. package/dist/skills/biz-line-strategy-generate/references/runtime.md +127 -0
  61. package/dist/skills/biz-line-strategy-generate/references/spec.md +500 -0
  62. package/dist/skills/biz-line-strategy-generate/scripts/ai_strategy.py +89 -0
  63. package/dist/skills/biz-line-strategy-generate/scripts/build_report.py +629 -0
  64. package/dist/skills/biz-line-strategy-generate/scripts/cleanup.py +87 -0
  65. package/dist/skills/biz-line-strategy-generate/scripts/cli_json.py +705 -0
  66. package/dist/skills/biz-line-strategy-generate/scripts/fetch_data.py +449 -0
  67. package/dist/skills/biz-line-strategy-generate/scripts/run_workflow.py +402 -0
  68. package/dist/skills/biz-line-strategy-generate/scripts/strategy_output.py +556 -0
  69. package/dist/skills/biz-line-strategy-generate/scripts/submit_tags.py +32 -0
  70. package/dist/skills/biz-line-strategy-generate/scripts/summarize.py +932 -0
  71. package/dist/skills/biz-line-strategy-generate/scripts/test_ai_strategy.py +235 -0
  72. package/dist/skills/biz-line-strategy-generate/scripts/test_cli_json.py +97 -0
  73. package/dist/skills/biz-line-strategy-generate/scripts/test_database_output.py +904 -0
  74. package/dist/skills/biz-line-strategy-generate/scripts/test_pipeline.py +253 -0
  75. package/dist/skills/biz-line-strategy-generate/scripts/test_strategy_rules.py +224 -0
  76. package/dist/skills/biz-line-strategy-generate/scripts/test_tag_submission.py +238 -0
  77. package/dist/skills/biz-line-strategy-generate/scripts/test_workflow.py +1233 -0
  78. package/dist/skills/sino-bc-cli/SKILL.md +62 -0
  79. package/dist/skills/sino-bc-cli/domains/sino-bc-auth/SKILL.md +36 -0
  80. package/dist/skills/sino-bc-cli/domains/sino-bc-bill/SKILL.md +48 -0
  81. package/dist/skills/sino-bc-cli/domains/sino-bc-biz-line/SKILL.md +58 -0
  82. package/dist/skills/sino-bc-cli/domains/sino-bc-biz-line/references/common-mistakes.md +7 -0
  83. package/dist/skills/sino-bc-cli/domains/sino-bc-biz-line/references/enums.md +13 -0
  84. package/dist/skills/sino-bc-cli/domains/sino-bc-biz-line-ai-strategy/SKILL.md +46 -0
  85. package/dist/skills/sino-bc-cli/domains/sino-bc-biz-line-metrics/SKILL.md +46 -0
  86. package/dist/skills/sino-bc-cli/domains/sino-bc-common-file/SKILL.md +44 -0
  87. package/dist/skills/sino-bc-cli/domains/sino-bc-dashboard/SKILL.md +50 -0
  88. package/dist/skills/sino-bc-cli/domains/sino-bc-dict/SKILL.md +48 -0
  89. package/dist/skills/sino-bc-cli/domains/sino-bc-document/SKILL.md +53 -0
  90. package/dist/skills/sino-bc-cli/domains/sino-bc-im/SKILL.md +62 -0
  91. package/dist/skills/sino-bc-cli/domains/sino-bc-invoice/SKILL.md +48 -0
  92. package/dist/skills/sino-bc-cli/domains/sino-bc-media/SKILL.md +40 -0
  93. package/dist/skills/sino-bc-cli/domains/sino-bc-organization/SKILL.md +46 -0
  94. package/dist/skills/sino-bc-cli/domains/sino-bc-project/SKILL.md +112 -0
  95. package/dist/skills/sino-bc-cli/domains/sino-bc-project-analysis/SKILL.md +61 -0
  96. package/dist/skills/sino-bc-cli/domains/sino-bc-project-analysis/references/analysis-workflow.md +21 -0
  97. package/dist/skills/sino-bc-cli/domains/sino-bc-project-analysis/references/filters-and-metrics.md +30 -0
  98. package/dist/skills/sino-bc-cli/domains/sino-bc-quota/SKILL.md +44 -0
  99. package/dist/skills/sino-bc-cli/domains/sino-bc-reconciliation/SKILL.md +47 -0
  100. package/dist/skills/sino-bc-cli/domains/sino-bc-report/SKILL.md +53 -0
  101. package/dist/skills/sino-bc-cli/domains/sino-bc-sso-team-group/SKILL.md +45 -0
  102. package/dist/skills/sino-bc-cli/domains/sino-bc-task/SKILL.md +73 -0
  103. package/dist/skills/sino-bc-cli/domains/sino-bc-task/references/state-machine.md +18 -0
  104. package/dist/skills/sino-bc-cli/domains/sino-bc-tenant/SKILL.md +34 -0
  105. package/dist/skills/sino-bc-cli/domains/sino-bc-user/SKILL.md +57 -0
  106. package/dist/skills/sino-bc-cli/domains/sino-bc-wallet/SKILL.md +55 -0
  107. package/dist/skills/sino-bc-cli/references/domain-index/module-8534789.md +53 -0
  108. package/dist/skills/sino-bc-cli/references/domain-index/module-8551546.md +70 -0
  109. package/dist/skills/sino-bc-cli/references/domain-index/module-8562638.md +13 -0
  110. package/dist/skills/sino-bc-cli/references/domain-index/module-8566367.md +13 -0
  111. package/dist/skills/sino-bc-cli/references/domain-index/module-8581524.md +17 -0
  112. package/dist/skills/sino-bc-cli/references/domain-index/module-8601540.md +13 -0
  113. package/dist/skills/sino-bc-cli/references/domain-index/module-8614891.md +33 -0
  114. package/dist/skills/sino-bc-cli/references/domain-index/module-8621792.md +17 -0
  115. package/dist/skills/sino-bc-shared/SKILL.md +31 -0
  116. package/dist/skills/sino-bc-shared/references/auth-recovery.md +36 -0
  117. package/dist/skills/sino-bc-shared/references/config-and-env.md +60 -0
  118. package/dist/skills/sino-bc-shared/references/output-contract.md +86 -0
  119. package/dist/skills/sino-bc-shared/references/skill-lifecycle.md +17 -0
  120. package/dist/skills/sino-bc-shared/references/tenant-context.md +21 -0
  121. package/dist/skills/sino-bc-shared/references/write-approval.md +16 -0
  122. package/package.json +70 -0
  123. package/scripts/postinstall.cjs +36 -0
@@ -0,0 +1,94 @@
1
+ # 组织与用户
2
+
3
+ 对应命令:`organization +<shortcut>` 与 `organization api <name>`。
4
+
5
+ 执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口,再按命中条件读取其 references;当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
6
+
7
+ ## 1. 获取用户可以查看的签约主体列表
8
+
9
+ `GET /sino-bc-nexus/corporation/list`
10
+
11
+ 主体上下文:`tenant=true`。
12
+
13
+ 角色范围:`sso/passport/system`。
14
+
15
+ 风险:`read`。
16
+
17
+ 主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
18
+
19
+ 调用示例:`sino-bc-cli organization api corporation-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
20
+
21
+ 获取用户可以查看的签约主体列表
22
+
23
+ ## 2. 人员架构树
24
+
25
+ `GET /sino-bc-nexus/org-member/tree`
26
+
27
+ 主体上下文:`tenant=true`。
28
+
29
+ 角色范围:`sso/passport/system`。
30
+
31
+ 风险:`read`。
32
+
33
+ 主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
34
+
35
+ 调用示例:`sino-bc-cli organization api org-member-tree --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
36
+
37
+ 人员架构树
38
+
39
+ ## 3. 团队成员列表
40
+
41
+ `GET /sino-bc-nexus/team-member/list`
42
+
43
+ 主体上下文:`tenant=true`。
44
+
45
+ 角色范围:`sso/passport/system`。
46
+
47
+ 风险:`read`。
48
+
49
+ 主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
50
+
51
+ 调用示例:`sino-bc-cli organization api team-member-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
52
+
53
+ 团队成员列表
54
+
55
+ ## 4. 获取当前用户信息
56
+
57
+ `POST /sino-bc-nexus/user/info`
58
+
59
+ 主体上下文:`tenant=true`。
60
+
61
+ 角色范围:`sso/passport/system`。
62
+
63
+ 风险:`read`。
64
+
65
+ 主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
66
+
67
+ 调用示例:`sino-bc-cli organization api user-info --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
68
+
69
+ 获取当前用户信息
70
+
71
+ ## 5. 根据用户来源类型获取用户列表(包含SSO用户则只返回前10条)
72
+
73
+ `POST /sino-bc-nexus/user/listBySourceType`
74
+
75
+ 主体上下文:`tenant=true`。
76
+
77
+ 角色范围:`sso/passport/system`。
78
+
79
+ 风险:`read`。
80
+
81
+ 主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
82
+
83
+ 调用示例:`sino-bc-cli organization api user-listBySourceType --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
84
+
85
+ 根据用户来源类型获取用户列表(包含SSO用户则只返回前10条)
86
+
87
+ **输入参数(--data)**
88
+
89
+ | 字段 | 类型 | 位置 | 必填 | 说明 |
90
+ | --- | --- | --- | --- | --- |
91
+ | `sourceTypeList` | array | body | 否 | 用户来源类型列表(BD/OP/CUSTOM) |
92
+ | `keyword` | string | body | 否 | 用户名关键词(模糊匹配) |
93
+ | `returnAll` | boolean | body | 否 | 是否返回全量;默认 false(含 BD/OP 时最多 10 条) |
94
+ | `corporationId` | string | body | 否 | 签约主体ID |
@@ -0,0 +1,364 @@
1
+ # 优化项目分析
2
+
3
+ 对应命令:`project-analysis +<shortcut>` 与 `project-analysis api <name>`。
4
+
5
+ 执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口,再按命中条件读取其 references;当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
6
+
7
+ ## 1. 导出优化师人效列表
8
+
9
+ `POST /sino-opti-hive/project/analysis/exportMemberHREList`
10
+
11
+ 主体上下文:`tenant=false`。
12
+
13
+ 角色范围:`sso/system`。
14
+
15
+ 风险:`write`。
16
+
17
+ 按月份(含起止月份)与可选行业、项目、PM 组别、签约主体筛选;开始月份不能晚于结束月份。后端按登录用户项目权限查询。 该接口会创建 Excel 并返回文件 URL。
18
+
19
+ **输入参数(--data)**
20
+
21
+ | 字段 | 类型 | 位置 | 必填 | 说明 |
22
+ | --- | --- | --- | --- | --- |
23
+ | `startMonth` | string | body | 是 | 开始月份(yyyy-MM) |
24
+ | `endMonth` | string | body | 是 | 结束月份(yyyy-MM) |
25
+ | `industryList` | array | body | 否 | 行业list(APP、GAME、ECBR) |
26
+ | `projectIdList` | array | body | 否 | 项目id列表 |
27
+ | `ssoTeamCodeList` | array | body | 否 | 组别code列表 |
28
+ | `corporationIdList` | array | body | 否 | 签约主体筛选 ID 列表;不等同于网关 x-corporation-id 上下文 |
29
+
30
+ ## 2. 导出优化师工时列表
31
+
32
+ `POST /sino-opti-hive/project/analysis/exportMemberTimesheetList`
33
+
34
+ 主体上下文:`tenant=false`。
35
+
36
+ 角色范围:`sso/system`。
37
+
38
+ 风险:`write`。
39
+
40
+ 按月份(含起止月份)与可选行业、项目、PM 组别、签约主体筛选;开始月份不能晚于结束月份。后端按登录用户项目权限查询。 该接口会创建 Excel 并返回文件 URL。
41
+
42
+ **输入参数(--data)**
43
+
44
+ | 字段 | 类型 | 位置 | 必填 | 说明 |
45
+ | --- | --- | --- | --- | --- |
46
+ | `startMonth` | string | body | 是 | 开始月份(yyyy-MM) |
47
+ | `endMonth` | string | body | 是 | 结束月份(yyyy-MM) |
48
+ | `industryList` | array | body | 否 | 行业list(APP、GAME、ECBR) |
49
+ | `projectIdList` | array | body | 否 | 项目id列表 |
50
+ | `ssoTeamCodeList` | array | body | 否 | 组别code列表 |
51
+ | `corporationIdList` | array | body | 否 | 签约主体筛选 ID 列表;不等同于网关 x-corporation-id 上下文 |
52
+
53
+ ## 3. 导出项目数据列表
54
+
55
+ `POST /sino-opti-hive/project/analysis/exportProjectDataList`
56
+
57
+ 主体上下文:`tenant=false`。
58
+
59
+ 角色范围:`sso/system`。
60
+
61
+ 风险:`write`。
62
+
63
+ 按月份(含起止月份)与可选行业、项目、PM 组别、签约主体筛选;开始月份不能晚于结束月份。后端按登录用户项目权限查询。 该接口会创建 Excel 并返回文件 URL;导出项目列表由服务端覆盖分页为第一页和 Excel 最大行数。
64
+
65
+ **输入参数(--data)**
66
+
67
+ | 字段 | 类型 | 位置 | 必填 | 说明 |
68
+ | --- | --- | --- | --- | --- |
69
+ | `startMonth` | string | body | 是 | 开始月份(yyyy-MM) |
70
+ | `endMonth` | string | body | 是 | 结束月份(yyyy-MM) |
71
+ | `industryList` | array | body | 否 | 行业list(APP、GAME、ECBR) |
72
+ | `projectIdList` | array | body | 否 | 项目id列表 |
73
+ | `ssoTeamCodeList` | array | body | 否 | 组别code列表 |
74
+ | `corporationIdList` | array | body | 否 | 签约主体筛选 ID 列表;不等同于网关 x-corporation-id 上下文 |
75
+ | `pageNum` | integer | body | 否 | 页码,从 1 开始 |
76
+ | `pageSize` | integer | body | 否 | 每页条数,后端默认 10 |
77
+ | `pagination` | boolean | body | 否 | 继承字段;本接口实现不使用,始终按 pageNum/pageSize 分页 |
78
+ | `count` | boolean | body | 否 | 继承字段;本接口实现不使用 |
79
+ | `sortType` | string | body | 否 | 继承字段;本接口实现不使用 |
80
+ | `sortDirection` | string | body | 否 | 继承字段;本接口实现不使用 |
81
+ | `startIndex` | integer | body | 否 | 继承字段;本接口按 pageNum/pageSize 计算分页,不使用此字段 |
82
+
83
+ ## 4. 查询优化师人效列表
84
+
85
+ `POST /sino-opti-hive/project/analysis/getMemberHREList`
86
+
87
+ 主体上下文:`tenant=false`。
88
+
89
+ 角色范围:`sso/system`。
90
+
91
+ 风险:`read`。
92
+
93
+ 按月份(含起止月份)与可选行业、项目、PM 组别、签约主体筛选;开始月份不能晚于结束月份。后端按登录用户项目权限查询。
94
+
95
+ **输入参数(--data)**
96
+
97
+ | 字段 | 类型 | 位置 | 必填 | 说明 |
98
+ | --- | --- | --- | --- | --- |
99
+ | `startMonth` | string | body | 是 | 开始月份(yyyy-MM) |
100
+ | `endMonth` | string | body | 是 | 结束月份(yyyy-MM) |
101
+ | `industryList` | array | body | 否 | 行业list(APP、GAME、ECBR) |
102
+ | `projectIdList` | array | body | 否 | 项目id列表 |
103
+ | `ssoTeamCodeList` | array | body | 否 | 组别code列表 |
104
+ | `corporationIdList` | array | body | 否 | 签约主体筛选 ID 列表;不等同于网关 x-corporation-id 上下文 |
105
+
106
+ ## 5. 查询优化师消耗趋势
107
+
108
+ `POST /sino-opti-hive/project/analysis/trend/getMemberSpendTrend`
109
+
110
+ 主体上下文:`tenant=false`。
111
+
112
+ 角色范围:`sso/system`。
113
+
114
+ 风险:`read`。
115
+
116
+ 按月份(含起止月份)与可选行业、项目、PM 组别、签约主体筛选;开始月份不能晚于结束月份。后端按登录用户项目权限查询。 趋势粒度由后端配置决定,当前默认不超过 2 个月按周,否则按月;以 dateDisplay 为准。
117
+
118
+ **输入参数(--data)**
119
+
120
+ | 字段 | 类型 | 位置 | 必填 | 说明 |
121
+ | --- | --- | --- | --- | --- |
122
+ | `startMonth` | string | body | 是 | 开始月份(yyyy-MM) |
123
+ | `endMonth` | string | body | 是 | 结束月份(yyyy-MM) |
124
+ | `industryList` | array | body | 否 | 行业list(APP、GAME、ECBR) |
125
+ | `projectIdList` | array | body | 否 | 项目id列表 |
126
+ | `ssoTeamCodeList` | array | body | 否 | 组别code列表 |
127
+ | `corporationIdList` | array | body | 否 | 签约主体筛选 ID 列表;不等同于网关 x-corporation-id 上下文 |
128
+
129
+ ## 6. 查询优化师工时趋势
130
+
131
+ `POST /sino-opti-hive/project/analysis/trend/getMemberTimesheetTrend`
132
+
133
+ 主体上下文:`tenant=false`。
134
+
135
+ 角色范围:`sso/system`。
136
+
137
+ 风险:`read`。
138
+
139
+ 按月份(含起止月份)与可选行业、项目、PM 组别、签约主体筛选;开始月份不能晚于结束月份。后端按登录用户项目权限查询。 趋势粒度由后端配置决定,当前默认不超过 2 个月按周,否则按月;以 dateDisplay 为准。
140
+
141
+ **输入参数(--data)**
142
+
143
+ | 字段 | 类型 | 位置 | 必填 | 说明 |
144
+ | --- | --- | --- | --- | --- |
145
+ | `startMonth` | string | body | 是 | 开始月份(yyyy-MM) |
146
+ | `endMonth` | string | body | 是 | 结束月份(yyyy-MM) |
147
+ | `industryList` | array | body | 否 | 行业list(APP、GAME、ECBR) |
148
+ | `projectIdList` | array | body | 否 | 项目id列表 |
149
+ | `ssoTeamCodeList` | array | body | 否 | 组别code列表 |
150
+ | `corporationIdList` | array | body | 否 | 签约主体筛选 ID 列表;不等同于网关 x-corporation-id 上下文 |
151
+
152
+ ## 7. 查询优化师工时列表
153
+
154
+ `POST /sino-opti-hive/project/analysis/getMemberTimesheetList`
155
+
156
+ 主体上下文:`tenant=false`。
157
+
158
+ 角色范围:`sso/system`。
159
+
160
+ 风险:`read`。
161
+
162
+ 按月份(含起止月份)与可选行业、项目、PM 组别、签约主体筛选;开始月份不能晚于结束月份。后端按登录用户项目权限查询。
163
+
164
+ **输入参数(--data)**
165
+
166
+ | 字段 | 类型 | 位置 | 必填 | 说明 |
167
+ | --- | --- | --- | --- | --- |
168
+ | `startMonth` | string | body | 是 | 开始月份(yyyy-MM) |
169
+ | `endMonth` | string | body | 是 | 结束月份(yyyy-MM) |
170
+ | `industryList` | array | body | 否 | 行业list(APP、GAME、ECBR) |
171
+ | `projectIdList` | array | body | 否 | 项目id列表 |
172
+ | `ssoTeamCodeList` | array | body | 否 | 组别code列表 |
173
+ | `corporationIdList` | array | body | 否 | 签约主体筛选 ID 列表;不等同于网关 x-corporation-id 上下文 |
174
+
175
+ ## 8. 查询项目数据列表
176
+
177
+ `POST /sino-opti-hive/project/analysis/getProjectDataList`
178
+
179
+ 主体上下文:`tenant=false`。
180
+
181
+ 角色范围:`sso/system`。
182
+
183
+ 风险:`read`。
184
+
185
+ 按月份(含起止月份)与可选行业、项目、PM 组别、签约主体筛选;开始月份不能晚于结束月份。后端按登录用户项目权限查询。
186
+
187
+ **输入参数(--data)**
188
+
189
+ | 字段 | 类型 | 位置 | 必填 | 说明 |
190
+ | --- | --- | --- | --- | --- |
191
+ | `startMonth` | string | body | 是 | 开始月份(yyyy-MM) |
192
+ | `endMonth` | string | body | 是 | 结束月份(yyyy-MM) |
193
+ | `industryList` | array | body | 否 | 行业list(APP、GAME、ECBR) |
194
+ | `projectIdList` | array | body | 否 | 项目id列表 |
195
+ | `ssoTeamCodeList` | array | body | 否 | 组别code列表 |
196
+ | `corporationIdList` | array | body | 否 | 签约主体筛选 ID 列表;不等同于网关 x-corporation-id 上下文 |
197
+ | `pageNum` | integer | body | 否 | 页码,从 1 开始 |
198
+ | `pageSize` | integer | body | 否 | 每页条数,后端默认 10 |
199
+ | `pagination` | boolean | body | 否 | 继承字段;本接口实现不使用,始终按 pageNum/pageSize 分页 |
200
+ | `count` | boolean | body | 否 | 继承字段;本接口实现不使用 |
201
+ | `sortType` | string | body | 否 | 继承字段;本接口实现不使用 |
202
+ | `sortDirection` | string | body | 否 | 继承字段;本接口实现不使用 |
203
+ | `startIndex` | integer | body | 否 | 继承字段;本接口按 pageNum/pageSize 计算分页,不使用此字段 |
204
+
205
+ ## 9. 查询单位工时消耗趋势
206
+
207
+ `POST /sino-opti-hive/project/analysis/trend/getSpendPerHour`
208
+
209
+ 主体上下文:`tenant=false`。
210
+
211
+ 角色范围:`sso/system`。
212
+
213
+ 风险:`read`。
214
+
215
+ 按月份(含起止月份)与可选行业、项目、PM 组别、签约主体筛选;开始月份不能晚于结束月份。后端按登录用户项目权限查询。 趋势粒度由后端配置决定,当前默认不超过 2 个月按周,否则按月;以 dateDisplay 为准。
216
+
217
+ **输入参数(--data)**
218
+
219
+ | 字段 | 类型 | 位置 | 必填 | 说明 |
220
+ | --- | --- | --- | --- | --- |
221
+ | `startMonth` | string | body | 是 | 开始月份(yyyy-MM) |
222
+ | `endMonth` | string | body | 是 | 结束月份(yyyy-MM) |
223
+ | `industryList` | array | body | 否 | 行业list(APP、GAME、ECBR) |
224
+ | `projectIdList` | array | body | 否 | 项目id列表 |
225
+ | `ssoTeamCodeList` | array | body | 否 | 组别code列表 |
226
+ | `corporationIdList` | array | body | 否 | 签约主体筛选 ID 列表;不等同于网关 x-corporation-id 上下文 |
227
+
228
+ ## 10. 查询消耗与工时趋势
229
+
230
+ `POST /sino-opti-hive/project/analysis/trend/getSpendTimesheet`
231
+
232
+ 主体上下文:`tenant=false`。
233
+
234
+ 角色范围:`sso/system`。
235
+
236
+ 风险:`read`。
237
+
238
+ 按月份(含起止月份)与可选行业、项目、PM 组别、签约主体筛选;开始月份不能晚于结束月份。后端按登录用户项目权限查询。 趋势粒度由后端配置决定,当前默认不超过 2 个月按周,否则按月;以 dateDisplay 为准。
239
+
240
+ **输入参数(--data)**
241
+
242
+ | 字段 | 类型 | 位置 | 必填 | 说明 |
243
+ | --- | --- | --- | --- | --- |
244
+ | `startMonth` | string | body | 是 | 开始月份(yyyy-MM) |
245
+ | `endMonth` | string | body | 是 | 结束月份(yyyy-MM) |
246
+ | `industryList` | array | body | 否 | 行业list(APP、GAME、ECBR) |
247
+ | `projectIdList` | array | body | 否 | 项目id列表 |
248
+ | `ssoTeamCodeList` | array | body | 否 | 组别code列表 |
249
+ | `corporationIdList` | array | body | 否 | 签约主体筛选 ID 列表;不等同于网关 x-corporation-id 上下文 |
250
+
251
+ ## 11. 查询分析汇总
252
+
253
+ `POST /sino-opti-hive/project/analysis/getSummaryData`
254
+
255
+ 主体上下文:`tenant=false`。
256
+
257
+ 角色范围:`sso/system`。
258
+
259
+ 风险:`read`。
260
+
261
+ 按月份(含起止月份)与可选行业、项目、PM 组别、签约主体筛选;开始月份不能晚于结束月份。后端按登录用户项目权限查询。
262
+
263
+ **输入参数(--data)**
264
+
265
+ | 字段 | 类型 | 位置 | 必填 | 说明 |
266
+ | --- | --- | --- | --- | --- |
267
+ | `startMonth` | string | body | 是 | 开始月份(yyyy-MM) |
268
+ | `endMonth` | string | body | 是 | 结束月份(yyyy-MM) |
269
+ | `industryList` | array | body | 否 | 行业list(APP、GAME、ECBR) |
270
+ | `projectIdList` | array | body | 否 | 项目id列表 |
271
+ | `ssoTeamCodeList` | array | body | 否 | 组别code列表 |
272
+ | `corporationIdList` | array | body | 否 | 签约主体筛选 ID 列表;不等同于网关 x-corporation-id 上下文 |
273
+
274
+ ## 12. 查询工时系统项目列表(分页)
275
+
276
+ `POST /sino-opti-hive/atw/query/pageProjects`
277
+
278
+ 主体上下文:`tenant=false`。
279
+
280
+ 角色范围:`sso/system`。
281
+
282
+ 风险:`read`。
283
+
284
+ 分页查询工时系统项目列表,对应 t_atw_project 单表数据。
285
+
286
+ **输入参数(--data)**
287
+
288
+ | 字段 | 类型 | 位置 | 必填 | 说明 |
289
+ | --- | --- | --- | --- | --- |
290
+ | `pageNum` | integer | body | 否 | 页码,从1开始;省略默认1,显式null或小于1时报错 |
291
+ | `pageSize` | integer | body | 否 | 每页条数,省略默认10,显式null或小于1时报错 |
292
+ | `atwProjectIdList` | array | body | 否 | 工时系统项目ID列表,IN 查询;不传或空列表不筛选 |
293
+ | `atwCreateTimeStart` | string | body | 否 | 工时系统项目创建时间区间开始(含),可单独传入,格式 yyyy-MM-dd HH:mm:ss |
294
+ | `atwCreateTimeEnd` | string | body | 否 | 工时系统项目创建时间区间结束(含),可单独传入,格式 yyyy-MM-dd HH:mm:ss |
295
+ | `projectIdList` | array | body | 否 | 项目ID列表,IN 查询;不传或空列表不筛选 |
296
+ | `name` | string | body | 否 | 工时系统项目名称;包含匹配,空白不筛选 |
297
+ | `kindCode` | string | body | 否 | 服务产品编码,来自工时系统字典;已知示例:1=广告优化运营(代投)、85=广告诊断顾问、-888=售前咨询,非固定枚举;精确匹配,不传不筛选 |
298
+
299
+ ## 13. 查询工时系统项目任务列表(分页)
300
+
301
+ `POST /sino-opti-hive/atw/query/pageTasks`
302
+
303
+ 主体上下文:`tenant=false`。
304
+
305
+ 角色范围:`sso/system`。
306
+
307
+ 风险:`read`。
308
+
309
+ 分页查询工时系统项目任务列表,对应 t_atw_task 单表数据。
310
+
311
+ **输入参数(--data)**
312
+
313
+ | 字段 | 类型 | 位置 | 必填 | 说明 |
314
+ | --- | --- | --- | --- | --- |
315
+ | `pageNum` | integer | body | 否 | 页码,从1开始;省略默认1,显式null或小于1时报错 |
316
+ | `pageSize` | integer | body | 否 | 每页条数,省略默认10,显式null或小于1时报错 |
317
+ | `atwTaskIdList` | array | body | 否 | 工时系统任务ID列表,IN 查询;不传或空列表不筛选 |
318
+ | `atwProjectIdList` | array | body | 否 | 工时系统项目ID列表,IN 查询;不传或空列表不筛选 |
319
+ | `projectIdList` | array | body | 否 | 项目ID列表,IN 查询;不传或空列表不筛选 |
320
+ | `name` | string | body | 否 | 工时系统任务名称;包含匹配,空白不筛选 |
321
+
322
+ ## 14. 查询工时系统工时明细(分页)
323
+
324
+ `POST /sino-opti-hive/atw/query/pageTimesheets`
325
+
326
+ 主体上下文:`tenant=false`。
327
+
328
+ 角色范围:`sso/system`。
329
+
330
+ 风险:`read`。
331
+
332
+ 分页查询工时系统工时明细,对应 t_atw_timesheet 单表数据。
333
+
334
+ **输入参数(--data)**
335
+
336
+ | 字段 | 类型 | 位置 | 必填 | 说明 |
337
+ | --- | --- | --- | --- | --- |
338
+ | `pageNum` | integer | body | 否 | 页码,从1开始;省略默认1,显式null或小于1时报错 |
339
+ | `pageSize` | integer | body | 否 | 每页条数,省略默认10,显式null或小于1时报错 |
340
+ | `atwTimesheetIdList` | array | body | 否 | 工时ID列表,IN 查询;不传或空列表不筛选 |
341
+ | `atwProjectIdList` | array | body | 否 | 工时系统项目ID列表,IN 查询;不传或空列表不筛选 |
342
+ | `atwProjectName` | string | body | 否 | 工时系统项目名称;包含匹配,空白不筛选 |
343
+ | `atwTaskIdList` | array | body | 否 | 工时系统任务ID列表,IN 查询;不传或空列表不筛选 |
344
+ | `atwTaskName` | string | body | 否 | 工时系统任务名称;包含匹配,空白不筛选 |
345
+ | `atwParentTaskIdList` | array | body | 否 | 工时系统父任务ID列表,IN 查询;不传或空列表不筛选 |
346
+ | `atwParentTaskName` | string | body | 否 | 工时系统父任务名称;包含匹配,空白不筛选 |
347
+ | `projectIdList` | array | body | 否 | 项目ID列表,IN 查询;不传或空列表不筛选 |
348
+ | `kindCode` | string | body | 否 | 服务产品编码,来自工时系统字典;已知示例:1=广告优化运营(代投)、85=广告诊断顾问、-888=售前咨询,非固定枚举;精确匹配,不传不筛选 |
349
+ | `kindName` | string | body | 否 | 服务产品名称,来自工时系统字典;包含匹配,空白不筛选 |
350
+ | `userIdList` | array | body | 否 | 用户ID列表,IN 查询;不传或空列表不筛选 |
351
+ | `channelName` | string | body | 否 | 媒体渠道名称,映射表中 channel 列;例如 Facebook、Google,来自工时系统渠道字典;精确匹配,不传不筛选 |
352
+ | `roleType` | string | body | 否 | 角色名称,已有映射:PM、主优化师、其他优化师、优化组长、其他成员;传名称,不传角色数字ID;精确匹配,不传不筛选 |
353
+ | `entryDate` | string | body | 否 | 工时填写归属日,格式 yyyy-MM-dd;精确匹配,不传不筛选 |
354
+ | `year` | integer | body | 否 | 工时填写归属年,格式 yyyy,例如 2026;精确匹配,不传不筛选 |
355
+ | `month` | integer | body | 否 | 工时填写归属月,格式 yyyyMM,例如 202609;精确匹配,不传不筛选 |
356
+ | `week` | integer | body | 否 | 工时填写归属周,格式 YYYYww(ISO周所属年份+两位周数,01–53),例如 202639=2026年第39周;周一开始,跨年时周所属年份可能与日历年份不同;精确匹配,不传不筛选 |
357
+ | `hour` | number | body | 否 | 填写工时,单位小时,支持小数;精确匹配,不传不筛选 |
358
+ | `timeCode` | string | body | 否 | 工时类型编码,来自工时系统字典;不是 time_code_type(REGULAR_TIME/LEAVE_TIME/OVER_TIME);精确匹配,不传不筛选 |
359
+ | `timeCodeName` | string | body | 否 | 工时类型名称,来自工时系统字典,与 timeCode 对应;包含匹配,空白不筛选 |
360
+ | `activity` | string | body | 否 | 审批状态:UNCOMMITTED=已保存,APPROVING=待审批,REJECTED=未通过,APPROVED=已批准;精确匹配,不传不筛选 |
361
+ | `submitDateStart` | string | body | 否 | 工时提交时间区间开始(含),可单独传入,格式 yyyy-MM-dd HH:mm:ss |
362
+ | `submitDateEnd` | string | body | 否 | 工时提交时间区间结束(含),可单独传入,格式 yyyy-MM-dd HH:mm:ss |
363
+ | `approvedDateStart` | string | body | 否 | 工时审批时间区间开始(含),可单独传入,格式 yyyy-MM-dd HH:mm:ss |
364
+ | `approvedDateEnd` | string | body | 否 | 工时审批时间区间结束(含),可单独传入,格式 yyyy-MM-dd HH:mm:ss |