chore: update readme

Author: daohu527

README.md

@@ -2,52 +2,69 @@
 
 This repository includes the following tools:
 
-- [Map Generation Tool](#map-generation-tool)
-- [Automated Data Copy Tool](#automated-data-copy-tool)
+- [http-server](#http-server)
+- [Automated Data Copy Tool (roadtest-archive)](#automated-data-copy-tool-roadtest-archive)
 
 ---
 
-## Map Generation Tool
+## Http Server
 
-Generate various Apollo map formats based on a given `base_map`.
+Provides a simple HTTP server used by developer tooling and local testing.
 
 ### Quick Start
 
+From the repository root:
+
 ```bash
-bash gen_all_map.sh <your_map_directory>
+cd http-server
+./manage.sh up
 ```
 
+See `http-server/README.md` for more details about the server and docker
+options.
+
 ---
 
-## Automated Data Copy Tool
+## Automated Data Copy Tool (roadtest-archive)
 
-Automatically copies data packages from the Apollo `data` directory to the `road_test` directory on a selected disk. After the copy process, a Feishu (Lark) notification is sent to the user.
+This component (now in `roadtest-archive/`) installs a udev rule and a
+systemd template to automatically archive data from an Apollo workspace to a
+removable device when it is plugged in. It creates a per-instance environment
+file under `/etc/road_test_archive/<UUID>.env` so each device instance gets the
+correct configuration.
 
-### Quick Start
+### Quick Start (install)
 
-Run the following command:
+Run the interactive installer as root:
 
 ```bash
-bash setup_host/road_test_env.sh
+sudo bash roadtest-archive/road_test_env.sh
 ```
 
-Follow the interactive prompts:
+The installer will:
+
+- check required commands (`rsync`, `curl`, `logger`, `flock`, `mountpoint`, `mount`, `udevadm`, `systemctl`)
+- install the runtime script to `/usr/local/bin/road_test_archive.sh`
+- install the systemd unit to `/etc/systemd/system/road_test_archive@.service`
+- install the udev rule to `/etc/udev/rules.d/99-roadtest.rules`
+- create `/etc/road_test_archive/<UUID>.env` and enable the per-UUID unit
+
+### Runtime/example
+
+Run the installer and follow prompts. Example interactive output:
 
 ```shell
-zero@zero:~/01code/whl-tools$ bash setup_host/road_test_env.sh
+$ sudo bash roadtest-archive/road_test_env.sh
 Enter Apollo workspace path [/home/zero/01code/apollo]:
 Enter notification Webhook URL [https://www.feishu.cn/flow/api/trigger-webhook/xxx]:
 [INFO]    Available filesystems:
-  1) /dev/nvme0n1p6 (UUID: f9ab690d-5e04-44d9-b9f8-c024016d8245)
-  2) /dev/nvme0n1p5 (UUID: DE2411AE24118AA3)
-  3) /dev/nvme0n1p3 (UUID: 560446550446386F)
-  4) /dev/nvme0n1p1 (UUID: CA41-1B79)
-  5) /dev/nvme0n1p4 (UUID: D62817D52817B389)
-Select an entry [2]:
+  1) /dev/sdb1 (UUID: 0123-ABCD)
+  2) /dev/sdc1 (UUID: 9f8e7d6c-...)
+Select an entry [1]:
 [INFO]    Configuration complete.
 Apollo Workspace : /home/zero/01code/apollo
 Webhook URL      : https://www.feishu.cn/flow/api/trigger-webhook/xxx
-Disk UUID        : DE2411AE24118AA3
+Disk UUID        : 0123-ABCD
 ```
 
 🔗 [How to Create a Feishu Webhook](https://www.feishu.cn/hc/zh-CN/articles/807992406756-webhook-%E8%A7%A6%E5%8F%91%E5%99%A8)

http-server/README.md

@@ -22,19 +22,65 @@ This repository provides a quick Docker-based setup to host an offline-capable B
 
 ---
 
+
 ## 3. Deployment & Startup
 
-### 3.1 Run the initializer
+This repository includes a convenience manager script `manage.sh` which wraps
+initialization and docker-compose operations. The script will detect whether
+`docker-compose` or the Docker CLI's `docker compose` subcommand is available
+and use the detected command.
+
+### 3.1 Quick deploy (recommended)
+
+From this directory run:
+
+```bash
+chmod +x manage.sh
+sudo ./manage.sh deploy
+```
+
+`deploy` will:
+
+- create necessary directories (`share`, `registry`, `filebrowser`, `squid/cache`)
+- initialize the filebrowser database
+- update registry `source.json` entries to point at the detected LAN IP
+- start the compose stack (file-server, bazel-registry, squid-proxy, filebrowser)
+
+After `deploy` completes it prints access instructions with the detected LAN
+IP.
+
+### 3.2 Troubleshooting & status
+
+Check stack health and endpoints:
 
-The `init.sh` script fixes directory permissions and updates any `source.json` entries in the `registry/` to point at the detected LAN IP.
+```bash
+./manage.sh status
+```
+
+Restart a single service or the entire stack:
+
+```bash
+./manage.sh restart file-server
+./manage.sh restart all
+```
+
+If you prefer to run compose manually the script supports `docker-compose` or
+`docker compose` — it will auto-detect which command to use.
+
+### 3.3 Optional: run initializer manually
+
+If you wish to run the low-level initializer directly (not required when using
+`manage.sh deploy`), you can run:
 
 ```bash
 chmod +x init.sh
 ./init.sh
-
 ```
 
-### 3.2 Verify access
+This fixes permissions and updates registry URLs, similar to what `deploy`
+performs.
+
+### 3.4 Verify access (endpoints)
 
 - **File Browser (admin UI)**: `http://<IP>:8082` (default admin/admin) — upload files to `share/`.
 - **File Server (downloads)**: `http://<IP>:8080` — serves `.tar.gz` source archives.

http-server/docker-compose.yml

@@ -1,7 +1,7 @@
 version: '3.8'
 
 services:
-  # 1. 源码包文件服务器
+  # 1. Source code package file server
   file-server:
     image: nginx:latest
     container_name: bazel-file-server
@@ -12,7 +12,7 @@ services:
       - ./nginx-conf/autoindex.conf:/etc/nginx/conf.d/default.conf:ro
     restart: unless-stopped
 
-  # 2. Bzlmod 注册表服务器
+  # 2. Bzlmod registry server
   bazel-registry:
     image: nginx:latest
     container_name: bazel-registry
@@ -23,7 +23,7 @@ services:
       - ./nginx-conf/autoindex.conf:/etc/nginx/conf.d/default.conf:ro
     restart: unless-stopped
 
-  # 3. Squid 缓存代理
+  # 3. Squid caching proxy
   squid-proxy:
     image: ubuntu/squid:latest
     container_name: bazel-proxy
@@ -34,7 +34,7 @@ services:
       - ./squid/squid.conf:/etc/squid/squid.conf
     restart: unless-stopped
 
-  # 4. 可视化管理
+  # 4. Visual management
   filebrowser:
     image: filebrowser/filebrowser:latest
     container_name: filebrowser

http-server/nginx-conf/autoindex.conf

@@ -5,7 +5,7 @@ server {
     location / {
         root /usr/share/nginx/html;
         index index.html index.htm;
-        autoindex on; # The magic line!
+        autoindex on;
         autoindex_exact_size off;
         autoindex_localtime on;
     }