# 小程序核心业务交付说明

## 一、本轮交付范围

本轮已完成以下小程序核心业务模块的正式化落地：

- `route` 路线规划
- `leisure` 休闲玩乐
- `culture` 文旅活动
- `explain` 游览讲解
- `heritage` 非遗文化
- `study` 研学团建
- `member-invoice` 发票申请

交付目标：

- 主数据不再依赖纯前端 mock
- 小程序列表 / 详情走正式后端
- 提交预约 / 报名走正式业务单
- 成功页支持按 `orderId` 回查
- 全局搜索 `search/global` 可命中核心业务
- 后台至少具备主数据维护和业务单查询入口
- 会员可对订单发起发票申请，后台可审核并回填附件

---

## 二、后端交付结果

### 1. 已新增正式业务模块

- `business-route`
- `business-culture`

### 2. 已扩展现有正式模块

- `business-guide`
  - 补齐 `explain` / `heritage` 主数据 payload
  - 补齐 `app_explain_booking_order`
  - 补齐 `app_heritage_booking_order`
- `business-study`
  - 补齐 `StudyProgramPayloadVO`
  - 补齐 `app_study_booking_order`
- `business-member`
  - 补齐 `app_member_invoice_apply`
  - 补齐发票申请后台审核与移动端申请
  - 补齐发票申请模拟数据脚本

### 3. 已打通移动端网关接口

以下接口现已走正式业务模块：

- `GET /route/plans`
- `GET /route/plan/{id}`
- `POST /route/trip/create`
- `GET /route/trip/result/{orderId}`

- `GET /culture/activities`
- `GET /culture/activity/{id}`
- `POST /culture/activity/enroll`
- `GET /culture/activity/enroll/result/{id}`

- `GET /explain/spots`
- `GET /explain/spot/{id}`
- `POST /explain/booking/create`
- `GET /explain/booking/result/{orderId}`

- `GET /heritage/culture-products`
- `GET /heritage/culture-product/{id}`
- `GET /heritage/projects`
- `GET /heritage/project/{id}`
- `POST /heritage/booking/create`
- `GET /heritage/booking/result/{orderId}`

- `GET /study/programs`
- `GET /study/program/{id}`
- `POST /study/booking/create`
- `GET /study/booking/result/{orderId}`

- `POST /member/invoiceApply/create`
- `GET /member/invoiceApply/result/{id}`
- `GET /member/invoiceApply/order/{orderId}`

### 4. 搜索聚合

`GET /search/global`

当前已切正式数据的业务域：

- `route`
- `leisure`
- `study`
- `explain`
- `heritage`
- `culture`

---

## 三、前端交付结果

### 1. 小程序端

以下页面已接入正式提交流程与结果回查：

- `pages/route/detail`
- `pages/route/success`
- `pages/activity/detail`
- `pages/activity/success`
- `pages/explain/book`
- `pages/explain/success`
- `pages/heritage/book`
- `pages/heritage/success`
- `pages/study/book`
- `pages/study/success`
- `pages/invoice/apply`
- `pages/invoice/result`

### 2. 管理端

主数据维护页已存在或已补齐：

- 路线：线路 / 站点 / 行程单
- 活动：活动管理
- 讲解：讲解点 / 音轨 / 讲解套餐
- 非遗：文创 / 项目 / 体验套餐
- 研学：方案 / 套餐

业务单最小查询页已补齐：

- 活动报名单
- 讲解预约单
- 非遗预约单
- 研学预约单
- 发票申请单

说明：

- 当前业务单后台页是“最小查询版”，可用于联调验证与排障。
- 还不是完整分页运营台。

---

## 四、数据库与脚本

### 1. 已新增或补充的核心脚本

- `business-route/route_schema.sql`
- `business-route/route_seed.sql`
- `business-route/route_menu_permission.sql`

- `business-culture/culture_schema.sql`
- `business-culture/culture_menu_permission.sql`

- `business-guide/guide_schema.sql`
- `business-guide/guide_menu_permission.sql`

- `business-study/src/main/resources/sql/study.sql`
- `business-study/study_menu_permission.sql`

### 2. 已补全 mapper.xml

`jeesharp-business` 下原先空壳的 `mapper.xml` 已全部补齐，当前复扫为 `0` 个空壳文件。

---

## 五、已完成的技术收口

- `MiniAppExperienceSupportService` 已明显瘦身
- 已删除一批被正式模块替代的 mock 提交 / 结果逻辑
- 已清理移动端 controller 中无用的 `MiniAppExperienceSupportService` 依赖
- 已补齐各模块最小标准 CRUD `mapper.xml`

---

## 六、当前已知状态

当前可以认为本轮核心链路已全部正式闭环：

- `route`
- `leisure`
- `culture`
- `explain`
- `heritage`
- `study`

---

## 七、剩余可选优化项

以下内容不是当前交付阻塞项，但值得作为下一阶段优化：

### 1. 后台业务单分页管理台

目前 `culture/explain/heritage/study` 业务单后台页仍以最小查询版为主。

建议补齐：

- `list`
- `info`
- 标准 `pro-table`
- 权限按钮

### 2. 统一交易域深度联动

建议继续推进：

- `trade_order_id` 真实挂单
- 支付状态联动
- 取消 / 退款 / 过期
- 状态流转日志

### 3. Support Service 继续瘦身

`MiniAppExperienceSupportService` 仍保留少量搜索托底与演示初始化逻辑。

建议最终收口为：

- 只保留确实尚未正式化的辅助能力
- 或拆分为单独的 `demo support` 组件

### 4. 编译与质量门禁

建议单独推进：

- Maven 全量编译验证
- 管理端 `vue-tsc` / 构建验证
- 联调冒烟脚本

---

## 八、推荐下一步

如果进入下一阶段，推荐顺序：

1. 业务单后台分页管理台完善
2. 统一交易域联动
3. `MiniAppExperienceSupportService` 终极瘦身
4. 编译与联调门禁建设
