Refresh IBKR rollout naming docs

Author: Pigbibi

README.md

@@ -40,6 +40,7 @@ The mainline runtime now follows one path only:
 
 - `global_etf_rotation`
 - `russell_1000_multi_factor_defensive`
+- `semiconductor_rotation_income`
 - `tech_pullback_cash_buffer`
 
 
@@ -49,7 +50,8 @@ The mainline runtime now follows one path only:
 | --- | --- | --- | --- | --- | --- | --- | --- |
 | `global_etf_rotation` | Global ETF Rotation | Yes | Yes | Yes | Yes | `us_equity` | current rollback line |
 | `russell_1000_multi_factor_defensive` | Russell 1000 Multi-Factor | Yes | Yes | No | No | `us_equity` | defensive stock baseline |
-| `tech_pullback_cash_buffer` | QQQ Tech Enhancement | Yes | Yes | No | No | `us_equity` | current IBKR paper dry-run candidate |
+| `semiconductor_rotation_income` | SOXL/SOXX Semiconductor Trend Income | Yes | Yes | No | No | `us_equity` | current IBKR dry-run line |
+| `tech_pullback_cash_buffer` | QQQ Tech Enhancement | Yes | Yes | No | No | `us_equity` | enabled feature-snapshot alternative |
 
 Check the current matrix locally:
 
@@ -171,7 +173,7 @@ The selected `ACCOUNT_GROUP` is now the runtime identity. Keep broker-specific i
 |----------|----------|-------------|
 | `IB_GATEWAY_ZONE` | Optional fallback | GCE zone (for example `us-central1-a`). Recommended to keep in the selected account-group entry; this env var is only a transition fallback. |
 | `IB_GATEWAY_IP_MODE` | Optional fallback | `internal` (default) or `external`. Recommended to keep in the selected account-group entry; this env var is only a transition fallback. |
-| `STRATEGY_PROFILE` | Yes | Strategy profile selector. Supported `us_equity` values: `global_etf_rotation`, `russell_1000_multi_factor_defensive`, `tech_pullback_cash_buffer` |
+| `STRATEGY_PROFILE` | Yes | Strategy profile selector. Supported `us_equity` values: `global_etf_rotation`, `russell_1000_multi_factor_defensive`, `semiconductor_rotation_income`, `tech_pullback_cash_buffer` |
 | `ACCOUNT_GROUP` | Yes | Account-group selector. No default fallback. |
 | `IBKR_FEATURE_SNAPSHOT_PATH` | Conditionally required | Required when `STRATEGY_PROFILE=russell_1000_multi_factor_defensive`. Path to the latest feature snapshot file (`.csv`, `.json`, `.jsonl`, `.parquet`). |
 | `IB_ACCOUNT_GROUP_CONFIG_SECRET_NAME` | Yes for Cloud Run | Secret Manager secret name for account-group config JSON. Recommended production source. |
@@ -244,7 +246,7 @@ Recommended account-group config payload:
       "ib_gateway_mode": "paper",
       "ib_gateway_ip_mode": "internal",
       "ib_client_id": 1,
-      "service_name": "interactive-brokers-quant-global-etf-rotation",
+      "service_name": "interactive-brokers-quant-service",
       "account_ids": ["DU1234567"]
     },
     "ira": {
@@ -253,7 +255,7 @@ Recommended account-group config payload:
       "ib_gateway_mode": "paper",
       "ib_gateway_ip_mode": "internal",
       "ib_client_id": 7,
-      "service_name": "interactive-brokers-quant-global-etf-rotation-ira",
+      "service_name": "interactive-brokers-quant-ira-service",
       "account_ids": ["U1234567"]
     }
   }
@@ -305,7 +307,7 @@ Important:
 ### Deployment unit and naming
 
 - `QuantPlatformKit` is only a shared dependency; Cloud Run now deploys `InteractiveBrokersPlatform`.
-- Recommended Cloud Run service name: `interactive-brokers-quant-global-etf-rotation-service`.
+- Recommended Cloud Run service name: `interactive-brokers-quant-service`.
 - For future multi-account rollout, keep one Cloud Run service per `ACCOUNT_GROUP`, and let each service select its account-group config at runtime.
 - If you later rename or move this repository, reselect the GitHub source in Cloud Build / Cloud Run trigger instead of assuming the existing source binding will update itself.
 - For the shared deployment model and trigger migration checklist, see [`QuantPlatformKit/docs/deployment_model.md`](../QuantPlatformKit/docs/deployment_model.md).
