# 集运云系统 **Repository Path**: pingstrong/jiyunsys ## Basic Information - **Project Name**: 集运云系统 - **Description**: 集运 / 拼邮 / 代购 / 分销，一套系统搞定。星链集运云支持包裹预报、扫码入库、合箱打包、余额支付、物流追踪、代购报价、拼邮组团、分销返佣、财务结算等功能。用户端、仓库端、业务员端、总后台全面打通，适合跨境集运、海外仓储、国际转运、代购平台使用。功能实用，操作简单，高性价比上线。 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-05-04 - **Last Updated**: 2026-08-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 需求文档 ## 1. 应用概述 ### 1.1 应用名称集运系统 ### 1.2 应用描述本系统是一套支持多角色协作的集运业务管理平台，覆盖用户下单、预报、仓库入库、库存管理、打包、出库、物流跟踪、代购、充值支付、拼邮、分销、营销等全链路流程。系统支持 Admin（总后台）、Sales（业务员端）、WMS（仓库端）、Client（用户端）四端协作，满足多仓库运营、多币种结算、多语言展示及精细化权限控制要求。 ## 2. 用户与使用场景 ### 2.1 目标用户 - Admin：系统运营人员、财务人员、配置管理员 - Sales：业务员、客户经理 - WMS：仓库操作人员、仓库管理员 - Client：集运服务使用客户 ### 2.2 核心使用场景 - 客户通过用户端提交包裹预报、查询运单、支付运费、申请代购、参与拼邮 - 仓库人员通过 WMS 端完成入库、上架、打包、出库等仓储作业 - 业务员通过 Sales 端维护客户关系、处理代购需求、跟进订单 - 管理员通过 Admin 端进行系统配置、权限管理、财务审核、数据统计 ## 集运系统商业版可以添加微信

![](/public/weixin.png)

