devmgt 接口文档 · AI 调用指南¶

curl -s http://192.168.7.21:5000/dev/api/deploy/info
# → {"ok": true, "meta": {"commit": "...", "version": "...", "built_at": "..."}, ...}

BASE=http://192.168.7.21:5000/dev/api

# 1) 产品线
curl -s -X POST $BASE/vm/product-lines -H 'Content-Type: application/json' \
  -d '{"name": "生产质量", "code": "BX-SCZL"}'
# → {"ok": true, "id": 8, "product_line": {...}}

# 2) 产品（一次性建产品+序列+仓库；也可 POST /vm/products 只建产品本身）
curl -s -X POST $BASE/vm/products/full -H 'Content-Type: application/json' \
  -d '{"product": {"code": "bams-mes", "name": "后端-生产质量", "type": "product",
                   "build_type": "maven", "image_name": "xxx/mes", "jenkins_folder": "bams",
                   "service_name": "bams-mes", "home_path": "/opt/mes", "deploy_to": "7.21"},
       "sequences": [{"code": "release", "name": "正式序列", "branches": "master,release"}],
       "repos": [{"name": "bams-mes", "git_url": "http://git.cnbmtech.com/xxx/bams-mes.git"}]}'
# → {"ok": true, "id": 31, "sequence_ids": [...], "repo_ids": [...], "errors": []}

# 3) 产品线挂产品
curl -s -X PUT $BASE/vm/product-lines/8/components -H 'Content-Type: application/json' \
  -d '{"product_ids": [31]}'

# 4) 建计划（自动继承产品线模块）
curl -s -X POST $BASE/vm/plans -H 'Content-Type: application/json' \
  -d '{"product_line_id": 8, "name": "v20260901", "plan_date": "2026-09-01", "status": "planning"}'
# → {"ok": true, "id": 25, "plan": {...}}

PID=25
# 1) 关联需求（story_id 从 /req/list-stories 或需求树拿）
curl -s -X POST $BASE/vm/plans/$PID/stories -H 'Content-Type: application/json' \
  -d '{"stories": [{"story_id": "26658", "story_title": "生产管理-物料管理-生产消耗明细增加数量合计"}]}'

# 2) 关联 bug
curl -s -X POST $BASE/vm/plans/$PID/bugs -H 'Content-Type: application/json' \
  -d '{"bugs": [{"bug_id": "193693", "bug_title": "过账日志功能"}]}'

# 3) 一键 Jenkins 编译（beta 序列、全部关联模块；product_codes 可指定子集）
curl -s -X POST $BASE/vm/plans/$PID/build -H 'Content-Type: application/json' \
  -d '{"sequence": "beta"}'
# → {"ok": true, "results": [{"repo": "bams-mes", "ok": true, "jenkins_url": "..."}], "errors": []}

# 4) Jenkins 的 ci.sh 会自动:取号(POST /vm/product/<code>/next-version)
#    → 构建完成后回写(POST /vm/version/<vid>, status=released, commits=..., plan_id=<PID>)
#    → 带 plan_id 时版本记录自动挂回计划。手动补写也可直接调这两个端点。

# 5) 查看计划版本 + 代码变更
curl -s $BASE/vm/plans/$PID/versions
curl -s -X POST $BASE/vm/plans/$PID/changes/refresh   # 慢操作，聚合 GitLab+禅道
curl -s $BASE/vm/plans/$PID/changes                   # 之后读缓存

K='X-Api-Key: <你的scoped-key>'
curl -s -H "$K" "$BASE/req/list-mine"
curl -s -X POST -H "$K" -H 'Content-Type: application/json' $BASE/req/complete-task \
  -d '{"task_id": 19743, "action": "finish"}'
curl -s -X POST -H "$K" -H 'Content-Type: application/json' $BASE/req/submit-effort \
  -d '{"task_id": 19743, "hours": 2, "comment": "联调"}'