# pipeline-opportunity — 商机产线能力包

把招标市场情报转化为软件研发商机：**热点软件推荐 → 每日AI/Agent招标 → 研发报告编写 → 人工确认 → 研发审批流程**。

## 平台边界（重要）

- **数据爬取平台**（ebpe.cc:/d/ymq/work/tender_opp，独立部署）：采集中国招标网站数据、
  持久存储、去重，仅通过内网 HTTP 只读接口对外（`192.168.16.2:9085`，X-API-Token 鉴权）。
- **本模块（产线平台侧）**：商机业务闭环。只消费爬虫数据，不爬取、不存招标原始数据；
  报告/审批状态落产线库 `opp_reports` / `opp_approvals` 表，绝不回写爬虫库。

依赖方向：产线平台 ──HTTP──> 数据爬取平台（单向）。

## 产线闭环与门禁

```
opp_hot_software / opp_daily_ai_tenders（爬虫平台数据）
        ↓ 选定方向
opp_create_report（草稿）→ opp_update_report（补写，数据必须来自工具返回）
        ↓
opp_submit_report ──> 人工确认任务（门禁，pipeline_human_tasks: opp_report_confirm）
        ↓ 人工确认通过（confirm 回流）
initiate_approval ──> 研发审批任务（门禁，opp_dev_approval）
        ↓ 人工审批结论回流
approved / rejected（rejected 可退回 draft 重来）
```

状态机：`draft → confirmed → approval_initiated → approved/rejected`（非法迁移一律拒绝）。
agent 禁止自批自审：确认与审批结论只能由人工任务回流驱动。

## 工具清单（主 agent / 驾驶舱）

| 工具 | 用途 |
|------|------|
| opp_hot_software | 热点软件推荐（招标量+预算+地区排名） |
| opp_daily_ai_tenders | 每日 AI/Agent 招标展示数据 |
| opp_search_tenders | 关键词检索招标信息 |
| opp_tender_detail | 单条详情（含原文/预算/联系人/来源链接） |
| opp_crawler_stats | 爬虫平台采集健康度 |
| opp_create_report / opp_update_report | 报告草稿创建与补写 |
| opp_list_reports / opp_get_report | 报告列表与全文 |
| opp_submit_report | 提交人工确认（门禁） |
| opp_list_approvals | 审批单列表 |
| opp_diagnose | 产线诊断（报告分布/待办/爬虫连通性） |

角色：`agent.opp_analyst`（商机分析师）、`agent.opp_writer`（研发报告撰写工程师）。
slash 命令：`/hot` `/ai` `/reports` `/oppdiag`。

## 爬虫平台接入配置

系统级配置禁硬编码，走 appbase `params` 表（兜底默认值内网地址）：

| params 键 | 值 |
|-----------|-----|
| `tender_api_base` | `http://192.168.16.2:9085`（默认） |
| `tender_api_token` | 爬虫平台 `state/api.env` 中的 TENDER_API_TOKEN |

## 部署（宿主 = pipeline-app）

1. `git clone` 到 `<APP_ROOT>/pkgs/pipeline-opportunity`
2. `bash build.sh`（建表 + 种子数据 + wwwroot 软链 + pip install）
3. app 入口已接线：`load_pipeline_opportunity()`（try/except 兜底）
4. RBAC：`cd <APP_ROOT> && py3/bin/python pkgs/pipeline-opportunity/scripts/load_path.py`
5. i18n：合并 `i18n/{zh,en}/msg.txt` 到宿主 wwwroot（merge_i18n.py），调 /i18n_getmsgs 刷新
6. 重启应用；浏览器验证驾驶舱 `/pipeline-opportunity/agent`

## 表

- `opp_reports`：研发报告（software/title/content/status/confirm_task_id/confirmed_by）
- `opp_approvals`：研发审批（report_id/status/note/resolved_by）

## 技能

产线技能在 pipeline-core 技能库：`skills_library/pipelines/opportunity_general/`
（common/opp-workflow 总纲 + roles/agent.opp_analyst、agent.opp_writer 角色技能）。