docs: add v5.3 development guardrails to gemini analysis

docs/arbitrage-engine/v51_gemini_analysis.md

@@ -145,5 +145,31 @@ BTC 轨**抛弃了线性加分**，采用**“布尔逻辑门控 (Boolean Logic
 
 ---
 
+## 四、开发注意事项（补充）
+
+1. **缺失数据默认策略（必须写死）**
+   - BTC 四个门控特征（`atr_percent_1h`, `tiered_cvd_whale`, `obi_depth_10`, `spot_perp_divergence`）任一缺失时，默认 `BLOCK_SIGNAL`。
+   - 必须记录 `block_reason=missing_feature:<name>`，避免静默放行。
+
+2. **阈值治理（避免拍脑袋改参）**
+   - `min_vol_threshold`、`obi_veto_threshold`、`whale_flow_threshold` 必须配置化（不可硬编码散落在代码中）。
+   - 文档标注为“初始值”，并明确回测校准窗口与更新频率。
+
+3. **标签口径统一（防止回填偏差）**
+   - `Y_binary_60m` 使用 `Mark Price` 判定触发顺序。
+   - ATR 必须使用信号触发时快照 `atr_value`，禁止回填时二次重算 ATR。
+
+4. **TP 兜底状态机补全部分成交分支**
+   - 触发兜底前先查询订单成交量。
+   - 若部分成交，只对剩余仓位执行 `Cancel -> Taker Market Close`，避免超平或漏平。
+
+5. **并发与幂等保护**
+   - `Cancel -> Market` 流程增加订单状态锁（或行级锁）和幂等键。
+   - 防止重复撤单、重复平仓、双写成交记录。
+
+6. **发布闸门指标字段统一**
+   - 统一报表输出字段：`maker_ratio`, `avg_friction_cost_r`, `flip_loss_r`。
+   - 发布闸门自动判断基于同一口径，避免人工解释偏差。
+
 **给开发者的最终建议：**
 你现在可以拿着这份拆解，直接去写 `v53_alt_config.json` 和 BTC 轨的条件判断代码了。建议你先从 **ALT 轨的 `v53_alt_config.json` 重写**开始，因为这个改动最小，见效最快。是否需要我帮你直接生成这个 JSON 文件的模板？