integrate

/integrate

为什么有这个命令：v0.9.11 之前 /impl → /verify 直接跑 unit 测试 + 代码评审，但前后端从未真正联调过——数据库没起、Redis 没起、server 进程没启动、API 路径前后端是否对齐未知。/integrate 填补这一环。

输入：$ARGUMENTS

---

Phase 1 — 前置校验

test -f docs/api-contract.yaml || { echo "❌ 请先运行 /design"; exit 1; }
test -f .ddt/tech-stack.json || { echo "❌ 缺 .ddt/tech-stack.json，先 /design"; exit 1; }

[ -f "$DDT_PLUGIN_ROOT/bin/aggregate.mjs" ] || DDT_PLUGIN_ROOT=$(cat "${HOME}/.claude/delivery-metrics/.ddt-plugin-root" 2>/dev/null)
[ -f "$DDT_PLUGIN_ROOT/bin/aggregate.mjs" ] || DDT_PLUGIN_ROOT="${HOME}/.claude/plugins/marketplaces/digital-delivery-team"
[ -f "$DDT_PLUGIN_ROOT/bin/aggregate.mjs" ] || { echo "❌ DDT plugin root 未解析"; exit 1; }
export DDT_PLUGIN_ROOT

if printf '%s' "$ARGUMENTS" | grep -q -- '--dry-run'; then
  node "$DDT_PLUGIN_ROOT/bin/integrate-up.mjs" --dry-run
  exit 0
fi
node "$DDT_PLUGIN_ROOT/bin/emit-phase.mjs" --phase integrate --action start

Phase 2 — 派发 integrate-up

跑核心起栈脚本：

node "$DDT_PLUGIN_ROOT/bin/integrate-up.mjs" $ARGUMENTS
INTEGRATE_EXIT=$?

bin/integrate-up.mjs 执行 8 个阶段（每步 emit 子状态到 stdout）：

Phase	动作	失败退出码
1	环境侦测：docker / docker-compose / 端口占用 / tech-stack	2
2	docker-compose 准备：用户配置 OR plugin 模板复制（按 preset）	—
3	docker compose up -d --wait（mysql/postgres + redis + healthcheck）	3
4	db migration（按 preset：mvn flyway / npx prisma migrate / alembic upgrade）	4
5	启 server 后台（mvn spring-boot:run / npm run start:dev），等 health 60s	5
6	启 web 后台（npm run dev），等端口 :5173 30s	6
7	smoke：GET health + OpenAPI 第一个 GET endpoint + web 端口监听	7
8	报告 → docs/integrate-report.md；可选 --tear-down 拆环境	—

Phase 3 — 失败处理

if [ "$INTEGRATE_EXIT" -ne 0 ]; then
  echo "❌ /integrate 失败（exit $INTEGRATE_EXIT）；详见 docs/integrate-report.md"
  echo ""
  echo "常见原因 + 自助："
  echo "  exit 2: docker / docker-compose 不可用 → 装 Docker Desktop"
  echo "  exit 3: docker compose up 失败 → docker compose -f docker-compose.yml logs"
  echo "  exit 4: db migration 失败 → 检查 server/{db,prisma,alembic} 配置"
  echo "  exit 5: server 未就绪 → cat .ddt/integrate/server.log"
  echo "  exit 6: web 未就绪 → cat .ddt/integrate/web.log"
  echo "  exit 7: smoke 失败 → curl 验证 endpoint；检查 api-contract.yaml 路径"
  echo ""
  echo "修好后重跑 /integrate；保留 stack 时手动 docker compose down 清理"
  exit "$INTEGRATE_EXIT"
fi