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

32
docs/08-02_flight-fare.md Normal file
View File

@@ -0,0 +1,32 @@
<!-- mipuyun-api-doc: flight-fare -->
# FlightFare
FlightFare 实体用于描述不同乘客类型(成人 / 儿童 / 婴儿)的费用构成,拆分基础票价与税费等明细项,同时包含去程和返程的价格、政策信息,字段与实际响应完全对应。
> **说明**:带 `rtn` 前缀的字段为回程字段,仅往返程有值。
| **参数名称** | **类型** | **示例值** | **说明** |
| --- | --- | --- | --- |
| fareBasis | String | | 去 fareBasis 信息(如有) |
| rtnFareBasis | String | | 回程 fareBasis 信息(如有) |
| fareFamily | String | "Lion Economy" | 去程票价舱/产品类型名称 |
| rtnFareFamily | String | "Lion Promo" | 回程票价舱/产品类型名称 |
| currency | String | "USD" | 币种编码,遵循 ISO 4217 标准(如 USD = 美元CNY = 人民币) |
| adultFare | BigDecimal | 6115.00 | 去程成人票价(不含税) |
| rtnAdultFare | BigDecimal | 6100.00 | 回程成人票价(不含税) |
| adultTax | BigDecimal | 13714.00 | 去程成人税费 |
| rtnAdultTax | BigDecimal | 8540.00 | 回程成人税费 |
| childFare | BigDecimal | 0.00 | 去程儿童票价(不含税),儿童定义为 2-12 周岁 |
| rtnChildFare | BigDecimal | 0.00 | 回程儿童票价(不含税) |
| childTax | BigDecimal | 0.00 | 去程儿童税费 |
| rtnChildTax | BigDecimal | 0.00 | 回程儿童税费 |
| infantFare | BigDecimal | 0.00 | 去程婴儿票价(不含税),婴儿定义为 0-2 周岁(无独立座位) |
| rtnInfantFare | BigDecimal | 0.00 | 回程婴儿票价(不含税) |
| infantTax | BigDecimal | 0.00 | 去程婴儿税费 |
| rtnInfantTax | BigDecimal | 0.00 | 回程婴儿税费 |
| bookingCode | String | "Y,Y" | 去程舱位代码(如 Y、B、M、W 等),廉航领域不一定存在,可通过系统设置-参数设置-默认舱位编码指定默认值。<br>**格式说明**<br>- 单程直飞:单个代码,如 `"Y"`<br>- 单程转机:逗号分隔多段,如 `"B,Y"` 表示第一段 B 舱,第二段 Y 舱 |
| rtnBookingCode | String | "Y,Y" | 回程舱位代码(如 Y、B、M、W 等),廉航领域不一定存在。<br>**格式说明**:同 bookingCode单段为单个代码多段用逗号分隔 |
| availableSeats | int | 7 | 去程剩余座位数 |
| rtnAvailableSeats | int | 2 | 回程剩余座位数 |
| flightPolicy | [FlightPolicy](08-04_flight-policy.md) | | 去程航班政策(包含去程免费行李额、退改规则等) |
| rtnFlightPolicy | [FlightPolicy](08-04_flight-policy.md) | | 回程航班政策(包含回程免费行李额、退改规则等) |