fix(gateway): document multi-item order intent schema

tests/test_openapi_export.py

@@ -103,3 +103,16 @@ def test_all_refs_resolve(spec):
     names = set(spec["components"]["schemas"])
     refs = set(re.findall(r"#/components/schemas/([^\"]+)", json.dumps(spec)))
     assert not refs - names
+
+
+def test_submit_order_intent_schema_documents_multi_item_and_legacy_fields(spec):
+    """intent 保持透传对象，同时在 OpenAPI 中明确展示新旧两种商品格式。"""
+    intent = spec["components"]["schemas"]["SubmitOrderRequest"]["properties"]["intent"]
+    properties = intent["properties"]
+    assert intent["additionalProperties"] is True
+    assert properties["items"]["type"] == "array"
+    assert properties["items"]["minItems"] == 1
+    item_object = properties["items"]["items"]["oneOf"][0]
+    assert item_object["required"] == ["item_url"]
+    assert "item_url" in properties
+    assert "quantity" in properties