@@ -322,7 +324,7 @@ Important:
 Example deploy/update command:
 
 ```bash
-gcloud run deploy interactive-brokers-quant-global-etf-rotation-service \
+gcloud run deploy interactive-brokers-quant-service \
   --source . \
   --region us-central1 \
   --service-account ibkr-platform-runtime@PROJECT_ID.iam.gserviceaccount.com \
@@ -350,7 +352,7 @@ gcloud run services update ibkr-quant \
 
 基于 IBKR 的全球 ETF 季度轮动策略（国际市场、商品、美股行业、美股宽基、科技和半导体），含每日金丝雀应急机制。定位上比 `TQQQ`、`SOXL` 这类高弹性科技策略更稳健，但不再把科技完全排除在外。部署在 GCP Cloud Run，连接 GCE 上的 IB Gateway。
 
-当前 `global_etf_rotation`、`russell_1000_multi_factor_defensive` 和 `tech_pullback_cash_buffer` 的策略实现都来自 `UsEquityStrategies`。
+当前 `global_etf_rotation`、`russell_1000_multi_factor_defensive`、`semiconductor_rotation_income` 和 `tech_pullback_cash_buffer` 的策略实现都来自 `UsEquityStrategies`。
 
 完整策略说明现在放在 [`UsEquityStrategies`](https://github.com/QuantStrategyLab/UsEquityStrategies#global_etf_rotation)。下面的策略章节主要保留执行侧摘要。
 
@@ -420,7 +422,7 @@ IBKR 账户
 |------|------|------|
 | `IB_GATEWAY_ZONE` | 可选过渡项 | GCE zone（如 `us-central1-a`）。推荐直接放进选中的账号组配置里；这里只保留过渡 fallback。 |
 | `IB_GATEWAY_IP_MODE` | 可选过渡项 | `internal`（默认）或 `external`。推荐直接放进选中的账号组配置里；这里只保留过渡 fallback。 |
-| `STRATEGY_PROFILE` | 是 | 策略档位选择。当前可用的 `us_equity` 值：`global_etf_rotation`、`russell_1000_multi_factor_defensive`、`tech_pullback_cash_buffer` |
+| `STRATEGY_PROFILE` | 是 | 策略档位选择。当前可用的 `us_equity` 值：`global_etf_rotation`、`russell_1000_multi_factor_defensive`、`semiconductor_rotation_income`、`tech_pullback_cash_buffer` |
 | `ACCOUNT_GROUP` | 是 | 账号组选择器，不再提供默认回退。 |
 | `IB_ACCOUNT_GROUP_CONFIG_SECRET_NAME` | Cloud Run 建议必填 | 账号组配置 JSON 在 Secret Manager 里的密钥名。生产环境推荐使用。 |
 | `IB_ACCOUNT_GROUP_CONFIG_JSON` | 否 | 本地开发用的账号组配置 JSON fallback。不建议在生产 Cloud Run 直接使用。 |
@@ -446,7 +448,7 @@ IBKR 账户
 当前第一步，建议让 GitHub / Cloud Run 只维护服务级变量：
 
 ```bash
-STRATEGY_PROFILE=global_etf_rotation
+STRATEGY_PROFILE=semiconductor_rotation_income
 ACCOUNT_GROUP=default
 IB_ACCOUNT_GROUP_CONFIG_SECRET_NAME=ibkr-account-groups
 GLOBAL_TELEGRAM_CHAT_ID=<telegram-chat-id>
@@ -470,7 +472,7 @@ IB_GATEWAY_IP_MODE=internal
       "ib_gateway_mode": "paper",
       "ib_gateway_ip_mode": "internal",
       "ib_client_id": 1,
-      "service_name": "interactive-brokers-quant-global-etf-rotation",
+      "service_name": "interactive-brokers-quant-service",
       "account_ids": ["DU1234567"]
     },
     "ira": {
@@ -479,7 +481,7 @@ IB_GATEWAY_IP_MODE=internal
       "ib_gateway_mode": "paper",
       "ib_gateway_ip_mode": "internal",
       "ib_client_id": 7,
-      "service_name": "interactive-brokers-quant-global-etf-rotation-ira",
+      "service_name": "interactive-brokers-quant-ira-service",
       "account_ids": ["U1234567"]
     }
   }
@@ -531,7 +533,7 @@ IB_GATEWAY_IP_MODE=internal
 ### 部署单元和命名建议
 
 - `QuantPlatformKit` 只是共享依赖，不单独部署；Cloud Run 现在部署的是 `InteractiveBrokersPlatform`。
-- 推荐 Cloud Run 服务名：`interactive-brokers-quant-global-etf-rotation-service`。
+- 推荐 Cloud Run 服务名：`interactive-brokers-quant-service`。
 - 后续如果扩到多账户，建议按 `ACCOUNT_GROUP` 拆成多个 Cloud Run 服务，并让每个服务在运行时选中自己的账号组配置。
 - 如果后面改 GitHub 仓库名或再次迁组织，Cloud Build / Cloud Run 里的 GitHub 来源需要重新选择，不要假设旧绑定会自动跟过去。
 - 统一部署模型和触发器迁移清单见 [`QuantPlatformKit/docs/deployment_model.md`](../QuantPlatformKit/docs/deployment_model.md)。
