小程序核心业务交付说明

一、本轮交付范围

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

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 / 构建验证
联调冒烟脚本

八、推荐下一步

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

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

DELIVERY_SUMMARY.md 5.2 KB Permalink Lịch sử Raw