docs: update prerequisites (SQLite3), fix config keys and CLI flags

- Add libsqlite3-dev / sqlite3 to system requirements
- Fix config examples: buy_group/sell_group → group_a/group_b
- Add --trade-db and --bench-warmup to CLI flags table
- Fix --bench-rounds default from 5 → 20
- Add --trade-db to systemd service examples

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: luisleo526

README.md

@@ -8,7 +8,7 @@ Low-latency crypto spot arbitrage system built in C++17. Monitors price differen
 
 ```bash
 # Build
-sudo apt install -y build-essential cmake libssl-dev libcurl4-openssl-dev zlib1g-dev
+sudo apt install -y build-essential cmake libssl-dev libcurl4-openssl-dev zlib1g-dev libsqlite3-dev
 mkdir build && cd build
 cmake .. -DCMAKE_BUILD_TYPE=Release
 make -j$(nproc)

docs/deployment.md

@@ -9,11 +9,11 @@
   "threshold": 2.0,
   "interval_sec": 1,
   "coins": ["BTC", "ETH", "XRP"],
-  "buy_group": {
+  "group_a": {
     "quote_currency": "USDT",
     "exchanges": ["bybit"]
   },
-  "sell_group": {
+  "group_b": {
     "quote_currency": "KRW",
     "exchanges": ["upbit"]
   },
@@ -71,8 +71,8 @@ Same as single binary config, plus `listen_port`. Credentials are **not** needed
 | `threshold` | Premium percentage that triggers a trade |
 | `interval_sec` | Display table refresh interval (seconds) |
 | `coins` | Coins to monitor/trade (e.g., `["BTC", "ETH", "XRP"]`) |
-| `buy_group` | Exchanges to buy on — `quote_currency` + exchange names |
-| `sell_group` | Exchanges to sell on — `quote_currency` + exchange names |
+| `group_a` | Exchange group A — `quote_currency` + exchange names |
+| `group_b` | Exchange group B — `quote_currency` + exchange names |
 | `cross_rate` | Currency conversion config (averaged mid-price from `sources`) |
 | `trade.*` | See [Trading](trading.md#configuration) |
 | `listen_port` | Master TCP listen port (master config only) |
@@ -107,7 +107,7 @@ Environment variables take precedence over the config file.
 ```
 ./spot_arb [--config <path>] [--threshold <pct>] [--interval <sec>]
            [--web PORT] [--dry-run] [--benchmark] [--bench-rounds N]
-           [--latency-log <path>]
+           [--bench-warmup N] [--latency-log <path>] [--trade-db <path>]
 ```
 
 | Flag | Default | Description |
@@ -118,8 +118,10 @@ Environment variables take precedence over the config file.
 | `--web PORT` | *(off)* | Start web dashboard on PORT |
 | `--dry-run` | *(off)* | Simulate trades without placing real orders |
 | `--benchmark` | *(off)* | Run order latency benchmark and exit |
-| `--bench-rounds` | `5` | Number of benchmark rounds |
-| `--latency-log` | *(off)* | CSV file for trade execution data |
+| `--bench-rounds` | `20` | Number of benchmark rounds |
+| `--bench-warmup` | `5` | Number of benchmark warmup rounds |
+| `--latency-log` | *(off)* | CSV file for trade latency data (truncated on restart) |
+| `--trade-db` | *(off)* | SQLite database for persistent trade history |
 
 ### `spot_master`
 
@@ -200,21 +202,22 @@ graph TD
 
 ### systemd service files
 
-=== "Master"
+=== "Single Binary"
 
     ```ini
-    # /etc/systemd/system/spot-master.service
+    # /etc/systemd/system/spot-arb.service
     [Unit]
-    Description=Spot Arbitrage Master
+    Description=Spot Arbitrage
     After=network.target
 
     [Service]
     Type=simple
     User=ubuntu
     WorkingDirectory=/home/ubuntu/spot_arbitrage
-    ExecStart=/home/ubuntu/spot_arbitrage/build/spot_master \
-        --config config_master.json \
-        --latency-log /var/log/spot_trades.csv
+    ExecStart=/home/ubuntu/spot_arbitrage/build/spot_arb \
+        --config config.json \
+        --latency-log /var/log/spot_trades.csv \
+        --trade-db /var/lib/spot_arb/trades.db
     Restart=always
     RestartSec=3
     LimitNOFILE=65536
@@ -223,20 +226,21 @@ graph TD
     WantedBy=multi-user.target
     ```
 
-=== "Slave"
+=== "Master"
 
     ```ini
-    # /etc/systemd/system/spot-slave.service
+    # /etc/systemd/system/spot-master.service
     [Unit]
