docs: add integration tests description

Signed-off-by: Teresaliu <teresaliu@didiglobal.com>

Author: liuchangyan

docs/best-practice/_index_en.md

@@ -4,5 +4,5 @@ type: docs
 description:
 author: HUATUO Team
 date: 2026-01-11
-weight: 5
+weight: 6
 ---

docs/best-practice/_index_zh.md

@@ -4,5 +4,5 @@ type: docs
 description:
 author: HUATUO Team
 date: 2026-01-11
-weight: 5
+weight: 6
 ---

docs/development/_index_en.md

@@ -4,5 +4,5 @@ type: docs
 description:
 author: HUATUO Team
 date: 2026-01-11
-weight: 6
+weight: 7
 ---

docs/development/_index_zh.md

@@ -4,5 +4,5 @@ type: docs
 description:
 author: HUATUO Team
 date: 2026-01-11
-weight: 6
+weight: 7
 ---

docs/faq/_index_en.md

@@ -1,5 +1,5 @@
 ---
 title: Frequenty Asked Questions
 type: docs
-weight: 7
+weight: 8
 ---

docs/faq/_index_zh.md

@@ -1,5 +1,5 @@
 ---
 title: 常见问题
 type: docs
-weight: 7
+weight: 8
 ---

docs/integration_en.md

@@ -0,0 +1,75 @@
+---
+title: Integration Test
+type: docs
+description:
+author: HUATUO Team
+date: 2026-03-04
+weight: 4
+---
+
+This integration test validates that **huatuo-bamai** can start correctly with mocked `/proc` and `/sys` filesystems and expose the expected **Prometheus metrics**.
+
+The test runs the real `huatuo-bamai` binary and verifies the `/metrics`endpoint output without relying on the host kernel or hardware.
+
+## What the Script Does
+The integration test performs the following steps:
+
+1. Generates a temporary `bamai.conf`
+2. Starts `huatuo-bamai` with mocked `procfs` and `sysfs`
+3. Waits for the Prometheus `/metrics` endpoint to become available
+4. Fetches all metrics from `/metrics`
+5. Verifies that all expected metrics exist
+6. Stops the service and cleans up resources
+
+If any expected metric is missing, the test fails.
+
+## How to Run
+Run the integration test from the project root:
+
+```bash
+bash integration/integration.sh
+```
+or
+```bash
+make integration
+```
+### On Failure
+
+- The `huatuo-bamai` service metrics and logs are printed to stdout
+- The temporary working directory is kept for debugging
+
+### On Success
+
+- Output the list of successfully validated metrics
+
+---
+
+## How to Add New Metrics Tests
+### Step 1: Add or Update Fixture Data
+
+If the metric depends on /proc or /sys, add or update mock data under:
+```bash
+integration/fixtures/
+```
+
+The directory structure should match the real kernel filesystem layout.
+### Step 2: Add Expected Metrics
+
+Create a new file under:
+```bash
+integration/fixtures/expected_metrics/
+├── cpu.txt
+├── memory.txt
+└── ...
+```
+
+Each non-empty, non-comment line represents one expected Prometheus metric line
+and must match the /metrics output exactly.
+
+New *.txt files are automatically picked up by the test.
+
+### Step 3: Run the Test
+```bash
+bash integration/integration.sh
+```
+The test fails if any expected metric is missing or mismatched.

docs/integration_zh.md

@@ -0,0 +1,67 @@
+---
+title: 集成测试
+type: docs
+description:
+author: HUATUO Team
+date: 2026-03-04
+weight: 4
+---
+
+集成测试用于验证 ``huatuo-bamai``在使用模拟的 ``/proc`` 和 ``/sys`` 文件系统时，能够正确启动并对外暴露符合预期的``Prometheus``指标。
+
+测试运行的是真实的可执行文件，并通过校验 ``/metrics`` 接口的输出结果，确保指标采集与暴露逻辑正确，而不依赖宿主机的内核或硬件环境。
+
+## 脚本执行流程
+
+该集成测试脚本主要包含以下步骤：
+
+1. 生成临时的``bamai.conf``配置文件
+2. 使用模拟的 ``procfs`` 和 ``sysfs`` 启动 ``huatuo-bamai`` 服务
+3. 等待 ``/metrics`` 接口可访问
+4. 从 ``/metrics`` 接口拉取所有指标数据
+5. 校验所有预期指标是否存在且内容匹配
+6. 停止服务并清理相关资源
+7. 若任意一个预期指标缺失或不匹配，测试将直接失败
+
+## 运行方式
+
+请在项目根目录下执行集成测试：
+```bash
+bash integration/integration.sh
+```
+或通过 Makefile 执行：
+```bash
+make integration
+```
+
+### 失败时的行为
+- ``huatuo-bamai`` 服务指标和日志将直接输出到标准输出，便于问题定位
+- 临时工作目录将被保留，用于后续调试分析
+
+### 成功时的行为
+- 显示验证成功的``metrics`` 列表
+---
+
+## 如何新增指标测试
+### 第一步：新增或更新模拟数据
+如果新增的指标依赖 ``/proc`` 或 ``/sys`` 文件内容，请在以下目录中新增或修改模拟数据：
+```bash
+integration/fixtures/
+```
+目录结构需与真实内核文件系统保持一致。
+
+### 第二步：添加预期指标
+在以下目录中新建一个文件：
+```bash
+integration/fixtures/expected_metrics/
+├── cpu.txt
+├── memory.txt
+└── ...
+```
+每一行（非空、非注释行）表示一条期望的 Prometheus 指标，指标内容必须与 ``/metrics`` 接口返回结果完全一致，新增的``*.txt`` 文件会被测试脚本自动加载并参与校验。
+
+### 第三步：运行测试
+```bash
+bash integration/integration.sh
+```
+当任意一个预期指标缺失或不匹配时，测试将失败。

docs/key-feature/_index_en.md

@@ -4,5 +4,5 @@ type: docs
 description:
 author: HUATUO Team
 date: 2026-01-11
-weight: 4
+weight: 5
 ---

docs/key-feature/_index_zh.md

@@ -4,5 +4,5 @@ type: docs
 description:
 author: HUATUO Team
 date: 2026-01-11
-weight: 4
+weight: 5
 ---