新增通过手机号获取排队信息的内部接口

docs/visitor-mini-program-integration.md

@@ -400,6 +400,24 @@ Content-Type: application/json
 
 测试环境下该接口被调用过于频繁时会返回 HTTP `429`、错误码 `PUBLIC_QUERY_RATE_LIMITED`，并通过 `Retry-After` 告知等待秒数。
 
+### 5.5 内部系统按手机号查状态
+
+供酒店业务服务等可信后端调用：
+
+```http
+POST /api/internal/status/search
+Content-Type: application/json
+```
+
+请求体仍为 `{ "phone": "13800138000" }`，响应为 `{ "tickets": [...] }`，只包含该手机号在运行或暂停项目中的 `WAITING`、`CALLED`、`ARRIVED` 活动号码，单个号码结构与 5.3 的状态响应一致。该接口在生产环境可用。
+
+访问限制：
+
+- 调用方必须通过 ClusterIP、内网域名等内部服务地址直连；
+- API 仅接受来源地址为私网或回环地址的连接，不信任 `X-Forwarded-For`；
+- 不得在公网 Ingress、网关或负载均衡器上发布 `/api/internal/*` 路径；
+- 如果公网 Ingress 与内部调用共用后端 Pod，仍须通过 Ingress 路由规则和 NetworkPolicy 阻断该路径，避免公网流量经私网代理地址绕过来源检查。
+
 ## 6. 号码状态与页面展示建议
 
 | `status` | 建议展示 | 处理方式 |