-    Description=Spot Arbitrage Slave
+    Description=Spot Arbitrage Master
     After=network.target
 
     [Service]
     Type=simple
     User=ubuntu
     WorkingDirectory=/home/ubuntu/spot_arbitrage
-    ExecStart=/home/ubuntu/spot_arbitrage/build/spot_slave \
-        --config config_slave.json
+    ExecStart=/home/ubuntu/spot_arbitrage/build/spot_master \
+        --config config_master.json \
+        --latency-log /var/log/spot_trades.csv
     Restart=always
     RestartSec=3
     LimitNOFILE=65536
@@ -245,21 +249,20 @@ graph TD
     WantedBy=multi-user.target
     ```
 
-=== "Single Binary"
+=== "Slave"
 
     ```ini
-    # /etc/systemd/system/spot-arb.service
+    # /etc/systemd/system/spot-slave.service
     [Unit]
-    Description=Spot Arbitrage
+    Description=Spot Arbitrage Slave
     After=network.target
 
     [Service]
     Type=simple
     User=ubuntu
     WorkingDirectory=/home/ubuntu/spot_arbitrage
-    ExecStart=/home/ubuntu/spot_arbitrage/build/spot_arb \
-        --config config.json \
-        --latency-log /var/log/spot_trades.csv
+    ExecStart=/home/ubuntu/spot_arbitrage/build/spot_slave \
+        --config config_slave.json
     Restart=always
     RestartSec=3
     LimitNOFILE=65536

docs/index.md

@@ -73,21 +73,21 @@ make -j$(nproc)
 
 - C++17 compiler (GCC 11+ or Clang 14+)
 - CMake 3.14+
-- OpenSSL, libcurl, zlib development headers
+- OpenSSL, libcurl, zlib, SQLite3 development headers
 
 All other dependencies (ixwebsocket, nlohmann/json, fmt) are fetched automatically via CMake FetchContent.
 
 === "Ubuntu/Debian"
 
     ```bash
     sudo apt update && sudo apt install -y \
-        build-essential cmake libssl-dev libcurl4-openssl-dev zlib1g-dev
+        build-essential cmake libssl-dev libcurl4-openssl-dev zlib1g-dev libsqlite3-dev
     ```
 
 === "macOS"
 
     ```bash
-    brew install cmake openssl curl
+    brew install cmake openssl curl sqlite3
     ```
 
 ## Build Outputs

docs/ko/deployment.md

@@ -9,11 +9,11 @@
   "threshold": 2.0,
   "interval_sec": 1,
   "coins": ["BTC", "ETH", "XRP"],
