sino-bc-cli 1.8.31 → 1.8.32

package/README.md

@@ -218,7 +218,13 @@ sino-bc-cli /uninstall --yes
 
 业务命令：`<域> +<命令>`；长尾：`<域> api <name> --data '<json>'`。先看帮助。
 
+优化组别统一使用 `sso-team-group` 域：`+group-list` 获取 code/name 选项，`+list` 查询管理信息，`+detail` 查询成员详情。
+
 ```bash
+sino-bc-cli sso-team-group --help
+sino-bc-cli sso-team-group +group-list
+sino-bc-cli sso-team-group +list --data '{}'
+sino-bc-cli sso-team-group +detail --data '{"code":"<组别code>"}'
 sino-bc-cli biz-line --help
 sino-bc-cli biz-line +list --data '{"name":"<业务线名称>"}'
 sino-bc-cli project-analysis +summary --data '{"startMonth":"2026-08","endMonth":"2026-08"}'

package/dist/affordance/biz-line.md

@@ -65,12 +65,6 @@
 - **示例**：`sino-bc-cli biz-line +categories --data '{...}'`
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
-## +group-list
-
-- **WHEN**：查询组别列表
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +group-list`
-
 ## +project-list
 
 - **WHEN**：查询业务线关联项目和广告账号

package/dist/affordance/sso-team-group.md

@@ -0,0 +1,30 @@
+# sso-team-group 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## +list
+
+- **WHEN**：优化组别列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli sso-team-group +list --data '{...}'`
+
+## +detail
+
+- **WHEN**：优化组别详情
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli sso-team-group +detail --data '{...}'`
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
+## +group-list
+
+- **WHEN**：优化组别选项列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli sso-team-group +group-list`
+
+## api
+
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli sso-team-group api <name> --data '{...}'`

package/dist/api-doc/README.md

@@ -20,7 +20,8 @@ Apifox 模块组织业务域导航，一级目录对应下表的 API Skill 与
 
 | 命令域 | 用途 | 接口文档 |
 | --- | --- | --- |
-| biz-line | 业务线、周策略、投放品类、策略标签、关联项目与 SSO 组别 | [接口文档](oapi/biz-line.md) |
+| biz-line | 业务线、周策略、投放品类、策略标签与关联项目 | [接口文档](oapi/biz-line.md) |
+| sso-team-group | 优化组别选项、组长、成员与行业信息 | [接口文档](oapi/sso-team-group.md) |
 | biz-line-metrics | 广告策略维度与成效数据 | [接口文档](oapi/biz-line-metrics.md) |
 | project-analysis | 优化项目月度分析、工时系统原始表、消耗与工时趋势、优化师人效及 Excel 导出 | [接口文档](oapi/project-analysis.md) |
 | biz-line-ai-strategy | AI 策略保存、历史记录、使用日志与正式策略快照 | [接口文档](oapi/biz-line-ai-strategy.md) |

package/dist/api-doc/oapi/biz-line.md

@@ -323,19 +323,7 @@ AI策略生成前分别调用三次：BUDGET_STRATEGY（预算）、MEDIA_STRATE
 | `sceneCode` | string | query | 是 | 必填。BUDGET_STRATEGY预算策略、MEDIA_STRATEGY媒介产品策略、AUDIENCE_STRATEGY受众定位策略；同时支持PLACEMENT_CATEGORY投放品类、CUSTOMER_TYPE客户类型。 |
 | `filterCondition` | string | query | 否 | 三类策略场景必须传非空值，否则返回[]；按实际字典配置的filter_condition精确匹配，同时包含filter_condition为NULL的通用项。此值没有固定枚举，不要用场景名或业务线ID臆造；其他场景可不传。 |
 
-## 11. 查询组别列表
-
-`GET /sino-opti-hive/sso-team/group-list`
-
-主体上下文：`tenant=false`。
-
-角色范围：`sso/system`。
-
-风险：`read`。
-
-查询组别列表
-
-## 12. 查询业务线关联项目和广告账号
+## 11. 查询业务线关联项目和广告账号
 
 `POST /sino-opti-hive/biz-line/project-list`
 
@@ -354,7 +342,7 @@ AI策略生成前分别调用三次：BUDGET_STRATEGY（预算）、MEDIA_STRATE
 | --- | --- | --- | --- | --- |
 | `bizLineId` | integer | body | 是 | 业务线 ID，必填 |
 
-## 13. 查询项目分页列表
+## 12. 查询项目分页列表
 
 `POST /sino-opti-hive/optimize/project/queryByPage`
 

package/dist/api-doc/oapi/sso-team-group.md

