feat: addon with submodules

Author: shenjinti

.gitignore

@@ -70,12 +70,7 @@ config/voicemail.toml
 config.toml.test
 docs/qrcode.png
 docs/rustpbx-product-brief.zh.html
-src/addons/wholesale
-src/addons/cc
-src/addons/endpoint_manager 
-src/addons/enterprise_auth 
-src/addons/ivr_editor 
-src/addons/jsonrpc_router 
-src/addons/telemetry 
-src/addons/voicemail 
+src/addons/jsonrpc_router
 *.sh
+screenshots/
+demo/

.gitmodules

@@ -0,0 +1,24 @@
+[submodule "src/addons/sbc"]
+	path = src/addons/sbc
+	url = https://cnb.cool/miuda.ai/sbc
+[submodule "src/addons/cc"]
+	path = src/addons/cc
+	url = https://cnb.cool/miuda.ai/cc
+[submodule "src/addons/wholesale"]
+	path = src/addons/wholesale
+	url = https://cnb.cool/miuda.ai/wholesale
+[submodule "src/addons/endpoint_manager"]
+	path = src/addons/endpoint_manager
+	url = https://cnb.cool/miuda.ai/endpoint_manager
+[submodule "src/addons/enterprise_auth"]
+	path = src/addons/enterprise_auth
+	url = https://cnb.cool/miuda.ai/enterprise_auth
+[submodule "src/addons/ivr_editor"]
+	path = src/addons/ivr_editor
+	url = https://cnb.cool/miuda.ai/ivr_editor
+[submodule "src/addons/telemetry"]
+	path = src/addons/telemetry
+	url = https://cnb.cool/miuda.ai/telemetry
+[submodule "src/addons/voicemail"]
+	path = src/addons/voicemail
+	url = https://cnb.cool/miuda.ai/voicemail

Cargo.toml

@@ -205,13 +205,13 @@ aws-lc-rs = { version = "1", optional = true }
 totp-rs = { version = "5.7.1", features = ["qr", "gen_secret"] }
 ldap3 = { version = "0.12.1", optional = true }
 ring = { version = "0.17", optional = true }
+tempfile = "3.27.0"
 
 
 [dev-dependencies]
-tempfile = "3.27.0"
 portpicker = "0.1.1"
 tower = { version = "0.5", features = ["util"] }
-sipbot = { version = "0.2.37", default-features = false }
+sipbot = { version = "0.2.38", default-features = false }
 serde_urlencoded = "0.7"
 
 [build-dependencies]

README.md

@@ -177,14 +177,40 @@ Per-channel overhead: ~0.06% CPU / 0.24 MB (signaling); ~0.19% CPU / 0.33 MB (wi
 # Linux: apt-get install cmake pkg-config libasound2-dev libssl-dev libopus-dev
 # macOS: brew install cmake openssl pkg-config
 
-git clone https://github.com/restsend/rustpbx
+git clone --recurse-submodules https://github.com/restsend/rustpbx
 cd rustpbx
 cargo build --release
 cargo run --bin rustpbx -- --conf config.toml.example
 ```
 
 > Cross-compile via [cross](https://github.com/cross-rs/cross): `cargo install cross && cross build --release --target aarch64-unknown-linux-gnu`
 
+### Submodules
+
+Commerce addons are managed as git submodules under `src/addons/`:
+
+| Submodule | Repository |
+|-----------|-----------|
+| `src/addons/cc` | https://cnb.cool/miuda.ai/cc |
+| `src/addons/wholesale` | https://cnb.cool/miuda.ai/wholesale |
+| `src/addons/endpoint_manager` | https://cnb.cool/miuda.ai/endpoint_manager |
+| `src/addons/enterprise_auth` | https://cnb.cool/miuda.ai/enterprise_auth |
+| `src/addons/ivr_editor` | https://cnb.cool/miuda.ai/ivr_editor |
+| `src/addons/sbc` | https://cnb.cool/miuda.ai/sbc |
+| `src/addons/telemetry` | https://cnb.cool/miuda.ai/telemetry |
+| `src/addons/voicemail` | https://cnb.cool/miuda.ai/voicemail |
+
+```bash
+# Initialize submodules after clone
+git submodule update --init --recursive
+
+# Pull latest changes for all submodules
+git submodule update --remote
+
+# Pull latest for a specific submodule
+git submodule update --remote src/addons/cc
+```
+
 ---
 
 ## Screenshots

docs/ivr_step_protocol_en.md

@@ -138,6 +138,35 @@ Every response is a JSON object with a `"type"` field. Two categories:
 { "type": "torecord",      "prompt": "leave_msg.wav", "beep": true }
 ```
 
+### Transparent Passthrough Fields
+
+Every `ActionNode` response can include three optional top-level fields for node identification and data passthrough:
+
+```json
+{
+  "type": "prompt",
+  "file": "hello.wav",
+  "step_id": "1000602002200750100",
+  "step_name": "欢迎语",
+  "extra": {
+    "tenantId": "didi",
+    "gvpFlow": "CTCDaiJiaKeFu",
+    "callPath": "F_11,F",
+    "businessType": "6",
+    "customerType": "1",
+    "routePoint": "39325"
+  }
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `step_id` | `string` or null | Node identifier — stored and emitted in `ivr_step_trace` events as `step_id` |
+| `step_name` | `string` or null | Node name — stored and emitted as `step_name` |
+| `extra` | `JSON Object` or null | Transparent passthrough data — provider returns the complete object each time; RustPBX stores it and includes it verbatim in every subsequent `ivr_step_trace` event |
+
+> **Passthrough behavior**: After `session_start`, the provider should include `extra` in every response. RustPBX stores the latest `extra` value and echoes it in all `ivr_step_trace` events until the provider updates it. The `step_id` and `step_name` from the most recent provider response are used for the current step's trace.
+
 ### Next Chaining
 
 Non-terminal actions can include a `next` field to chain multiple actions without a round-trip: