diff --git a/deploy/portainer/docker-compose.yml b/deploy/portainer/docker-compose.yml
index 9a71234c..591c8849 100644
--- a/deploy/portainer/docker-compose.yml
+++ b/deploy/portainer/docker-compose.yml
@@ -1,5 +1,7 @@
 version: "3.8"
 
+# Default production stack: GB32960, JT808, Yutong MQTT, history, analytics.
+# Legacy and optional services stay outside this compose file.
 # Set LINGNIU_IMAGE_VERSION in Portainer Stack env, for example:
 # main-0.1.0-SNAPSHOT-22468e7
 x-common-env: &common-env
diff --git a/modules/apps/vehicle-history-app/src/test/java/com/lingniu/ingest/historyapp/PortainerComposeResourceLimitsTest.java b/modules/apps/vehicle-history-app/src/test/java/com/lingniu/ingest/historyapp/PortainerComposeResourceLimitsTest.java
index 3129772c..ea82fd46 100644
--- a/modules/apps/vehicle-history-app/src/test/java/com/lingniu/ingest/historyapp/PortainerComposeResourceLimitsTest.java
+++ b/modules/apps/vehicle-history-app/src/test/java/com/lingniu/ingest/historyapp/PortainerComposeResourceLimitsTest.java
@@ -10,6 +10,20 @@ import static org.assertj.core.api.Assertions.assertThat;
 
 class PortainerComposeResourceLimitsTest {
 
+    @Test
+    void portainerStackDocumentsDefaultProductionSurfaceOnly() throws IOException {
+        String compose = Files.readString(repositoryRoot().resolve("deploy/portainer/docker-compose.yml"));
+
+        assertThat(compose)
+                .contains("Default production stack: GB32960, JT808, Yutong MQTT, history, analytics.")
+                .contains("Legacy and optional services stay outside this compose file.")
+                .doesNotContain("\n  xinda-push-app:\n")
+                .doesNotContain("\n  command-gateway:\n")
+                .doesNotContain("\n  vehicle-state-service:\n")
+                .doesNotContain("\n  raw-archive-store:\n")
+                .doesNotContain("\n  event-file-store:\n");
+    }
+
     @Test
     void productionServicesHaveOverridableMemoryLimits() throws IOException {
         String compose = Files.readString(repositoryRoot().resolve("deploy/portainer/docker-compose.yml"));