sino-bc-cli 1.0.0-beta.0

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

@@ -0,0 +1,382 @@
+# 业务线策略
+
+对应命令：`biz-line +<shortcut>` 与 `biz-line api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 查询业务线分页列表
+
+`POST /sino-opti-hive/biz-line/list`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+查询业务线分页列表。需要查询业务线关联项目和广告账号，使用业务线ID查询【业务线关联项目列表】。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 是 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 是 | 每页条数 |
+| `sortType` | string | body | 否 | 排序字段（继承 PageRequest.sortType）。SPEND=按上期周消耗；WEEK_OVER_WEEK=按上期周消耗环比；PERIOD=按本期策略周期；TRAFFIC_LIGHT=按上期红绿灯。不传时默认按业务线 id 倒序 |
+| `sortDirection` | string | body | 否 | 排序方向：ASC 升序，DESC 降序；默认 DESC |
+| `name` | string | body | 否 | 业务线名称，模糊搜索 |
+| `status` | integer | body | 否 | 状态：1=进行中 2=已完成 3=已暂停 |
+| `ssoTeamCode` | string | body | 否 | 组别 code，精确筛选（多选请用 ssoTeamCodeList） |
+| `ssoTeamCodeList` | array | body | 否 | 组别 code 列表，多选 |
+| `trafficLightList` | array | body | 否 | 红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。 |
+| `adCategoryProjectId` | integer | body | 否 | 投放品类：取接口biz-line-open-dict-items |
+| `idList` | array | body | 否 | 业务线 ID 列表 |
+| `pmUserIds` | array | body | 否 | PM 用户 ID 多选（OR 语义：命中任一 PM） |
+| `projectRatingList` | array | body | 否 | 项目评级多选：S、A、B、C |
+| `businessRegionList` | array | body | 否 | 商务地区：EAST_CHINA=华东 SOUTH_CHINA=华南 NORTH_CHINA=华北 |
+| `newCustomerTag` | string | body | 否 | 新客标签单选，NEW_TAG = 新客   NONE_NEW_TAG = 非新客
+ |
+| `weekOverWeekFilter` | string | body | 否 | 周消耗环比筛选，DOWN_20 = 周消耗下降20%及以上 |
+
+## 2. 业务线详情
+
+`POST /sino-opti-hive/biz-line/detail`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+业务线详情
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | body | 是 |  |
+
+## 3. 新建业务线
+
+`POST /sino-opti-hive/biz-line/save`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`write`。
+
+⚠️ 写操作。成功时 result 为新建业务线详情 BizLineDetailVO。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `name` | string | body | 是 | 业务线名称，业务/产品线名称不可重复 |
+| `mediaChannels` | array | body | 否 | 投放渠道 code。通过 GET /bc-business-pu/media/queryChannelInfo 取 channelId；名称见同接口 channelName |
+| `strategyControlDegree` | integer | body | 否 | 策略掌控程度：1弱（以客户策略为主） 2强（以我方提供策略） 3中（与客户共创） |
+| `adCategoryIndustryIds` | array | body | 否 | 投放行业 ID。通过 GET /sino-opti-hive/dict/items（sceneCode=PLACEMENT_CATEGORY） 取一级节点 id |
+| `adCategoryProjectIds` | array | body | 否 | 投放品类 ID。通过 GET /sino-opti-hive/dict/items（sceneCode=PLACEMENT_CATEGORY） 取二级 children.id；选其他时可为空，改填 adCategoryOther |
+| `adCategoryOther` | string | body | 否 | 投放品类-其他说明 |
+| `customerTypeIds` | array | body | 否 | 客户类型 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=CUSTOMER_TYPE 取 id |
+| `customerTypeOther` | string | body | 否 | 客户类型-其他说明 |
+| `amUserIds` | array | body | 否 | AM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `pmUserIds` | array | body | 否 | PM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `customerInfrastructure` | array | body | 否 | 1=数据追踪方式：AdJust，2=数据追踪方式：AF，3=数据追踪方式：其他MMP，4=数据追踪方式：客户BI，5=数据追踪方式：媒体后台，6=素材产出方式：CB，7=素材产出方式：客户提供，8=素材产出方式：内部设计师制作，9=素材产出方式：无需素材（ASA、推流等），10=基建情况：基建完善，11=基建情况：三方回传数据异常，12=基建情况：APP埋点异常 |
+| `coreIndex` | string | body | 否 | 核心指标 |
+| `monthlyMaterialCount` | string | body | 否 | 月度上新素材量 |
+| `projectInitStatus` | string | body | 否 | 项目初始化状态 |
+| `projectBrief` | string | body | 否 | 项目 Brief |
+| `corporationIds` | array | body | 否 | 关联签约主体 ID（字符串）。通过 POST /sino-opti-hive/corporation/page 获取签约主体 ID |
+| `projectIds` | array | body | 否 | 关联项目 ID |
+| `ssoTeamCode` | string | body | 是 | 组别 code，单选，必填。通过 GET /sino-opti-hive/sso-team/group-list 取 code |
+| `businessRegion` | string | body | 是 | EAST_CHINA=华东，SOUTH_CHINA=华南，NORTH_CHINA=华北。必填 |
+| `projectRating` | string | body | 否 | S、A、B、C。非新客必填 |
+| `newCustomerTag` | string | body | 否 | NEW_TAG=是（新客），NONE_NEW_TAG=否（非新客） |
+
+## 4. 更新业务线
+
+`POST /sino-opti-hive/biz-line/update`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`write`。
+
+更新业务线信息
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | body | 是 | 通过 POST /sino-opti-hive/biz-line/list 取 id |
+| `status` | integer | body | 是 | 状态：1进行中 2已完成 3已暂停 |
+| `name` | string | body | 是 | 业务线名称，业务/产品线名称不可重复 |
+| `mediaChannels` | array | body | 否 | 投放渠道 code。通过 GET /bc-business-pu/media/queryChannelInfo 取 channelId；名称见同接口 channelName |
+| `strategyControlDegree` | integer | body | 否 | 策略掌控程度：1弱（以客户策略为主） 2强（以我方提供策略） 3中（与客户共创） |
+| `adCategoryIndustryIds` | array | body | 否 | 投放行业 ID。通过 GET /sino-opti-hive/dict/items（sceneCode=PLACEMENT_CATEGORY） 取一级节点 id |
+| `adCategoryProjectIds` | array | body | 否 | 投放品类 ID。通过 GET /sino-opti-hive/dict/items（sceneCode=PLACEMENT_CATEGORY） 取二级 children.id；选其他时可为空，改填 adCategoryOther |
+| `adCategoryOther` | string | body | 否 | 投放品类-其他说明 |
+| `customerTypeIds` | array | body | 否 | 客户类型 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=CUSTOMER_TYPE 取 id |
+| `customerTypeOther` | string | body | 否 | 客户类型-其他说明 |
+| `amUserIds` | array | body | 否 | AM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `pmUserIds` | array | body | 否 | PM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `customerInfrastructure` | array | body | 否 | 1=数据追踪方式：AdJust，2=数据追踪方式：AF，3=数据追踪方式：其他MMP，4=数据追踪方式：客户BI，5=数据追踪方式：媒体后台，6=素材产出方式：CB，7=素材产出方式：客户提供，8=素材产出方式：内部设计师制作，9=素材产出方式：无需素材（ASA、推流等），10=基建情况：基建完善，11=基建情况：三方回传数据异常，12=基建情况：APP埋点异常 |
+| `coreIndex` | string | body | 否 | 核心指标 |
+| `monthlyMaterialCount` | string | body | 否 | 月度上新素材量 |
+| `projectInitStatus` | string | body | 否 | 项目初始化状态 |
+| `projectBrief` | string | body | 否 | 项目 Brief |
+| `corporationIds` | array | body | 否 | 关联签约主体 ID（字符串）。通过 POST /sino-opti-hive/corporation/page 获取签约主体 ID |
+| `projectIds` | array | body | 否 | 关联项目 ID。通过 POST /sino-opti-hive/optimize/project/queryByPage 获取；按 ID 反查名称用 POST /sino-opti-hive/optimize/project/listByIds |
+| `ssoTeamCode` | string | body | 是 | 组别 code，单选，必填。通过 GET /sino-opti-hive/sso-team/group-list 取 code |
+| `businessRegion` | string | body | 是 | EAST_CHINA=华东，SOUTH_CHINA=华南，NORTH_CHINA=华北。必填 |
+| `projectRating` | string | body | 否 | S、A、B、C。非新客必填 |
+| `newCustomerTag` | string | body | 否 | NEW_TAG=是（新客），NONE_NEW_TAG=否（非新客） |
+
+## 5. 更新业务线状态
+
+`POST /sino-opti-hive/biz-line/status/update`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`write`。
+
+⚠️ 写操作。仅更新状态与操作人；成功时 result 为 Boolean。status：1进行中 2已完成 3已暂停。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | body | 是 |  |
+| `status` | integer | body | 是 | 状态：1进行中 2已完成 3已暂停；对应 BizLineStatusEnum |
+
+## 6. 查询投放策略分页列表
+
+`POST /sino-opti-hive/biz-line/strategy/list`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+查询投放策略分页列表
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 是 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 是 | 每页条数 |
+| `sortDirection` | string | body | 否 | 创建日期排序 DESC 或 ASC，默认 DESC |
+| `bizLineId` | integer | body | 否 | 可选，不传则按权限查全部可见业务线。 |
+| `trafficLight` | integer | body | 否 | 红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。 |
+
+## 7. 查询投放策略消耗信息
+
+`POST /sino-opti-hive/biz-line/strategy/spend`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+查询投放策略消耗信息
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `strategyId` | integer | body | 是 | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
+
+## 8. 新建投放策略
+
+`POST /sino-opti-hive/biz-line/strategy/save`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`write`。
+
+新建投放策略，投放策略按周填写
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `bizLineId` | integer | body | 是 | 通过 POST /sino-opti-hive/biz-line/list 取 id |
+| `periodStart` | string | body | 是 | 策略周期起（日期） |
+| `periodEnd` | string | body | 是 | 策略周期止（日期） |
+| `budgetStrategyTags` | array | body | 是 | 预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
+| `budgetStrategySupplement` | string | body | 是 | 预算策略补充说明 |
+| `mediaStrategyTags` | array | body | 是 | 媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
+| `mediaStrategySupplement` | string | body | 是 | 媒介策略补充说明 |
+| `audienceStrategyTags` | array | body | 是 | 受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
+| `audienceStrategySupplement` | string | body | 是 | 受众策略补充说明 |
+| `creativeStrategy` | string | body | 是 | 素材创意策略说明，最大 5000 字 |
+| `previewPeriodStart` | string | body | 否 | 上期（preview）策略周期起；缺省为本期 periodStart 的上一自然周周一 |
+| `previewPeriodEnd` | string | body | 否 | 上期（preview）策略周期止；缺省为 previewPeriodStart+6（周日） |
+| `previewBudgetStrategyTags` | array | body | 否 | 上期预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
+| `previewBudgetStrategySupplement` | string | body | 否 | 上期预算策略补充说明 |
+| `previewMediaStrategyTags` | array | body | 否 | 上期媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
+| `previewMediaStrategySupplement` | string | body | 否 | 上期媒介策略补充说明 |
+| `previewAudienceStrategyTags` | array | body | 否 | 上期受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
+| `previewAudienceStrategySupplement` | string | body | 否 | 上期受众策略补充说明 |
+| `previewCreativeStrategy` | string | body | 否 | 上期素材创意策略说明，最大 5000 字 |
+| `trafficLight` | integer | body | 否 | 红绿灯：1 KPI达标、2 距GAP 20%内、3 距GAP 20%以上、4 已暂停、5 存在风险、6 KPI达标且项目顺利 |
+| `coreIssueCategories` | array | body | 否 | 1=受众策略问题，2=跨媒介策略问题，3=媒介广告产品使用策略问题，4=出价策略问题，5=素材策略问题，6=素材执行问题，7=素材管理问题，8=投放规划问题，9=媒体素材政策/尺度/风控问题，10=媒体适配/潜力问题，11=市场选择/竞争问题，12=客户对接不顺畅，13=客户侧：数据对接问题，14=客户侧：产品问题/投放生命周期问题，15=客户侧：运营/基建问题，16=客户侧：存在投放限制，17=客户侧：转自投，18=客户侧：需求临时无规划，19=客户侧：KPI不合理，20=投放生命周期问题/素材疲劳问题，21=内部团队人员调配问题，22=其他 |
+| `issuesAndOpportunities` | string | body | 否 | 项目问题&机会，最大 5000 字 |
+| `spend` | string | body | 否 | 周期投放消耗（回顾，展示用字符串），最大 50 字 |
+| `customerSatisfaction` | integer | body | 否 | 客户满意度：1满意 2不满意 |
+| `satisfactionReason` | string | body | 否 | 满意度原因说明，最大 5000 字 |
+| `coreEffectIndex` | string | body | 否 | 核心效果指标，最大 5000 字 |
+| `budgetStrategyEffect` | integer | body | 否 | 预算策略效果：1有效 2无效 3待观察 |
+| `budgetStrategyLearning` | string | body | 否 | 预算策略 learning |
+| `mediaStrategyEffect` | integer | body | 否 | 媒介策略效果：1有效 2无效 3待观察 |
+| `mediaStrategyLearning` | string | body | 否 | 媒介策略 learning |
+| `audienceStrategyEffect` | integer | body | 否 | 受众策略效果：1有效 2无效 3待观察 |
+| `audienceStrategyLearning` | string | body | 否 | 受众策略 learning |
+| `creativeStrategyEffect` | integer | body | 否 | 素材策略效果：1有效 2无效 3待观察 |
+| `creativeStrategyLearning` | string | body | 否 | 素材策略 learning |
+
+## 9. 更新投放策略
+
+`POST /sino-opti-hive/biz-line/strategy/update`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`write`。
+
+更新投放策略
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | body | 是 | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
+| `version` | integer | body | 是 | 乐观锁版本号 |
+| `overwrite` | boolean | body | 否 | 默认 false：版本冲突则报错；true 强制覆盖 |
+| `bizLineId` | integer | body | 是 | 通过 POST /sino-opti-hive/biz-line/list 取 id |
+| `periodStart` | string | body | 是 | 策略周期起（日期） |
+| `periodEnd` | string | body | 是 | 策略周期止（日期） |
+| `budgetStrategyTags` | array | body | 是 | 预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
+| `budgetStrategySupplement` | string | body | 是 | 预算策略补充说明 |
+| `mediaStrategyTags` | array | body | 是 | 媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
+| `mediaStrategySupplement` | string | body | 是 | 媒介策略补充说明 |
+| `audienceStrategyTags` | array | body | 是 | 受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
+| `audienceStrategySupplement` | string | body | 是 | 受众策略补充说明 |
+| `creativeStrategy` | string | body | 是 | 素材创意策略说明，最大 5000 字 |
+| `previewPeriodStart` | string | body | 否 | 上期（preview）策略周期起；缺省为本期 periodStart 的上一自然周周一 |
+| `previewPeriodEnd` | string | body | 否 | 上期（preview）策略周期止；缺省为 previewPeriodStart+6（周日） |
+| `previewBudgetStrategyTags` | array | body | 否 | 上期预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
+| `previewBudgetStrategySupplement` | string | body | 否 | 上期预算策略补充说明 |
+| `previewMediaStrategyTags` | array | body | 否 | 上期媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
+| `previewMediaStrategySupplement` | string | body | 否 | 上期媒介策略补充说明 |
+| `previewAudienceStrategyTags` | array | body | 否 | 上期受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
+| `previewAudienceStrategySupplement` | string | body | 否 | 上期受众策略补充说明 |
+| `previewCreativeStrategy` | string | body | 否 | 上期素材创意策略说明，最大 5000 字 |
+| `trafficLight` | integer | body | 否 | 红绿灯：1 KPI达标、2 距GAP 20%内、3 距GAP 20%以上、4 已暂停、5 存在风险、6 KPI达标且项目顺利 |
+| `coreIssueCategories` | array | body | 否 | 1=受众策略问题，2=跨媒介策略问题，3=媒介广告产品使用策略问题，4=出价策略问题，5=素材策略问题，6=素材执行问题，7=素材管理问题，8=投放规划问题，9=媒体素材政策/尺度/风控问题，10=媒体适配/潜力问题，11=市场选择/竞争问题，12=客户对接不顺畅，13=客户侧：数据对接问题，14=客户侧：产品问题/投放生命周期问题，15=客户侧：运营/基建问题，16=客户侧：存在投放限制，17=客户侧：转自投，18=客户侧：需求临时无规划，19=客户侧：KPI不合理，20=投放生命周期问题/素材疲劳问题，21=内部团队人员调配问题，22=其他 |
+| `issuesAndOpportunities` | string | body | 否 | 项目问题&机会，最大 5000 字 |
+| `spend` | string | body | 否 | 周期消耗（回顾，展示用字符串），最大 50 字 |
+| `customerSatisfaction` | integer | body | 否 | 客户满意度：1满意 2不满意 |
+| `satisfactionReason` | string | body | 否 | 满意度原因说明，最大 5000 字 |
+| `coreEffectIndex` | string | body | 否 | 核心效果指标，最大 5000 字 |
+| `budgetStrategyEffect` | integer | body | 否 | 预算策略效果：1有效 2无效 3待观察 |
+| `budgetStrategyLearning` | string | body | 否 | 预算策略 learning |
+| `mediaStrategyEffect` | integer | body | 否 | 媒介策略效果：1有效 2无效 3待观察 |
+| `mediaStrategyLearning` | string | body | 否 | 媒介策略 learning |
+| `audienceStrategyEffect` | integer | body | 否 | 受众策略效果：1有效 2无效 3待观察 |
+| `audienceStrategyLearning` | string | body | 否 | 受众策略 learning |
+| `creativeStrategyEffect` | integer | body | 否 | 素材策略效果：1有效 2无效 3待观察 |
+| `creativeStrategyLearning` | string | body | 否 | 素材策略 learning |
+
+## 10. 查询业务线字典和策略标签
+
+`GET /sino-opti-hive/dict/items`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+按sceneCode查询业务字典，使用GET Query参数，不传JSON请求体。sceneCode必填，不存在的场景返回空数组。
+
+AI策略生成前分别调用三次：BUDGET_STRATEGY（预算）、MEDIA_STRATEGY（媒介产品）、AUDIENCE_STRATEGY（受众定位）。三次都需传非空filterCondition，使用当前业务实际字典配置值；缺少该参数不会报错，而是直接返回[]。匹配规则为filter_condition等于传入值或为NULL（通用项）。不要据空数组自动推断该场景没有标签。
+
+将返回id分别填入保存接口budgetStrategyTags、mediaStrategyTags、audienceStrategyTags；不要传name或itemCode。此接口也保留PLACEMENT_CATEGORY（投放品类）和CUSTOMER_TYPE（客户类型）用途，二者过滤“其他”项；策略场景不做该过滤。两级场景返回树，叶子children可为null。
+
+策略调用示例：/sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY&filterCondition={{strategyFilterCondition}}。变量必须替换为实际配置值；另外两类策略仅替换sceneCode。投放品类调用示例：/sino-opti-hive/dict/items?sceneCode=PLACEMENT_CATEGORY。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `sceneCode` | string | query | 是 | 必填。BUDGET_STRATEGY预算策略、MEDIA_STRATEGY媒介产品策略、AUDIENCE_STRATEGY受众定位策略；同时支持PLACEMENT_CATEGORY投放品类、CUSTOMER_TYPE客户类型。 |
+| `filterCondition` | string | query | 否 | 三类策略场景必须传非空值，否则返回[]；按实际字典配置的filter_condition精确匹配，同时包含filter_condition为NULL的通用项。此值没有固定枚举，不要用场景名或业务线ID臆造；其他场景可不传。 |
+
+## 11. 查询业务线关联项目和广告账号
+
+`POST /sino-opti-hive/biz-line/project-list`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+根据业务线 ID 查询业务线关联项目和广告账号
+
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `bizLineId` | integer | body | 是 | 业务线 ID，必填 |
+
+## 12. 查询项目分页列表
+
+`POST /sino-opti-hive/optimize/project/queryByPage`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+查询项目分页列表
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `sortType` | string | body | 否 | lastWeekSpend=上周消耗；lastWeekSpendQoq=上周消耗环比；createTime=创建时间。不传默认 createTime |
+| `sortDirection` | string | body | 否 | ASC 升序，DESC 降序；默认 DESC |
+| `corporationId` | integer | body | 否 | 签约主体 ID |
+| `corporationIdList` | array | body | 否 | 签约主体 ID 多选 |
+| `projectId` | integer | body | 否 | 项目 ID，精确匹配 |
+| `projectIdList` | array | body | 否 | 项目 ID 多选。已知 ID 时直接传入；本接口出参 projectId 也可回填 |
+| `projectName` | string | body | 否 | 项目名称，模糊查询 |
+| `projectKeyword` | string | body | 否 | 项目 ID 精确，或项目名称分词模糊（空格分词，词之间 AND） |
+| `startDate` | string | body | 否 | 项目周期开始日期 yyyy-MM-dd |
+| `endDate` | string | body | 否 | 项目周期结束日期 yyyy-MM-dd |
+| `projectUserIdList` | array | body | 否 | 项目成员用户 ID 多选。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId，也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `ssoTeamCodeList` | array | body | 否 | 组别 code 多选，按该组别下 PM 成员筛项目。通过 GET /sino-opti-hive/sso-team/group-list 取 code |
+| `adAccountId` | string | body | 否 | 广告账号 ID 模糊查询，至少 2 个字符 |
+| `demandOrderKeyword` | string | body | 否 | 需求单编号精确，或需求单名称分词模糊（空格分词） |
+| `signalLightList` | array | body | 否 | 项目红绿灯多选，与出参 signalLight 同值（字符串，不是业务线策略 trafficLight 的整数枚举） |
+| `projectStatusList` | array | body | 否 | 项目执行状态多选。本接口查的是项目（非需求）：4=待分配，5=执行中，6=已暂停，7=已完成，8=终止。出参 projectStatusName 为对应中文名 |
+| `isLast7DSpend` | array | body | 否 | 0=否，1=是。仅传一个值时生效；同时传 0 和 1 等于不筛 |
+| `uploadInfoTypeList` | array | body | 否 | 0=无上传，1=仅上传brief，2=仅上传mediaPlan，3=上传brief和mediaPlan。多选 |
+| `serviceCodeList` | array | body | 否 | 服务/产品 code 多选。不传时服务端默认 1、85（代投类项目） |
+| `bizLineIdList` | array | body | 否 | 按已关联业务线过滤项目。通过 POST /sino-opti-hive/biz-line/list 取 id |

package/dist/api-doc/oapi/common-file.md

@@ -0,0 +1,50 @@
+# 文件管理
+
+对应命令：`common-file +<shortcut>` 与 `common-file api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 上传文件
+
+`POST /bc-business-pu/file/fileUpload`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`write`。
+
+上传单个私有文件，使用multipart/form-data，file为必填文件part。serviceName可选，未传或为空字符串时默认bc-business-pu，支持的服务名见参数枚举。
+
+上传文件不能为空，默认最大50MB（52428800字节，含边界），由Apollo配置file.upload.max-size控制。存储目录为服务名/yyyy-MM，文件名使用UUID并保留扩展名。上传返回的私有链接有效期默认3600秒，由file.download.url-expire-seconds控制。
+
+成功返回UploadFileResult，请保存result.storageKey供后续获取下载链接或关联业务记录使用。重复上传会生成新的存储文件。服务名非法、文件为空、文件超限、文件名为空或配置非正数时返回业务错误。本接口不要求业务签约主体参数。
+
+编码：`multipart/form-data`；文件字段填写本地路径，`--dry-run` 只预览、不上传。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `file` | string | form | 是 | 本地文件路径；发送时读取为文件。待上传文件，非空，默认最大50MB，以Apollo配置为准。 |
+| `serviceName` | string | form | 否 | 来源服务；未传或为空字符串时默认bc-business-pu，用于存储目录隔离。 |
+
+## 2. 获取文件下载链接
+
+`GET /bc-business-pu/file/getUrlByKey`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+使用文件上传成功后返回的storageKey获取私有文件下载链接。storageKey必填且不能是空白字符串，请原样传入，不要传已有下载URL。
+
+成功时result直接返回URL字符串，不执行302重定向。有效期默认3600秒，由Apollo配置file.download.url-expire-seconds控制，与上传返回链接使用同一配置。链接失效后可重新调用本接口生成。生成失败、返回空链接或有效期配置非正数时返回业务错误。本接口不要求业务签约主体参数。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `storageKey` | string | query | 是 | 上传接口result.storageKey返回的文件标识，非空白字符串。 |

