init: mipu-open 对外开放项目统一管理仓库

- 添加 mipu-api 作为 git submodule (Claude Code Skill)
- 迁移 API 文档源文件到 docs/ 目录统一维护
- 添加 Gitea Actions 工作流:tag推送自动打包docs并发布Release
- Skill 运行时自动从 mipu-open Release 下载最新文档

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
杨柳杰
2026-05-04 12:16:08 +08:00
commit b450b512a2
38 changed files with 5473 additions and 0 deletions

76
docs/08-01_itinerary.md Normal file
View File

@@ -0,0 +1,76 @@
<!-- mipuyun-api-doc: itinerary -->
# Itinerary - 行程实体对象
Itinerary 实体(行程组合信息,与实际响应字段一致)
| **参数名称** | **类型** | **说明** |
| --- | --- | --- |
| outboundSegments | Array<[SegmentElement](08-03_segment-element.md)> | 去程航段列表单程OW和往返RT场景均返回按行程顺序排列 |
| inboundSegments | Array<[SegmentElement](08-03_segment-element.md)> | 返程航段列表仅往返RT场景返回字段含义同 outboundSegments单程OW场景为空数组 |
| fares | Array<[FlightFare](08-02_flight-fare.md)> | 该行程下的可选票价方案列表,每个方案包含去程/回程的票价、税费、座位数、舱位类型及航班政策信息 |
## 实体轮廓
```json
{
"outboundSegments": [
{
"index": 1,
"carrier": "VJ",
"flightNumber": "VJ884",
"operatingCarrier": "",
"operatingFlightnumber": "",
"originAirport": "BOM",
"destinationAirport": "SGN",
"departureTime": "202510270040",
"arrivalTime": "202510270705",
"departureTerminal": "",
"arrivalTerminal": "",
"stopCities": "",
"duration": 295,
"aircraftCode": "330",
"codeShare": false
}
],
"inboundSegments": [
{
// 同 outboundSegments 结构
}
],
"fares": [
{
"fareBasis": "",
"rtnFareBasis": "",
"fareFamily": "Lion Economy",
"rtnFareFamily": "Lion Promo",
"currency": "USD",
"bookingCode": "Y,Y",
"rtnBookingCode": "Y,Y",
"availableSeats": 7,
"rtnAvailableSeats": 2,
"flightPolicy": {
"airlineCode": "SL",
"fareFamilyType": "Lion Economy",
"description": "",
"freeAncillaryList": [
{
"categoryCode": "CabinBaggageOverheadLocker",
"segmentIndex": 1,
"paxType": "ADT",
"piece": 1,
"weight": 7,
"size": ""
}
],
"refundRules": [], // 预留字段,暂未提供
"changeRules": [] // 预留字段,暂未提供
},
"rtnFlightPolicy": {
// 同 flightPolicy 结构
}
}
]
}
```
> `RuleElement` 结构详见 [FlightPolicy](08-04_flight-policy.md)