-  "buy_group": {
+  "group_a": {
     "quote_currency": "USDT",
     "exchanges": ["bybit"]
   },
-  "sell_group": {
+  "group_b": {
     "quote_currency": "KRW",
     "exchanges": ["upbit"]
   },
@@ -71,8 +71,8 @@
 | `threshold` | 거래를 트리거하는 프리미엄 백분율 |
 | `interval_sec` | 화면 테이블 갱신 간격 (초) |
 | `coins` | 모니터링/거래할 코인 (예: `["BTC", "ETH", "XRP"]`) |
-| `buy_group` | 매수 거래소 — `quote_currency` + 거래소 이름 |
-| `sell_group` | 매도 거래소 — `quote_currency` + 거래소 이름 |
+| `group_a` | 거래소 그룹 A — `quote_currency` + 거래소 이름 |
+| `group_b` | 거래소 그룹 B — `quote_currency` + 거래소 이름 |
 | `cross_rate` | 환율 변환 설정 (소스 거래소의 중간 가격 평균) |
 | `trade.*` | [거래](trading.md#설정) 참조 |
 | `listen_port` | 마스터 TCP 리슨 포트 (마스터 전용) |
@@ -107,7 +107,7 @@ export UPBIT_API_SECRET="your_secret"
 ```
 ./spot_arb [--config <경로>] [--threshold <퍼센트>] [--interval <초>]
            [--web PORT] [--dry-run] [--benchmark] [--bench-rounds N]
-           [--latency-log <경로>]
+           [--bench-warmup N] [--latency-log <경로>] [--trade-db <경로>]
 ```
 
 | 인수 | 기본값 | 설명 |
@@ -118,8 +118,10 @@ export UPBIT_API_SECRET="your_secret"
 | `--web PORT` | *(비활성)* | 웹 대시보드 시작 |
 | `--dry-run` | *(비활성)* | 실제 주문 없이 거래 시뮬레이션 |
 | `--benchmark` | *(비활성)* | 주문 지연 벤치마크 실행 후 종료 |
-| `--bench-rounds` | `5` | 벤치마크 라운드 수 |
-| `--latency-log` | *(비활성)* | 거래 실행 데이터 CSV 파일 |
+| `--bench-rounds` | `20` | 벤치마크 라운드 수 |
+| `--bench-warmup` | `5` | 벤치마크 워밍업 라운드 수 |
+| `--latency-log` | *(비활성)* | 거래 지연 데이터 CSV 파일 (재시작 시 초기화) |
+| `--trade-db` | *(비활성)* | 영구 거래 기록용 SQLite 데이터베이스 |
 
 ## 클라우드 배포
 
@@ -193,7 +195,8 @@ graph TD
     WorkingDirectory=/home/ubuntu/spot_arbitrage
     ExecStart=/home/ubuntu/spot_arbitrage/build/spot_arb \
         --config config.json \
-        --latency-log /var/log/spot_trades.csv
+        --latency-log /var/log/spot_trades.csv \
+        --trade-db /var/lib/spot_arb/trades.db
     Restart=always
     RestartSec=3
     LimitNOFILE=65536

docs/ko/index.md

@@ -73,21 +73,21 @@ make -j$(nproc)
 
 - C++17 컴파일러 (GCC 11+ 또는 Clang 14+)
 - CMake 3.14+
-- OpenSSL, libcurl, zlib 개발 헤더
+- OpenSSL, libcurl, zlib, SQLite3 개발 헤더
 
 기타 의존성(ixwebsocket, nlohmann/json, fmt)은 CMake FetchContent를 통해 자동으로 다운로드됩니다.
 
 === "Ubuntu/Debian"
 
     ```bash
     sudo apt update && sudo apt install -y \
-        build-essential cmake libssl-dev libcurl4-openssl-dev zlib1g-dev
+        build-essential cmake libssl-dev libcurl4-openssl-dev zlib1g-dev libsqlite3-dev
     ```
 
 === "macOS"
 
     ```bash
-    brew install cmake openssl curl
+    brew install cmake openssl curl sqlite3
     ```
 
 ## 빌드 산출물

docs/zh-cn/deployment.md

@@ -9,11 +9,11 @@
   "threshold": 2.0,
   "interval_sec": 1,
   "coins": ["BTC", "ETH", "XRP"],
-  "buy_group": {
+  "group_a": {
     "quote_currency": "USDT",
     "exchanges": ["bybit"]
   },
-  "sell_group": {
+  "group_b": {
     "quote_currency": "KRW",
     "exchanges": ["upbit"]
   },
@@ -71,8 +71,8 @@
 | `threshold` | 触发交易的溢价百分比 |
 | `interval_sec` | 显示表格的更新间隔（秒） |
 | `coins` | 监控/交易的币种（如 `["BTC", "ETH", "XRP"]`） |
-| `buy_group` | 买入的交易所——`quote_currency` + 交易所名称 |
-| `sell_group` | 卖出的交易所——`quote_currency` + 交易所名称 |
+| `group_a` | 交易所分组 A——`quote_currency` + 交易所名称 |
+| `group_b` | 交易所分组 B——`quote_currency` + 交易所名称 |
 | `cross_rate` | 汇率转换配置（来源交易所的中间价平均） |
 | `trade.*` | 详见[交易](trading.md#配置) |
 | `listen_port` | 主节点 TCP 监听端口（仅主节点配置） |
@@ -107,7 +107,7 @@ export UPBIT_API_SECRET="your_secret"
 ```
 ./spot_arb [--config <路径>] [--threshold <百分比>] [--interval <秒>]
            [--web PORT] [--dry-run] [--benchmark] [--bench-rounds N]
-           [--latency-log <路径>]
+           [--bench-warmup N] [--latency-log <路径>] [--trade-db <路径>]
 ```
 
 | 参数 | 默认值 | 说明 |
@@ -118,8 +118,10 @@ export UPBIT_API_SECRET="your_secret"
 | `--web PORT` | *（关闭）* | 启动 Web 仪表板 |
 | `--dry-run` | *（关闭）* | 模拟交易，不下真实订单 |
 | `--benchmark` | *（关闭）* | 执行订单延迟测试后退出 |
-| `--bench-rounds` | `5` | 测试回合数 |
-| `--latency-log` | *（关闭）* | 交易执行数据的 CSV 文件 |
+| `--bench-rounds` | `20` | 测试回合数 |
+| `--bench-warmup` | `5` | 预热回合数 |
+| `--latency-log` | *（关闭）* | 交易延迟数据的 CSV 文件（重启时清空） |
+| `--trade-db` | *（关闭）* | 持久化交易记录的 SQLite 数据库 |
 
 ## 云端部署
 
@@ -193,7 +195,8 @@ graph TD
     WorkingDirectory=/home/ubuntu/spot_arbitrage
     ExecStart=/home/ubuntu/spot_arbitrage/build/spot_arb \
         --config config.json \
-        --latency-log /var/log/spot_trades.csv
+        --latency-log /var/log/spot_trades.csv \
+        --trade-db /var/lib/spot_arb/trades.db
     Restart=always
     RestartSec=3
     LimitNOFILE=65536

docs/zh-cn/index.md

@@ -73,21 +73,21 @@ make -j$(nproc)
 
 - C++17 编译器（GCC 11+ 或 Clang 14+）
 - CMake 3.14+
-- OpenSSL、libcurl、zlib 开发头文件
+- OpenSSL、libcurl、zlib、SQLite3 开发头文件
 
 其他依赖（ixwebsocket、nlohmann/json、fmt）会由 CMake FetchContent 自动下载。
 
 === "Ubuntu/Debian"
 
     ```bash
     sudo apt update && sudo apt install -y \
-        build-essential cmake libssl-dev libcurl4-openssl-dev zlib1g-dev
+        build-essential cmake libssl-dev libcurl4-openssl-dev zlib1g-dev libsqlite3-dev
     ```
 
 === "macOS"
 
     ```bash
-    brew install cmake openssl curl
+    brew install cmake openssl curl sqlite3
     ```
 
 ## 编译产物

docs/zh-tw/deployment.md

@@ -9,11 +9,11 @@
   "threshold": 2.0,
   "interval_sec": 1,
   "coins": ["BTC", "ETH", "XRP"],
-  "buy_group": {
+  "group_a": {
     "quote_currency": "USDT",
     "exchanges": ["bybit"]
   },
-  "sell_group": {
+  "group_b": {
     "quote_currency": "KRW",
     "exchanges": ["upbit"]
   },
@@ -71,8 +71,8 @@
 | `threshold` | 觸發交易的溢價百分比 |
 | `interval_sec` | 顯示表格的更新間隔（秒） |
 | `coins` | 監控/交易的幣種（如 `["BTC", "ETH", "XRP"]`） |
-| `buy_group` | 買入的交易所——`quote_currency` + 交易所名稱 |
-| `sell_group` | 賣出的交易所——`quote_currency` + 交易所名稱 |
+| `group_a` | 交易所分組 A——`quote_currency` + 交易所名稱 |
+| `group_b` | 交易所分組 B——`quote_currency` + 交易所名稱 |
 | `cross_rate` | 匯率轉換設定（來源交易所的中間價平均） |
 | `trade.*` | 詳見[交易](trading.md#設定) |
 | `listen_port` | 主節點 TCP 監聽埠（僅主節點設定） |
@@ -107,7 +107,7 @@ export UPBIT_API_SECRET="your_secret"
 ```
 ./spot_arb [--config <路徑>] [--threshold <百分比>] [--interval <秒>]
            [--web PORT] [--dry-run] [--benchmark] [--bench-rounds N]
-           [--latency-log <路徑>]
+           [--bench-warmup N] [--latency-log <路徑>] [--trade-db <路徑>]
 ```
 
 | 參數 | 預設值 | 說明 |
@@ -118,8 +118,10 @@ export UPBIT_API_SECRET="your_secret"
 | `--web PORT` | *（關閉）* | 啟動 Web 儀表板 |
 | `--dry-run` | *（關閉）* | 模擬交易，不下真實訂單 |
 | `--benchmark` | *（關閉）* | 執行訂單延遲測試後退出 |
-| `--bench-rounds` | `5` | 測試回合數 |
-| `--latency-log` | *（關閉）* | 交易執行資料的 CSV 檔案 |
+| `--bench-rounds` | `20` | 測試回合數 |
+| `--bench-warmup` | `5` | 預熱回合數 |
+| `--latency-log` | *（關閉）* | 交易延遲資料的 CSV 檔案（重啟時清空） |
+| `--trade-db` | *（關閉）* | 持久化交易紀錄的 SQLite 資料庫 |
 
 ## 雲端部署
 
@@ -193,7 +195,8 @@ graph TD
     WorkingDirectory=/home/ubuntu/spot_arbitrage
     ExecStart=/home/ubuntu/spot_arbitrage/build/spot_arb \
         --config config.json \
-        --latency-log /var/log/spot_trades.csv
+        --latency-log /var/log/spot_trades.csv \
+        --trade-db /var/lib/spot_arb/trades.db
     Restart=always
     RestartSec=3
     LimitNOFILE=65536