package/dist/api-doc/oapi/dashboard.md

@@ -0,0 +1,218 @@
+# 看板
+
+对应命令：`dashboard +<shortcut>` 与 `dashboard api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 营销目标预算分布
+
+`POST /sino-bc-nexus/dashboard/budget-by-marketing-goal`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli dashboard api dashboard-budget-by-marketing-goal --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+营销目标预算分布
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
+| `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
+
+## 2. 媒体预算占比
+
+`POST /sino-bc-nexus/dashboard/budget-by-media`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli dashboard api dashboard-budget-by-media --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+媒体预算占比
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
+| `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
+
+## 3. 项目类型预算分布
+
+`POST /sino-bc-nexus/dashboard/budget-by-project-type`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli dashboard api dashboard-budget-by-project-type --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+项目类型预算分布
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
+| `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
+
+## 4. 区域预算占比
+
+`POST /sino-bc-nexus/dashboard/budget-by-region`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli dashboard api dashboard-budget-by-region --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+区域预算占比
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
+| `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
+| `dimension` | string | body | 否 | 区域维度：COUNTRY 按国家、REGION 按大区；不传默认 COUNTRY |
+
+## 5. 预算排行榜
+
+`POST /sino-bc-nexus/dashboard/budget-rank`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli dashboard api dashboard-budget-rank --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+预算排行榜
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
+| `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
+| `dimension` | string | body | 否 | 排行榜维度：PROJECT 按项目、BUSINESS_LINE 按业务线 |
+| `topN` | integer | body | 否 | 展示 Top 条数，默认 5 |
+
+## 6. 预算来源占比
+
+`POST /sino-bc-nexus/dashboard/budget-source-ratio`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli dashboard api dashboard-budget-source-ratio --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+预算来源占比
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
+| `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
+| `dimension` | string | body | 否 | 占比维度：SOURCE 市场范围（t_project.market_scope），SEGMENT 渠道类型（t_project_budget.dim_type=SOURCE）；不传默认 SOURCE |
+
+## 7. 关键项目时间轴
+
+`POST /sino-bc-nexus/dashboard/key-project-timeline`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli dashboard api dashboard-key-project-timeline --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+关键项目时间轴
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
+| `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
+| `topN` | integer | body | 否 | 展示条数，默认 5 |
+
+## 8. 核心卡片指标
+
+`POST /sino-bc-nexus/dashboard/metrics`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli dashboard api dashboard-metrics --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+核心卡片指标
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
+| `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
+
+## 9. 项目分布
+
+`POST /sino-bc-nexus/dashboard/project-distribution`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli dashboard api dashboard-project-distribution --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+项目分布
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `startDate` | string | body | 否 | 筛选开始日期（可选，须与结束日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-01-01 |
+| `endDate` | string | body | 否 | 筛选结束日期（可选，须与开始日期同时传入），格式 yyyy-MM-dd，时间跨度最长一年；JSON 字符串；格式 yyyy-MM-dd；仅日期，不含时分秒及时区；示例：2025-06-30 |
+| `dimension` | string | body | 否 | 分布维度：STAGE 按当前阶段、LEVEL 按项目等级、TYPE 按项目类型 |