甲方对接自动化 (表单模板 + webhook 触发 S1)¶
版本: v0.6 · 2026-06-16 · 新增 (per 网页分析 §5) 适用: PM / 客户对接人 / 销售支持 触发: 用户填表单 → 飞书 webhook → 自动 S1 启动
§5.1 设计目标¶
- 甲方首次接触 → 30 min 内自动开 S1 (需求接入) 工单
- 减少 PM 抄表: 表单 → 飞书 v06_需求接入 表, 不手抄
- 可追溯: 表单提交 ID 与 S1 工单 1:1 绑定
- 可审计: 表单内容存档, 60 天后清理
§5.2 甲方需求表单 (web 端)¶
URL: https://fde.nautilus.social/onboard/
后端: scripts/onboard_form.py (FastAPI, 端口 8850)
存储: 飞书 v06_需求接入 表 (app_token RGDKbrtZ1aMcEOsZ2GcczeFknNg table_id tblTZ0RCzVkrRquh)
表单字段 (12 项)¶
| # | 字段 | 类型 | 必填 | 备注 |
|---|---|---|---|---|
| 1 | 甲方公司名 | Text | ✅ | |
| 2 | 联系人姓名 | Text | ✅ | |
| 3 | 联系人手机 | Tel | ✅ | 飞书 IM 通知用 |
| 4 | 联系人邮箱 | ✅ | ||
| 5 | 业务类型 | SingleSelect | ✅ | 1=出题 / 2=教案 / 3=评测 / 4=其它 |
| 6 | 一级类目 | Text | ✅ | 例: "法律" / "金融" |
| 7 | 三级领域 | Text | 🟡 | 例: "合同审查" / "信用评估" |
| 8 | L级 | SingleSelect | ✅ | L1 / L2 / L3 (见 sop/01) |
| 9 | 预估规模 | Number | 🟡 | 案例数 / 教案数 / 评测 task 数 |
| 10 | 期望交付日 | Date | 🟡 | |
| 11 | 特殊要求 | Textarea | 🟢 | 自由描述 |
| 12 | 是否签约 | Switch | ✅ | 决定是否进 S2 |
§5.3 webhook 触发链¶
甲方填表单
↓ POST /onboard/submit (HMAC-signed)
onboard_form.py
├─→ 飞书 v06_需求接入 加 1 行 (状态=待审核)
├─→ 飞书 IM 推 PM: "新甲方: XXX, 业务=YYY"
└─→ 触发 /webhook/onboard → S1 auto-start
├─ 派活给 PM (v06_派活 表 + 1 行)
├─ 拉 SOP 模板 (sop/02_甲方需求与审核要点.md)
└─ 24h 后自动提醒: "S1 进度?"
§5.4 S1 启动 checklist (自动)¶
| # | 动作 | 自动 / 人工 | 工具 |
|---|---|---|---|
| 1 | 飞书 v06_需求接入 加行 | 自动 | onboard_form |
| 2 | 飞书 v06_派活 加行 (派活给 PM) | 自动 | webhook /onboard |
| 3 | 拉 SOP 02 模板 | 自动 | sop/02_*.md |
| 4 | 建 mock 数据 base (甲方专属) | 半自动 | PM 点确认 |
| 5 | 拉 §4 沙箱环境 (mock 演练) | 自动 | sandbox/* |
| 6 | 24h 后 IM 提醒 S1 进度 | 自动 | cron |
§5.5 失败重试 + 审计¶
- 表单提交失败: 重试 3 次 → 仍失败 → 飞书 IM 报 PM + webhook 日志
- 表单内容 60 天后归档:
scripts/onboard_archive.py(cron 月跑) - 审计: 表单提交 → 飞书 v06_审计日志 表 + 1 行 (writer_source=engine, operation=create)
§5.6 实施 (v0.7 留 hook, v0.6 文档先行)¶
v0.6 (本版本): 文档 + 表单 UI mockup + webhook 链路图
v0.7 (下次): 实装 onboard_form.py + 飞书表单 + 触发器测试
v0.8 (后续): 60 天归档脚本 + 审计自动接入
参考: sop/02_甲方需求与审核要点.md §3 (审核清单) + training/04_每日任务卡_沙箱演练.md §4.2