@@ -548,7 +550,7 @@ IB_GATEWAY_IP_MODE=internal
 示例部署命令：
 
 ```bash
-gcloud run deploy interactive-brokers-quant-global-etf-rotation-service \
+gcloud run deploy interactive-brokers-quant-service \
   --source . \
   --region us-central1 \
   --service-account ibkr-platform-runtime@PROJECT_ID.iam.gserviceaccount.com \

docs/examples/ibkr-account-groups.default.json

@@ -6,7 +6,7 @@
       "ib_gateway_mode": "paper",
       "ib_gateway_ip_mode": "internal",
       "ib_client_id": 1,
-      "service_name": "interactive-brokers-quant-global-etf-rotation",
+      "service_name": "interactive-brokers-quant-service",
       "account_ids": [
         "DU1234567"
       ]

docs/ibkr_runtime_rollout.md

@@ -1,6 +1,6 @@
 # InteractiveBrokersPlatform 配置落地：先跑通 `ACCOUNT_GROUP=default`
 
-这份文档只管当前这一步：**先把 `interactive-brokers-quant-global-etf-rotation-service` 这一个 Cloud Run 服务，用 `ACCOUNT_GROUP=default` 跑通。**
+这份文档只管当前这一步：**先把 `interactive-brokers-quant-service` 这一个 Cloud Run 服务，用 `ACCOUNT_GROUP=default` 跑通。**
 
 不在这一步里做的事：
 
@@ -67,7 +67,7 @@ cp docs/examples/ibkr-account-groups.default.json /tmp/ibkr-account-groups.json
       "ib_gateway_mode": "paper",
       "ib_gateway_ip_mode": "internal",
       "ib_client_id": 1,
-      "service_name": "interactive-brokers-quant-global-etf-rotation",
+      "service_name": "interactive-brokers-quant-service",
       "account_ids": ["DU1234567"]
     }
   }
@@ -224,7 +224,7 @@ gcloud projects add-iam-policy-binding "${PROJECT_ID}" \
 6. **检查 Cloud Run 当前 env**
 
 ```bash
-gcloud run services describe interactive-brokers-quant-global-etf-rotation-service \
+gcloud run services describe interactive-brokers-quant-service \
   --project "${PROJECT_ID}" \
   --region "us-central1" \
   --format="yaml(spec.template.spec.serviceAccountName,spec.template.spec.containers[0].env)"
@@ -233,7 +233,7 @@ gcloud run services describe interactive-brokers-quant-global-etf-rotation-servi
 7. **看启动日志**
 
 ```bash
-gcloud run services logs read interactive-brokers-quant-global-etf-rotation-service \
+gcloud run services logs read interactive-brokers-quant-service \
   --project "${PROJECT_ID}" \
   --region "us-central1" \
   --limit=100

tests/test_account_group_examples.py

@@ -19,5 +19,5 @@ def test_default_account_group_example_is_valid():
     assert default_group.ib_gateway_mode == "paper"
     assert default_group.ib_gateway_ip_mode == "internal"
     assert default_group.ib_client_id == 1
-    assert default_group.service_name == "interactive-brokers-quant-global-etf-rotation"
+    assert default_group.service_name == "interactive-brokers-quant-service"
     assert default_group.account_ids == ("DU1234567",)

tests/test_runtime_config_support.py

@@ -108,7 +108,7 @@ def test_load_platform_runtime_settings_supports_explicit_group_config_values(mo
         '{"groups":{"taxable_main":{"ib_gateway_instance_name":"ib-gateway-main",'
         '"ib_gateway_zone":"us-central1-a","ib_gateway_mode":"live",'
         '"ib_gateway_ip_mode":"external","ib_client_id":7,'
-        '"service_name":"interactive-brokers-quant-global-etf-rotation-taxable-main",'
+        '"service_name":"interactive-brokers-quant-taxable-main-service",'
         '"account_ids":["U1234567"]}}}',
     )
     monkeypatch.setenv("TELEGRAM_TOKEN", "token-1")
@@ -129,7 +129,7 @@ def test_load_platform_runtime_settings_supports_explicit_group_config_values(mo
     assert settings.feature_snapshot_path is None
     assert settings.feature_snapshot_manifest_path is None
     assert settings.account_group == "taxable_main"
-    assert settings.service_name == "interactive-brokers-quant-global-etf-rotation-taxable-main"
+    assert settings.service_name == "interactive-brokers-quant-taxable-main-service"
     assert settings.account_ids == ("U1234567",)
     assert settings.tg_token == "token-1"
     assert settings.tg_chat_id == "chat-1"
@@ -332,7 +332,7 @@ def test_load_platform_runtime_settings_uses_account_group_secret(monkeypatch):
           "ib_gateway_mode": "live",
           "ib_gateway_ip_mode": "external",
           "ib_client_id": 9,
-          "service_name": "interactive-brokers-quant-global-etf-rotation-ira",
+          "service_name": "interactive-brokers-quant-ira-service",
           "account_ids": ["U1234567", "U7654321"]
         }
       }
@@ -359,7 +359,7 @@ def access_secret_version(self, request):
     assert settings.ib_gateway_ip_mode == "external"
     assert settings.ib_client_id == 9
     assert settings.account_group == "ira"
-    assert settings.service_name == "interactive-brokers-quant-global-etf-rotation-ira"
+    assert settings.service_name == "interactive-brokers-quant-ira-service"
     assert settings.account_ids == ("U1234567", "U7654321")