M1 自拆解简报 · 入口级交付

[JIAQIA]

M1 自拆解简报 · platform-common（当前空壳，须起骨架）

粗粒度里程碑简报。只读本简报 + 本仓代码即可自拆子任务并自验收，无需问人。
上位总纲：主仓 docs/milestones/M1-单命名空间端到端贯通.md。

0. 一句话目标

本仓目前是空壳（只有 CLAUDE.md/README/LICENSE，无 pom.xml/src），M1 = 起一个与其它 Java 服务同范式的最小 Spring Boot 骨架，使其能产出镜像、装进 umbrella，不拖累单 ns demo。

1. 起点 · 代码现状

• 现状：无 pom.xml、无 src/、无 Dockerfile。规划承载：DolphinScheduler + Flowable（调度/流程公共能力）。
• ⚠️ CLAUDE.md 缺契约块（consumer ×4）。
• 参照系：control-plane/governance/security 等都是 Java17 + SB3.3.5 + 继承 libs-java parent/BOM 0.2.0 的标准骨架，可照抄。

2. 范围边界

• ✅ M1：最小可启动 SB 服务（actuator + 一个 probe）+ Dockerfile + 镜像 + 契约块。
• ⛔ 不做：真实 DolphinScheduler/Flowable 集成。

3. 工作项 & 拆分指引

WP1 起 Spring Boot 最小骨架

• 要达成：pom.xml（parent = libs-java parent，import libs-java BOM；artifact io.hashmatrix）+ Application 主类 + actuator（liveness/readiness）+ 一个 ProbeController GET /api/platform-common/probe。
• 入手点：照抄 governance/security 的 pom.xml 与 ProbeController 结构（同 BOM、同 actuator 配置）。
• 拉 libs 需 read:packages PAT（见 libs-java README）。
• 可拆：- [ ] pom（parent+BOM）- [ ] Application + 配置 - [ ] actuator + probe - [ ] application.yml 端口。
• 验收：mvn spring-boot:run 起在 8089，/actuator/health 绿，/api/platform-common/probe 200。

WP2 容器化 + 契约块

• Dockerfile（多阶段、非 root、EXPOSE 8089）；CI 推 ghcr.io/hashmatrixdata/platform-common:<semver>；端口 ${SERVER_PORT:8089}/mgmt 9089；套 contracts/integration.md §1 补 CLAUDE.md 契约块。

4. 关键参考

• 范式仓：services/governance、services/security 的 pom.xml + ProbeController。
• libs：libs-java README.md（parent + import BOM 接入；PAT 拉取）。

5. 依赖 & 约束

• 依赖：libs-java（GH Packages PAT）。端口 8089/9089。受 D5 约束。

6. 完成判据

• pom.xml + Application + actuator + probe 可本地启动（8089）
• Dockerfile + 镜像入 ghcr；CLAUDE.md 契约块补齐
• 红线自检过