售前行程管理
目标
售前可以管理自己的行程（增删改查完成），销售可以查询售前的行程和工作负载。
脚本入口
-
主脚本：node scripts/presales-itinerary.mjs <action> [options]
-
查询脚本：node scripts/search.mjs presales-itineraries [options]
-
通用脚本：node scripts/request.mjs ...
-
环境变量：
-
必填：LCRM_API_KEY
-
可选：LCRM_BASE_URL （默认 https://crm.langcore.net ）
目标接口
-
创建：POST /api/presales-itineraries
-
修改：PUT /api/presales-itineraries/{id}
-
删除：DELETE /api/presales-itineraries/{id}
-
完成：POST /api/presales-itineraries/{id}/complete
-
查询：GET /api/presales-itineraries/week (支持时间段、用户、机会筛选)
-
辅助机会检索：GET /api/presales-itineraries/opportunities?keyword=<关键词>&limit=20
创建接口字段
必填：
-
title
-
startTime
-
endTime
-
opportunityId
-
tripType
-
deliveryMode
选填：
- remark ：备注，会同步到飞书日程描述中
枚举约束
tripType ：
-
需求调研 产品介绍 技术交流 方案沟通 方案撰写 技术预研 POC测试
-
产品演示 产品部署 标书撰写 讲标支持 商务谈判 内部会议 案例整理 培训学习
deliveryMode ：
- 现场 远程
status ：
-
PLANNED 已计划
-
COMPLETED 已完成
时间约束
-
必须是半小时粒度（分钟只能 00 或 30 ）。
-
endTime 必须晚于 startTime 。
必须执行的流程
-
先调脚本解析原文：
-
node scripts/presales-itinerary.mjs ai-parse --text "<用户原文>"
-
根据解析结果补齐字段：
-
opportunityId 缺失时，调用：
-
node scripts/presales-itinerary.mjs search-opportunities --keyword "<关键词>" --limit 20
-
然后让用户确认具体机会。
-
tripType 或 deliveryMode 缺失/非法时，让用户从枚举里选。
-
title/startTime/endTime 缺失时，逐项追问。
-
本地校验：
-
时间合法且半小时粒度。
-
枚举合法。
-
提交前确认（强制）：
-
展示确认卡片：
-
标题
-
时间范围
-
机会（名称 + 客户）
-
行程类型
-
交付形式
-
备注（有则展示）
-
仅当用户明确回复"确认/提交/是"后再调用创建接口。
-
调用创建脚本并回传结果：
-
node scripts/presales-itinerary.mjs create --payload '<JSON>'
-
或 --payload-file <file>
操作命令示例
创建行程
node scripts/presales-itinerary.mjs create
--title "朗致产品演示"
--start-time "2026-02-12T14:00:00"
--end-time "2026-02-12T16:00:00"
--opportunity-id "<opportunityId>"
--trip-type "产品演示"
--delivery-mode "现场"
带备注
node scripts/presales-itinerary.mjs create
--title "朗致产品演示"
--start-time "2026-02-12T14:00:00"
--end-time "2026-02-12T16:00:00"
--opportunity-id "<opportunityId>"
--trip-type "产品演示"
--delivery-mode "现场"
--remark "需要准备演示环境"
修改行程
node scripts/presales-itinerary.mjs update
--id "<itineraryId>"
--title "更新后的标题"
--start-time "2026-02-12T15:00:00"
--end-time "2026-02-12T17:00:00"
--opportunity-id "<opportunityId>"
--trip-type "方案沟通"
--delivery-mode "远程"
带备注
node scripts/presales-itinerary.mjs update
--id "<itineraryId>"
--title "更新后的标题"
--start-time "2026-02-12T15:00:00"
--end-time "2026-02-12T17:00:00"
--opportunity-id "<opportunityId>"
--trip-type "方案沟通"
--delivery-mode "远程"
--remark "更新备注"
删除行程
node scripts/presales-itinerary.mjs delete --id "<itineraryId>"
完成行程
完成行程后，系统会自动根据完成情况创建一条商务记录（跟进类型为"售前现场"或"售前远程"，取决于行程的交付形式）。
--completion-note 支持富文本（HTML 格式）。
node scripts/presales-itinerary.mjs complete
--id "<itineraryId>"
--actual-hours 2.5
--completion-note "完成产品演示，客户反馈良好"
查询行程
查询指定时间段的行程
node scripts/search.mjs presales-itineraries
--start-date 2026-02-10
--end-date 2026-02-16
查询某个售前的行程（销售查询售前工作负载）
node scripts/search.mjs presales-itineraries
--user-id "<userId>"
--start-date 2026-02-10
--end-date 2026-02-16
查询某个机会的行程
node scripts/search.mjs presales-itineraries
--opportunity-id "<opportunityId>"
缺失信息提示模板
-
缺机会：请确认要关联的机会（可提供机会名或客户名）。
-
缺类型：请确认行程类型（从系统枚举中选择）。
-
缺交付形式：请确认交付形式（现场/远程）。
-
缺时间：请补充开始和结束时间（半小时粒度，例如 2026-02-11T14:00:00 到 2026-02-11T16:30:00）。
权限说明
-
售前（PreSales）：可以创建、修改、删除、完成、查询自己的行程
-
销售（Sales）：可以查询售前的行程和工作负载（用于了解售前是否有空）
-
管理员（SystemAdmin）：拥有所有权限