主题
功能模块划分
本文档按用户可理解的业务功能划分「携岛 / XieDao」系统，作为后续编写功能设计文档和使用手册的统一目录。 本文描述系统“提供什么功能”，不作为后端包结构、Maven 模块或微服务拆分依据。
1. 文档目标
本次功能划分用于：
- 明确系统的一级、二级功能，避免后续文档遗漏或重复。
- 明确每项功能的使用角色和操作终端。
- 为功能设计文档提供统一编号和章节顺序。
- 为各终端使用手册建立功能与页面的对应关系。
- 区分可操作功能、系统自动功能、配置后可用能力和暂未实现能力。
后续文档分为两类：
- 功能设计文档：按本文的 12 个业务模块编写，重点描述流程、状态、规则、权限和异常。
- 使用手册：按用户端小程序、商户端小程序、商户 Web、平台管理端分别编写，重点描述入口和操作步骤。
2. 系统终端与角色
系统由同一 Git 仓库中的 5 个子项目组成：
| 子项目 | 终端 | 主要角色 | 主要用途 |
|---|---|---|---|
| Api/ | 后端服务 | 所有终端、系统任务 | 统一提供业务接口和自动任务 |
| AdminWeb/ | 平台管理端 | 平台管理员、运营、审核、财务人员 | 平台运营、审核、监管和系统管理 |
| MerchantWeb/ | 商户 Web | 商户负责人、商户运营人员 | 商品、订单、活动、财务和设置管理 |
| App/ | 用户端微信小程序 | 终端消费者 | 浏览、下单、支付、履约、售后和社区互动 |
| MerchantApp/ | 商户端微信小程序 | 商户、商户员工、司机 | 移动接单、核销、调度、发货和经营查看 |
功能文档统一使用以下角色名称：
| 角色 | 说明 |
|---|---|
| 消费者 | 使用用户端小程序购买商品或服务的用户 |
| 商户负责人 | 负责入驻、资料、商品、经营和财务的商户账号 |
| 商户员工 | 执行接单、核销、发货、售后等日常工作的人员 |
| 司机 | 在商户端小程序中执行租车或接送调度任务的人员 |
| 平台运营 | 维护商品、营销、内容和首页配置的人员 |
| 平台审核 | 审核商户、商品、内容及售后事项的人员 |
| 平台财务 | 管理钱包、提现、结算规则和财务检查的人员 |
| 系统管理员 | 管理账号、角色、菜单、字典、配置和系统监控的人员 |
3. 一级功能模块
| 编号 | 模块 | 核心职责 | 主要角色 |
|---|---|---|---|
| F01 | 账户与用户 | 登录认证、用户资料、常用信息和用户管理 | 消费者、商户、平台人员 |
| F02 | 商户入驻与管理 | 入驻申请、资质审核、商户资料和经营能力 | 商户负责人、平台审核 |
| F03 | 商品与供应 | 商品资料、价格、库存、房态、上下架和商品审核 | 消费者、商户、平台运营 |
| F04 | 营销活动 | 优惠券、团购、拼团、促销活动和热销推荐 | 消费者、商户、平台运营 |
| F05 | 订单交易 | 确认订单、创建订单、合并支付和订单状态管理 | 消费者、商户、平台人员 |
| F06 | 支付与退款 | 微信支付、钱包抵扣、支付结果和退款资金处理 | 消费者、平台财务、系统 |
| F07 | 履约管理 | 预约、接单、核销、调度、发货、收货和履约确认 | 消费者、商户员工、司机 |
| F08 | 售后服务 | 售后申请、退款计算、审核、超时和进度查询 | 消费者、商户、平台审核 |
| F09 | 商户财务 | 商户收入、冻结、结算、钱包、提现、罚款和保证金 | 商户负责人、平台财务 |
| F10 | 内容与社区 | 游记、话题、互动、关注、旅游攻略和内容审核 | 消费者、商户、平台运营 |
| F11 | 消息与通知 | 即时消息、订单通知、商户广播、短信和系统通知 | 所有角色、系统 |
| F12 | 平台运营与系统 | 首页配置、基础数据、看板、自动对账、权限和监控 | 平台人员、系统管理员 |
4. 二级功能划分
F01 账户与用户
功能范围
- 消费者微信授权登录、手机号获取、退出登录。
- 商户账号登录、密码管理和登录状态维护。
- 平台账号登录、验证码、退出登录和令牌管理。
- 消费者个人资料、常用游客、收货地址和账户状态。
- 平台端用户查询、状态管理、角色和数据权限。
主要终端：用户端小程序、商户端小程序、商户 Web、平台管理端。
文档边界：优惠券和钱包分别归入 F04、F06；社区关注关系的业务操作归入 F10。
F02 商户入驻与管理
功能范围
- 商户入驻申请、资料填写和申请进度查询。
- 主体信息、经营资质和证件材料维护。
- 平台审核、驳回、重新提交和商户状态管理。
- 商户经营类型、菜单和功能权限配置。
- 商户资料变更、经营地址变更和通知管理。
- 入驻保证金要求及缴纳状态展示。
主要终端：商户端小程序、商户 Web、平台管理端。
文档边界：商户结算银行卡、钱包、收入、提现和保证金流水归入 F09。
F03 商品与供应
商品与供应按业务类型划分为 8 个二级模块：
| 编号 | 业务类型 | 主要功能 |
|---|---|---|
| F03-01 | 酒店住宿 | 酒店资料、房型、房态日历、价格和审核 |
| F03-02 | 租车 | 车型、车辆、租赁价格、增值服务和可售状态 |
| F03-03 | 接送服务 | 路线、包车、出租车价格、服务区域和可售配置 |
| F03-04 | 旅拍 | 摄影套餐、服务内容、价格和可售状态 |
| F03-05 | 物品租赁 | 租赁商品、押金、价格、库存和租赁规则 |
| F03-06 | 商城 | 商品、SKU、分类、价格、库存和上下架 |
| F03-07 | 套餐 | 固定套餐、组合明细、行程、价格日历和折扣规则 |
| F03-08 | 定制游 | 定制游案例、线路、阶段、需求和报价 |
公共功能
- 商品分类、基础资料、图片和详情维护。
- 平台自营、商户经营及平台代运营等经营模式。
- 商品提交、审核、驳回、重新提交、上下架和热销展示。
- 价格日历、库存日历和月度日历提交审核。
- 用户端商品列表、搜索、筛选和详情展示。
主要终端：用户端小程序、商户端小程序、商户 Web、平台管理端。
文档边界：购买流程归入 F05；接单、调度、核销和发货归入 F07；退款规则归入 F08。
F04 营销活动
功能范围
- 优惠券模板、领取、发放、赠送、券包和新人礼包。
- 优惠券适用范围、使用门槛、有效期和商户承担规则。
- 团购、多人团购、拼团和活动商品。
- 商品促销、活动价格、活动库存和活动状态管理。
- 热销推荐和营销落地页。
- 下单时优惠试算、优惠分摊、占用、核销和退还。
主要终端：用户端小程序、商户 Web、平台管理端。
文档边界：首页 Banner、首页 Tab 和导航配置归入 F12；营销形成的订单归入 F05。
F05 订单交易
功能范围
- 购物车及商城商品加购。
- 各业务类型的订单确认和价格试算。
- 单订单、组合订单及合并支付关系。
- 商品金额、优惠金额、钱包抵扣、附加费和应付金额计算。
- 创建订单、待支付超时取消和用户主动取消。
- 消费者、商户和平台的订单列表、详情及筛选。
- 订单状态、订单事件、支付后处理和业务完成。
- 不同业务类型订单的公共展示状态。
主要终端：用户端小程序、商户端小程序、商户 Web、平台管理端。
文档边界：资金支付归入 F06；具体业务履约归入 F07；退款申请归入 F08；商户入账归入 F09。
F06 支付与退款
功能范围
- 微信支付预下单、小程序调起支付和支付结果查询。
- 单订单支付和多订单合并支付。
- 用户钱包抵扣及微信、钱包渠道金额记录。
- 支付回调验签、支付结果更新、重复回调幂等处理。
- 支付订单查询、关闭和异常补偿。
- 审核通过后的微信退款、钱包退款、退款回调和失败重试。
- 微信支付分订单创建、查询、完结和取消。
主要终端：用户端小程序；部分状态由系统自动处理。
当前限制
- 微信平台直连支付已经实现，但开发环境可通过配置关闭。
- 微信支付分默认使用 Mock 模式，正式使用依赖真实商户配置。
- 微信服务商利润分账尚无业务实现，不作为已交付的可操作功能编写。
文档边界：是否允许退款、退款金额和审核流程归入 F08；退款后的商户收入冲减归入 F09。
F07 履约管理
功能范围
- 酒店预约、入住相关状态和履约确认。
- 商户接单、订单核销和扫码核销。
- 租车、接送、旅拍和物品租赁的调度任务。
- 司机、车辆、服务时间和调度状态管理。
- 商城订单批量发货、物流单号、物流查询和确认收货。
- 微信交易发货信息上传及履约状态同步。
- 微信支付分履约完结。
- 履约超时、异常任务和人工处理入口。
主要终端：商户端小程序、商户 Web、用户端小程序、平台管理端。
文档边界：履约前的订单状态归入 F05；履约争议和退款申请归入 F08。
F08 售后服务
功能范围
- 用户退款申请、退款原因、退款范围和凭证。
- 不同商品类型的退款资格判断和退款政策提示。
- 退款政策、时间阶梯、手续费和不可退规则。
- 整单退款、部分退款和套餐子项退款计算。
- 商户审核、平台审核、同意、拒绝和审核记录。
- 自动审核超时、退款任务重试和人工处理。
- 退款快照、商户分摊、退款进度和结果展示。
- 商城售后和退款商品处理。
主要终端：用户端小程序、商户端小程序、商户 Web、平台管理端。
文档边界：售后模块决定“退不退、退多少”；F06 负责“通过什么渠道把钱退回”。
F09 商户财务
功能范围
- 商户收入明细、订单收入和活动分摊结果。
- 商户钱包冻结、待结算、可用余额及账本流水。
- 订单完成后的结算计划、结算周期和自动释放。
- 微信履约状态、物流同步状态对结算的影响。
- 提现申请、银行卡、提现审核和提现记录。
- 商户罚款、罚款申诉和处理历史。
- 入驻保证金账户、保证金流水和有效状态。
- 平台结算规则和不同活动类型的结算周期配置。
主要终端：商户端小程序、商户 Web、平台管理端；部分结算由系统自动执行。
当前限制：当前“结算”指系统内部的商户收入记账和余额释放，不等同于微信服务商利润分账。
F10 内容与社区
功能范围
- 游记/笔记列表、详情、发布、草稿和编辑。
- 图片、文本内容及关联商品展示。
- 话题、评论、点赞、收藏和关注。
- 用户主页、关注关系和互动统计。
- 推荐内容、商户内容和社区展示。
- 旅游攻略列表、详情及关联商品。
- 平台内容审核、状态管理和违规处理。
- 阿里云内容审核和 OCR 辅助能力。
主要终端：用户端小程序、商户端小程序、平台管理端。
F11 消息与通知
功能范围
- 用户、商户和平台人员的即时消息账号及凭证。
- 用户与商户之间的会话、历史消息和未读状态。
- 新订单、取消、售后、罚款等业务通知。
- 商户广播通知、入驻通知和系统通知。
- 短信场景、短信发送、验证码和发送日志。
- 消息失败记录和必要的重试处理。
主要终端：四个前端终端；部分消息由系统自动发送。
命名说明：当前系统提供 IM、短信和业务通知能力，尚未形成完整的客服工单系统，因此本模块不命名为“客服中心”。
F12 平台运营与系统
运营功能
- 首页 Banner、首页 Tab、导航和展示分组。
- 地区、位置区域、商品类目及其他基础数据。
- 平台数据看板、商户统计、订单统计和经营统计。
- 平台钱包、用户钱包和异常资金记录查看。
- 微信交易账单自动下载及系统自动对账。
- 待办事项和运营提醒。
系统管理功能
- 平台用户、部门、岗位、角色、菜单和数据权限。
- 字典、参数、通知公告和系统配置。
- 登录日志、操作日志、在线用户和缓存监控。
- 服务监控、数据源监控、定时任务和代码生成工具。
主要终端：平台管理端。
当前限制：微信账单对账目前是后台自动任务，AdminWeb 没有独立的对账操作页面；使用手册只描述其自动运行和异常处理方式，不描述不存在的菜单操作。
5. 主要业务流程与模块关系
5.1 消费者购买流程
账户登录（F01）
-> 浏览商品/服务（F03）
-> 领取或选择优惠（F04）
-> 确认并创建订单（F05）
-> 微信支付/钱包抵扣（F06）
-> 商户履约（F07）
-> 订单完成（F05）
-> 商户收入结算（F09）
5.2 商户入驻经营流程
商户注册登录（F01）
-> 提交入驻申请（F02）
-> 平台审核（F02）
-> 维护商品和价格库存（F03）
-> 参与营销活动（F04）
-> 接收订单并履约（F05/F07）
-> 查看收入并申请提现（F09）
5.3 售后退款流程
用户发起售后申请（F08）
-> 系统计算退款资格和金额（F08）
-> 商户/平台审核（F08）
-> 微信及钱包退款（F06）
-> 更新订单状态（F05）
-> 冲减或调整商户收入（F09）
-> 发送处理结果通知（F11）
5.4 内容互动流程
用户/商户发布内容（F10）
-> 内容审核（F10）
-> 社区展示与互动（F10）
-> 关联商品或攻略（F03/F10）
-> 发送互动通知（F11）
6. 功能状态表达规范
后续文档必须使用以下状态，避免把代码占位、配置项或后台任务写成完整用户功能：
| 状态 | 含义 | 使用要求 |
|---|---|---|
| 已实现 | 已有页面或接口，并存在完整业务处理 | 可以写入功能设计和使用手册 |
| 系统自动 | 由回调、事件或定时任务执行，无人工页面 | 功能设计说明触发条件；使用手册不虚构入口 |
| 配置后可用 | 代码已实现，但依赖微信、阿里云、OpenIM 等外部配置 | 明确环境和配置前提 |
| 默认模拟 | 默认返回模拟结果，未默认连接正式能力 | 明确标注 Mock，不描述为正式生产能力 |
| 暂未实现 | 仅有配置、接口、注释或规划，没有完整业务实现 | 只能放入限制或后续规划 |
当前需要特别标注的能力：
| 功能 | 状态 | 说明 |
|---|---|---|
| 微信平台直连支付 | 配置后可用 | 开发环境可关闭，正式使用依赖商户参数和证书 |
| 微信支付分 | 默认模拟 | 默认 mock-mode=true |
| 微信服务商利润分账 | 暂未实现 | 有配置痕迹，但没有完整 Java 业务实现 |
| 商户内部收入结算 | 系统自动 | 已有结算计划、冻结和余额释放逻辑 |
| 微信账单交易对账 | 系统自动 | 已有后台任务，暂无 AdminWeb 独立操作页面 |
| OpenIM 即时消息 | 配置后可用 | 依赖自托管 OpenIM 服务 |
| 阿里云短信、OSS、内容审核 | 配置后可用 | 依赖对应阿里云参数和服务状态 |
7. 功能设计文档编写规范
当前功能设计集中编写在 Docs/功能设计说明书.md 中，并按 F01 至 F12 设置独立章节。集中编写便于完整阅读跨模块流程，也避免初期产生大量内容很少的文件。
后续某个模块内容明显增多或需要独立维护时，可以拆分为“Fxx-模块名称.md”，总说明书保留摘要和链接，功能编号保持不变。
每份功能设计文档统一使用以下章节：
- 功能概述。
- 使用角色与权限。
- 前置条件。
- 页面和接口入口。
- 主业务流程。
- 状态及状态流转。
- 业务规则和计算规则。
- 数据输入与输出。
- 异常、边界和幂等处理。
- 消息、短信和自动任务。
- 与其他模块的关系。
- 当前限制。
功能设计文档描述业务事实，不大段复制 Java 类、数据库字段或接口源码。代码路径只放在“实现参考”附录中，便于维护人员核对。
8. 使用手册编写规划
当前使用手册集中编写在 Docs/系统使用手册.md 中。使用手册不按 12 个模块机械拆分，而是按终端和用户任务组织；后续需要单独交付给不同用户群体时，再从总手册拆分对应章节。
8.1 用户端小程序使用手册
- 登录、个人资料和常用信息。
- 首页、搜索和商品浏览。
- 酒店、租车、接送、旅拍、租赁、商城、套餐和定制游下单。
- 优惠券、活动和钱包使用。
- 订单确认、支付和订单查询。
- 预约、核销、收货等履约操作。
- 售后申请和退款进度。
- 社区、攻略、收藏、关注和消息。
8.2 商户端小程序使用手册
- 登录、入驻和资料维护。
- 工作台、待办和经营数据。
- 商品、价格和库存维护。
- 接单、核销、调度和发货。
- 售后申请处理。
- 收入、结算、提现和银行卡。
- 内容发布、通知和消息。
- 司机模式及调度任务。
8.3 商户 Web 使用手册
- 登录和商户设置。
- 商品、房型和价格日历。
- 活动和营销配置。
- 订单、履约和售后。
- 财务、收入和提现。
- 数据统计、消息和通知。
8.4 平台管理端使用手册
- 平台登录、账号、角色和权限。
- 商户入驻、资料和经营状态审核。
- 商品、价格日历和经营内容审核。
- 营销、优惠券和首页配置。
- 订单、履约和售后监管。
- 商户财务、钱包、提现、罚款和结算规则。
- 社区、攻略、短信和通知管理。
- 地区、类目、字典、参数和系统监控。
9. 文档追踪规则
- 每个功能使用本文定义的 Fxx 或 Fxx-xx 编号。
- 功能设计文档记录涉及的角色和终端。
- 使用手册在操作章节中标注对应功能编号。
- 一个业务规则只在对应功能设计文档中完整定义，其他文档使用链接引用。
- 自动任务和回调必须明确写成“系统自动”，不能编造页面入口。
- 暂未实现或默认 Mock 的能力必须出现在“当前限制”，不能写成已交付功能。
- 页面名称和菜单名称以实际前端显示为准；代码类名只用于开发维护附录。
划分依据：对 Api/、AdminWeb/、MerchantWeb/、App/、MerchantApp/ 当前代码、页面和配置的核对，更新时间为 2026-08-31。