docs(acm2-75): 重排 Q 序号并补齐 Redis 投影与查询侧边界

Co-authored-by: Cursor <cursoragent@cursor.com>

src/main/kotlin/com/gzzn/omms/msgexchange/codec/JacksonXmlCodec.kt

@@ -85,7 +85,7 @@ class JacksonXmlCodec : XmlCodec {
     /**
      * 子类型分派必须是**白名单**：未知的 SCHD 子类型不能静默当成全量日计划（DNLD）——
      * 那会让一条本该"暂不支持、等人工处置"的报文走最重的整包合并写入路径。
-     * 空 STYP 按 legacy 约定视为 DNLD（该约定待与 SIS 逐类对拍确认，见 Q8）。
+     * 空 STYP 按 legacy 约定视为 DNLD（该约定待与 SIS 逐类对拍确认，见 Q3）。
      */
     private fun kindOf(type: String, styp: String): MsgKind = when (type) {
         "SCHD" -> when (styp) {

src/main/kotlin/com/gzzn/omms/msgexchange/codec/SisMessageBody.kt

@@ -23,7 +23,7 @@ data class ScheduleBody(
  * 只保留在 wire/domain、尚未映射到持久化明细的集合键（`[G-SRVT-VIPF]`）。
  *
  * 它们不参与合并、不进快照、不落库；保留的目的是不让入站事实在解码层被静默抹平，并让真实
- * 流量里的出现情况可观测——决定"缺席是否等于删除"的 `Q13` 需要真实报文才能定案。
+ * 流量里的出现情况可观测——决定"缺席是否等于删除"的 `Q11` 需要真实报文才能定案。
  */
 private val UNPERSISTED_COLLECTION_KEYS: Set<String> = setOf("SRVT", "VIPF")
 
@@ -132,7 +132,7 @@ data class FlightRecordXml(
     @param:JacksonXmlElementWrapper(useWrapping = false) @param:JacksonXmlProperty(localName = "ROUT") val rout: List<RoutXml> = emptyList(),
     @param:JacksonXmlElementWrapper(useWrapping = false) @param:JacksonXmlProperty(localName = "ERUT") val erut: List<RoutXml> = emptyList(),
     // SRVT/VIPF 用可空表达"段是否出现"：null = 未出现；出现即为列表（空元素得到一行空行）。
-    // 两者都不落明细表、不参与合并，清空语义待 `Q13`（`[G-SRVT-VIPF]`）。
+    // 两者都不落明细表、不参与合并，清空语义待 `Q11`（`[G-SRVT-VIPF]`）。
     @param:JacksonXmlElementWrapper(useWrapping = false) @param:JacksonXmlProperty(localName = "SRVT") val srvt: List<SrvtXml>? = null,
     @param:JacksonXmlElementWrapper(useWrapping = false) @param:JacksonXmlProperty(localName = "VIPF") val vipf: List<VipfXml>? = null,
 )

src/main/kotlin/com/gzzn/omms/msgexchange/codec/SisWireMapper.kt

@@ -38,7 +38,7 @@ internal object SisWireMapper {
      * `filterValues` 去掉的正是"缺席"，避免整包凭空清空本地明细（合并语义见 docs/implementation.md「SCHD 日计划」）。
      *
      * `SRVT`/`VIPF` 尚未有明细表（`[G-SRVT-VIPF]`）：只用"键是否存在"表达段是否出现，保留原始
-     * 内容与顺序，不参与合并、不判断清空语义（`Q13`）——出现（哪怕为空）与缺席不再被抹平。
+     * 内容与顺序，不参与合并、不判断清空语义（`Q11`）——出现（哪怕为空）与缺席不再被抹平。
      */
     private fun FlightRecordXml.collections(): Map<String, List<Map<String, String>>> {
         val mapped = linkedMapOf(

src/main/kotlin/com/gzzn/omms/msgexchange/infra/metrics/PipelineCounters.kt

@@ -21,7 +21,7 @@ class PipelineCounters {
      * 入站记录里出现 `SRVT`/`VIPF` 段的条数（`[G-SRVT-VIPF]`）。
      *
      * 这两个集合目前只保留在 wire/domain，不落明细表、不参与合并；计数是"真实报文有没
-     * 有在用"的唯一取证渠道（清空语义 `Q13` 需要真实样例才能定案）。> 0 表示确有流量携带该段。
+     * 有在用"的唯一取证渠道（清空语义 `Q11` 需要真实样例才能定案）。> 0 表示确有流量携带该段。
      */
     fun unpersistedCollectionSeenAdd(hits: Map<String, Int>) {
         hits["SRVT"]?.let { srvtSeen.addAndGet(it.toLong()) }

src/main/kotlin/com/gzzn/omms/msgexchange/infra/metrics/PipelineMetrics.kt

@@ -94,7 +94,7 @@ class PipelineMetrics(
             .strongReference(true)
             .register(registry)
 
-        // SRVT/VIPF 尚未落明细表（[G-SRVT-VIPF]）：计数替代静默丢弃，为 Q13 提供真实流量证据。
+        // SRVT/VIPF 尚未落明细表（[G-SRVT-VIPF]）：计数替代静默丢弃，为 Q11 提供真实流量证据。
         Gauge.builder("msgx.pipeline.codec.srvt_seen.total", counters) { it.srvtSeenCount().toDouble() }
             .strongReference(true)
             .register(registry)

src/main/kotlin/com/gzzn/omms/msgexchange/infra/persistence/jdbc/JdbcCminmsgInboxRepository.kt

@@ -37,10 +37,10 @@ class JdbcCminmsgInboxRepository(
             }
         } catch (e: IllegalStateException) {
             // 只调整适配代码、不碰共享 Schema：把"取不到 generated key"变成可诊断错误，
-            // 指出这是共享信箱 ID 生成方式的前提（C-14、Q7）。
+            // 指出这是共享信箱 ID 生成方式的前提（C-14、Q8）。
             throw IllegalStateException(
                 "shared mailbox insert returned no generated CMINMSGS_ID; " +
-                    "the CMINMSGS_ID column must be DB-generated (C-14, Q7)",
+                    "the CMINMSGS_ID column must be DB-generated (C-14, Q8)",
                 e,
             )
         }

src/main/kotlin/com/gzzn/omms/msgexchange/processing/Pump.kt

@@ -190,7 +190,7 @@ class MessageProcessor(
             }
         }
 
-        // [G-SRVT-VIPF]：SRVT/VIPF 段只保留在解码载荷里，尚未落明细表（清空语义待 Q13）。
+        // [G-SRVT-VIPF]：SRVT/VIPF 段只保留在解码载荷里，尚未落明细表（清空语义待 Q11）。
         // 计数 + 告警替代此前的静默丢弃；出现即证明真实报文携带该段，可作为定案依据。
         val unpersisted = unpersistedCollectionHits(decoded.body)
         if (unpersisted.isNotEmpty()) {