hfb_sys/docs/快手小店应用申请MRD_PRD.md

快手小店应用服务 MRD/PRD

1. 开发者公司介绍

a) 公司体量、人员数量

本应用由自研技术团队开发和维护，团队具备前后端开发、产品运营、客服处理和系统运维能力。系统已完成商品发布、订单履约、商家交接、买家确认、售后争议、后台管理等核心能力建设。

公司主体、人员数量、联系方式等信息请按实际情况补充。

b) 公司提供的所有服务应用

目前主要提供虚拟商品/服务类订单履约系统，包含商家商品管理、订单管理、商家发码、买家确认、核销记录、客服介入、证据上传和后台审计等服务。

2. 应用服务在其他平台表现

a) 使用用户数量、活跃用户量、留存率等

当前应用处于自研和业务验证阶段，已完成核心业务流程搭建。

b) 销售价格报表

• 目前为商家自研自用,无需价格相关

3. 应用服务功能简介

a) 功能介绍

本应用面向快手小店商家，主要解决虚拟服务、数字权益、预约服务等订单的发码和核销问题。

核心功能包括：

• 同步快手小店订单。
• 商家在订单支付后发码或提交交接说明。
• 买家查看发码内容并确认收到。
• 商家根据订单或核销码完成核销。
• 保存发码、确认、核销和售后处理记录。
• 支持客服查看订单、交接记录、证据附件和操作日志。

b) 功能使用流程

1. 买家在快手小店下单并完成支付。
2. 应用同步订单信息，生成待发码订单。
3. 商家进入后台，对订单填写服务码、交接说明或履约信息。
4. 买家查看发码内容并确认收到。
5. 买家使用服务时出示订单或核销码。
6. 商家核验后完成核销。
7. 如出现售后问题，客服可查看全链路记录并处理。

4. 应用服务功能详述

a) 详细介绍功能点

1. 订单管理
   商家可查看快手订单状态，筛选待发码、待核销、已完成、售后中订单。

2. 商家发码
   商家可对已支付订单填写服务码、预约码、账号交接说明或其他履约内容，并保存发码记录。

3. 买家确认
   买家收到服务信息后，可确认已收到，系统记录确认时间和订单状态。

4. 商家核销
   商家输入或扫描核销码，系统校验订单是否已支付、是否已发码、是否重复核销、是否存在售后。校验通过后完成核销。

5. 履约留痕
   系统保存发码记录、核销记录、聊天记录、证据附件和客服处理记录，方便后续查询。

6. 售后处理
   如订单出现异常，客服可查看订单详情、发码内容、核销状态和证据材料，并进行处理。

b) 系统主要功能截图

提交前建议补充以下全景截图：

• 商家订单列表页。
• 订单详情页。
• 商家发码页面。
• 商家核销页面。
• 售后/客服处理页面。
• 后台审计日志页面。

c) 系统子功能截图

提交前建议补充以下全景截图：

• 订单筛选功能。
• 发码内容填写功能。
• 买家确认功能。
• 核销成功/失败提示。
• 证据上传功能。
• 操作日志详情。

5. 应用服务实现机制

a) 服务数据层

系统后端使用 Go + Gin，数据库使用 MySQL，文件存储使用对象存储，前端使用 Vue 3 + TypeScript。

主要数据包括：

• 商家/买家用户信息。
• 快手订单映射信息。
• 发码记录。
• 核销记录。
• 售后和争议记录。
• 文件证据。
• 后台操作审计日志。

b) 服务业务流层

业务流程为：

快手订单支付成功 -> 应用同步订单 -> 商家发码 -> 买家确认 -> 商家核销 -> 订单完成。

异常流程为：

订单售后中或退款中 -> 暂停核销 -> 客服查看证据 -> 处理售后结果 -> 恢复或关闭订单。

c) 服务接口调用

系统会调用快手开放平台接口完成订单同步、订单状态回调、履约状态反馈和核销状态反馈。内部接口用于商家发码、买家确认、商家核销、记录查询和后台审核。

6. 应用服务对接接口和反馈字段

a) 具体接口调用和字段反馈

拟对接能力：

• 店铺授权接口：获取商家店铺授权。
• 订单查询接口：同步订单号、商品、SKU、支付状态、售后状态。
• 订单回调接口：接收支付成功、关闭、退款、售后变更。
• 履约反馈接口：商家发码后反馈发码状态。
• 核销反馈接口：商家核销后反馈核销结果。

主要字段：

• shop_id：店铺 ID。
• order_id：快手订单 ID。
• item_id：商品 ID。
• sku_id：SKU ID。
• order_status：订单状态。
• pay_time：支付时间。
• delivery_status：发码状态。
• verify_code：核销码。
• verify_status：核销状态。
• verify_time：核销时间。

b) 回调地址、回调原因

正式域名待补充，建议配置：

• POST https://{正式域名}/api/open/kuaishou/callbacks/order：订单支付、关闭、状态变化回调。
• POST https://{正式域名}/api/open/kuaishou/callbacks/after-sale：退款、售后状态变化回调。
• POST https://{正式域名}/api/open/kuaishou/callbacks/verify：核销状态变化回调。

回调处理会进行签名校验、幂等判断、状态更新和日志记录。

7. 应用服务服务市场信息

a) 应用 icon 图

待补充。建议图标突出“发码、核销、订单履约”含义，不使用快手官方标识。

b) 应用服务介绍

快手小店发码核销助手是一款面向商家的订单履约工具。商家可在订单支付后快速发码，买家确认收到后，商家可根据订单或核销码完成核销。系统会保存发码、确认、核销、售后和客服处理记录，帮助商家提升履约效率，减少漏发、错发、重复核销和售后纠纷。

c) 价格表

价格待补充，可参考：

版本	功能	价格
基础版	订单同步、手动发码、手动核销	待补充
专业版	批量发码、核销统计、证据上传	待补充
企业版	多店铺、多角色、审计报表、接口日志	待补充

8. 自研发软件著作权

待补充。

如已有软件著作权，请补充证书截图、证书编号、软件名称、著作权人信息，并确保著作权人与店铺或开发者实名认证主体一致。

如暂未取得，可备注：

本系统为自研系统，相关软件著作权材料正在准备中。系统代码、业务流程、前后端页面和数据库设计均由开发团队自主研发。