Merge branch 'codex/gb32960-service-split'

2026-06-24 14:32:59 +08:00
parent b983f77c23 620821b624
commit a70f8f39ad
48 changed files with 4166 additions and 74 deletions
--- a/modules/apps/gb32960-ingest-app/pom.xml
+++ b/modules/apps/gb32960-ingest-app/pom.xml
@@ -0,0 +1,66 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>com.lingniu.ingest</groupId>
+        <artifactId>lingniu-vehicle-ingest</artifactId>
+        <version>0.1.0-SNAPSHOT</version>
+        <relativePath>../../../pom.xml</relativePath>
+    </parent>
+
+    <artifactId>gb32960-ingest-app</artifactId>
+    <name>gb32960-ingest-app</name>
+    <description>GB32960 protocol ingress runtime: TCP decode, auth, Kafka production, and ACK.</description>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>ingest-core</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>session-core</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>observability</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>protocol-gb32960</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>sink-mq</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <finalName>gb32960-ingest-app</finalName>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <configuration>
+                    <jvmArguments>--sun-misc-unsafe-memory-access=allow</jvmArguments>
+                </configuration>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>repackage</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>
--- a/modules/apps/gb32960-ingest-app/src/main/java/com/lingniu/ingest/gb32960app/Gb32960IngestApplication.java
+++ b/modules/apps/gb32960-ingest-app/src/main/java/com/lingniu/ingest/gb32960app/Gb32960IngestApplication.java
@@ -0,0 +1,21 @@
+package com.lingniu.ingest.gb32960app;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication(scanBasePackages = "com.lingniu.ingest")
+public class Gb32960IngestApplication {
+
+    private static final Logger log = LoggerFactory.getLogger(Gb32960IngestApplication.class);
+
+    public static void main(String[] args) {
+        try {
+            SpringApplication.run(Gb32960IngestApplication.class, args);
+        } catch (Throwable t) {
+            log.error("GB32960 ingest application failed to start, forcing JVM exit", t);
+            System.exit(1);
+        }
+    }
+}
--- a/modules/apps/gb32960-ingest-app/src/main/resources/application.yml
+++ b/modules/apps/gb32960-ingest-app/src/main/resources/application.yml
@@ -0,0 +1,110 @@
+spring:
+  application:
+    name: gb32960-ingest-app
+  threads:
+    virtual:
+      enabled: true
+
+server:
+  port: ${HTTP_PORT:20100}
+
+lingniu:
+  ingest:
+    gb32960:
+      enabled: true
+      server:
+        enabled: true
+      port: ${GB32960_PORT:32960}
+      boss-threads: ${GB32960_BOSS_THREADS:1}
+      worker-threads: ${GB32960_WORKER_THREADS:0}
+      auth:
+        enabled: ${GB32960_AUTH_ENABLED:false}
+        case-sensitive: false
+        whitelist: []
+        platforms:
+          - username: ${GB32960_PLATFORM_USER_HYUNDAI:Hyundai}
+            password: ${GB32960_PLATFORM_PWD_HYUNDAI:f2e3445d7cda409fb4f278f6fb890734}
+            allowed-ips:
+              - ${GB32960_PLATFORM_IP_HYUNDAI:8.134.95.166}
+            description: 外部下级平台 - Hyundai
+      tls:
+        enabled: ${GB32960_TLS_ENABLED:false}
+        cert-path: ${GB32960_TLS_CERT:}
+        key-path: ${GB32960_TLS_KEY:}
+        trust-cert-path: ${GB32960_TLS_CA:}
+        require-client-auth: true
+      vendor-extensions:
+        - name: guangdong-fc
+          match:
+            platform-accounts:
+              - Hyundai
+            vin-prefixes: []
+            vins: []
+      parse:
+        lenient-block-failure: true
+      diagnostics:
+        max-logged-frame-keys-per-channel: ${GB32960_DIAGNOSTICS_MAX_LOGGED_FRAME_KEYS_PER_CHANNEL:4096}
+    pipeline:
+      disruptor:
+        ring-buffer-size: ${PIPELINE_RING_BUFFER_SIZE:131072}
+        wait-strategy: ${PIPELINE_WAIT_STRATEGY:yielding}
+        producer-type: multi
+      dedup:
+        enabled: true
+        cache-size: 200000
+        ttl-seconds: 600
+      rate-limit:
+        per-vin-qps: 50
+    session:
+      store: ${SESSION_STORE:memory}
+      ttl: ${SESSION_TTL:30m}
+    identity:
+      store: ${VEHICLE_IDENTITY_STORE:file}
+      file:
+        path: ${VEHICLE_IDENTITY_FILE:./data/vehicle-identity.jsonl}
+    sink:
+      mq:
+        enabled: ${KAFKA_ENABLED:true}
+        type: kafka
+        bootstrap-servers: ${KAFKA_BROKERS:114.55.58.251:9092}
+        compression-type: zstd
+        linger-ms: 20
+        batch-size: 65536
+        acks: all
+        enable-idempotence: true
+        node-id: ${KAFKA_NODE_ID:gb32960-ingest-local}
+        topics:
+          realtime: ${KAFKA_TOPIC_GB32960_EVENT:vehicle.event.gb32960.v1}
+          location: ${KAFKA_TOPIC_GB32960_EVENT:vehicle.event.gb32960.v1}
+          alarm: ${KAFKA_TOPIC_GB32960_EVENT:vehicle.event.gb32960.v1}
+          session: ${KAFKA_TOPIC_GB32960_EVENT:vehicle.event.gb32960.v1}
+          media-meta: ${KAFKA_TOPIC_MEDIA_META:vehicle.media.meta.v1}
+          raw-archive: ${KAFKA_TOPIC_GB32960_RAW:vehicle.raw.gb32960.v1}
+          dlq: ${KAFKA_TOPIC_GB32960_DLQ:vehicle.dlq.gb32960.v1}
+        consumer:
+          enabled: false
+    event-file-store:
+      enabled: false
+    event-history:
+      enabled: false
+    vehicle-state:
+      enabled: false
+    vehicle-stat:
+      enabled: false
+
+management:
+  endpoints:
+    web:
+      exposure:
+        include: health,info,metrics,prometheus,env
+  health:
+    redis:
+      enabled: ${MANAGEMENT_HEALTH_REDIS_ENABLED:false}
+  metrics:
+    tags:
+      application: gb32960-ingest-app
+
+logging:
+  level:
+    root: INFO
+    com.lingniu.ingest: INFO
--- a/modules/apps/gb32960-ingest-app/src/test/java/com/lingniu/ingest/gb32960app/Gb32960IngestAppCompositionTest.java
+++ b/modules/apps/gb32960-ingest-app/src/test/java/com/lingniu/ingest/gb32960app/Gb32960IngestAppCompositionTest.java
@@ -0,0 +1,68 @@
+package com.lingniu.ingest.gb32960app;
+
+import com.lingniu.ingest.core.config.IngestCoreAutoConfiguration;
+import com.lingniu.ingest.protocol.gb32960.codec.Gb32960MessageDecoder;
+import com.lingniu.ingest.protocol.gb32960.config.Gb32960AutoConfiguration;
+import com.lingniu.ingest.protocol.gb32960.inbound.Gb32960NettyServer;
+import com.lingniu.ingest.session.config.SessionCoreAutoConfiguration;
+import com.lingniu.ingest.sink.mq.KafkaEventSink;
+import com.lingniu.ingest.sink.mq.KafkaEnvelopeDeadLetterSink;
+import com.lingniu.ingest.sink.mq.SinkMqAutoConfiguration;
+import org.apache.kafka.clients.producer.KafkaProducer;
+import org.junit.jupiter.api.Test;
+import org.springframework.boot.autoconfigure.AutoConfigurations;
+import org.springframework.boot.test.context.runner.ApplicationContextRunner;
+import org.springframework.context.ApplicationContext;
+import org.springframework.util.ClassUtils;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.mockito.Mockito.mock;
+
+class Gb32960IngestAppCompositionTest {
+
+    private final ApplicationContextRunner contextRunner = new ApplicationContextRunner()
+            .withConfiguration(AutoConfigurations.of(
+                    IngestCoreAutoConfiguration.class,
+                    SessionCoreAutoConfiguration.class,
+                    SinkMqAutoConfiguration.class,
+                    Gb32960AutoConfiguration.class))
+            .withAllowBeanDefinitionOverriding(true)
+            .withBean("kafkaProducer", KafkaProducer.class, Gb32960IngestAppCompositionTest::kafkaProducer)
+            .withPropertyValues(
+                    "lingniu.ingest.gb32960.enabled=true",
+                    "lingniu.ingest.gb32960.server.enabled=true",
+                    "lingniu.ingest.gb32960.port=0",
+                    "lingniu.ingest.session.store=memory",
+                    "lingniu.ingest.sink.mq.enabled=true",
+                    "lingniu.ingest.sink.mq.type=kafka",
+                    "lingniu.ingest.sink.mq.bootstrap-servers=localhost:9092",
+                    "lingniu.ingest.sink.mq.consumer.enabled=false",
+                    "lingniu.ingest.event-file-store.enabled=false",
+                    "lingniu.ingest.event-history.enabled=false",
+                    "lingniu.ingest.vehicle-state.enabled=false",
+                    "lingniu.ingest.vehicle-stat.enabled=false");
+
+    @Test
+    void createsGb32960ListenerWithoutHistoryStorageBoundaries() {
+        contextRunner.run(context -> {
+            assertThat(context).hasSingleBean(Gb32960MessageDecoder.class);
+            assertThat(context).hasSingleBean(Gb32960NettyServer.class);
+            assertThat(context).hasSingleBean(KafkaEventSink.class);
+            assertThat(context).hasSingleBean(KafkaEnvelopeDeadLetterSink.class);
+
+            assertTypeNotPresent(context, "com.lingniu.ingest.sink.archive.ArchiveStore");
+            assertTypeNotPresent(context, "com.lingniu.ingest.eventfilestore.EventFileStore");
+        });
+    }
+
+    @SuppressWarnings("unchecked")
+    private static KafkaProducer<String, byte[]> kafkaProducer() {
+        return mock(KafkaProducer.class);
+    }
+
+    private static void assertTypeNotPresent(ApplicationContext context, String className) {
+        assertThat(ClassUtils.isPresent(className, context.getClassLoader()))
+                .as("%s must stay outside the GB32960 ingest runtime", className)
+                .isFalse();
+    }
+}
--- a/modules/apps/gb32960-ingest-app/src/test/java/com/lingniu/ingest/gb32960app/Gb32960IngestAppDefaultsTest.java
+++ b/modules/apps/gb32960-ingest-app/src/test/java/com/lingniu/ingest/gb32960app/Gb32960IngestAppDefaultsTest.java
@@ -0,0 +1,39 @@
+package com.lingniu.ingest.gb32960app;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.config.YamlPropertiesFactoryBean;
+import org.springframework.core.io.ClassPathResource;
+
+import java.util.Properties;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+class Gb32960IngestAppDefaultsTest {
+
+    @Test
+    void applicationDefaultsKeepGb32960IngestAsTcpKafkaProducerOnly() {
+        Properties properties = applicationProperties();
+
+        assertThat(properties)
+                .containsEntry("spring.application.name", "gb32960-ingest-app")
+                .containsEntry("lingniu.ingest.gb32960.enabled", true)
+                .containsEntry("lingniu.ingest.gb32960.server.enabled", true)
+                .containsEntry("lingniu.ingest.gb32960.port", "${GB32960_PORT:32960}")
+                .containsEntry("lingniu.ingest.sink.mq.enabled", "${KAFKA_ENABLED:true}")
+                .containsEntry("lingniu.ingest.sink.mq.consumer.enabled", false)
+                .containsEntry("lingniu.ingest.event-file-store.enabled", false)
+                .containsEntry("lingniu.ingest.event-history.enabled", false)
+                .containsEntry("lingniu.ingest.vehicle-state.enabled", false)
+                .containsEntry("lingniu.ingest.vehicle-stat.enabled", false);
+    }
+
+    private static Properties applicationProperties() {
+        YamlPropertiesFactoryBean factory = new YamlPropertiesFactoryBean();
+        factory.setResources(new ClassPathResource("application.yml"));
+
+        Properties properties = factory.getObject();
+
+        assertThat(properties).isNotNull();
+        return properties;
+    }
+}
--- a/modules/apps/vehicle-analytics-app/pom.xml
+++ b/modules/apps/vehicle-analytics-app/pom.xml
@@ -0,0 +1,66 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>com.lingniu.ingest</groupId>
+        <artifactId>lingniu-vehicle-ingest</artifactId>
+        <version>0.1.0-SNAPSHOT</version>
+        <relativePath>../../../pom.xml</relativePath>
+    </parent>
+
+    <artifactId>vehicle-analytics-app</artifactId>
+    <name>vehicle-analytics-app</name>
+    <description>Vehicle state, daily statistics, alarms, and analytics runtime.</description>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>ingest-api</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>observability</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>sink-mq</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>vehicle-state-service</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>vehicle-stat-service</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <finalName>vehicle-analytics-app</finalName>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <configuration>
+                    <jvmArguments>--sun-misc-unsafe-memory-access=allow</jvmArguments>
+                </configuration>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>repackage</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>
--- a/modules/apps/vehicle-analytics-app/src/main/java/com/lingniu/ingest/analyticsapp/VehicleAnalyticsApplication.java
+++ b/modules/apps/vehicle-analytics-app/src/main/java/com/lingniu/ingest/analyticsapp/VehicleAnalyticsApplication.java
@@ -0,0 +1,21 @@
+package com.lingniu.ingest.analyticsapp;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication(scanBasePackages = "com.lingniu.ingest")
+public class VehicleAnalyticsApplication {
+
+    private static final Logger log = LoggerFactory.getLogger(VehicleAnalyticsApplication.class);
+
+    public static void main(String[] args) {
+        try {
+            SpringApplication.run(VehicleAnalyticsApplication.class, args);
+        } catch (Throwable t) {
+            log.error("Vehicle analytics application failed to start, forcing JVM exit", t);
+            System.exit(1);
+        }
+    }
+}
--- a/modules/apps/vehicle-analytics-app/src/main/resources/application.yml
+++ b/modules/apps/vehicle-analytics-app/src/main/resources/application.yml
@@ -0,0 +1,62 @@
+spring:
+  application:
+    name: vehicle-analytics-app
+  threads:
+    virtual:
+      enabled: true
+
+server:
+  port: ${HTTP_PORT:20300}
+
+lingniu:
+  ingest:
+    gb32960:
+      enabled: false
+    sink:
+      mq:
+        enabled: ${KAFKA_ENABLED:true}
+        type: kafka
+        bootstrap-servers: ${KAFKA_BROKERS:114.55.58.251:9092}
+        topics:
+          realtime: ${KAFKA_TOPIC_GB32960_EVENT:vehicle.event.gb32960.v1}
+          dlq: ${KAFKA_TOPIC_GB32960_DLQ:vehicle.dlq.gb32960.v1}
+        consumer:
+          enabled: ${KAFKA_CONSUMER_ENABLED:true}
+          client-id-prefix: ${KAFKA_CONSUMER_CLIENT_ID_PREFIX:vehicle-analytics}
+          auto-offset-reset: ${KAFKA_CONSUMER_AUTO_OFFSET_RESET:earliest}
+          max-poll-records: ${KAFKA_CONSUMER_MAX_POLL_RECORDS:500}
+          bindings:
+            vehicleStateEnvelopeConsumerProcessor:
+              enabled: ${VEHICLE_STATE_ENABLED:false}
+              group-id: ${KAFKA_GROUP_STATE:vehicle-state}
+              topics:
+                - ${KAFKA_TOPIC_GB32960_EVENT:vehicle.event.gb32960.v1}
+            vehicleStatEnvelopeConsumerProcessor:
+              enabled: ${VEHICLE_STAT_ENABLED:true}
+              group-id: ${KAFKA_GROUP_STAT:vehicle-stat}
+              topics:
+                - ${KAFKA_TOPIC_GB32960_EVENT:vehicle.event.gb32960.v1}
+      archive:
+        enabled: false
+    event-file-store:
+      enabled: false
+    event-history:
+      enabled: false
+    vehicle-state:
+      enabled: ${VEHICLE_STATE_ENABLED:false}
+    vehicle-stat:
+      enabled: ${VEHICLE_STAT_ENABLED:true}
+      file-path: ${VEHICLE_STAT_FILE_PATH:./target/vehicle-stat/}
+      zone-id: ${VEHICLE_STAT_ZONE_ID:Asia/Shanghai}
+
+management:
+  endpoints:
+    web:
+      exposure:
+        include: health,info,metrics,prometheus,env
+  health:
+    redis:
+      enabled: ${MANAGEMENT_HEALTH_REDIS_ENABLED:false}
+  metrics:
+    tags:
+      application: vehicle-analytics-app
--- a/modules/apps/vehicle-analytics-app/src/test/java/com/lingniu/ingest/analyticsapp/VehicleAnalyticsAppCompositionTest.java
+++ b/modules/apps/vehicle-analytics-app/src/test/java/com/lingniu/ingest/analyticsapp/VehicleAnalyticsAppCompositionTest.java
@@ -0,0 +1,85 @@
+package com.lingniu.ingest.analyticsapp;
+
+import com.lingniu.ingest.api.consumer.EnvelopeConsumerProcessor;
+import com.lingniu.ingest.sink.mq.KafkaEnvelopeDeadLetterSink;
+import com.lingniu.ingest.sink.mq.KafkaEventSink;
+import com.lingniu.ingest.sink.mq.SinkMqAutoConfiguration;
+import com.lingniu.ingest.vehiclestate.VehicleStateEnvelopeIngestor;
+import com.lingniu.ingest.vehiclestate.config.VehicleStateAutoConfiguration;
+import com.lingniu.ingest.vehiclestat.DailyVehicleStatService;
+import com.lingniu.ingest.vehiclestat.FileVehicleStatRepository;
+import com.lingniu.ingest.vehiclestat.VehicleStatController;
+import com.lingniu.ingest.vehiclestat.VehicleStatEnvelopeIngestor;
+import com.lingniu.ingest.vehiclestat.VehicleStatEventProcessor;
+import com.lingniu.ingest.vehiclestat.VehicleStatEventSink;
+import com.lingniu.ingest.vehiclestat.VehicleStatRepository;
+import com.lingniu.ingest.vehiclestat.config.VehicleStatAutoConfiguration;
+import org.apache.kafka.clients.producer.KafkaProducer;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.io.TempDir;
+import org.springframework.boot.autoconfigure.AutoConfigurations;
+import org.springframework.boot.test.context.runner.ApplicationContextRunner;
+import org.springframework.context.ApplicationContext;
+import org.springframework.util.ClassUtils;
+
+import java.nio.file.Path;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.mockito.Mockito.mock;
+
+class VehicleAnalyticsAppCompositionTest {
+
+    @TempDir
+    Path tempDir;
+
+    @Test
+    void createsStatsBeansWithoutProtocolListenerOrEventFileStore() {
+        new ApplicationContextRunner()
+                .withConfiguration(AutoConfigurations.of(
+                        SinkMqAutoConfiguration.class,
+                        VehicleStateAutoConfiguration.class,
+                        VehicleStatAutoConfiguration.class))
+                .withAllowBeanDefinitionOverriding(true)
+                .withBean("kafkaProducer", KafkaProducer.class, VehicleAnalyticsAppCompositionTest::kafkaProducer)
+                .withPropertyValues(
+                        "lingniu.ingest.sink.mq.enabled=true",
+                        "lingniu.ingest.sink.mq.type=kafka",
+                        "lingniu.ingest.sink.mq.bootstrap-servers=localhost:9092",
+                        "lingniu.ingest.sink.mq.consumer.enabled=false",
+                        "lingniu.ingest.vehicle-state.enabled=false",
+                        "lingniu.ingest.vehicle-stat.enabled=true",
+                        "lingniu.ingest.vehicle-stat.file-path=" + tempDir.resolve("vehicle-stat"),
+                        "lingniu.ingest.event-file-store.enabled=false",
+                        "lingniu.ingest.event-history.enabled=false",
+                        "lingniu.ingest.gb32960.enabled=false")
+                .run(context -> {
+                    assertThat(context).hasSingleBean(VehicleStatRepository.class);
+                    assertThat(context).hasSingleBean(FileVehicleStatRepository.class);
+                    assertThat(context).hasSingleBean(DailyVehicleStatService.class);
+                    assertThat(context).hasSingleBean(VehicleStatEventProcessor.class);
+                    assertThat(context).hasSingleBean(VehicleStatEnvelopeIngestor.class);
+                    assertThat(context).hasSingleBean(VehicleStatEventSink.class);
+                    assertThat(context).hasSingleBean(VehicleStatController.class);
+                    assertThat(context).hasSingleBean(KafkaEventSink.class);
+                    assertThat(context).hasSingleBean(KafkaEnvelopeDeadLetterSink.class);
+                    assertThat(context).hasBean("vehicleStatEnvelopeConsumerProcessor");
+                    assertThat(context.getBean("vehicleStatEnvelopeConsumerProcessor"))
+                            .isInstanceOf(EnvelopeConsumerProcessor.class);
+
+                    assertThat(context).doesNotHaveBean(VehicleStateEnvelopeIngestor.class);
+                    assertTypeNotPresent(context, "com.lingniu.ingest.protocol.gb32960.inbound.Gb32960NettyServer");
+                    assertTypeNotPresent(context, "com.lingniu.ingest.eventfilestore.EventFileStore");
+                });
+    }
+
+    @SuppressWarnings("unchecked")
+    private static KafkaProducer<String, byte[]> kafkaProducer() {
+        return mock(KafkaProducer.class);
+    }
+
+    private static void assertTypeNotPresent(ApplicationContext context, String className) {
+        assertThat(ClassUtils.isPresent(className, context.getClassLoader()))
+                .as("%s must stay outside the vehicle analytics runtime", className)
+                .isFalse();
+    }
+}
--- a/modules/apps/vehicle-analytics-app/src/test/java/com/lingniu/ingest/analyticsapp/VehicleAnalyticsAppDefaultsTest.java
+++ b/modules/apps/vehicle-analytics-app/src/test/java/com/lingniu/ingest/analyticsapp/VehicleAnalyticsAppDefaultsTest.java
@@ -0,0 +1,49 @@
+package com.lingniu.ingest.analyticsapp;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.config.YamlPropertiesFactoryBean;
+import org.springframework.core.io.ClassPathResource;
+
+import java.util.Properties;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+class VehicleAnalyticsAppDefaultsTest {
+
+    @Test
+    void applicationDefaultsKeepAnalyticsAsStatConsumerRuntime() {
+        Properties properties = applicationProperties();
+
+        assertThat(properties)
+                .containsEntry("spring.application.name", "vehicle-analytics-app")
+                .containsEntry("lingniu.ingest.gb32960.enabled", false)
+                .containsEntry("lingniu.ingest.sink.archive.enabled", false)
+                .containsEntry("lingniu.ingest.event-file-store.enabled", false)
+                .containsEntry("lingniu.ingest.event-history.enabled", false)
+                .containsEntry("lingniu.ingest.vehicle-stat.enabled", "${VEHICLE_STAT_ENABLED:true}")
+                .containsEntry("lingniu.ingest.vehicle-state.enabled", "${VEHICLE_STATE_ENABLED:false}")
+                .containsEntry("lingniu.ingest.sink.mq.consumer.enabled", "${KAFKA_CONSUMER_ENABLED:true}")
+                .containsEntry(
+                        "lingniu.ingest.sink.mq.consumer.bindings.vehicleStatEnvelopeConsumerProcessor.enabled",
+                        "${VEHICLE_STAT_ENABLED:true}")
+                .containsEntry(
+                        "lingniu.ingest.sink.mq.consumer.bindings.vehicleStateEnvelopeConsumerProcessor.enabled",
+                        "${VEHICLE_STATE_ENABLED:false}")
+                .containsEntry(
+                        "lingniu.ingest.sink.mq.consumer.bindings.vehicleStatEnvelopeConsumerProcessor.group-id",
+                        "${KAFKA_GROUP_STAT:vehicle-stat}")
+                .containsEntry(
+                        "lingniu.ingest.sink.mq.consumer.bindings.vehicleStateEnvelopeConsumerProcessor.group-id",
+                        "${KAFKA_GROUP_STATE:vehicle-state}");
+    }
+
+    private static Properties applicationProperties() {
+        YamlPropertiesFactoryBean factory = new YamlPropertiesFactoryBean();
+        factory.setResources(new ClassPathResource("application.yml"));
+
+        Properties properties = factory.getObject();
+
+        assertThat(properties).isNotNull();
+        return properties;
+    }
+}
--- a/modules/apps/vehicle-history-app/pom.xml
+++ b/modules/apps/vehicle-history-app/pom.xml
@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>com.lingniu.ingest</groupId>
+        <artifactId>lingniu-vehicle-ingest</artifactId>
+        <version>0.1.0-SNAPSHOT</version>
+        <relativePath>../../../pom.xml</relativePath>
+    </parent>
+
+    <artifactId>vehicle-history-app</artifactId>
+    <name>vehicle-history-app</name>
+    <description>Vehicle raw archive, event history, and GB32960 frame query runtime.</description>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>ingest-api</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>observability</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>sink-mq</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>sink-archive</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>event-file-store</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>event-history-service</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.lingniu.ingest</groupId>
+            <artifactId>protocol-gb32960</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <finalName>vehicle-history-app</finalName>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <configuration>
+                    <jvmArguments>--sun-misc-unsafe-memory-access=allow</jvmArguments>
+                </configuration>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>repackage</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>
--- a/modules/apps/vehicle-history-app/src/main/java/com/lingniu/ingest/historyapp/VehicleHistoryApplication.java
+++ b/modules/apps/vehicle-history-app/src/main/java/com/lingniu/ingest/historyapp/VehicleHistoryApplication.java
@@ -0,0 +1,21 @@
+package com.lingniu.ingest.historyapp;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication(scanBasePackages = "com.lingniu.ingest")
+public class VehicleHistoryApplication {
+
+    private static final Logger log = LoggerFactory.getLogger(VehicleHistoryApplication.class);
+
+    public static void main(String[] args) {
+        try {
+            SpringApplication.run(VehicleHistoryApplication.class, args);
+        } catch (Throwable t) {
+            log.error("Vehicle history application failed to start, forcing JVM exit", t);
+            System.exit(1);
+        }
+    }
+}
--- a/modules/apps/vehicle-history-app/src/main/resources/application.yml
+++ b/modules/apps/vehicle-history-app/src/main/resources/application.yml
@@ -0,0 +1,65 @@
+spring:
+  application:
+    name: vehicle-history-app
+  threads:
+    virtual:
+      enabled: true
+
+server:
+  port: ${HTTP_PORT:20200}
+
+lingniu:
+  ingest:
+    gb32960:
+      enabled: true
+      server:
+        enabled: false
+    sink:
+      mq:
+        enabled: ${KAFKA_ENABLED:true}
+        type: kafka
+        bootstrap-servers: ${KAFKA_BROKERS:114.55.58.251:9092}
+        topics:
+          realtime: ${KAFKA_TOPIC_GB32960_EVENT:vehicle.event.gb32960.v1}
+          raw-archive: ${KAFKA_TOPIC_GB32960_RAW:vehicle.raw.gb32960.v1}
+          dlq: ${KAFKA_TOPIC_GB32960_DLQ:vehicle.dlq.gb32960.v1}
+        consumer:
+          enabled: ${KAFKA_CONSUMER_ENABLED:true}
+          client-id-prefix: ${KAFKA_CONSUMER_CLIENT_ID_PREFIX:vehicle-history}
+          auto-offset-reset: ${KAFKA_CONSUMER_AUTO_OFFSET_RESET:earliest}
+          max-poll-records: ${KAFKA_CONSUMER_MAX_POLL_RECORDS:500}
+          bindings:
+            eventHistoryEnvelopeConsumerProcessor:
+              enabled: true
+              group-id: ${KAFKA_GROUP_HISTORY:vehicle-history}
+              topics:
+                - ${KAFKA_TOPIC_GB32960_EVENT:vehicle.event.gb32960.v1}
+                - ${KAFKA_TOPIC_GB32960_RAW:vehicle.raw.gb32960.v1}
+      archive:
+        enabled: ${SINK_ARCHIVE_ENABLED:true}
+        type: local
+        path: ${SINK_ARCHIVE_PATH:./archive/}
+    event-file-store:
+      enabled: ${EVENT_FILE_STORE_ENABLED:true}
+      path: ${EVENT_FILE_STORE_PATH:./target/event-store/}
+      zone-id: ${EVENT_FILE_STORE_ZONE_ID:Asia/Shanghai}
+      batch-size: ${EVENT_FILE_STORE_BATCH_SIZE:500}
+      flush-interval-millis: ${EVENT_FILE_STORE_FLUSH_INTERVAL_MILLIS:1000}
+    event-history:
+      enabled: true
+    vehicle-state:
+      enabled: false
+    vehicle-stat:
+      enabled: false
+
+management:
+  endpoints:
+    web:
+      exposure:
+        include: health,info,metrics,prometheus,env
+  health:
+    redis:
+      enabled: ${MANAGEMENT_HEALTH_REDIS_ENABLED:false}
+  metrics:
+    tags:
+      application: vehicle-history-app
--- a/modules/apps/vehicle-history-app/src/test/java/com/lingniu/ingest/historyapp/VehicleHistoryAppCompositionTest.java
+++ b/modules/apps/vehicle-history-app/src/test/java/com/lingniu/ingest/historyapp/VehicleHistoryAppCompositionTest.java
@@ -0,0 +1,83 @@
+package com.lingniu.ingest.historyapp;
+
+import com.lingniu.ingest.eventfilestore.EventFileStore;
+import com.lingniu.ingest.eventfilestore.EventFileStoreSink;
+import com.lingniu.ingest.eventfilestore.config.EventFileStoreAutoConfiguration;
+import com.lingniu.ingest.eventhistory.EventHistoryController;
+import com.lingniu.ingest.eventhistory.EventHistoryEnvelopeIngestor;
+import com.lingniu.ingest.eventhistory.Gb32960DecodedFrameService;
+import com.lingniu.ingest.eventhistory.Gb32960FrameController;
+import com.lingniu.ingest.eventhistory.config.EventHistoryAutoConfiguration;
+import com.lingniu.ingest.protocol.gb32960.codec.Gb32960MessageDecoder;
+import com.lingniu.ingest.protocol.gb32960.config.Gb32960AutoConfiguration;
+import com.lingniu.ingest.protocol.gb32960.inbound.Gb32960NettyServer;
+import com.lingniu.ingest.sink.archive.ArchiveStore;
+import com.lingniu.ingest.sink.archive.RawArchiveEventSink;
+import com.lingniu.ingest.sink.archive.config.SinkArchiveAutoConfiguration;
+import com.lingniu.ingest.sink.mq.KafkaEnvelopeDeadLetterSink;
+import com.lingniu.ingest.sink.mq.KafkaEventSink;
+import com.lingniu.ingest.sink.mq.SinkMqAutoConfiguration;
+import org.apache.kafka.clients.producer.KafkaProducer;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.io.TempDir;
+import org.springframework.boot.autoconfigure.AutoConfigurations;
+import org.springframework.boot.test.context.runner.ApplicationContextRunner;
+
+import java.nio.file.Path;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.mockito.Mockito.mock;
+
+class VehicleHistoryAppCompositionTest {
+
+    @TempDir
+    Path tempDir;
+
+    @Test
+    void createsHistoryStorageAndQueryBeansWithoutGb32960TcpServer() {
+        new ApplicationContextRunner()
+                .withConfiguration(AutoConfigurations.of(
+                        SinkArchiveAutoConfiguration.class,
+                        EventFileStoreAutoConfiguration.class,
+                        SinkMqAutoConfiguration.class,
+                        Gb32960AutoConfiguration.class,
+                        EventHistoryAutoConfiguration.class))
+                .withAllowBeanDefinitionOverriding(true)
+                .withBean("kafkaProducer", KafkaProducer.class, VehicleHistoryAppCompositionTest::kafkaProducer)
+                .withPropertyValues(
+                        "lingniu.ingest.sink.archive.enabled=true",
+                        "lingniu.ingest.sink.archive.type=local",
+                        "lingniu.ingest.sink.archive.path=" + tempDir.resolve("archive"),
+                        "lingniu.ingest.event-file-store.enabled=true",
+                        "lingniu.ingest.event-file-store.path=" + tempDir.resolve("event-store"),
+                        "lingniu.ingest.event-history.enabled=true",
+                        "lingniu.ingest.gb32960.enabled=true",
+                        "lingniu.ingest.gb32960.server.enabled=false",
+                        "lingniu.ingest.sink.mq.enabled=true",
+                        "lingniu.ingest.sink.mq.type=kafka",
+                        "lingniu.ingest.sink.mq.bootstrap-servers=localhost:9092",
+                        "lingniu.ingest.sink.mq.consumer.enabled=false",
+                        "lingniu.ingest.vehicle-state.enabled=false",
+                        "lingniu.ingest.vehicle-stat.enabled=false")
+                .run(context -> {
+                    assertThat(context).hasSingleBean(ArchiveStore.class);
+                    assertThat(context).hasSingleBean(RawArchiveEventSink.class);
+                    assertThat(context).hasSingleBean(EventFileStore.class);
+                    assertThat(context).hasSingleBean(EventFileStoreSink.class);
+                    assertThat(context).hasSingleBean(KafkaEventSink.class);
+                    assertThat(context).hasSingleBean(KafkaEnvelopeDeadLetterSink.class);
+
+                    assertThat(context).hasSingleBean(EventHistoryEnvelopeIngestor.class);
+                    assertThat(context).hasSingleBean(EventHistoryController.class);
+                    assertThat(context).hasSingleBean(Gb32960MessageDecoder.class);
+                    assertThat(context).hasSingleBean(Gb32960DecodedFrameService.class);
+                    assertThat(context).hasSingleBean(Gb32960FrameController.class);
+                    assertThat(context).doesNotHaveBean(Gb32960NettyServer.class);
+                });
+    }
+
+    @SuppressWarnings("unchecked")
+    private static KafkaProducer<String, byte[]> kafkaProducer() {
+        return mock(KafkaProducer.class);
+    }
+}
--- a/modules/apps/vehicle-history-app/src/test/java/com/lingniu/ingest/historyapp/VehicleHistoryAppDefaultsTest.java
+++ b/modules/apps/vehicle-history-app/src/test/java/com/lingniu/ingest/historyapp/VehicleHistoryAppDefaultsTest.java
@@ -0,0 +1,50 @@
+package com.lingniu.ingest.historyapp;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.config.YamlPropertiesFactoryBean;
+import org.springframework.core.io.ClassPathResource;
+
+import java.util.Properties;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+class VehicleHistoryAppDefaultsTest {
+
+    @Test
+    void applicationDefaultsKeepHistoryAsDecoderConsumerAndStorageRuntime() {
+        Properties properties = applicationProperties();
+
+        assertThat(properties)
+                .containsEntry("spring.application.name", "vehicle-history-app")
+                .containsEntry("lingniu.ingest.gb32960.enabled", true)
+                .containsEntry("lingniu.ingest.gb32960.server.enabled", false)
+                .containsEntry("lingniu.ingest.sink.archive.enabled", "${SINK_ARCHIVE_ENABLED:true}")
+                .containsEntry("lingniu.ingest.event-file-store.enabled", "${EVENT_FILE_STORE_ENABLED:true}")
+                .containsEntry("lingniu.ingest.event-history.enabled", true)
+                .containsEntry("lingniu.ingest.vehicle-state.enabled", false)
+                .containsEntry("lingniu.ingest.vehicle-stat.enabled", false)
+                .containsEntry("lingniu.ingest.sink.mq.consumer.enabled", "${KAFKA_CONSUMER_ENABLED:true}")
+                .containsEntry(
+                        "lingniu.ingest.sink.mq.consumer.bindings.eventHistoryEnvelopeConsumerProcessor.enabled",
+                        true)
+                .containsEntry(
+                        "lingniu.ingest.sink.mq.consumer.bindings.eventHistoryEnvelopeConsumerProcessor.group-id",
+                        "${KAFKA_GROUP_HISTORY:vehicle-history}")
+                .containsEntry(
+                        "lingniu.ingest.sink.mq.consumer.bindings.eventHistoryEnvelopeConsumerProcessor.topics[0]",
+                        "${KAFKA_TOPIC_GB32960_EVENT:vehicle.event.gb32960.v1}")
+                .containsEntry(
+                        "lingniu.ingest.sink.mq.consumer.bindings.eventHistoryEnvelopeConsumerProcessor.topics[1]",
+                        "${KAFKA_TOPIC_GB32960_RAW:vehicle.raw.gb32960.v1}");
+    }
+
+    private static Properties applicationProperties() {
+        YamlPropertiesFactoryBean factory = new YamlPropertiesFactoryBean();
+        factory.setResources(new ClassPathResource("application.yml"));
+
+        Properties properties = factory.getObject();
+
+        assertThat(properties).isNotNull();
+        return properties;
+    }
+}