86 lines
4.4 KiB
Markdown
86 lines
4.4 KiB
Markdown
---
|
||
name: pipeline-opportunity
|
||
description: "商机产线能力包——招标市场情报(数据爬取平台)→热点软件推荐→每日AI招标→研发报告→人工确认→研发审批。含爬虫平台接入配置与工具清单。"
|
||
---
|
||
|
||
# pipeline_opportunity
|
||
|
||
商机产线能力包：把中国招标市场情报转化为软件研发商机。挂载到宿主应用（pipeline-app）即生效，
|
||
项目 `sd_projects.pipeline_id='opportunity_general'` 时自动启用全部工具。
|
||
|
||
## 平台边界（必读）
|
||
|
||
```
|
||
数据爬取平台 (ebpe.cc:/d/ymq/work/tender_opp) 产线平台 (本模块)
|
||
采集/存储/去重/只读查询 商机业务闭环
|
||
┌──────────────────────────┐ ┌──────────────────────────┐
|
||
│ ccgp+ggzy 采集 (30min) │ 内网HTTP只读 │ 热点推荐/每日AI招标 │
|
||
│ SQLite 持久 (1700+条) │ ←──────────────── │ 研发报告→人工确认→研发审批 │
|
||
│ http_api.py :9085 +token │ │ opp_reports/opp_approvals │
|
||
└──────────────────────────┘ └──────────────────────────┘
|
||
```
|
||
|
||
- 本模块**不爬取、不存**招标原始数据，只消费爬虫平台；报告/审批状态落产线库。
|
||
- 爬虫平台侧细节见其仓库 `BOUNDARY.md`/`README.md`（HTTP 端点 /api/tenders 等）。
|
||
|
||
## Architecture
|
||
|
||
```
|
||
pipeline_opportunity/
|
||
├── init.py # load_pipeline_opportunity()（幂等挂载）
|
||
├── opp_common.py # DB上下文/爬虫HTTP客户端/状态机/人工任务
|
||
├── opp_data_capability.py # 爬虫平台只读封装（热点/搜索/详情/每日AI/健康度）
|
||
├── opp_report_capability.py # 报告+审批状态机（draft→confirmed→approval→approved/rejected）
|
||
├── opp_ability.py # 12工具+prompt+2角色+4 slash 命令（PipelineAbility 注册）
|
||
├── wwwroot/ # opp_reports / opp_approvals CRUD 页面（xls2ui 生成）
|
||
├── models/ + json/ # DDL 与 CRUD 源
|
||
└── scripts/load_path.py # RBAC 路径注册
|
||
```
|
||
|
||
## 爬虫平台接入（配置不硬编码）
|
||
|
||
appbase `params` 表两个键（`opp_common.get_crawler_config` 读取，默认内网地址兜底）：
|
||
|
||
| 键 | 值 |
|
||
|----|-----|
|
||
| `tender_api_base` | `http://192.168.16.2:9085`（内网网卡绑定，公网不可达） |
|
||
| `tender_api_token` | 爬虫平台 `state/api.env` 的 TENDER_API_TOKEN |
|
||
|
||
## 工具（主 agent，opp_ 前缀）
|
||
|
||
| 工具 | 用途 |
|
||
|------|------|
|
||
| `opp_hot_software(days,top)` | 热点软件推荐：招标量+预算+地区排名 |
|
||
| `opp_daily_ai_tenders(date)` | 每日 AI/Agent 招标展示数据 |
|
||
| `opp_search_tenders(keyword,days,source,limit)` | 关键词检索 |
|
||
| `opp_tender_detail(tender_id)` | 单条详情（原文/预算/联系人/来源链接） |
|
||
| `opp_crawler_stats()` | 爬虫平台采集健康度 |
|
||
| `opp_create_report / opp_update_report` | 报告草稿创建/补写 |
|
||
| `opp_list_reports / opp_get_report` | 报告列表/全文 |
|
||
| `opp_submit_report(report_id)` | 提交人工确认（创建门禁任务） |
|
||
| `opp_list_approvals` | 审批单列表 |
|
||
| `opp_diagnose` | 产线诊断 |
|
||
|
||
角色：`agent.opp_analyst` / `agent.opp_writer`；slash：`/hot` `/ai` `/reports` `/oppdiag`。
|
||
|
||
## 状态机与门禁（不要绕过）
|
||
|
||
```
|
||
draft ──人工确认──> confirmed ──发起──> approval_initiated ──人工结论──> approved
|
||
↑ └ rejected ──> draft（可重来）
|
||
```
|
||
|
||
- 确认/审批都是 `pipeline_human_tasks` 人工任务（task_type: `opp_report_confirm` /
|
||
`opp_dev_approval`），结论由人工回流，agent 禁止自批自审。
|
||
- 非法迁移一律拒绝（`REPORT_TRANSITIONS`）。
|
||
- 报告中的招标数字必须来自工具返回的真实数据，禁止编造；引用带来源链接。
|
||
|
||
## 部署清单（宿主侧）
|
||
|
||
1. `build.sh`（建表+种子+wwwroot 软链+pip install）
|
||
2. app 入口 `load_pipeline_opportunity()`（已接线，try/except 兜底）
|
||
3. `scripts/load_path.py` 注册 RBAC
|
||
4. i18n 合并 `i18n/{zh,en}/msg.txt`
|
||
5. params 表配 `tender_api_base` / `tender_api_token`
|
||
6. 重启 → 驾驶舱验证 `/hot` 或 `opp_diagnose`
|