@@ -0,0 +1,54 @@
+# 优化组别
+
+对应命令：`sso-team-group +<shortcut>` 与 `sso-team-group api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 优化组别列表
+
+`POST /sino-opti-hive/sso-team/group-manage/list`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+查询优化组别列表
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `leaderUserName` | string | body | 否 | 组长名称，支持模糊搜索 |
+| `industryList` | array | body | 否 | 枚举值：APP：游戏 ECBR：电商品牌 GAME：游戏 |
+
+## 2. 优化组别详情
+
+`GET /sino-opti-hive/sso-team/group-manage/detail`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+组别详情
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `code` | string | query | 是 | 部门code，可从优化组别列表获取 |
+
+## 3. 优化组别选项列表
+
+`GET /sino-opti-hive/sso-team/group-list`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+查询组别列表(优化组别)

package/dist/generated/api-catalog.json

@@ -1808,9 +1808,15 @@
               },
               "updateTime": {
                 "type": "string",
-                "format": "date-time",
+                "title": "策略最后更新时间",
                 "description": "策略最后更新时间",
-                "title": "策略最后更新时间"
+                "format": "date-time"
+              },
+              "createTime": {
+                "type": "string",
+                "format": "date-time",
+                "title": "策略创建时间",
+                "description": "策略创建时间"
               }
             }
           },
@@ -2575,48 +2581,6 @@
       "system"
     ]
   },
-  {
-    "name": "sso-team-group-list",
-    "displayName": "查询组别列表",
-    "description": "查询组别列表",
-    "group": "",
-    "method": "GET",
-    "path": "/sino-opti-hive/sso-team/group-list",
-    "timeout": 180000,
-    "tag": "业务线策略",
-    "domain": "biz-line",
-    "shortcut": "+group-list",
-    "risk": "read",
-    "summary": "查询组别列表",
-    "docFile": "biz-line.md",
-    "responseSchema": {
-      "type": "array",
-      "description": "组别全量列表，供业务线筛选/新建使用",
-      "items": {
-        "type": "object",
-        "properties": {
-          "code": {
-            "type": "string",
-            "description": "组别 code，对应业务线筛选/保存字段 ssoTeamCode",
-            "example": "TEAM_DEMO",
-            "title": "组别code"
-          },
-          "name": {
-            "type": "string",
-            "description": "组别名称",
-            "example": "示例组别",
-            "title": "组别名称"
-          }
-        }
-      },
-      "title": "组别列表"
-    },
-    "tenant": false,
-    "roleScope": [
-      "sso",
-      "system"
-    ]
-  },
   {
     "name": "biz-line-project-list",
     "displayName": "查询业务线关联项目和广告账号",
@@ -7065,6 +7029,237 @@
       "passport"
     ]
   },
+  {
+    "name": "sso-team-group-manage-list",
+    "displayName": "优化组别列表",
+    "description": "查询优化组别列表",
+    "group": "",
+    "method": "POST",
+    "path": "/sino-opti-hive/sso-team/group-manage/list",
+    "timeout": 180000,
+    "tag": "组别",
+    "domain": "sso-team-group",
+    "shortcut": "+list",
+    "risk": "read",
+    "summary": "优化组别列表",
+    "docFile": "sso-team-group.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "leaderUserName": {
+          "type": "string",
+          "description": "组长名称，支持模糊搜索"
+        },
+        "industryList": {
+          "type": "array",
+          "description": "枚举值：APP：游戏 ECBR：电商品牌 GAME：游戏",
+          "items": {
+            "type": "string"
+          },
+          "title": "行业筛选列表，传枚举值code"
+        }
+      }
+    },
+    "responseSchema": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "部门code"
+          },
+          "name": {
+            "type": "string",
+            "description": "部门名称（行业+最低一级，如GAME-华东组）"
+          },
+          "leaderList": {
+            "type": "array",
+            "description": "组长列表",
+            "items": {
+              "type": "object",
+              "properties": {
+                "userId": {
+                  "type": "integer",
+                  "description": "用户ID",
+                  "format": "int32"
+                },
+                "userName": {
+                  "type": "string",
+                  "description": "用户名"
+                }
+              }
+            }
+          },
+          "industry": {
+            "type": "string",
+            "description": "行业"
+          },
+          "memberCount": {
+            "type": "integer",
+            "description": "优化师人数（仅在职、不含组长）",
+            "format": "int32"
+          },
+          "updateBy": {
+            "type": "string",
+            "description": "更新人姓名；系统更新返回null",
+            "nullable": true
+          },
+          "updateTime": {
+            "type": "string",
+            "description": "最后更新时间，格式 yyyy-MM-dd HH:mm:ss；未更新时可为null",
+            "nullable": true
+          }
+        }
+      }
+    },
+    "tenant": false,
+    "roleScope": [
+      "sso",
+      "system"
+    ]
+  },
+  {
+    "name": "sso-team-group-manage-detail",
+    "displayName": "优化组别详情",
+    "description": "组别详情",
+    "group": "",
+    "method": "GET",
+    "path": "/sino-opti-hive/sso-team/group-manage/detail",
+    "timeout": 180000,
+    "tag": "组别",
+    "domain": "sso-team-group",
+    "shortcut": "+detail",
+    "risk": "read",
+    "summary": "优化组别详情",
+    "docFile": "sso-team-group.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": "部门code，可从优化组别列表获取"
+        }
+      },
+      "required": [
+        "code"
+      ]
+    },
+    "queryParameters": [
+      {
+        "name": "code",
+        "required": true,
+        "schema": {
+          "type": "string",
+          "description": "部门code，可从优化组别列表获取"
+        },
+        "explode": true
+      }
+    ],
+    "responseSchema": {
+      "type": "object",
+      "description": "组别详情；未找到对应code时返回null",
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": "部门code"
+        },
+        "name": {
+          "type": "string",
+          "description": "部门名称"
+        },
+        "leaderList": {
+          "type": "array",
+          "description": "组长列表",
+          "items": {
+            "type": "object",
+            "properties": {
+              "userId": {
+                "type": "integer",
+                "description": "用户ID",
+                "format": "int32"
+              },
+              "userName": {
+                "type": "string",
+                "description": "用户名"
+              }
+            }
+          }
+        },
+        "industry": {
+          "type": "string",
+          "description": "枚举值：APP：游戏 ECBR：电商品牌 GAME：游戏",
+          "title": "枚举code"
+        },
+        "memberList": {
+          "type": "array",
+          "description": "优化师列表（仅在职、已排除组长）",
+          "items": {
+            "type": "object",
+            "properties": {
+              "userId": {
+                "type": "integer",
+                "description": "用户ID",
+                "format": "int32"
+              },
+              "userName": {
+                "type": "string",
+                "description": "用户名"
+              }
+            }
+          }
+        }
+      },
+      "nullable": true
+    },
+    "tenant": false,
+    "roleScope": [
+      "sso",
+      "system"
+    ]
+  },
+  {
+    "name": "sso-team-group-list",
+    "displayName": "优化组别选项列表",
+    "description": "查询组别列表(优化组别)",
+    "group": "",
+    "method": "GET",
+    "path": "/sino-opti-hive/sso-team/group-list",
+    "timeout": 180000,
+    "tag": "业务线策略",
+    "domain": "sso-team-group",
+    "shortcut": "+group-list",
+    "risk": "read",
+    "summary": "优化组别选项列表",
+    "docFile": "sso-team-group.md",
+    "responseSchema": {
+      "type": "array",
+      "description": "组别全量列表，供业务线筛选/新建使用",
+      "items": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "组别 code，对应业务线筛选/保存字段 ssoTeamCode",
+            "example": "TEAM_DEMO",
+            "title": "组别code"
+          },
+          "name": {
+            "type": "string",
+            "description": "组别名称",
+            "example": "示例组别",
+            "title": "组别名称"
+          }
+        }
+      },
+      "title": "组别列表"
+    },
+    "tenant": false,
+    "roleScope": [
+      "sso",
+      "system"
+    ]
+  },
   {
     "name": "project-action-log-page-by-project",
     "displayName": "按项目查询最新操作日志（分页倒序）",

package/dist/generated/api-directory-index.json

@@ -63,6 +63,13 @@
       "name": "业务线AI策略",
       "domain": "biz-line-ai-strategy"
     },
+    {
+      "id": 97790804,
+      "moduleId": 8534789,
+      "parentId": null,
+      "name": "优化组别",
+      "domain": "sso-team-group"
+    },
     {
       "id": 95572166,
       "moduleId": 8551546,
@@ -273,13 +280,6 @@
       "method": "GET",
       "path": "/sino-opti-hive/dict/items"
     },
-    {
-      "id": 512471149,
-      "moduleId": 8534789,
-      "folderId": 95368550,
-      "method": "GET",
-      "path": "/sino-opti-hive/sso-team/group-list"
-    },
     {
       "id": 513105129,
       "moduleId": 8534789,
@@ -462,6 +462,27 @@
       "method": "POST",
       "path": "/sino-opti-hive/biz-line/ai-strategy/snapshot/list"
     },
+    {
+      "id": 525988616,
+      "moduleId": 8534789,
+      "folderId": 97790804,
+      "method": "POST",
+      "path": "/sino-opti-hive/sso-team/group-manage/list"
+    },
+    {
+      "id": 525988623,
+      "moduleId": 8534789,
+      "folderId": 97790804,
+      "method": "GET",
+      "path": "/sino-opti-hive/sso-team/group-manage/detail"
+    },
+    {
+      "id": 512471149,
+      "moduleId": 8534789,
+      "folderId": 97790804,
+      "method": "GET",
+      "path": "/sino-opti-hive/sso-team/group-list"
+    },
     {
       "id": 513635206,
       "moduleId": 8551546,