Phase 9 + 10：Spring Boot starter + Testcontainers interop 骨架 + README 收尾

[lixuanqun]

概述

把剩余三件事一次性完成：Spring Boot 自动配置、互操作测试骨架、README 同步。到此项目原计划的 0-10 阶段全部交付。

🔗 stacked on PR #14 TLS+WS

1. sip-spring-boot-starter（第 11 模块）

配置

sip:
  transport:
    udp:  { enabled: true,  host: 0.0.0.0, port: 5060 }
    tcp:  { enabled: false, host: 0.0.0.0, port: 5060 }
    tls:  { enabled: false, host: 0.0.0.0, port: 5061,
            keystore-path: file:/etc/sip/keystore.p12,
            keystore-password: changeit }
    ws:   { enabled: false, host: 0.0.0.0, port: 80 }

自动 Beans

• 4 个 transport @ConditionalOnProperty
• TimerScheduler 单例 @ConditionalOnMissingBean
• RegistrationClient / OptionsProbe 连接到第一个可用 transport
• TLS keystore 支持 classpath: / file: / 文件系统路径
• 默认 TrustManager 全拒（强制操作员显式提供 SSLContext bean）
• @PreDestroy 钩子按反序关闭

工程

• Spring Boot 3.4 BOM 引入父 POM，仅 starter 模块消费
• starter 不带 module-info.java（Spring Boot 与 JPMS 不友好），仅此模块 -Xlint:-module
• JDK 21 this-escape 警告由 setter final 修复

测试

• ApplicationContextRunner 4 场景

2. sip-interop-tests（第 12 模块，profile interop）

mvn verify              # 默认 11 modules，跳过 interop
mvn verify -Pinterop    # 启用，需要 Docker

KamailioContainer

• 固定 kamailio/kamailio-ci:5.7-alpine
• 内嵌最小 Kamailio 配置 via Transferable（registrar + Digest auth）
• isDockerAvailable() 静态探测，无 Docker 时测试 优雅 skip

测试

• registersWithDigestAuth — REGISTER → 401 → Digest auth → 200 全流程
• optionsProbeReturns200 — OPTIONS → 200

3. README 同步

• 模块表更新到 12 模块
• 路线图 Phase 8/9/10 全部 ✅
• 测试规模表按模块列出，~225 tests
• 新增 "Spring Boot 自动配置（推荐）" 快速上手段

验证

mvn -B verify           → 11 modules SUCCESS, ~225 tests
mvn -B verify -Pinterop → 12 modules SUCCESS（interop 测试在无 Docker 时 skip）

PR 链完整图

main
 └── #2  骨架 + ADR-0001
      └── #3  fixture 基础设施
           └── #4  SipParser
                └── #5  SipEncoder
                     └── #6  SipUriParser
                          └── #7  typed headers
                               └── #8  UDP + TCP transport
                                    └── #9  事务层 4 FSM
                                         └── #10 Dialog + REGISTER + Digest
                                              └── #11 GB28181
                                                   └── #12 ADR-0002 + README
                                                        └── #13 RFC 4475 +9 fixture + <hex>
                                                             └── #14 TLS + WebSocket
                                                                  └── #15 ← 本 PR

合并顺序：#2 → #3 → … → #15。