物流供应链简单案例

功能描述

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

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

  • 物流公司（本案例中只有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信息表示

测试