refactor: make latest state optional

docs/module-data-flow.html

@@ -325,7 +325,7 @@ flowchart TB
 
   subgraph services["消费服务 modules/services"]
     history["event-history-service<br/>Kafka event/raw 到 TDengine 历史查询"]
-    state["vehicle-state-service<br/>Kafka 全字段事件到 Redis 热状态"]
+    state["vehicle-state-service<br/>可选 Redis 热状态<br/>optional-latest-state"]
     stat["vehicle-stat-service<br/>Kafka 全字段事件到指标表"]
   end
 
@@ -614,7 +614,7 @@ flowchart LR
       </tr>
       <tr>
         <td>modules/services/vehicle-state-service</td>
-        <td>消费 Kafka 全字段事件，更新车辆最新状态、位置、安全和最后事件到 Redis；生产消费可使用 <code>tryIngest</code> 和自动装配的 <code>EnvelopeConsumerProcessor</code> 隔离坏 protobuf 和缺快照 Envelope，并把失败记录交给死信出口。</td>
+        <td>消费 Kafka 全字段事件，更新车辆最新状态、位置、安全和最后事件到 Redis；仅通过 <code>optional-latest-state</code> profile 显式构建，不属于默认生产 reactor；生产消费可使用 <code>tryIngest</code> 和自动装配的 <code>EnvelopeConsumerProcessor</code> 隔离坏 protobuf 和缺快照 Envelope，并把失败记录交给死信出口。</td>
         <td>Kafka Protobuf Envelope。</td>
         <td><code>vehicle:state:{vin}</code>、<code>vehicle:location:{vin}</code>、<code>vehicle:safety:{vin}</code>。</td>
         <td><span class="tag green">毫秒级热查询</span><span class="tag red">氢泄露安全</span></td>

docs/operations/gb32960-service-split-runbook.md

@@ -136,7 +136,7 @@ java --sun-misc-unsafe-memory-access=allow \
   -jar modules/apps/vehicle-analytics-app/target/vehicle-analytics-app.jar
 ```
 
-`vehicle-analytics-app` is intentionally a metric runtime only. Latest-state APIs belong to `vehicle-state-service` and should be deployed as a separate consumer if that surface is needed.
+`vehicle-analytics-app` is intentionally a metric runtime only. Latest-state APIs belong to `vehicle-state-service`, which stays outside the default reactor and should be built with `-Poptional-latest-state` and deployed as a separate consumer if that surface is needed.
 
 ## Health Verification
 

docs/target-architecture.md

@@ -140,6 +140,9 @@ require a separate Redis mileage state.
 
 Module: `vehicle-state-service`
 
+This module is outside the default production reactor. Build it with
+`-Poptional-latest-state` when Redis latest-state APIs are explicitly needed.
+
 Responsibilities:
 
 - Consume normalized Kafka envelopes.
@@ -183,6 +186,8 @@ flowchart LR
 - Xinda Push is absent from default deployment and history consumer bindings.
 - JSATL12 is absent from the default Maven reactor and available through
   `optional-attachments`.
+- vehicle-state-service is absent from the default Maven reactor and available
+  through `optional-latest-state`.
 - History APIs read from TDengine by default; Parquet/DuckDB is optional
   compatibility only.
 - Raw frame queries can return complete parsed JSON through `payloadJson.parsed`.