sino-bc-cli 1.8.1 → 1.8.3

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

@@ -2,7 +2,7 @@
 
 数据来源：[sino-opti-hive 接口文档](https://o-test-sino-opti-hive.meetsocial.com/doc.html#/default/%E4%B8%9A%E5%8A%A1%E7%BA%BF%E6%9F%A5%E8%AF%A2/channelsUsingGET)
 
-对外开放的只读查询接口，共 **5** 个，均不涉及数据变更。
+对外开放的只读查询接口，共 **2** 个（渠道、品类字典）。业务线列表与周策略已改绑内部接口，见 [biz-line-strategy.md](./biz-line-strategy.md) 的 `biz-line-list` / `biz-line-strategy-list`。
 
 > **网关地址**：`https://test-agent.beyondclick.com`（三环境同一地址，唯一来源 `src/constants/gateway.ts` 的 `GATEWAY_CONFIG`），不要直连 sino-opti-hive 服务地址。
 >
@@ -12,9 +12,8 @@
 | --- | --- | --- | --- | --- |
 | 1 | `biz-line-open-channels` | 查询投放渠道列表 | GET | `/sino-opti-hive/biz-line-open/channels` |
 | 2 | `biz-line-open-placement-categories` | 查询投放品类字典树 | GET | `/sino-opti-hive/biz-line-open/placement-categories` |
-| 3 | `biz-line-open-list` | 查询业务线列表（不分页） | POST | `/sino-opti-hive/biz-line-open/list` |
-| 4 | `biz-line-open-strategies` | 查询业务线投放策略及表现 | POST | `/sino-opti-hive/biz-line-open/strategies` |
-| 5 | `biz-line-open-strategy-top` | 查询投放表现 Top 业务线 | POST | `/sino-opti-hive/biz-line-open/strategy-top` |
+
+> `biz-line-open-list` / `biz-line-open-strategies` / `biz-line-open-strategy-top` 已不在现行 catalog。`+list` / `+strategies` 改打 `biz-line-list` / `biz-line-strategy-list`。`+top` 已下线。
 
 所有接口统一返回 `RestResponseVO` 包装：`success`、`code`、`message`、`result`、`traceId`。下文只描述 `result`。
 
@@ -204,11 +203,14 @@
 ## 命令调用
 
 ```bash
-# 默认生产环境 + 内置 API Key，交互选择接口
-sino-bc-cli /bc-api
-
-# 指定环境（test / pre / prod）
-sino-bc-cli /bc-api test
+# 本组接口都有 Shortcut
+sino-bc-cli biz-line +channels
+sino-bc-cli biz-line +categories
+sino-bc-cli biz-line +list --name <业务线名称>
+sino-bc-cli biz-line +strategies --name <业务线名称>
+
+# 切换环境（test / pre / prod）
+sino-bc-cli /set-config env test
 ```
 
 详见 [README.md](./README.md)。

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

@@ -8,7 +8,7 @@
 >
 > **路由前缀**：经网关调用时所有路径需带 `/sino-opti-hive`，例如 `/sino-opti-hive/biz-line/list`。
 >
-> ⚠️ 标记为「写操作」的接口会变更线上数据，`/bc-api` 会按文档示例请求体直接发起调用，调用前请确认环境。
+> ⚠️ 标记为「写操作」的接口会变更线上数据。CLI 会强制确认：不加 `--yes` 时交互式终端询问，非交互式环境以退出码 `10` 返回 `confirmation_required`；执行前可用 `--dry-run` 预览。文档中的「请求示例」只说明字段口径，不会被当作默认请求体发送。
 
 | # | name | 展示名 | 方法 | 路径（含前缀） |
 | --- | --- | --- | --- | --- |
@@ -305,11 +305,15 @@
 ## 命令调用
 
 ```bash
-# 默认生产环境 + 内置 API Key，交互选择接口
-sino-bc-cli /bc-api
+# 写操作有 Shortcut：先预览，确认后追加 --yes
+sino-bc-cli biz-line +status --id <业务线 ID> --status 3 --dry-run
+sino-bc-cli biz-line +status --id <业务线 ID> --status 3 --yes
 
-# 指定环境（test / pre / prod）
-sino-bc-cli /bc-api test
+# 其余接口按 name 点名调用
+sino-bc-cli biz-line api biz-line-strategy-detail --data '{"bizLineId":123,"id":1}'
+
+# 切换环境（test / pre / prod）
+sino-bc-cli /set-config env test
 ```
 
 详见 [README.md](./README.md)。

package/dist/generated/api-catalog.json

@@ -0,0 +1,287 @@
+[
+  {
+    "name": "biz-line-open-channels",
+    "displayName": "查询投放渠道列表",
+    "description": "无入参，返回 ChannelEnum 全量：code = 渠道 ID，name = 渠道名称",
+    "group": "业务线查询",
+    "method": "GET",
+    "path": "/sino-opti-hive/biz-line-open/channels",
+    "timeout": 20000,
+    "tag": "业务线查询",
+    "domain": "biz-line",
+    "shortcut": "+channels",
+    "risk": "read",
+    "summary": "查询投放渠道列表",
+    "docFile": "biz-line-query.md"
+  },
+  {
+    "name": "biz-line-open-placement-categories",
+    "displayName": "查询投放品类字典树",
+    "description": "无入参，一级节点 = 投放行业，二级节点 children = 投放品类",
+    "group": "业务线查询",
+    "method": "GET",
+    "path": "/sino-opti-hive/biz-line-open/placement-categories",
+    "timeout": 20000,
+    "tag": "业务线查询",
+    "domain": "biz-line",
+    "shortcut": "+categories",
+    "risk": "read",
+    "summary": "查询投放品类字典树",
+    "docFile": "biz-line-query.md"
+  },
+  {
+    "name": "biz-line-list",
+    "displayName": "业务线分页列表",
+    "description": "result 为分页对象：total = 总条数，result = 当前页 BizLineListVO 列表",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/list",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+list",
+    "risk": "read",
+    "summary": "业务线分页列表",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-detail",
+    "displayName": "业务线详情",
+    "description": "按业务线 ID 查详情，result 为 BizLineDetailVO",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/detail",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+detail",
+    "risk": "write",
+    "summary": "业务线详情",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-save",
+    "displayName": "新建业务线",
+    "description": "⚠️ 写操作：新建业务线，成功时 result 为新建业务线详情",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/save",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+save",
+    "risk": "write",
+    "summary": "新建业务线",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-update",
+    "displayName": "编辑业务线",
+    "description": "⚠️ 写操作：按 ID 编辑业务线，成功时 result 为 Boolean",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/update",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+update",
+    "risk": "write",
+    "summary": "编辑业务线",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-status-update",
+    "displayName": "切换业务线状态",
+    "description": "⚠️ 写操作：仅更新状态与操作人，status 取 1 进行中 / 2 已完成 / 3 已暂停",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/status/update",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+status",
+    "risk": "write",
+    "summary": "切换业务线状态",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-del",
+    "displayName": "删除业务线",
+    "description": "⚠️ 写操作：按 ID 删除业务线，成功时 result 为 Boolean",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/del",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+delete",
+    "risk": "write",
+    "summary": "删除业务线",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-list-export",
+    "displayName": "业务线列表导出",
+    "description": "导出筛选条件下所有业务线数据，result 为 Excel 文件访问 URL",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/list/export",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+export",
+    "risk": "write",
+    "summary": "业务线列表导出",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-list",
+    "displayName": "全部策略分页",
+    "description": "按业务线分页查周策略，result 为 BizLineStrategyDetailVO 分页对象",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/list",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+strategies",
+    "risk": "read",
+    "summary": "全部策略分页",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-detail",
+    "displayName": "策略详情（编辑返显）",
+    "description": "result 为 BizLineStrategyDetailVO，含标签展示文案与乐观锁版本号",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/detail",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+strategy-detail",
+    "risk": "write",
+    "summary": "策略详情（编辑返显）",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-period-list",
+    "displayName": "策略周期列表",
+    "description": "按业务线返回全部策略周期，result 含 items 与 total",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/period-list",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+period-list",
+    "risk": "write",
+    "summary": "策略周期列表",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-preview-info",
+    "displayName": "新建策略前置-上期摘要",
+    "description": "按目标周期取上期策略摘要，periodExist 标识目标周期是否已有数据",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/preview-info",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+preview-info",
+    "risk": "write",
+    "summary": "新建策略前置-上期摘要",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-save",
+    "displayName": "新建策略",
+    "description": "⚠️ 写操作：新建业务线周策略，成功时 result 为 Boolean",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/save",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+strategy-save",
+    "risk": "write",
+    "summary": "新建策略",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-update",
+    "displayName": "编辑策略",
+    "description": "⚠️ 写操作：按策略 ID 编辑，version 为乐观锁，overwrite=true 强制覆盖",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/update",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+strategy-update",
+    "risk": "write",
+    "summary": "编辑策略",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-del",
+    "displayName": "删除策略",
+    "description": "⚠️ 写操作：按策略 ID 删除，成功时 result 为 Boolean",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/del",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+strategy-delete",
+    "risk": "write",
+    "summary": "删除策略",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-compare",
+    "displayName": "策略对比",
+    "description": "对比两期策略，diffFields 给出存在差异的字段名列表",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/compare",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+compare",
+    "risk": "write",
+    "summary": "策略对比",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-spend",
+    "displayName": "策略周期消耗汇总",
+    "description": "按策略 ID 汇总周期内关联项目消耗，result 含 totalSpend",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/spend",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+spend",
+    "risk": "write",
+    "summary": "策略周期消耗汇总",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-exprot-all",
+    "displayName": "导出全部策略",
+    "description": "导出该业务线全部策略，result 为文件访问 URL（服务端路径拼写为 exprot-all）",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/exprot-all",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+exprot-all",
+    "risk": "write",
+    "summary": "导出全部策略",
+    "docFile": "biz-line-strategy.md"
+  }
+]