CRM 项目管理

参考文档索引

| 分类 | 文件 | 说明 | |------|------|------| | 认证 | authentication.md | 登录流程、密码加密、凭据提取 | | 基础 | base.md | 工具函数、编码规范 | | 枚举 | enums.md | 时间常量、dbType、searchCondition 通用结构 | | 项目管理 | project.md | 查询项目列表、新增项目 | | 项目任务 | project_task.md | 查询项目任务列表、新增项目任务 | | 项目跟进 | project_follow.md | 查询项目跟进列表、新增项目跟进 |

第一步：收集凭据（每次对话开始时）

尚未获取凭据时，使用 AskUserQuestion 工具一次性收集 4 个参数：

AskUserQuestion({
  questions: [
    { header: "平台地址", question: "CRM 平台的 base_url 是什么？",
      options: [{ label: "在下方输入平台地址", description: "例如 https://crm.example.com" }] },
    { header: "userId",   question: "登录企业账号是什么？",
      options: [{ label: "在下方输入企业账号", description: "企业 userId" }] },
    { header: "email",    question: "登录账号是什么？",
      options: [{ label: "在下方输入账号", description: "登录邮箱或账号" }] },
    { header: "密码",     question: "登录密码是什么？",
      options: [{ label: "在下方输入密码", description: "明文密码，自动加密" }] },
  ]
})

收集到凭据后，调用 scripts/crm_login.py 登录：

python scripts/crm_login.py \
  --base-url <base_url> \
  --user-id <userId> \
  --email <email> \
  --password <password>

登录成功输出 JSON：{"success": true, "authToken": "...", "JSESSIONID": "...", "emp_id": "..."}

凭据在当前会话中复用，不要重复询问。

常见操作速查

| 操作 | 接口 | 参考文档 | |------|------|---------| | 查询项目列表 | POST /Project/list | project.md | | 新增项目 | viewId=ProjectAdd → POST /Project/insert | project.md | | 查询项目任务列表 | POST /ProjectTask/list | project_task.md | | 新增项目任务 | viewId=ProjectTaskAdd → POST /ProjectTask/insert | project_task.md | | 查询项目跟进列表 | POST /ProjectFollow/list | project_follow.md | | 新增项目跟进 | viewId=ProjectFollowAdd → POST /ProjectFollow/insert | project_follow.md |

脚本工具

crm_login.py — 登录获取凭据

python scripts/crm_login.py \
  --base-url https://xxx \
  --user-id xxx \
  --email xxx \
  --password xxx

输出：{"success": true, "authToken": "...", "JSESSIONID": "...", "emp_id": "..."}

crm_query.py — 通用查询（使用凭据）

python scripts/crm_query.py \
  --base-url https://xxx \
  --jsessionid xxx \
  --auth-token xxx \
  --module-id project \
  --limit 25

crm_form_submit.py — 通用表单提交（使用凭据）

# 仅查看模板
python scripts/crm_form_submit.py \
  --base-url https://xxx \
  --jsessionid xxx \
  --auth-token xxx \
  --view-id ProjectAdd \
  --template-only

# 提交新增
python scripts/crm_form_submit.py \
  --base-url https://xxx \
  --jsessionid xxx \
  --auth-token xxx \
  --view-id ProjectAdd \
  --data '{"name":"测试项目"}'

关键注意事项

• 中文编码：所有含中文的请求必须通过 Python 脚本执行，不能用 Bash 直接 curl（详见 base.md）
• multipart 请求：使用 curl --data-binary @- 通过 subprocess 发送
• 日期格式：提交格式必须为 Y-m-d H:i:s（含时间部分），如 2026-06-05 00:00:00
• 响应数据位置：解析时用 resp.get('rows') or resp.get('data') or []
• 新增操作：使用通用表单流程（scripts/crm_form_submit.py）：view/form → 解析字段 → insert