feat：项目细节

.gitignore

@@ -40,4 +40,6 @@ logs/
 
 ### SQL Files ###
 *.sql
-*.md
+*.md
+# 允许 docs 目录下的文档
+!docs/**/*.md

docs/BUSINESS_MODEL_DESIGN.md

@@ -0,0 +1,526 @@
+# 业务模型设计文档
+
+> **项目**: Travel (Tech Mall) - 旅游线路交易系统  
+> **最后更新**: 2025-12-01  
+> **状态**: 设计确认 ✅
+
+---
+
+## 📋 业务概述
+
+本系统是一个**旅游线路预订和票务管理平台**，支持固定班次和滚动班次两种运营模式，为用户提供线路查询、在线下单、支付、电子凭证和核销等完整服务。
+
+---
+
+## 🎯 核心业务共识
+
+### 1. 班次类型
+
+#### 固定班次 (FixedSchedule)
+- 管理后台设置具体出行时间段
+- 每个班次有独立的座位限制
+- 示例：2025-12-01 08:00 出发，2025-12-01 18:00 返回
+
+#### 滚动班次 (RollingSchedule)
+- 按固定频率发车（如每 5 分钟一班）
+- 配置运营时间段和单次座位数
+- 示例：08:00-18:00 运营，每 5 分钟一班，每班 20 座
+
+### 2. 库存管理策略
+
+**方案**: 线路级别库存 + 班次级别座位限制
+
+```
+线路总库存池: 100 张
+├── 固定班次 A (08:00): 座位限制 40 座
+├── 固定班次 B (14:00): 座位限制 40 座  
+└── 滚动班次: 单次座位 20 座
+```
+
+**规则**:
+- ✅ 线路维护总库存池
+- ✅ 固定班次设置座位上限（不能超过线路库存）
+- ✅ 滚动班次按单次座位数消耗库存
+- ✅ 所有班次共享线路库存池
+- ✅ 库存操作需记录日志（锁定、扣减、释放、退还）
+
+### 3. 票种系统
+
+支持多种票种，每种票种价格不同：
+
+| 票种代码 | 票种名称 | 价格策略 | 适用人群 |
+|---------|---------|---------|---------|
+| ADULT | 成人票 | 基准价格 100% | 成年人 |
+| CHILD | 儿童票 | 基准价格 50% | 儿童 |
+| STUDENT | 学生票 | 基准价格 70% | 学生 |
+| SENIOR | 老人票 | 基准价格 80% | 老年人 |
+
+### 4. 座位管理
+
+**明确**: 本系统**不提供座位选择功能**
+- 无需座位号管理
+- 先到先得原则
+- 仅控制总人数
+
+### 5. 购票流程
+
+用户购票时必须选择：
+1. **出行日期** - 具体哪一天出行
+2. **班次** - 选择固定班次或滚动班次
+3. **票种** - 成人/儿童/学生/老人
+4. **购买数量** - 购买张数
+
+### 6. 多租户
+
+**明确**: 系统**不需要考虑多租户**架构
+
+---
+
+## 🏗️ 领域模型
+
+### 核心实体关系
+
+```mermaid
+graph TB
+    subgraph "线路域 Route Domain"
+        R[线路 Route<br/>- 线路编码<br/>- 线路名称<br/>- 起止点<br/>- 总库存]
+        FS[固定班次 FixedSchedule<br/>- 班次编号<br/>- 出发/到达时间<br/>- 座位限制<br/>- 票价配置]
+        RS[滚动班次 RollingSchedule<br/>- 滚动班次编号<br/>- 运营时间段<br/>- 发车间隔<br/>- 单次座位数<br/>- 票价配置]
+        IL[库存日志 InventoryLog<br/>- 操作类型<br/>- 操作数量<br/>- 关联订单]
+        
+        R --> FS
+        R --> RS
+        R --> IL
+    end
+    
+    subgraph "交易域 Trade Domain"
+        O[订单 Order<br/>- 订单号<br/>- 用户编号<br/>- 班次信息<br/>- 票种/数量<br/>- 订单状态<br/>- 金额]
+        P[支付 Payment<br/>- 支付单号<br/>- 支付方式<br/>- 支付状态<br/>- 支付金额]
+        RF[退款 Refund<br/>- 退款单号<br/>- 退款状态<br/>- 退款金额]
+        
+        O --> P
+        O --> RF
+    end
+    
+    subgraph "履约域 Perform Domain"
+        T[凭证 Ticket<br/>- 凭证号<br/>- 订单号<br/>- 票种<br/>- 凭证状态<br/>- 可用日期]
+        V[核销记录 Verification<br/>- 凭证号<br/>- 核销时间<br/>- 核销地点]
+        
+        T --> V
+    end
+    
+    FS -.订购.-> O
+    RS -.订购.-> O
+    O -.生成.-> T
+    
+    style R fill:#e1f5ff
+    style O fill:#fff4e1
+    style T fill:#f0ffe1
+```
+
+---
+
+## 📊 核心实体详细设计
+
+### 1. 线路 (Route)
+
+**表名**: `route`
+
+| 字段 | 类型 | 说明 |
+|-----|------|-----|
+| id | BIGINT | 主键 |
+| route_code | VARCHAR(50) | 线路编码，唯一 |
+| route_name | VARCHAR(200) | 线路名称 |
+| start_point | VARCHAR(100) | 出发地 |
+| end_point | VARCHAR(100) | 目的地 |
+| route_type | VARCHAR(20) | 线路类型：SHORT/MEDIUM/LONG |
+| total_inventory | INT | 总库存数量 |
+| remaining_inventory | INT | 剩余库存数量 |
+| responsible_user | VARCHAR(50) | 责任用户 |
+| status | VARCHAR(20) | 状态：ACTIVE/INACTIVE |
+| create_time | DATETIME | 创建时间 |
+| update_time | DATETIME | 更新时间 |
+| deleted | TINYINT | 逻辑删除标识 |
+
+---
+
+### 2. 固定班次 (FixedSchedule)
+
+**表名**: `fixed_schedule`
+
+| 字段 | 类型 | 说明 |
+|-----|------|-----|
+| id | BIGINT | 主键 |
+| schedule_code | VARCHAR(50) | 班次编号，唯一 |
+| route_code | VARCHAR(50) | 关联线路编码 |
+| departure_time | DATETIME | 出发时间 |
+| arrival_time | DATETIME | 到达时间 |
+| seat_limit | INT | 座位限制 |
+| remaining_seats | INT | 剩余座位 |
+| adult_price | DECIMAL(10,2) | 成人票价 |
+| child_price | DECIMAL(10,2) | 儿童票价 |
+| student_price | DECIMAL(10,2) | 学生票价 |
+| senior_price | DECIMAL(10,2) | 老人票价 |
+| status | VARCHAR(20) | 状态：AVAILABLE/FULL/CANCELLED |
+| create_time | DATETIME | 创建时间 |
+| update_time | DATETIME | 更新时间 |
+| deleted | TINYINT | 逻辑删除标识 |
+
+---
+
+### 3. 滚动班次 (RollingSchedule)
+
+**表名**: `rolling_schedule`
+
+| 字段 | 类型 | 说明 |
+|-----|------|-----|
+| id | BIGINT | 主键 |
+| rolling_schedule_code | VARCHAR(50) | 滚动班次编号，唯一 |
+| route_code | VARCHAR(50) | 关联线路编码 |
+| operation_mode | VARCHAR(20) | 运营模式：FIXED_INTERVAL |
+| operation_start_time | TIME | 运营开始时间 |
+| operation_end_time | TIME | 运营结束时间 |
+| interval_minutes | INT | 发车间隔（分钟） |
+| seats_per_batch | INT | 单次座位数 |
+| adult_price | DECIMAL(10,2) | 成人票价 |
+| child_price | DECIMAL(10,2) | 儿童票价 |
+| student_price | DECIMAL(10,2) | 学生票价 |
+| senior_price | DECIMAL(10,2) | 老人票价 |
+| status | VARCHAR(20) | 状态：ACTIVE/INACTIVE |
+| create_time | DATETIME | 创建时间 |
+| update_time | DATETIME | 更新时间 |
+| deleted | TINYINT | 逻辑删除标识 |
+
+---
+
+### 4. 订单 (Order)
+
+**表名**: `order`
+
+| 字段 | 类型 | 说明 |
+|-----|------|-----|
+| id | BIGINT | 主键 |
+| order_no | VARCHAR(50) | 订单号，唯一 |
+| user_no | VARCHAR(50) | 用户编号 |
+| route_code | VARCHAR(50) | 线路编码 |
+| order_type | VARCHAR(20) | 订单类型：FIXED/ROLLING |
+| schedule_code | VARCHAR(50) | 固定班次编号（固定班次时） |
+| rolling_schedule_code | VARCHAR(50) | 滚动班次编号（滚动班次时） |
+| travel_date | DATE | 出行日期 |
+| ticket_type | VARCHAR(20) | 票种：ADULT/CHILD/STUDENT/SENIOR |
+| quantity | INT | 购买数量 |
+| unit_price | DECIMAL(10,2) | 单价 |
+| original_amount | DECIMAL(10,2) | 原始金额 |
+| actual_amount | DECIMAL(10,2) | 实付金额 |
+| order_status | VARCHAR(20) | 订单状态 |
+| create_time | DATETIME | 创建时间 |
+| expire_time | DATETIME | 支付超时时间 |
+| pay_time | DATETIME | 支付时间 |
+| update_time | DATETIME | 更新时间 |
+| deleted | TINYINT | 逻辑删除标识 |
+
+**订单状态枚举** (OrderStatus):
+- `PENDING_PAYMENT` - 待支付
+- `PAID` - 已支付
+- `COMPLETED` - 已完成
+- `CANCELLED` - 已取消
+- `REFUNDING` - 退款中
+- `REFUNDED` - 已退款
+
+---
+
+### 5. 支付 (Payment)
+
+**表名**: `payment`
+
+| 字段 | 类型 | 说明 |
+|-----|------|-----|
+| id | BIGINT | 主键 |
+| payment_no | VARCHAR(50) | 支付单号，唯一 |
+| order_no | VARCHAR(50) | 关联订单号 |
+| payment_method | VARCHAR(20) | 支付方式：ALIPAY/WECHAT/BANK |
+| payment_amount | DECIMAL(10,2) | 支付金额 |
+| payment_status | VARCHAR(20) | 支付状态 |
+| third_party_no | VARCHAR(100) | 第三方支付流水号 |
+| create_time | DATETIME | 创建时间 |
+| pay_time | DATETIME | 支付完成时间 |
+| update_time | DATETIME | 更新时间 |
+| deleted | TINYINT | 逻辑删除标识 |
+
+---
+
+### 6. 退款 (Refund)
+
+**表名**: `refund`
+
+| 字段 | 类型 | 说明 |
+|-----|------|-----|
+| id | BIGINT | 主键 |
+| refund_no | VARCHAR(50) | 退款单号，唯一 |
+| order_no | VARCHAR(50) | 关联订单号 |
+| payment_no | VARCHAR(50) | 关联支付单号 |
+| refund_amount | DECIMAL(10,2) | 退款金额 |
+| refund_reason | VARCHAR(500) | 退款原因 |
+| refund_status | VARCHAR(20) | 退款状态 |
+| third_party_refund_no | VARCHAR(100) | 第三方退款流水号 |
+| create_time | DATETIME | 创建时间 |
+| refund_time | DATETIME | 退款完成时间 |
+| update_time | DATETIME | 更新时间 |
+| deleted | TINYINT | 逻辑删除标识 |
+
+> **TODO**: 退款详细规则待定
+> - 退款时效限制（出行前多久可退？）
+> - 退款手续费计算规则
+> - 部分退票支持
+> - 库存回退处理
+> - 凭证状态更新
+
+---
+
+### 7. 凭证 (Ticket)
+
+**表名**: `ticket`
+
+| 字段 | 类型 | 说明 |
+|-----|------|-----|
+| id | BIGINT | 主键 |
+| ticket_no | VARCHAR(50) | 凭证号，唯一 |
+| order_no | VARCHAR(50) | 关联订单号 |
+| route_code | VARCHAR(50) | 线路编码 |
+| schedule_info | VARCHAR(200) | 班次信息（具体时间） |
+| ticket_type | VARCHAR(20) | 票种 |
+| ticket_status | VARCHAR(20) | 凭证状态 |
+| issue_time | DATETIME | 出票时间 |
+| usable_date | DATE | 可用日期 |
+| verification_time | DATETIME | 核销时间 |
+| create_time | DATETIME | 创建时间 |
+| update_time | DATETIME | 更新时间 |
+| deleted | TINYINT | 逻辑删除标识 |
+
+**凭证状态枚举** (TicketStatus):
+- `UNUSED` - 未使用
+- `USED` - 已使用
+- `REFUNDED` - 已退票
+- `EXPIRED` - 已过期
+
+---
+
+### 8. 核销记录 (TicketVerification)
+
+**表名**: `ticket_verification`
+
+| 字段 | 类型 | 说明 |
+|-----|------|-----|
+| id | BIGINT | 主键 |
+| ticket_no | VARCHAR(50) | 凭证号 |
+| verification_time | DATETIME | 核销时间 |
+| verification_location | VARCHAR(100) | 核销地点 |
+| operator | VARCHAR(50) | 操作人 |
+| create_time | DATETIME | 创建时间 |
+| deleted | TINYINT | 逻辑删除标识 |
+
+---
+
+### 9. 库存日志 (InventoryLog)
+
+**表名**: `inventory_log`
+
+| 字段 | 类型 | 说明 |
+|-----|------|-----|
+| id | BIGINT | 主键 |
+| route_code | VARCHAR(50) | 线路编码 |
+| operation_type | VARCHAR(20) | 操作类型：LOCK/DEDUCT/RELEASE/REFUND |
+| related_order_no | VARCHAR(50) | 关联订单号 |
+| quantity | INT | 操作数量 |
+| before_amount | INT | 操作前库存 |
+| after_amount | INT | 操作后库存 |
+| operation_time | DATETIME | 操作时间 |
+| operator | VARCHAR(50) | 操作人 |
+| remark | VARCHAR(500) | 备注 |
+| create_time | DATETIME | 创建时间 |
+| deleted | TINYINT | 逻辑删除标识 |
+
+**操作类型枚举** (OperationType):
+- `LOCK` - 锁定库存（下单时）
+- `DEDUCT` - 扣减库存（支付成功）
+- `RELEASE` - 释放库存（订单取消/超时）
+- `REFUND` - 退还库存（退款成功）
+
+---
+
+## 🔄 核心业务流程
+
+### 购票流程
+
+```mermaid
+sequenceDiagram
+    participant U as 用户
+    participant TC as Trade Controller
+    participant TS as Trade Service
+    participant RS as Route Service
+    participant MQ as RocketMQ
+    participant PS as Perform Service
+    
+    U->>TC: 1. 创建订单请求
+    TC->>TS: 2. 处理订单
+    
+    rect rgb(240, 248, 255)
+        Note over TS: LiteFlow 流程编排
+        TS->>TS: 3. 参数校验
+        TS->>RS: 4. 检查线路库存
+        RS-->>TS: 库存充足
+        TS->>RS: 5. 锁定库存
+        RS->>RS: 记录库存日志(LOCK)
+        RS-->>TS: 锁定成功
+        TS->>TS: 6. 创建订单(PENDING_PAYMENT)
+    end
+    
+    TS-->>U: 7. 返回订单信息
+    
+    U->>TC: 8. 支付订单
+    TC->>TS: 9. 处理支付
+    TS->>TS: 10. 更新订单状态(PAID)
+    TS->>RS: 11. 扣减库存
+    RS->>RS: 记录库存日志(DEDUCT)
+    TS->>MQ: 12. 发送支付成功消息
+    
+    MQ->>PS: 13. 监听支付成功
+    PS->>PS: 14. 生成电子凭证
+    PS-->>U: 凭证生成完成
+```
+
+### 核销流程
+
+```mermaid
+sequenceDiagram
+    participant D as 检票设备/APP
+    participant PS as Perform Service
+    
+    D->>PS: 1. 扫描凭证号
+    PS->>PS: 2. 查询凭证信息
+    
+    alt 凭证状态 = UNUSED
+        PS->>PS: 3. 更新凭证状态(USED)
+        PS->>PS: 4. 记录核销日志
+        PS-->>D: ✅ 核销成功
+    else 凭证状态 = USED
+        PS-->>D: ❌ 凭证已使用
+    else 凭证状态 = REFUNDED
+        PS-->>D: ❌ 凭证已退票
+    else 凭证状态 = EXPIRED
+        PS-->>D: ❌ 凭证已过期
+    end
+```
+
+### 订单超时取消流程
+
+```mermaid
+sequenceDiagram
+    participant T as 定时任务
+    participant TS as Trade Service
+    participant RS as Route Service
+    
+    T->>TS: 1. 扫描超时订单
+    TS->>TS: 2. 查询 PENDING_PAYMENT 订单
+    
+    loop 每个超时订单
+        TS->>TS: 3. 更新订单状态(CANCELLED)
+        TS->>RS: 4. 释放库存
+        RS->>RS: 5. 记录库存日志(RELEASE)
+    end
+```
+
+---
+
+## 📋 业务规则清单
+
+### 库存规则
+1. ✅ 线路总库存 ≥ 所有固定班次座位限制之和
+2. ✅ 下单时先锁定库存，支付成功后扣减库存
+3. ✅ 订单取消/超时，释放已锁定库存
+4. ✅ 退款成功，退还已扣减库存
+5. ✅ 所有库存操作必须记录日志
+
+### 订单规则
+1. ✅ 订单创建后 30 分钟内未支付自动取消
+2. ✅ 订单状态流转：待支付 → 已支付 → 已完成
+3. ✅ 订单支付后才能生成凭证
+4. ✅ 一个订单对应多张凭证（根据购买数量）
+
+### 凭证规则
+1. ✅ 凭证号全局唯一
+2. ✅ 凭证绑定出行日期和班次信息
+3. ✅ 未使用的凭证才能核销
+4. ✅ 凭证核销后不可重复使用
+
+### 票种规则
+1. ✅ 每个班次配置各票种价格
+2. ✅ 一个订单只能购买一种票种
+3. ✅ 票种价格独立设置，不强制比例
+
+---
+
+## 🎨 枚举类型定义
+
+### OrderTypeEnum (订单类型)
+```java
+FIXED("FIXED", "固定班次订单"),
+ROLLING("ROLLING", "滚动班次订单");
+```
+
+### TicketTypeEnum (票种类型)
+```java
+ADULT("ADULT", "成人票"),
+CHILD("CHILD", "儿童票"),
+STUDENT("STUDENT", "学生票"),
+SENIOR("SENIOR", "老人票");
+```
+
+### OrderStatusEnum (订单状态)
+```java
+PENDING_PAYMENT("PENDING_PAYMENT", "待支付"),
+PAID("PAID", "已支付"),
+COMPLETED("COMPLETED", "已完成"),
+CANCELLED("CANCELLED", "已取消"),
+REFUNDING("REFUNDING", "退款中"),
+REFUNDED("REFUNDED", "已退款");
+```
+
+### TicketStatusEnum (凭证状态)
+```java
+UNUSED("UNUSED", "未使用"),
+USED("USED", "已使用"),
+REFUNDED("REFUNDED", "已退票"),
+EXPIRED("EXPIRED", "已过期");
+```
+
+### OperationTypeEnum (库存操作类型)
+```java
+LOCK("LOCK", "锁定库存"),
+DEDUCT("DEDUCT", "扣减库存"),
+RELEASE("RELEASE", "释放库存"),
+REFUND("REFUND", "退还库存");
+```
+
+---
+
+## 🚀 后续待办事项
+
+### 业务规则待明确
+- [ ] 退款时效规则（出行前多久可退？）
+- [ ] 退款手续费计算规则
+- [ ] 是否支持部分退票
+- [ ] 凭证有效期规则
+- [ ] 库存预警机制
+
+### 技术实现待补充
+- [ ] 分布式锁实现（防止超卖）
+- [ ] 定时任务实现（订单超时取消）
+- [ ] 消息幂等性处理
+- [ ] 分布式事务处理方案
+
+---
+
+> **文档维护**: 本文档应随业务演进持续更新  
+> **最后审核**: 2025-12-01  
+> **审核状态**: ✅ 业务方案已确认