初昕
📚 货源渠道配置完整教程
📦 货源渠道首页（列表页）
这是你管理所有货源渠道的总览页面，核心功能如下：
精准查询：可输入平台名称 / 域名搜索渠道，也能通过 “渠道类型” 下拉筛选，点击「查询」获取结果，「重置」可清空筛选条件。
快速新增：点击「+ 添加」按钮，即可进入新渠道的配置流程。
数据总览：页面展示「总余额」和「渠道额度使用情况」（已创建数量 / 最大可创建数量），让你对资源情况一目了然。
渠道列表：所有创建完成的渠道会在此展示，包含 ID、对接名称、渠道类型、余额、状态等信息，方便你快速识别和管理。
⚙️ 添加渠道 - 基础配置
这是创建新渠道的第一步，用来完成核心对接信息的填写：
核心必填项
渠道名称：为渠道设置一个辨识度高的名称，方便后续管理识别。
渠道类型：当前默认选择「卡速售 v2」，无需手动修改。
商品通知地址：系统已自动填充固定接口地址，当渠道商品余额≥1.00 元时，会通过此地址自动同步商品信息，请勿修改。
对接信息配置
地址：填写对接域名（必须带上
http://或https://前缀，例如http://www.baidu.com）。备用地址：开启后可填写备用域名，用于主地址故障时的容灾切换。
APPID & 密钥：填写合作方提供的 APPID，若无需修改密钥则留空即可。
功能开关
余额预警：开启后可设置余额阈值，当渠道余额低于阈值时触发提醒。
状态：默认选择「开启」，新渠道创建后即可正常使用；选择「关闭」则渠道暂时无法提供服务。
🔄 添加渠道 - 同步配置
这个模块用来设置商品、订单的自动同步规则，保障数据实时一致：
商品同步设置
快捷全选：勾选「全选」可一键选中所有商品同步选项（库存数量、商品价格、商品状态等）；也可根据需求单独勾选字段。
同步间隔：默认每 5 秒拉取一次商品信息，可根据实际需求调整请求间隔时间。
订单同步配置
快捷全选：勾选「全选」可一键选中所有订单同步选项（同步订单、同步退款等）；也可单独勾选需要同步的订单事件。
自动撤单：开启后，系统会根据预设规则自动处理需要撤销的订单。
同步间隔：默认每 10 秒拉取一次订单信息，可按需调整请求间隔时间。
历史订单同步：可设置同步历史订单的时间范围，保障新渠道创建后历史数据完整。
🛠️ 添加渠道 - 其他配置
这个模块用来设置渠道的个性化展示和对接规则：
卡密域名替换：默认选择「不使用」，若需统一替换卡密中的域名，可选择「系统默认」并配置对应域名。
商品 ID 对齐：开启「对接是否相同商品 ID」后，对接渠道的商品 ID 将与我方系统保持一致，便于商品识别和管理。
页面地址自定义：可填写电脑端、手机端的「商品详情地址」和「订单列表地址」，无需自定义则留空使用默认链接。
状态开关：默认「开启」，可随时切换渠道的启用 / 停用状态。
🔤 添加渠道 - 关键字替换
这个模块用来对商品文本信息进行批量替换，实现内容的个性化适配：
商品名称替换：按照 “原内容→替换内容” 的格式填写（例如：
https://www.baidu.com替换为https://ceshi.com），系统会自动替换商品名称中的对应文本。商品内容自定义：在「商品详情」「商品注意事项」「商品使用说明」输入框中，填写需要替换的规则或自定义内容，让商品展示信息更符合渠道需求。
⚠️ 注意事项
所有带「*」的字段为必填项，未填写将无法完成渠道创建。
商品通知地址为系统固定接口，请勿随意修改，否则会导致商品同步失败。
对接域名必须包含
http://或https://前缀，否则会导致对接失败。配置过程中遇到任何问题，可随时联系客服协助处理：微信：900000064
渠道创建完成后，可在「货源渠道首页」查看状态，若状态异常请检查配置信息或联系客服。
🛠️ 货源渠道对接配置参考模板
（覆盖从配置到验证的全流程，技术人员可直接参考使用）
📋 一、基础信息登记
渠道名称：填写供应商官方名称（如 “卡速售 V2”“福禄网络”），需与预设渠道清单完全一致。
渠道类型：选择对应品类（如 “虚拟商品 - 游戏点卡”“实物商品 - 3C 配件”），便于后续分类管理。
对接人信息：记录供应商对接人姓名、联系方式，以及我方技术对接人信息，便于问题协同。
合作等级：标注渠道优先级（如 “核心渠道”“备用渠道”），用于后续额度分配与资源倾斜。
⚙️ 二、核心配置参数（技术人员专属）
（1）接口基础配置
接口地址：填写供应商提供的 API 对接 URL，需提前通过 Postman 验证可访问性，避免调用失败。
请求方式：选择与供应商匹配的方式（GET/POST），默认优先使用 POST（安全性更高）。
请求编码：统一使用 UTF-8，需与供应商接口文档完全一致，避免乱码。
超时时间：设置接口请求超时阈值（如 5 秒），防止因供应商响应慢导致系统阻塞。
（2）安全与签名配置
签名算法：选择供应商指定的算法（如 MD5、RSA），需与供应商确认签名生成规则（如参数拼接顺序、密钥位置）。
签名密钥：填写供应商提供的 API 密钥，需存储在安全的密钥管理系统，避免明文泄露。
加密方式：若需加密传输，配置 AES 等加密算法的密钥与向量，确保数据传输安全。
（3）业务关联配置
对接域名 / 账号：填写供应商后台分配的对接域名、商户账号，需与供应商后台完全一致，否则会导致采购失败。
渠道额度：根据合作等级设置该渠道的最大采购额度（如核心渠道设为 10000 元 / 天，备用渠道设为 2000 元 / 天）。
库存同步频率：设置自动同步库存的时间间隔（如每 30 分钟一次），或选择手动同步。
🧪 三、测试验证步骤
连通性测试
使用 Postman 调用接口地址，验证返回状态码为 200，确认接口可正常访问。
签名验证测试
构造测试请求，生成签名并发送给供应商验证，确认签名通过，避免请求被拦截或篡改。
采购功能测试
发起 1 元小额采购（如购买 10 元面值点卡），验证商品卡密 / 交付链接正常返回，且渠道余额扣减准确。
库存同步测试
修改供应商后台商品库存，触发自动同步，验证我方系统库存更新一致，避免超卖。
异常场景测试
模拟余额不足、库存为 0、网络超时等场景，验证系统是否触发预警或错误提示，确保异常处理逻辑正常。
🛡️ 四、运维监控要点
核心指标监控
接口成功率：目标≥99.5%，低于阈值时触发告警。
渠道余额：设置预警阈值（如低于 500 元时推送提醒），避免余额不足导致断供。
库存准确率：每日核对系统库存与供应商库存，差异率需≤0.1%。
日志留存要求
接口调用日志、采购记录需留存 90 天以上，用于纠纷处理与审计追溯。
定期巡检计划
每周执行一次全量接口连通性测试，每月与供应商核对资金流水与库存数据。
🚨 五、异常处理预案
接口调用失败
先检查网络与接口地址，若正常则切换至备用渠道，并通知供应商排查故障。
渠道余额不足
立即触发余额充值流程，若无法及时充值则暂停该渠道采购，切换至备用渠道。
库存异常
手动同步库存并与供应商核对，若差异由供应商导致则要求其修正，若为系统问题则技术人员排查修复。
系统当前支持多种渠道系统对接，一键克隆对接
全自动同步商品、订单信息，操作简单，货源无忧，支持自定义配置每一个渠道同步规则