## 3. 页面结构与功能说明 ### 3.1 总后台 Admin #### 3.1.1 登录与账号管理 - 登录页：支持账号密码登录、手机号验证码登录、邮箱密码登录、二次验证 - 员工管理：新增员工、编辑员工、启用禁用账号、重置密码、分配角色、绑定仓库、设置数据权限、查看登录日志、查看操作日志、设置可登录端权限 - 角色管理：新增角色、编辑角色、删除角色、复制角色权限、配置菜单权限、配置按钮权限、配置字段权限、配置导出权限、配置审核权限、配置数据权限、配置可登录端 - 登录日志：查看所有员工登录记录、筛选登录端、筛选登录方式、筛选登录结果 #### 3.1.2 客户管理 - 客户列表：查看全部客户、按客户编号搜索、按手机号搜索、按业务员筛选、按状态筛选、按注册来源筛选 - 客户详情：查看客户基础信息、查看余额、查看消费记录、查看运单记录、查看代购记录、查看拼邮记录、查看分销关系 - 客户操作：新增客户资料、编辑客户资料、启用禁用客户账号、客户标签管理、客户备注管理、客户默认仓库设置、客户业务员绑定、客户归属转移、发送注册邀请、发送登录邀请、重置客户登录状态 #### 3.1.3 基础数据管理 - 仓库管理：新增仓库、编辑仓库、启用禁用仓库、查看仓库详情 - 仓位管理：新增仓位、编辑仓位、启用禁用仓位、查看仓位使用情况、查看仓位变更日志 - 国家地区管理：新增国家、编辑国家、启用禁用国家、配置币种、配置时区 - 货物类型管理：新增货物类型、编辑货物类型、启用禁用货物类型 #### 3.1.4 渠道管理 - 渠道列表：查看全部渠道、按仓库筛选、按国家筛选、按状态筛选 - 渠道配置：新增渠道、编辑渠道、启用禁用渠道、配置计费方式（体积模式或重量模式）、配置价格规则、配置支持货物类型、配置内容详情 #### 3.1.5 运单管理 - 运单列表：查看全部运单、按运单号搜索、按客户搜索、按仓库筛选、按渠道筛选、按状态筛选、按时间筛选 - 运单详情：查看运单基础信息、查看包裹明细、查看费用明细、查看物流轨迹、查看操作日志 - 运单操作：修改运单状态、处理异常运单、取消运单、重新计算运费 #### 3.1.6 代购管理 - 代购需求列表：查看全部代购需求、按客户搜索、按业务员筛选、按状态筛选 - 代购详情：查看需求信息、查看报价版本、查看采购进度、查看沟通记录 - 代购操作：分配业务员、审核报价、处理异常、取消代购 #### 3.1.7 拼邮管理 - 拼邮团列表：查看全部拼邮团、按团编号搜索、按团长搜索、按仓库筛选、按渠道筛选、按国家筛选、按状态筛选、按创建时间筛选 - 拼邮团详情：查看团基础信息、查看团员列表、查看子运单列表、查看主运单、查看费用分摊记录、查看支付记录、查看操作日志 - 拼邮操作：强制成团、强制解散、强制失败、延长截止时间、移出异常团员、重新计算分摊费用、处理支付异常、处理退款、处理主单异常、添加后台备注 - 拼邮规则配置：开启关闭拼邮功能、配置默认成团条件、配置允许拼邮的仓库渠道国家、配置分摊方式、配置超时规则、配置解散规则、配置是否允许用户端开团、配置是否允许业务员代客户开团、配置是否允许团长解散、配置是否允许团长延长截止时间、配置是否允许未入库包裹加入拼邮、配置是否允许已入库包裹加入拼邮、配置解散后子运单是否转为普通运单、配置默认最低成团人数、配置默认最大成团人数、配置默认最低成团重量、配置默认最大限制重量、配置默认拼邮有效时长、配置是否允许 Admin 强制成团、配置成团条件、配置团员支付超时时间、配置超时未支付是否自动移出、配置自动移出后是否重新分摊、配置是否允许余额支付、配置是否允许在线支付、配置退款方式、配置默认分摊方式、配置是否允许按重量分摊、配置是否允许按体积分摊、配置是否允许按件数分摊、配置是否允许固定金额分摊、配置金额小数位数、配置尾差处理方式 - 团长等级配置：新增团长等级、编辑团长等级、设置升级条件、配置奖励类型、配置奖励比例、配置固定奖励金额、配置团长运费折扣、配置奖励结算时机、配置奖励发放账户、配置奖励冲正规则、启用停用奖励规则、查看奖励发放记录 - 拼邮财务统计：查看拼邮总收入、查看拼邮总运费、查看拼邮总利润、查看团长奖励金额、查看退款金额、按团统计、按日期统计、按渠道统计、按仓库统计、导出对账单 #### 3.1.8 财务管理 - 充值审核：查看线下充值申请、审核通过、审核驳回、查看充值凭证 - 提现审核：查看提现申请、审核通过、审核驳回、查看提现记录 - 财务流水：查看全部流水、按客户搜索、按流水类型筛选、按时间筛选、导出流水 - 调账管理：新增调账、查看调账记录、填写调账原因 - 退款管理：查看退款申请、处理退款、查看退款记录 #### 3.1.9 分销管理 - 邀请关系：查看邀请关系树、人工调整邀请关系、查看调整日志 - 佣金规则配置：配置固定金额、配置百分比提成、配置阶梯提成、配置触发场景（首单奖励、充值奖励、运单消费奖励、代购成交奖励） - 佣金记录：查看佣金发放记录、按用户搜索、按时间筛选 #### 3.1.10 营销管理 - 优惠券管理：新增优惠券、编辑优惠券、启用禁用优惠券、查看优惠券使用记录、配置优惠券类型（满减券、折扣券、运费券、新人券、指定渠道券）、配置有效期、配置最低消费、配置限定用户、配置限定模块、配置限定渠道 - 活动管理：新增活动、编辑活动、启用禁用活动、查看参与记录、查看奖励发放记录、查看数据统计、配置活动类型（首充活动、满额返现、邀请奖励、节日活动） #### 3.1.11 消息管理 - 消息模板配置：配置消息类型、配置触发场景、配置消息内容 - 消息发送日志：查看消息发送记录、按类型筛选、按时间筛选 #### 3.1.12 报表统计 - 订单统计：按时间范围统计、按仓库统计、按渠道统计、按国家统计、按业务员统计、按客户类型统计 - 收入统计：查看总收入、查看运费收入、查看代购收入、查看拼邮收入 - 利润统计：查看总利润、查看渠道利润、查看代购利润、查看拼邮利润 - 仓库效率统计：查看入库效率、查看打包效率、查看出库效率 - 客户增长统计：查看新增客户、查看活跃客户、查看客户来源 - 业务员业绩统计：查看业务员成交订单数、查看业务员成交额、查看业务员客户贡献 - 代购转化率统计：查看代购需求数、查看报价数、查看成交数、查看转化率 #### 3.1.13 风控管理 - 风控规则配置：配置高频充值后快速提现规则、配置大额人工调账规则、配置敏感货频繁走普货渠道规则、配置多次取消代购规则、配置包裹异常率过高规则、配置物流长时间不更新规则 - 风控记录：查看风控触发记录、查看人工审核记录、查看订单冻结记录、查看钱包冻结记录、查看提现拦截记录、查看高风险用户标记记录 #### 3.1.14 系统配置 - 汇率配置：新增汇率、编辑汇率、查看汇率历史 - 系统参数配置：配置基准币种、配置默认语言、配置对象存储方式（本地存储、七牛、阿里云、腾讯云、华为云）、配置消息通知方式（站内信、小程序订阅消息、邮件、短信）、配置初始密码首次登录必须修改、配置连续密码错误锁定次数、配置高危操作二次验证、配置 IP 白名单、配置登录时间限制 ### 3.2 仓库端 WMS #### 3.2.1 登录 - 登录页：支持账号密码登录、手机号验证码登录 #### 3.2.2 入库管理 - 入库扫码：扫描包裹单号、匹配预报或运单、录入货物类型、称重、测量尺寸、拍照、分配仓位、提交入库 - 入库列表：查看待上架包裹、查看已上架包裹、查看入库异常包裹、按包裹号搜索、按客户搜索、按状态筛选 - 入库详情：查看包裹信息、查看入库图片、查看重量尺寸、查看仓位信息 #### 3.2.3 上架管理 - 上架操作：选择待上架包裹、绑定仓位、记录上架时间、记录操作人 - 上架记录：查看上架历史、按包裹号搜索、按仓位搜索 #### 3.2.4 库存查询 - 库存列表：查看当前库存、按客户搜索、按运单号搜索、按包裹号搜索、按仓位搜索、按状态筛选 - 库存详情：查看包裹图片、查看重量尺寸、查看上架信息 #### 3.2.5 移库管理 - 移库操作：选择包裹、选择新仓位、填写移库原因、记录操作人、提交移库 - 移库记录：查看移库历史、按包裹号搜索、按时间筛选 #### 3.2.6 盘点管理 - 盘点操作：创建盘点任务、选择盘点仓位、扫码盘点、记录盘点结果、提交盘点 - 盘点记录：查看盘点历史、按仓位搜索、按时间筛选 #### 3.2.7 打包管理 - 打包任务列表：查看待打包运单、查看拼邮主运单、按运单号搜索、按客户搜索 - 打包操作：选择包裹合包、录入打包后重量、录入打包后尺寸、上传打包图片、选择包材、记录包材费用、生成打包单 - 打包记录：查看打包历史、按运单号搜索、按时间筛选 #### 3.2.8 出库管理 - 出库任务列表：查看待出库运单、按渠道筛选、按国家筛选 - 出库操作：创建出库批次、批量打印面单、录入物流单号、确认发货、批量出库 - 出库记录：查看出库历史、按运单号搜索、按时间筛选 #### 3.2.9 异常件管理 - 异常上报：提交异常、选择异常类型（破损、丢件、无法匹配预报、重量尺寸异常、禁运品疑似、标签异常）、上传异常图片、填写异常说明、指派处理人 - 异常列表：查看待处理异常、查看已处理异常、按异常类型筛选、按时间筛选 - 异常详情：查看异常信息、查看异常图片、查看处理结果 #### 3.2.10 拼邮主运单管理 - 拼邮主运单列表：查看待打包主运单、按主运单号搜索、按拼邮团编号搜索、按渠道筛选、按状态筛选 - 主运单详情：查看主单信息、查看子单明细、查看团员包裹明细 - 主运单打包：扫码核验所有子单包裹、合并打包、录入打包后重量、录入打包后尺寸、上传打包图片、选择包材、记录包材费用、生成打包记录、提交待出库 - 主运单面单打印：生成主运单面单、打印主运单面单、重新打印、录入物流单号、确认发货、批量出库 - 主运单异常处理：主单异常上报、子单包裹缺失上报、破损上报、重量异常上报、禁运疑似上报、上传异常图片、填写异常说明、提交 Admin 处理 ### 3.3 业务员端 Sales #### 3.3.1 登录 - 登录页：支持账号密码登录、手机号验证码登录、邮箱密码登录 #### 3.3.2 客户管理 - 客户列表：查看自己名下客户、按客户编号搜索、按手机号搜索、按标签筛选、按状态筛选 - 客户详情：查看客户基础信息、查看余额（只读）、查看运单记录、查看代购记录、查看拼邮记录、查看跟进记录 - 客户操作：新增客户资料、编辑自己名下客户基础资料、客户绑定、开通客户登录账号、发送注册登录邀请、重发邀请链接或小程序二维码、查看客户账号激活状态、标签管理、备注管理 #### 3.3.3 跟进记录 - 新增跟进：选择跟进类型（电话、微信、面谈、系统留言）、填写跟进内容、设置下次跟进时间、设置意向等级、记录创建人 - 跟进列表：查看跟进记录、按客户筛选、按跟进类型筛选、按时间筛选 #### 3.3.4 代购管理 - 代购需求列表：查看自己名下客户代购需求、按客户搜索、按状态筛选 - 代购详情：查看需求信息、查看商品图片链接、查看预算数量备注 - 代购操作：接收需求、创建报价、录入商品链接截图规格价格数量、调整服务费、提交客户确认、更新采购状态、添加沟通记录 #### 3.3.5 拼邮管理 - 拼邮团列表：查看名下客户发起的拼邮团、查看名下客户加入的拼邮团、按客户搜索、按团编号搜索、按状态筛选 - 拼邮团详情：查看团详情、查看团员支付状态、查看子运单状态 - 拼邮操作：代客户创建拼邮团、协助选择仓库国家渠道、协助设置规则、协助生成邀请链接、添加业务员备注、查看未支付团员、协助团长催付、记录沟通内容、处理客户无法支付问题、提交异常给 Admin #### 3.3.6 业绩统计 - 业绩数据：查看成交订单数、查看代购成交额、查看客户贡献排行、查看佣金统计、查看名下客户拼邮订单数、查看拼邮成交金额、查看拼邮运费收入、查看参与拼邮客户数、查看拼邮转化率、查看团长贡献统计 ### 3.4 用户端 Client #### 3.4.1 注册与登录 - 注册页：支持手机号验证码注册、微信小程序授权注册、邮箱注册、邀请码注册、业务员邀请注册 - 登录页：支持手机号验证码登录、微信小程序授权登录、手机号客户编号密码登录、邮箱密码登录 - 绑定手机号：微信登录后绑定手机号 #### 3.4.2 账户中心 - 个人资料：查看编辑基本资料、上传头像、修改昵称 - 收货地址管理：新增地址、编辑地址、删除地址、设置默认地址 - 身份资料：填写身份信息（按清关要求配置） - 语言切换：选择默认语言 - 默认仓库设置：选择默认仓库 - 默认币种设置：选择默认币种 - 修改密码：输入原密码、输入新密码、确认新密码 - 修改手机号：验证原手机号、输入新手机号、验证新手机号 - 账号注销：提交注销申请（需满足无未完成订单、无冻结余额、无售后争议等条件） #### 3.4.3 预报功能 - 新增预报：填写快递单号、填写商品名称、选择商品类别、填写数量、填写申报价值、选择币种、选择所属仓库、填写备注、选择是否加入拼邮团 - 预报列表：查看预报记录、按状态筛选、按仓库筛选 - 预报详情：查看预报信息、编辑未入库预报 #### 3.4.4 运单查询 - 运单列表：查看运单记录、按运单号搜索、按状态筛选、按仓库筛选、按时间筛选 - 运单详情：查看运单基础信息、查看状态时间轴、查看包裹图片、查看重量尺寸、查看物流轨迹、查看费用明细、查看异常提示、申请打包、支付运费 #### 3.4.5 代购功能 - 提交代购需求：上传商品图片、填写商品链接、填写预算、填写数量、填写备注 - 代购列表：查看代购记录、按状态筛选 - 代购详情：查看需求信息、查看报价版本、确认报价、拒绝报价、在线支付、查看采购进度、查看入库结果 #### 3.4.6 拼邮功能 - 拼邮首页：展示可加入拼邮团列表、展示拼邮团状态、展示团长仓库国家渠道货物类型、展示当前人数最低人数、展示当前重量最低重量、展示截止时间、展示预计优惠说明、筛选仓库国家渠道货物类型 - 我要开团：选择仓库、选择目的国家、选择运输渠道、选择货物类型、设置最低成团人数、设置最大人数、设置最低成团重量、设置最大限制重量、设置截止时间、填写团长备注、提交创建拼邮团、生成邀请链接或二维码 - 加入拼邮团：查看拼邮团详情、选择要加入的包裹或预报、提交加入申请 - 我的拼邮团：查看我发起的拼邮团、查看我加入的拼邮团、查看拼邮团状态、查看团员列表、查看个人包裹列表、查看个人分摊金额、查看支付状态、查看物流状态、查看团长奖励状态 - 预报包裹到拼邮团：新增预报时选择加入拼邮团、选择已有未打包包裹加入拼邮团 - 分摊金额与支付：查看个人分摊金额、查看分摊规则、查看费用明细、余额支付、在线支付 - 团长功能：查看团员列表、查看团员支付状态、一键催付、解散拼邮团、延长截止时间、查看团长奖励、分享拼邮团链接、查看拼邮团二维码 - 物流查看：查看主运单物流轨迹、查看子运单状态、查看发货时间、查看妥投状态、查看异常提示 #### 3.4.7 余额与消费记录 - 钱包首页：查看可用余额、查看冻结余额、查看累计充值、查看累计消费、查看累计退款、查看累计佣金、查看累计提现 - 充值入口：在线充值（微信支付宝）、线下充值申请 - 线下充值申请：填写充值金额、选择币种、填写付款时间、选择收款方式、上传凭证图片、填写备注、提交申请 - 提现入口：提交提现申请、填写提现金额、选择提现方式、填写提现账户、提交申请 - 流水列表：查看流水记录、按流水类型筛选、按时间筛选 #### 3.4.8 分销功能 - 我的邀请码：查看本人邀请码、生成邀请链接、生成邀请二维码 - 邀请记录：查看邀请人数、查看邀请关系 - 佣金记录：查看佣金收入、查看佣金明细、按时间筛选 #### 3.4.9 优惠券 - 优惠券列表：查看可用优惠券、查看已使用优惠券、查看已过期优惠券 - 优惠券详情：查看优惠券规则、查看使用条件、查看有效期 #### 3.4.10 消息中心 - 消息列表：查看未读消息、查看已读消息、按类型筛选、批量已读 - 消息详情：查看消息内容、跳转业务详情页 ## 4. 业务规则与逻辑 ### 4.1 多仓库体系 1. 一个客户可使用多个仓库 2. 所有包裹、运单、库存、出库记录必须绑定 warehouse_id 3. 仓库数据默认隔离 4. 仓库账号只能查看所属仓库数据 5. 后台管理员可查看全部仓库数据 ### 4.2 多币种体系 1. 涉及金额的业务字段统一采用 amount + currency 存储 2. 支持基准币种统计 3. 汇率按配置表读取，支持手工维护 4. 财务流水需同时记录原币种金额、汇率、基准币种金额 ### 4.3 权限体系 1. 功能权限：菜单权限、按钮权限、字段权限、导出权限、审核权限 2. 数据权限：ALL（全部数据）、OWN（本人负责数据）、WAREHOUSE（所属仓库数据）、SELF（本人数据） ### 4.4 账号体系 1. 员工账号体系：适用于 Admin、WMS、Sales，由总后台统一创建，不开放自主注册 2. 客户账号体系：适用于 Client，允许用户自主注册，也允许业务员在权限范围内为客户创建客户资料并开通用户端登录能力 3. 员工账号和客户账号必须分表管理 4. 所有登录行为必须记录登录日志 5. 所有密码必须加密存储，系统不得保存或展示明文密码 ### 4.5 业务员客户权限 1. 业务员可新增客户资料、编辑自己名下客户基础资料、为客户开通用户端登录账号、发送注册登录邀请 2. 业务员不得查看客户登录密码、不得查看客户密码加密值、不得设置客户长期密码、不得替客户修改长期密码、不得直接修改客户余额、不得删除客户财务流水、不得查看非自己名下客户、不得随意转移客户归属、不得绕过验证码登录客户账号 3. 客户通过手机号验证码首次登录，客户首次登录后可自行设置密码 ### 4.6 运单流程 1. 预报 -> 待入库 -> 已入库 -> 已打包 -> 待支付运费 -> 待出库 -> 已出库 -> 已完成 2. 一个运单可关联多个包裹 3. 多个预报件允许合包 4. 已出库运单不可修改核心收件与包裹信息 5. 取消运单必须记录取消原因 6. 运费应保留明细：基础运费、操作费、附加费、优惠、应付金额 ### 4.7 渠道计费规则 #### 4.7.1 体积模式 1. 当计费方式为体积模式时，仅启用体积模式计费字段 2. 若计费体积 <= 首立方，则运费 = 首立方价格 + 操作费 3. 若计费体积 > 首立方，则运费 = 首立方价格 + ceil((计费体积 - 首立方) / 续立方) × 续立方价格 + 操作费 4. 若业务要求按重量转换体积取大值，则计费体积 = max(实际体积, 实际重量 / 重量转体积密度数) 5. 所有续费按向上取整计算 #### 4.7.2 重量模式 1. 当计费方式为重量模式时，仅启用重量模式计费字段 2. 体积重 = 长 × 宽 × 高 / 体积转换重量系数 3. 计费重量 = max(实际重量, 体积重) 4. 若计费重量 <= 首重重量，则运费 = 首重价格 + 操作费 5. 若计费重量 > 首重重量，则运费 = 首重价格 + ceil((计费重量 - 首重重量) / 续重重量) × 续重价格 + 操作费 6. 所有续费按向上取整计算 ### 4.8 入库规则 1. 入库重量单位为 KG，必须 > 0 2. 尺寸单位为 CM，长宽高必须 > 0 3. 入库图片至少 1 张，支持多图 4. 仓位必须属于当前仓库 5. 敏感货需在后续渠道选择中限制渠道范围 6. 若重量与预报差异过大，需触发异常提醒 7. 无预报包裹允许异常入库，状态置为待人工处理 ### 4.9 打包规则 1. 包裹已入库 2. 异常已处理 3. 客户已提交打包需求或系统允许自动打包 4. 选择多个包裹合包 5. 录入打包后重量与尺寸 6. 重新计算运费 7. 记录包材与操作费 8. 上传打包图片 9. 生成打包单 ### 4.10 出库规则 1. 运单已确认渠道 2. 运费已支付或允许后付 3. 面单已生成 4. 无未处理异常 5. 按渠道国家创建出库批次 6. 批量打印面单 7. 批量确认发货 8. 记录物流单号 9. 更新物流状态 ### 4.11 代购流程 1. 需求提交 -> 待受理 -> 待报价 -> 已报价 -> 待客户确认 -> 已确认 -> 待支付 -> 已支付待采购 -> 采购中 -> 采购完成 -> 待入库 -> 已入库 -> 已生成运单 -> 已完成 2. 报价发给客户后不可直接覆盖，只能新增版本 3. 客户确认某版本后，其它版本自动失效 4. 确认后的商品图、链接、规格、价格、数量、服务费、总价必须生成快照 5. 快照不可编辑，只可查看 6. 客户确认并付款后，金额先进入冻结余额 7. 采购完成后扣减冻结资金 8. 服务费和差额进入利润记录 9. 采购失败支持退款到余额或原路退回 ### 4.12 拼邮规则 #### 4.12.1 强约束规则 1. 同一时间一个客户只能加入一个进行中的拼邮团 2. 同一拼邮团必须满足：同仓库、同渠道、同目的国家、同货物类型 3. 团员必须先预报包裹，或选择已有可拼邮包裹，才能参与最终分摊 4. 未支付超时的团员自动移出拼邮团，子运单恢复普通运单 5. 成团后不可更换渠道 6. 成团后不可修改已用于分摊的重量、体积和件数 7. 团长解散或系统超时解散后，子运单自动脱离拼邮团，不影响原包裹库存 8. 仅已支付的团员参与最终合包发货 9. 主运单出库后，子运单不可再退出拼邮团 10. 敏感货拼邮团只能选择支持敏感货的渠道 11. 渠道停用后，未成团拼邮团自动标记异常或失败；已发货拼邮团不受影响 #### 4.12.2 加入拼邮团条件 1. 用户账号状态正常 2. 用户未加入其他进行中的拼邮团 3. 拼邮团状态为招募中 4. 拼邮团未超过最大人数 5. 拼邮团未超过最大重量限制 6. 用户选择的包裹属于同一仓库 7. 用户选择的包裹货物类型与拼邮团一致 8. 用户选择的目的国家与拼邮团一致 9. 用户选择的渠道与拼邮团一致 10. 用户包裹无未处理异常 #### 4.12.3 成团条件 1. 策略一：当前团员人数 >= 最低成团人数 2. 策略二：当前总重量 >= 最低成团重量 3. 策略三：当前团员人数 >= 最低成团人数，并且当前总重量 >= 最低成团重量 4. 策略四：Admin 强制成团 #### 4.12.4 失败条件 1. 到达截止时间后未满足成团条件 2. 渠道被停用且无可替代方案 3. 拼邮团总重量超过最大限制且无法调整 4. 所有团员退出或被移出 5. Admin 判定异常并强制失败 #### 4.12.5 解散规则 1. 允许团长解散的状态：招募中、待成团（按配置决定） 2. 不允许团长解散的状态：已成团、待支付、已支付、待打包、已发货、已完成 #### 4.12.6 运费分摊规则 1. 按重量分摊：个人运费 = 个人重量 / 总重量 × 总运费 2. 按体积分摊：个人运费 = 个人体积 / 总体积 × 总运费 3. 按件数分摊：个人运费 = 个人件数 / 总件数 × 总运费 4. 固定金额分摊：每个团员按固定金额支付 5. 金额保留 2 位小数 6. 最后 1 名团员兜底尾差，保证所有团员分摊金额合计等于主运单总运费 #### 4.12.7 主子运单规则 1. 主运单由系统在成团并支付完成后生成 2. WMS 仓库只操作主运单 3. 主运单用于打包、称重、打印面单、出库、物流跟踪 4. 每个团员对应一个子运单 5. 子运单用于客户查看自己的包裹、费用、支付和物流 6. 主单状态变化后同步到所有子单 #### 4.12.8 团长奖励规则 1. 团长运费折扣：团长本人运费按折扣计算 2. 团长免固定金额：团长本人减免固定金额 3. 按团员总运费百分比返佣：团员总运费的百分比作为团长佣金 4. 固定奖励：每成功发货一团奖励固定金额 5. 默认结算时机：主运单发货后自动结算 6. 已解散、已失败拼邮团不发放奖励 7. 主运单取消后，已发放奖励需冲正 ### 4.13 财务规则 1. 任何金额变动都必须生成流水 2. 禁止直接改余额，只能通过流水变更 3. 调账需记录原因与操作日志 4. 线下充值需财务审核 5. 审核驳回必须填写原因 6. 审核通过后生成钱包入账流水 7. 提现金额不能超过可提现余额 8. 提现需冻结对应金额，完成后扣减 ### 4.14 分销规则 1. 用户通过邀请码注册后绑定上级 2. 默认绑定后不可修改，后台可人工调整并记录日志 3. 支持固定金额、百分比提成、阶梯提成 4. 佣金触发场景：首单奖励、充值奖励、运单消费奖励、代购成交奖励 ### 4.15 优惠券规则 1. 类型：满减券、折扣券、运费券、新人券、指定渠道券 2. 支持有效期、最低消费、限定用户、限定模块、限定渠道 3. 券状态：未使用、已使用、已过期、已作废 ### 4.16 消息通知规则 1. 运单：预报成功、入库成功、打包完成、待支付、已出库、物流异常 2. 代购：需求已受理、已报价、报价即将过期、支付成功、采购完成、已入库 3. 财务：充值成功、审核通过驳回、提现通过驳回、退款成功 4. 拼邮：拼邮团创建成功、有新团员加入、团员退出、团员未支付提醒、拼邮团即将到期、拼邮团已成团、拼邮团失败、拼邮团已发货、团长奖励到账、成功加入拼邮团、拼邮团即将成团、待支付分摊费用、支付成功、支付超时被移出、拼邮团解散、主运单已发货、物流异常 ### 4.17 风控规则 1. 高频充值后快速提现：触发人工审核 2. 大额人工调账：需记录调账原因与操作日志，触发风控审核 3. 敏感货频繁走普货渠道：触发风控，标记高风险用户 4. 多次取消代购：触发风控，标记高风险用户 5. 包裹异常率过高：触发风控，标记高风险用户 6. 物流长时间不更新：触发异常提醒，通知客户和仓库 ### 4.18 全局日志与审计以下动作必须记录操作日志： 1. 登录退出 2. 角色与权限修改 3. 运单状态修改 4. 仓库入库上架移库打包出库 5. 代购报价确认取消采购 6. 充值审核提现审核退款调账 7. 渠道价格规则修改 8. 异常件处理日志需包含操作人、角色、模块、对象ID、操作前后摘要、时间、IP、设备信息。 ### 4.19 全局图片与附件规则 1. 支持多图上传 2. 按业务类型分类存储：入库图、打包图、异常图、报价图、充值凭证、面单图等 3. 记录上传人、上传时间 4. 关键图片默认不可直接覆盖，只能追加 5. 支持逻辑删除 ## 5. 异常与边界情况 | 异常场景 | 处理方式 | |---------|--------| | 入库重量与预报差异过大 | 触发异常提醒，仓库上报异常，Admin 审核处理 | | 无预报包裹到仓 | 允许异常入库，状态置为待人工处理，仓库上报异常 | | 包裹破损 | 仓库上报异常，上传异常图片，填写异常说明，指派处理人 | | 包裹丢件 | 仓库上报异常，上传异常图片，填写异常说明，指派处理人 | | 禁运品疑似 | 仓库上报异常，上传异常图片，填写异常说明，提交 Admin 处理 | | 代购采购失败 | 支持退款到余额或原路退回，生成退款流水 | | 代购客户拒绝报价 | 报价版本失效，代购需求状态变为已拒绝 | | 拼邮团员未支付 | 系统在超时时间后自动移出团员，子运单恢复普通运单，剩余团员重新计算分摊金额 | | 拼邮重量异常 | 系统触发异常提醒，WMS 提交异常图片和说明，Admin 审核后可重新核算费用 | | 拼邮渠道禁用 | 招募中拼邮团自动变为异常或失败，系统通知团长和团员，子运单恢复普通运单，如已有支付执行退款 | | 拼邮主单取消 | 主单取消后所有子单取消拼邮关系，已支付金额退回余额或原路退回，已生成奖励需冲正 | | 拼邮子单包裹缺失 | WMS 标记缺失异常，该子单暂不参与发货，如已支付则生成退款或差额处理 | | 拼邮团超重 | 禁止继续加入新团员，Admin 可移出部分未支付团员，系统重新分摊费用 | | 充值审核驳回 | 必须填写驳回原因，通知用户 | | 提现审核驳回 | 必须填写驳回原因，解冻金额，通知用户 | | 高频充值后快速提现 | 触发风控，进入人工审核 | | 大额人工调账 | 需记录调账原因与操作日志，触发风控审核 | | 敏感货频繁走普货渠道 | 触发风控，标记高风险用户 | | 物流长时间不更新 | 触发异常提醒，通知客户和仓库 | | 渠道停用 | 未成团拼邮团自动标记异常或失败，已发货拼邮团不受影响，新运单不可选择该渠道 | | 仓库停用 | 不可继续分配新业务，已有业务继续处理 | | 员工账号禁用 | 不可登录，已有操作记录保留 | | 客户账号禁用 | 不可登录，已有订单和余额保留 | | 连续密码错误达到限制次数 | 锁定账号，需管理员解锁 | | 初始密码首次登录 | 强制修改密码 | | 高危操作 | 需二次验证 | | 异常登录 | 要求短信或邮箱验证 | | 黑名单用户 | 不可登录或限制操作 | | 客户账号注销 | 需满足无未完成订单、无冻结余额、无售后争议等条件 | ## 6. 验收标准 1. 用户可完成注册登录、预报并查询运单 2. 客户账号与员工账号隔离，后台三端不允许自主注册 3. 业务员可新增客户并发送登录邀请，但不得查看或设置客户长期密码 4. 仓库可完成入库、上架、打包、出库全流程 5. 系统可按渠道规则自动计算运费 6. 代购需求可完成报价、确认、支付、采购、入库联动 7. 拼邮可完成开团、入团、分摊、支付、主单发货、子单同步 8. 钱包余额、冻结、扣费、退款流水准确一致 9. 不同角色只能访问其权限范围内数据 10. 核心业务日志、状态日志、登录日志、财务日志可追溯 11. 所有关键操作均有日志记录 12. 主运单状态变更可以同步所有子运单 13. 财务流水包含支付、冻结、扣费、退款、奖励 14. 团长奖励可以按规则自动结算 15. 后台可以查看、搜索、强制处理拼邮团 16. 拼邮失败、解散、主单取消时，子单和资金处理正确 17. 风控规则可以正常触发并执行相应动作 18. 消息通知可以按规则触发并发送 19. 优惠券可以正常创建、发放、使用、核销 20. 分销关系可以正常绑定、佣金可以正常计算和发放 21. 营销活动可以正常创建、参与、奖励发放 22. 报表统计数据准确，支持多维度筛选和导出 23. 多仓库数据隔离正确，权限控制有效 24. 多币种金额计算准确，汇率转换正确 25. 盘点功能可以正常执行，盘点结果准确 26. 移库功能可以正常执行，移库记录完整 27. 异常件可以正常上报、处理、跟踪 28. 面单可以正常生成、打印 29. 物流轨迹可以正常更新、查询 30. 系统配置可以正常修改并生效