• 物流供应链简单案例
    • 功能描述
    • 数据结构设计
    • function及各自实现的功能
    • 接口设计
    • 测试

    物流供应链简单案例

    功能描述

    该 智能合约 实现了一个简单的供应链应用案例，针对物流行业的应用场景。由于将合约的协议公开，并且签收快递时需要签名，可以在很大程度上保证不被冒领，实现了一手交钱，一手交货，同时提高了效率，确保了透明。

    该智能合约中三种角色如下：

    • 物流公司（本案例中只有1位）
    • 寄货方（本案例中有多位）
    • 收货方（本案例中有多位）

    业务流程如下：

    1、寄货方填写寄货单，物流公司根据寄货单寄快递。

    2、寄快递过程中物流公司各个快递点对快递进行扫描，描述目前快递进度，并更新货单状态。寄货方和收货方可以根据单号进行查询。

    3、快递到达后，收货方检查商品，确认无误后，扫码并使用私钥签名，支付相关费用，更新订单状态。

    在实际中，物流费的支付分为两类：

    • 1、寄货方支付。收货方签收快递后先预付给物流公司。
    • 2、收货方支付。收货方签收快递后支付给物流公司。

    在本案例中暂不考虑货物损坏、收货方失联、货物保值等的相关问题。具体实现逻辑如下：

    • 创建账户。为每个用户生成唯一的私钥与地址。
    • 生成寄货单。寄货方填写纸质寄货单，物流公司根据此生成电子单。
    • 更新寄货单。物流公司旗下快递点根据配送信息更新电子寄货单。
    • 收货方签收确认。收货方收到货物后，使用自己的私钥进行签收，完成相应的付款。

    账户私钥应该由安装在本地的客户端生成，本例中为了简便，使用模拟私钥和公钥。每位用户的私钥为guid+“1”，公钥为guid+“2”。用户签名为私钥+“1”

    数据结构设计

    • 寄货单

      • 寄货单编号
      • 寄货方地址
      • 收货方地址
      • 寄货方联系方式
      • 收货方联系方式
      • 物流费用
      • 物流费用支付类型 //0：寄货方支付 1：收货方支付
      • 寄货方预支付费用 //模拟实际预支付，寄货方支付物流费下值为物流费，否则为0
      • 快递配送信息 // 快递运送状态，所经过快递分拨中心与快递点的数组
      • 收货方签名

    • 寄货方

      • 姓名
      • 所在地址
      • 账户地址
      • 账户公钥
      • 联系方式
      • 账户余额
    • 收货方
      • 姓名
      • 所在地址
      • 账户地址
      • 账户公钥
      • 账户私钥
      • 联系方式
      • 账户余额
    • 物流公司
      • 账户公钥
      • 账户私钥
      • 名称
      • 地址
      • 联系方式
      • 账户余额
      • 物流公司旗下分拨中心与快递点
    • 快递点
      • 名称
      • 所在地址
      • 联系方式
      • 快递点公钥
      • 快递点私钥
      • 快递点账户地址

    function及各自实现的功能

    • init 初始化物流公司及其下相应快递点
    • invoke 调用合约内部的函数
    • query 查询相关的信息
    • createUser 创建用户 init
    • createExpress 创建物流公司 init
    • createExpressPoint 创建快递点 init
    • createExpressOrder 寄货方创建寄货单 init
    • finishExpressOrder 收货方签收寄货单 invoke
    • addExpressPointer 物流公司添加新的快递点 invoke
    • updateExpressOrder 更新物流公司订单,添加快递点的信息 invoke
    • getExpressOrderById 查询订单状态 query
    • getExpress 获取物流公司信息 query
    • getUserByAddress 获取用户信息 query

    • getExpressPointByAddress 获取快递点信息 query

    • writeExpress 存储物流公司信息 （以物流公司账户地址进行存储）

    • writeExpressOrder 存储寄货单 （以“express”+id 进行存储）
    • writeUser 存储用户信息 （以地址进行存储）
    • writeExpressPoint 存储物流点信息 （以快递点账户地址进行存储）

    接口设计

    createUser

    request参数

    1. args[0] 姓名 
    2. args[1] 所在地址
    3. args[2] 联系方式
    4. args[3] 账户余额

    response参数

    1. user信息的json表示

    createExpressPointer

    request参数

    1. args[0] 姓名
    2. args[1] 所在地址
    3. args[2] 联系方式

    response参数

    1. 物流点的信息的json表示

    createExpress

    request 参数

    1. args[0]  名称
    2. args[1]  地址
    3. args[2]  联系方式
    4. args[3]  账户余额

    response 参数

    1. 物流公司信息的json表示

    addExpressPointer

    request参数

    1. args[0] 添加快递点

    response参数

    1. 物流公司信息的json表示

    createExpressOrder

    request参数

    1. args[0] 寄货方地址
    2. args[1] 收货方地址
    3. args[2] 寄货方账户地址
    4. args[3] 收货方账户地址
    5. args[4] 寄货方联系方式
    6. args[5] 收货方联系方式
    7. args[6] 物流费用支付类型
    8. args[7] 寄货方预支付费用 （收货方支付的话值为0）
    9. args[8] 物流费用

    response 参数

    1. 订单信息的json表示

    updateExpressOrder

    request参数

    1. args[0]  订单id
    2. args[1]  快递点地址

    response参数

    1. 订单信息的json表示

    finishExpressOrder

    request参数

    1. args[0] 收货方账户地址
    2. args[1] 账户订单编号
    3. args[2] 收货方签名

    response参数

    1. 订单信息的json表示

    getExpressOrderById

    request参数：

    1. args[0] id

    response参数：

    1. 快递订单的json表示

    getExpress

    response参数：

    1. 快递信息的json表示

    getUserByAddress

    request参数

    1. args[0] address

    response参数

    1. 用户信息的json表示

    getExpressPointerByAddress

    request参数

    1. args[0] address

    response参数

    1. 快递点的json信息表示

    测试