From a1889a981a5a1d9b19b871f979647da6d27d9d71 Mon Sep 17 00:00:00 2001
From: niexiaorong <niexiaorong@example.com>
Date: Thu, 18 Jun 2026 16:15:13 +0800
Subject: [PATCH 1/7] =?UTF-8?q?fix(mysql):=20=E4=BF=AE=E5=A4=8D=20device?=
 =?UTF-8?q?=5Fproduct=20=E5=88=9D=E5=A7=8B=E5=8C=96=E6=95=B0=E6=8D=AE?=
 =?UTF-8?q?=E5=88=97=E6=95=B0=E4=B8=8D=E5=8C=B9=E9=85=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

device_product 表新增 organize_id/creator_id 字段后，初始化 INSERT 未同步补充，导致 VALUES 数量与列数不一致。
---
 mysql8/initdb/02-maintain-init-data.sql | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mysql8/initdb/02-maintain-init-data.sql b/mysql8/initdb/02-maintain-init-data.sql
index a97842d..88cc087 100644
--- a/mysql8/initdb/02-maintain-init-data.sql
+++ b/mysql8/initdb/02-maintain-init-data.sql
@@ -218,8 +218,8 @@ INSERT INTO `maintain`.`device_manufacturer` VALUES (1, '43a610ca929d45dea574b11
 -- Records of device_product
 -- ----------------------------
 
-INSERT INTO `maintain`.`device_product` VALUES (1, '7de049b26def4364a9f3dc3bc60cf029', 'TCG-MDVR', 'TCG-MDVR', '1d3b089c74ca496b8c17cfa77e13a65a', '[\"808-2011\",\"808-2013\",\"808-2016\",\"808-2019\",\"1078-2016\",\"safety-jiangsu\",\"tl\"]', '', 2, 4095, '43a610ca929d45dea574b1122e313e2b', 'TGC', NULL, '', 0, NULL, NULL, 0, '', '[\"TCG-MDVR\"]', 0, '2026-01-21 07:15:23', '2026-01-21 07:16:39');
-INSERT INTO `maintain`.`device_product` VALUES (2, 'bf56842a3d80445c96d705e91320a92a', 'GPS Tracker', 'GPS Tracker', 'ed4d3d9b5eda4dfe9a6cdb1327ec1690', '[\"808-2011\",\"808-2013\",\"808-2019\",\"tg\"]', '', 0, 288, '43a610ca929d45dea574b1122e313e2b', 'TGC', NULL, '', 0, NULL, NULL, 0, '', NULL, 0, '2026-01-21 08:02:53', '2026-01-21 08:02:53');
+INSERT INTO `maintain`.`device_product` VALUES (1, '7de049b26def4364a9f3dc3bc60cf029', 'TCG-MDVR', 'TCG-MDVR', '1d3b089c74ca496b8c17cfa77e13a65a', '[\"808-2011\",\"808-2013\",\"808-2016\",\"808-2019\",\"1078-2016\",\"safety-jiangsu\",\"tl\"]', '', 2, 4095, '43a610ca929d45dea574b1122e313e2b', 'TGC', NULL, '', 0, NULL, NULL, 0, '', '[\"TCG-MDVR\"]', 0, '', '', '2026-01-21 07:15:23', '2026-01-21 07:16:39');
+INSERT INTO `maintain`.`device_product` VALUES (2, 'bf56842a3d80445c96d705e91320a92a', 'GPS Tracker', 'GPS Tracker', 'ed4d3d9b5eda4dfe9a6cdb1327ec1690', '[\"808-2011\",\"808-2013\",\"808-2019\",\"tg\"]', '', 0, 288, '43a610ca929d45dea574b1122e313e2b', 'TGC', NULL, '', 0, NULL, NULL, 0, '', NULL, 0, '', '', '2026-01-21 08:02:53', '2026-01-21 08:02:53');
 
 -- ----------------------------
 -- Records of system_msg_template

From 3db23ee023bb158c7234d4ea3cb67407b5398747 Mon Sep 17 00:00:00 2001
From: niexiaorong <niexiaorong@example.com>
Date: Thu, 18 Jun 2026 16:23:31 +0800
Subject: [PATCH 2/7] =?UTF-8?q?chore(tools):=20=E6=96=B0=E5=A2=9E=E5=88=9D?=
 =?UTF-8?q?=E5=A7=8B=E5=8C=96=20SQL=20=E5=88=97=E6=95=B0=E6=A0=A1=E9=AA=8C?=
 =?UTF-8?q?=E8=84=9A=E6=9C=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

用于检查 mysql8/initdb 下 INSERT VALUES 数量与 CREATE TABLE 列数是否一致，避免表结构变更后初始化数据遗漏。
---
 scripts/check-init-sql.js | 186 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 186 insertions(+)
 create mode 100644 scripts/check-init-sql.js

diff --git a/scripts/check-init-sql.js b/scripts/check-init-sql.js
new file mode 100644
index 0000000..2516975
--- /dev/null
+++ b/scripts/check-init-sql.js
@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+/**
+ * 校验 mysql8/initdb 下所有初始化 SQL 的 INSERT VALUES 数量是否与对应 CREATE TABLE 的列数一致。
+ * 用法：node scripts/check-init-sql.js
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+const base = "mysql8/initdb";
+const files = fs.readdirSync(base).filter(f => f.endsWith(".sql")).sort().map(f => path.join(base, f));
+
+// schema.table -> column count
+const tables = {};
+const inserts = [];
+
+function norm(name) {
+  return name.replace(/`/g, "").toLowerCase();
+}
+
+function getDb(line, currentDb) {
+  const m = line.match(/^USE\s+`?(\w+)`?\s*;/i);
+  return m ? norm(m[1]) : currentDb;
+}
+
+// Split body by top-level commas (not inside parentheses or quotes)
+function splitTopLevel(text) {
+  const parts = [];
+  let current = "";
+  let depth = 0;
+  for (let i = 0; i < text.length; i++) {
+    const ch = text[i];
+    if (ch === "'") {
+      current += ch;
+      i++;
+      while (i < text.length && text[i] !== "'") {
+        if (text[i] === "\\" && i + 1 < text.length) {
+          current += text[i++];
+        }
+        current += text[i++];
+      }
+      if (i < text.length) current += text[i];
+    } else if (ch === "(") {
+      depth++;
+      current += ch;
+    } else if (ch === ")") {
+      depth--;
+      current += ch;
+    } else if (ch === "," && depth === 0) {
+      parts.push(current.trim());
+      current = "";
+    } else {
+      current += ch;
+    }
+  }
+  if (current.trim()) parts.push(current.trim());
+  return parts;
+}
+
+function defaultDb(file) {
+  const baseName = path.basename(file);
+  if (baseName.includes("maintain")) return "maintain";
+  if (baseName.includes("cbus")) return "cbus";
+  if (baseName.includes("gps")) return "gps";
+  if (baseName.includes("analytics")) return "analytics";
+  return null;
+}
+
+files.forEach(file => {
+  const text = fs.readFileSync(file, "utf-8");
+  const lines = text.split(/\r?\n/);
+
+  let currentDb = defaultDb(file);
+
+  // Parse CREATE TABLE
+  const createRe = /CREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?([\w`.]+)\s*\((.*?)\)\s+ENGINE/sgi;
+  let m;
+  while ((m = createRe.exec(text)) !== null) {
+    const tableName = norm(m[1]);
+    const schema = tableName.includes(".") ? tableName.split(".")[0] : currentDb;
+    const shortName = tableName.includes(".") ? tableName.split(".")[1] : tableName;
+    const key = schema ? `${schema}.${shortName}` : shortName;
+    const body = m[2];
+    const parts = splitTopLevel(body);
+    let colCount = 0;
+    for (const s of parts) {
+      if (!s) continue;
+      if (/^(PRIMARY\s+KEY|UNIQUE\s+KEY|UNIQUE\s+INDEX|KEY|INDEX|CONSTRAINT|FOREIGN\s+KEY)\b/i.test(s)) continue;
+      if (/^`\w+`\s+\w+/.test(s)) {
+        colCount++;
+      }
+    }
+    tables[key] = colCount;
+  }
+
+  // Parse INSERT INTO (only without explicit column list)
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    currentDb = getDb(line, currentDb);
+
+    const match = line.match(/^INSERT\s+INTO\s+([\w`.]+)\s+VALUES\s+(.*)/i);
+    if (!match) continue;
+    const tableName = norm(match[1]);
+    const schema = tableName.includes(".") ? tableName.split(".")[0] : currentDb;
+    const shortName = tableName.includes(".") ? tableName.split(".")[1] : tableName;
+    const key = schema ? `${schema}.${shortName}` : shortName;
+
+    let rest = match[2];
+    let j = i;
+    while (!rest.trim().endsWith(";") && j + 1 < lines.length) {
+      j++;
+      rest += " " + lines[j];
+      currentDb = getDb(lines[j], currentDb);
+    }
+    rest = rest.trim().replace(/;$/, "");
+
+    // Extract top-level parentheses groups
+    const groups = [];
+    let start = -1;
+    let depth = 0;
+    for (let k = 0; k < rest.length; k++) {
+      const ch = rest[k];
+      if (ch === "'") {
+        k++;
+        while (k < rest.length && rest[k] !== "'") {
+          if (rest[k] === "\\" && k + 1 < rest.length) k++;
+          k++;
+        }
+      } else if (ch === "(") {
+        if (depth === 0) start = k;
+        depth++;
+      } else if (ch === ")") {
+        depth--;
+        if (depth === 0 && start !== -1) {
+          groups.push(rest.slice(start + 1, k));
+          start = -1;
+        }
+      }
+    }
+
+    for (const values of groups) {
+      let count = 1;
+      depth = 0;
+      for (let k = 0; k < values.length; k++) {
+        const ch = values[k];
+        if (ch === "'") {
+          k++;
+          while (k < values.length && values[k] !== "'") {
+            if (values[k] === "\\" && k + 1 < values.length) k++;
+            k++;
+          }
+        } else if (ch === "(") {
+          depth++;
+        } else if (ch === ")") {
+          depth--;
+        } else if (ch === "," && depth === 0) {
+          count++;
+        }
+      }
+      inserts.push({file, line: j + 1, table: key, vcount: count});
+    }
+  }
+});
+
+const mismatches = inserts.filter(ins => tables[ins.table] && tables[ins.table] !== ins.vcount);
+const grouped = {};
+mismatches.forEach(ins => {
+  const key = `${ins.file}:${ins.line}:${ins.table}`;
+  if (!grouped[key]) grouped[key] = ins;
+});
+
+if (Object.keys(grouped).length) {
+  console.log("发现列数不匹配的 INSERT:");
+  Object.values(grouped).sort((a,b)=>`${a.file}:${a.line}`.localeCompare(`${b.file}:${b.line}`)).forEach(ins => {
+    console.log(`  ${ins.file}:${ins.line} 表=${ins.table} 列数=${tables[ins.table]} VALUES数=${ins.vcount}`);
+  });
+} else {
+  console.log("未发现列数不匹配的 INSERT。");
+}
+
+const insertedTables = new Set(inserts.map(i => i.table));
+const unknown = [...insertedTables].filter(t => !tables[t]);
+if (unknown.length) {
+  console.log("\n以下 INSERT 找不到对应 CREATE TABLE（可能跨库/表名解析问题）:");
+  unknown.sort().forEach(t => console.log(`  ${t}`));
+}

From b09dadea1cc4cad3adecf0cc6f256aa3b2c12bc7 Mon Sep 17 00:00:00 2001
From: niexiaorong <niexiaorong@example.com>
Date: Thu, 18 Jun 2026 16:27:17 +0800
Subject: [PATCH 3/7] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9E=20CLAUDE.md=20?=
 =?UTF-8?q?=E4=BB=93=E5=BA=93=E6=8C=87=E5=BC=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

记录 Docker Compose 部署架构、常用命令、配置与数据目录约定，以及初始化 SQL 校验等关键信息。
---
 CLAUDE.md | 106 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 106 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..3357b4e
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,106 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Repository Overview
+
+This is the Docker Compose configuration repository for TranscodeGroup's fleet/vehicle tracking platform. It does not contain application source code; it packages and orchestrates pre-built backend/frontend images and infrastructure services (MySQL, Redis, MongoDB, RabbitMQ, MinIO, nginx, SRS, etc.).
+
+The repo is deployed to `/home/docker` on target servers. Runtime configuration and compose overrides live in `/home/docker-compose`, and persistent data is written to `/data`.
+
+## Common Commands
+
+All compose commands are run from `/home/docker-compose`, where the top-level `compose.yaml` and `.env` files reside.
+
+```sh
+# Validate compose configuration and required environment variables
+docker compose config
+
+# Export resolved compose config for diff review
+docker compose config > compose-stack.yaml
+
+# Start the stack in the background
+docker compose up -d
+
+# Recreate a specific service after changing its config/image
+docker compose up -d --force-recreate <service>
+
+# Follow logs for a service
+docker compose logs -f <service>
+
+# Validate that initdb INSERT statements match CREATE TABLE column counts
+node /home/docker/scripts/check-init-sql.js
+```
+
+When modifying `mysql8/initdb/*.sql`, run `check-init-sql.js` before committing to catch column/value mismatches.
+
+## High-Level Architecture
+
+### Modular Compose Layout
+
+Each top-level directory (`maintain/`, `jtt808/`, `bus/`, `video/`, `mysql8/`, `nginx/`, etc.) contains one or more focused `compose.yml` fragments. These fragments are assembled by the example deployments in `examples/` using Docker Compose `include`:
+
+- `examples/track-http/compose.yaml` — Tracker V2 single-node HTTP deployment.
+- `examples/track-https/compose.yaml` — Tracker V2 single-node HTTPS deployment.
+- `examples/bus-http/compose.yaml` / `examples/bus-https/compose.yaml` — Bus platform single-node deployments.
+- `examples/video-storage/compose.yaml` / `examples/video-stream/compose.yaml` — Distributed video storage/streaming nodes.
+
+A deployment typically `include`s shared infrastructure (mysql8, redis, mongodb, rabbitmq, minio), one or more backend service fragments, nginx fragments, and optional video or web-downloader fragments.
+
+### Two Primary Products
+
+1. **Tracker V2 (track)**
+   - `maintain` — Spring Boot backend (`transcodegroup/maintain-server`), the main API and device registry.
+   - `jtt808` — JT/T 808 device gateway (`transcodegroup/jtt808-server`), handles terminal connections and forwards to `maintain`.
+   - `video` — SRS + RTP streaming stack for live video, playback, talk, and monitor.
+   - `nginx` — Reverse proxy and static frontend host for the `track` web app.
+
+2. **Bus**
+   - `gateway_808_2019` — JT/T 808 gateway for the Bus product (`transcodegroup/gateway-808-2019`).
+   - `gateway_web` — Spring Boot web backend (`transcodegroup/gateway-web`).
+   - `gateway_dispatch` — Spring Boot scheduler (`transcodegroup/gateway-dispatch`).
+   - `gateway_jsatl12` — Active-safety alarm file gateway (`transcodegroup/gateway-jsatl12`).
+   - `nginx` — Reverse proxy and static frontend host for the `bus` web app.
+
+Both products share the same infrastructure services but use different MySQL databases (`maintain` vs `cbus`).
+
+### Configuration and Data Layout
+
+- `/home/docker` — This repository.
+- `/home/docker-compose/compose.yaml` — Deployment-specific composition, created from an `examples/` template.
+- `/home/docker-compose/.env` — Runtime overrides, created from `default.env`.
+- `/data` — All persistent runtime data (MySQL data, logs, uploaded files, nginx html, SRS recordings, etc.).
+- `/home/docker-compose/bus-override/` and `/home/docker-compose/track-override/` — Frontend override directories. Files here are copied into `/data/nginx/html/` when nginx starts. Use these to override `_app.config.js`, `index-seo.html`, favicons, and logos instead of editing `/data/nginx/html/` directly.
+- `/home/docker-compose/token/` — JWT RSA key pairs and `ip2region.xdb`.
+- `/home/docker-compose/opt/` — Optional host binaries mounted into containers, e.g. `ffmpeg`, `ffprobe`, and `ifv2mp4` for the jtt808 video-conversion tools.
+
+### MySQL Initialization
+
+`mysql8/compose.yml` mounts `mysql8/initdb/` into `/docker-entrypoint-initdb.d`. Scripts run once on the first container startup, before the application connects. The directory is split into table-definition and seed-data files per logical database (`maintain`, `cbus`, etc.). When altering these schemas, update the corresponding seed `INSERT`s and validate with `scripts/check-init-sql.js`.
+
+### Networking and Service Discovery
+
+Services within the same compose project resolve each other by service name. Common aliases used in environment variables:
+
+- `mysql8`, `redis`, `mongodb`, `rabbitmq`, `minio`, `nginx`, `jtt808`, `maintain`, `srs`, `rtp`.
+
+External access is exposed through `nginx` (ports 80/443 by default) and, for device protocols, directly through `jtt808` / `gateway_808_2019` / `video` RTP ports.
+
+### Frontend Deployment
+
+Frontend artifacts are not built here. They are downloaded from CI artifacts using `scripts/teamcity-download-artifact.sh` or deployed from tagged GitHub releases using `scripts/distar-beta-deploy.sh`. See `scripts/README.md` and `jtt808/README.md` for exact commands.
+
+## Important Notes
+
+- Most compose fragments rely on environment variables marked `{?required}` in their image tags or env vars. Always run `docker compose config` before `up` to catch missing values.
+- MySQL init scripts only execute on a fresh data volume. To re-run them you must wipe `/data/mysql8/data`, which destroys all data.
+- The `100-init-partition-table.sql` script uses `USE maintain;` and `USE cbus;` to create monthly partitions for large tables (position, alarm, depart_arrive).
+- HTTPS deployments need a valid certificate path in `.env`. For testing, use the built-in placeholder cert at `${DOCKER_DIR}/nginx/ssl/placeholder`.
+- GitHub Actions in `.github/workflows/` only manage project board automation and PR author assignment; they do not build or test this repo.
+
+## Related Documentation
+
+- `README.md` / `README.en.md` — Deployment quick-start.
+- `scripts/README.md` — Frontend artifact download and distar deployment scripts.
+- `jtt808/README.md` — FFmpeg and IFV-to-MP4 tooling setup.
+- `default.env` / `default.en.env` — Full list of configurable environment variables.

From 5e9c5316458c57e169f13fc5718bbe765377848d Mon Sep 17 00:00:00 2001
From: niexiaorong <niexiaorong@example.com>
Date: Thu, 18 Jun 2026 16:31:14 +0800
Subject: [PATCH 4/7] =?UTF-8?q?chore(review):=20=E6=B7=BB=E5=8A=A0?=
 =?UTF-8?q?=E7=89=88=E6=9C=AC=E5=8F=98=E6=9B=B4=E6=97=B6=E5=90=8C=E6=AD=A5?=
 =?UTF-8?q?=E6=A3=80=E6=9F=A5=20mysql8=20=E5=88=9D=E5=A7=8B=E5=8C=96?=
 =?UTF-8?q?=E8=84=9A=E6=9C=AC=E7=9A=84=E8=A7=84=E5=88=99?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 新增 .github/copilot-instructions.md，供 Copilot review 时提醒\n- 新增 .github/pull_request_template.md，PR 提交时强制勾选\n- 更新 CLAUDE.md，让后续 Claude Code 实例也遵守该规则
---
 .github/copilot-instructions.md  | 25 +++++++++++++++++++++++++
 .github/pull_request_template.md |  7 +++++++
 CLAUDE.md                        | 11 +++++++++++
 3 files changed, 43 insertions(+)
 create mode 100644 .github/copilot-instructions.md
 create mode 100644 .github/pull_request_template.md

diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
new file mode 100644
index 0000000..f1f6a5a
--- /dev/null
+++ b/.github/copilot-instructions.md
@@ -0,0 +1,25 @@
+# Copilot Review Instructions
+
+When reviewing pull requests in this repository, apply the following rules.
+
+## Version bumps that require MySQL init data sync
+
+This repository is a Docker Compose packaging repo for a fleet/vehicle tracking platform. Backend and frontend version variables in `default.env` / `default.en.env` map to application releases that may introduce new database migrations or seed-data changes.
+
+If a PR changes either of these version variables, the author must also review and update the corresponding MySQL initialization scripts under `mysql8/initdb/`:
+
+- `BUS_WEB_VERSION` — may affect the `cbus` database. Verify that `mysql8/initdb/03-cbus-init-table.sql` and `mysql8/initdb/04-cbus-init-data.sql` still match the expected schema and seed data for the new version.
+- `TRACK_MAINTAIN_VERSION` — may affect the `maintain` database. Verify that `mysql8/initdb/01-maintain-init-table.sql` and `mysql8/initdb/02-maintain-init-data.sql` still match the expected schema and seed data for the new version.
+
+Do not approve the PR until:
+
+1. The init SQL scripts are confirmed to be consistent with the new version, OR
+2. The author explicitly confirms that no schema/seed changes are required for this version bump.
+
+## General SQL init validation
+
+If `mysql8/initdb/*.sql` is modified, run `node scripts/check-init-sql.js` to ensure every `INSERT INTO ... VALUES` statement has the same number of values as the corresponding `CREATE TABLE` has columns.
+
+## Compose validation
+
+Any change to `compose.yml`, `compose*.yml`, or included compose fragments should be validated with `docker compose config` before merging.
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
new file mode 100644
index 0000000..1904e21
--- /dev/null
+++ b/.github/pull_request_template.md
@@ -0,0 +1,7 @@
+## PR Checklist
+
+- [ ] I have run `docker compose config` and the compose configuration resolves without errors.
+- [ ] If I changed `BUS_WEB_VERSION`, I verified whether `mysql8/initdb/03-cbus-init-table.sql` and `mysql8/initdb/04-cbus-init-data.sql` need to be updated for the new version.
+- [ ] If I changed `TRACK_MAINTAIN_VERSION`, I verified whether `mysql8/initdb/01-maintain-init-table.sql` and `mysql8/initdb/02-maintain-init-data.sql` need to be updated for the new version.
+- [ ] If I changed `mysql8/initdb/*.sql`, I ran `node scripts/check-init-sql.js` and fixed any column/value mismatches.
+- [ ] I exported `docker compose config > compose-stack.yaml` and reviewed the diff before submitting.
diff --git a/CLAUDE.md b/CLAUDE.md
index 3357b4e..020a1a3 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -90,6 +90,17 @@ External access is exposed through `nginx` (ports 80/443 by default) and, for de
 
 Frontend artifacts are not built here. They are downloaded from CI artifacts using `scripts/teamcity-download-artifact.sh` or deployed from tagged GitHub releases using `scripts/distar-beta-deploy.sh`. See `scripts/README.md` and `jtt808/README.md` for exact commands.
 
+## Review Rules
+
+When a pull request changes the following version variables in `default.env` / `default.en.env`, the reviewer must confirm that the corresponding MySQL initialization scripts under `mysql8/initdb/` are still consistent with the new application version:
+
+- `BUS_WEB_VERSION` — check `mysql8/initdb/03-cbus-init-table.sql` and `mysql8/initdb/04-cbus-init-data.sql`.
+- `TRACK_MAINTAIN_VERSION` — check `mysql8/initdb/01-maintain-init-table.sql` and `mysql8/initdb/02-maintain-init-data.sql`.
+
+If the SQL init files are modified, run `node scripts/check-init-sql.js` to catch column/value mismatches. Any compose change must pass `docker compose config`.
+
+These rules are also encoded in `.github/copilot-instructions.md` and `.github/pull_request_template.md`.
+
 ## Important Notes
 
 - Most compose fragments rely on environment variables marked `{?required}` in their image tags or env vars. Always run `docker compose config` before `up` to catch missing values.

From e90dd5b705fe3bb66922b05b5c4506a41cb84b98 Mon Sep 17 00:00:00 2001
From: niexiaorong <niexiaorong@example.com>
Date: Thu, 18 Jun 2026 16:49:27 +0800
Subject: [PATCH 5/7] =?UTF-8?q?chore(review):=20=E7=A7=BB=E9=99=A4=20Copil?=
 =?UTF-8?q?ot=20=E6=8C=87=E4=BB=A4=EF=BC=8C=E4=BB=85=E4=BF=9D=E7=95=99=20C?=
 =?UTF-8?q?laude=20=E4=B8=8E=20PR=20=E6=A8=A1=E6=9D=BF=E8=A7=84=E5=88=99?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

删除 .github/copilot-instructions.md，CLAUDE.md 中不再引用 Copilot 规则。
---
 .github/copilot-instructions.md | 25 -------------------------
 CLAUDE.md                       |  2 +-
 2 files changed, 1 insertion(+), 26 deletions(-)
 delete mode 100644 .github/copilot-instructions.md

diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
deleted file mode 100644
index f1f6a5a..0000000
--- a/.github/copilot-instructions.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# Copilot Review Instructions
-
-When reviewing pull requests in this repository, apply the following rules.
-
-## Version bumps that require MySQL init data sync
-
-This repository is a Docker Compose packaging repo for a fleet/vehicle tracking platform. Backend and frontend version variables in `default.env` / `default.en.env` map to application releases that may introduce new database migrations or seed-data changes.
-
-If a PR changes either of these version variables, the author must also review and update the corresponding MySQL initialization scripts under `mysql8/initdb/`:
-
-- `BUS_WEB_VERSION` — may affect the `cbus` database. Verify that `mysql8/initdb/03-cbus-init-table.sql` and `mysql8/initdb/04-cbus-init-data.sql` still match the expected schema and seed data for the new version.
-- `TRACK_MAINTAIN_VERSION` — may affect the `maintain` database. Verify that `mysql8/initdb/01-maintain-init-table.sql` and `mysql8/initdb/02-maintain-init-data.sql` still match the expected schema and seed data for the new version.
-
-Do not approve the PR until:
-
-1. The init SQL scripts are confirmed to be consistent with the new version, OR
-2. The author explicitly confirms that no schema/seed changes are required for this version bump.
-
-## General SQL init validation
-
-If `mysql8/initdb/*.sql` is modified, run `node scripts/check-init-sql.js` to ensure every `INSERT INTO ... VALUES` statement has the same number of values as the corresponding `CREATE TABLE` has columns.
-
-## Compose validation
-
-Any change to `compose.yml`, `compose*.yml`, or included compose fragments should be validated with `docker compose config` before merging.
diff --git a/CLAUDE.md b/CLAUDE.md
index 020a1a3..98471c9 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -99,7 +99,7 @@ When a pull request changes the following version variables in `default.env` / `
 
 If the SQL init files are modified, run `node scripts/check-init-sql.js` to catch column/value mismatches. Any compose change must pass `docker compose config`.
 
-These rules are also encoded in `.github/copilot-instructions.md` and `.github/pull_request_template.md`.
+These rules are also encoded in `.github/pull_request_template.md`.
 
 ## Important Notes
 

From 2f7751cef327c9deebffa41d51b7f8541f686d8d Mon Sep 17 00:00:00 2001
From: niexiaorong <fukua365@gmail.com>
Date: Thu, 18 Jun 2026 17:01:43 +0800
Subject: [PATCH 6/7] =?UTF-8?q?fix(PR):=20=E4=BF=AE=E6=94=B9=E5=8F=98?=
 =?UTF-8?q?=E9=87=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/pull_request_template.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 1904e21..aca33cd 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -1,7 +1,7 @@
 ## PR Checklist
 
 - [ ] I have run `docker compose config` and the compose configuration resolves without errors.
-- [ ] If I changed `BUS_WEB_VERSION`, I verified whether `mysql8/initdb/03-cbus-init-table.sql` and `mysql8/initdb/04-cbus-init-data.sql` need to be updated for the new version.
+- [ ] If I changed `BUS_GATEWAY_VERSION`, I verified whether `mysql8/initdb/03-cbus-init-table.sql` and `mysql8/initdb/04-cbus-init-data.sql` need to be updated for the new version.
 - [ ] If I changed `TRACK_MAINTAIN_VERSION`, I verified whether `mysql8/initdb/01-maintain-init-table.sql` and `mysql8/initdb/02-maintain-init-data.sql` need to be updated for the new version.
 - [ ] If I changed `mysql8/initdb/*.sql`, I ran `node scripts/check-init-sql.js` and fixed any column/value mismatches.
 - [ ] I exported `docker compose config > compose-stack.yaml` and reviewed the diff before submitting.

From 5b5e2f43f90d8ba79fe85eec4ad3f1e85745b58e Mon Sep 17 00:00:00 2001
From: niexiaorong <fukua365@gmail.com>
Date: Thu, 18 Jun 2026 17:03:12 +0800
Subject: [PATCH 7/7] =?UTF-8?q?fix(PR):=20=E4=BF=AE=E6=94=B9=E5=8F=98?=
 =?UTF-8?q?=E9=87=8F2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CLAUDE.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 98471c9..cc4fa06 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -94,7 +94,7 @@ Frontend artifacts are not built here. They are downloaded from CI artifacts usi
 
 When a pull request changes the following version variables in `default.env` / `default.en.env`, the reviewer must confirm that the corresponding MySQL initialization scripts under `mysql8/initdb/` are still consistent with the new application version:
 
-- `BUS_WEB_VERSION` — check `mysql8/initdb/03-cbus-init-table.sql` and `mysql8/initdb/04-cbus-init-data.sql`.
+- `BUS_GATEWAY_VERSION` — check `mysql8/initdb/03-cbus-init-table.sql` and `mysql8/initdb/04-cbus-init-data.sql`.
 - `TRACK_MAINTAIN_VERSION` — check `mysql8/initdb/01-maintain-init-table.sql` and `mysql8/initdb/02-maintain-init-data.sql`.
 
 If the SQL init files are modified, run `node scripts/check-init-sql.js` to catch column/value mismatches. Any compose change must pass `docker compose config`.