整个项目的目的是将核心公司（车企）的还款能力传递下去，使有核心公司的欠款单据的链上的公司可以通过单据向金融机构（银行）借款融资。然而金融机构只认可车企的还款能力，所以当某企业凭单据向金融机构借款时，金融机构需要对该单据的公司进行评估看是否具有还款能力，在本次的情境下，只需要知道单据的源头是否为车企就行了。显然这就是一个简单的溯源问题，只需要追溯单据最初的付款方是否为车企，所以只需要通过区块链的方式将每次交易的信息记录下来就行了。因此，我认为这次需要设计的供应链金融的平台的核心就是账款单据，我通过一个ability属性来最终表示一个公司是否具有向金融机构借款融资的能力，当然，ability在链上是可以传递的。
【源码地址】
公司Company结构体属性：公司名称，资产
单据Bill结构体属性：单据金额，单据交易双方的地址，单据交易时间，单据的还款时间（精确到日），该单据是否被银行认可（ability为True和False），单据的交易次数（transactionCounts）
address car = 0xca35b7d915458ef540ade6068dfe2f44e8fa733c; //汽车公司的地址
address tyre = 0x14723a09acff6d2a60dcdf7aa4aff308fddc160c; //轮胎公司的地址
address hub = 0x4b0897b0513fdc7c541b6d9d7e929c4e5364d2db; //轮毂公司的地址
address alui = 0x583031d1113ad414f02576bd6afabfb302140225; //铝锭公司地址
address alum = 0xdd870fa1b7c4700f2bd7f44238821c26f7392148; //铝矿公司的地址
address bank = 0x95f452956282a5bfc2c8522bf23cd5525fcbcb9b; //银行地址
mapping(address => Company) public companyMap; //地址与公司的映射
mapping(address => Bill) public billMap; // 公司与单据的映射
struct Bill{
address payer; //付款人地址
address payee; //收款人地址
uint transactionCounts; //交易次数
uint paymentTime; //支付时间
uint repaymentTime; //还款时间
uint billBalance; //余额
bool ability; //是否具有还款能力
}
struct Company{
bytes32 companyName; //公司名
uint property; //公司资产
} // 创建单据事件
event Bill_(string msg, address payer, address payee, uint amount, bool ability);
// 单据转让事件
event Tran_(string msg, address transferer, address receiver, uint amount, uint payerBillBalance, uint payeeBillBalance, bool payerBillAbility, bool payeeBillAbility);
// 融资事件
event Fina_(string msg, address company, address financier, uint amount, uint companyPro);
// 还款事件
event Pay_(string msg, address payer, address payee, uint amount, uint payerPro, uint payeePro);- Company创建并初始化
Company public com__ = Company({companyName : "", property : 3000});
constructor() public{
// 建立公司
Company memory car_com = com__;
car_com.companyName = "Car";
car_com.property = 10000;
Company memory tyre_com = com__;
tyre_com.companyName = "Tyre";
Company memory hub_com = com__;
hub_com.companyName = "Hub";
Company memory alui_com = com__;
alui_com.companyName = "Alui";
Company memory alum_com = com__;
alum_com.companyName = "Alum";
Company memory bank_com = com__;
bank_com.companyName = "Bank";
bank_com.property = 100000;
}- 映射表的建立
// 建立公司地址与公司的映射
companyMap[car] = car_com;
companyMap[tyre]= tyre_com;
companyMap[hub] = hub_com;
// 建立公司和bill的映射
billMap[car] = bill__;
billMap[tyre] = bill__;
billMap[hub] = bill__;| 公司名 | 地址 |
|---|---|
| Car | 0xca35b7d915458ef540ade6068dfe2f44e8fa733c |
| Tyre | 0x14723a09acff6d2a60dcdf7aa4aff308fddc160c |
| Hub | 0x4b0897b0513fdc7c541b6d9d7e929c4e5364d2db |
| Alui | 0x583031d1113ad414f02576bd6afabfb302140225 |
| Alum | 0xdd870fa1b7c4700f2bd7f44238821c26f7392148 |
| Bank | 0x95f452956282a5bfc2c8522bf23cd5525fcbcb9b |
单据生成函数：function createBill(address payee, uint amount) public {}
function createBill(address payee, uint amount) public {
require(msg.sender != payee, "Bill payee cannot be yourself!");
require(payee != bank, "Bill payee cannot be bank!");
Bill memory bill;
bill.transactionCounts = 1;
bill.payer = msg.sender;
if (bill.payer != car) {
bill.ability = false;
}
else bill.ability = true;
bill.payee = payee;
bill.billBalance = amount;
// 创建公司的Bill
billMap[msg.sender] = bill;
billMap[payee] = bill;
emit Bill_("Create a bill!", bill.payer, payee, amount, bill.ability);
}要求：
- 收款公司不能为单据生成公司
- 收款公司不能为银行
功能：
- 设置交易双方和单据金额（根据传入参数）
- 交易次数（
transactionCounts）变为1 - 设置交易时间
- 根据payer（付款公司）确认该单据是否有
ability - 根据payee（收款公司）确认该单据交易的商品（
commodity）信息 - 将Bill加入Commpany与Bill的映射表中
函数：function transferBill(address payee, uint amount) public{}
// 转让单据
function transferBill(address receiver, uint amount) public{
require(billMap[msg.sender].billBalance >= amount, "Insufficient bill balance!");
billMap[msg.sender].payer = msg.sender;
billMap[msg.sender].payee = receiver;
billMap[msg.sender].billBalance -= amount;
billMap[msg.sender].transactionCounts += 1;
billMap[receiver].transactionCounts += 1;
billMap[receiver].payer = msg.sender;
billMap[receiver].payee = receiver;
billMap[receiver].billBalance += amount;
billMap[receiver].ability = billMap[msg.sender].ability;
emit Tran_("Transfer a Bill!", msg.sender, receiver, amount, billMap[msg.sender].billBalance, billMap[receiver].billBalance, billMap[msg.sender].ability, billMap[receiver].ability);
}要求：
- 单据中的交易次数至少为1
- 单据的金额不小于交易金额
功能：
- 创建新的Bill
- 更新交易双方信息
- 付款方单据金额减少
- 收款方单据金额增加
- 交易时间的修改
- 交易次数加1
ability不变- 将更新的Bill加入到billMap中
说明：单据的转让过程中，其实交易双方的信息修改和交易商品的更新是不重要的，重要的是ability的传递、单据金额的变化和交易时间的更新，ability和金额确定公司能否根据此单据向银行借一定资金
函数：function borrowBill(address payee, uint amount) public{}
// 向银行申请融资
function applyFinancing(address financier, uint amount) public{
require(financier == bank, "Please apply to the bank for financing");
require(billMap[msg.sender].ability == true, "Bills are not eligible for financing!");
require(billMap[msg.sender].billBalance >= amount, "The amount of financing exceeds the balance of the bill!");
companyMap[msg.sender].property += amount;
billMap[msg.sender].payer = msg.sender;
billMap[msg.sender].payee = bank;
billMap[msg.sender].transactionCounts += 1;
billMap[msg.sender].billBalance -= amount;
emit Fina_("Apply to the bank for financing!", msg.sender, financier, amount, companyMap[msg.sender].property);
}要求：
- Bill的
ability为true - Bill的金额不小于借款金额
- Bill的收款方必须为银行
功能：
- 单据转让功能
- 公司资金增加
- 金融机构资金减少
- 将更新的Bill加入到
billMap中
函数：function payBill() public {}
// 还款
function payBill(address payee) public {
require(msg.sender == car, "You don't have to pay bill!");
require(billMap[payee].ability == true && billMap[payee].billBalance > 0, "You don't have to pay no ability bill!");
require(companyMap[msg.sender].property > billMap[payee].billBalance, "Insufficient company assets!");
uint amount = billMap[payee].billBalance;
billMap[payee] = bill__;
companyMap[msg.sender].property -= amount;
companyMap[payee].property += amount;
emit Pay_("Pay a bill!", msg.sender, payee, amount, companyMap[msg.sender].property, companyMap[payee].property);
}要求：
- 结算公司为
Car - 还款单据的
ability为true - 结算公司的
财产（property）大于单据的金额（billBalance）
功能：
- 单据销毁（重新初始化）
- 持有单据的公司资金增加
- 核心公司的资金减少
-
Car公司生成ability为true的单据(能向银行借款)调用createBill函数，当前账户为payer（Car），payee为传入的公司地址(Tyre)，amount为单据金额
函数调用结果
查询"billMap"中的Bill结果(decoded input 为key：公司地址；decoded output为value：Bill信息)
-
Tyre公司生成ability为false的单据调用createBill函数，当前账户为payer（Tyre），payee为传入的公司地址(Car)，amount为单据金额
函数调用结果
查询"billMap"中的Bill结果(decoded input 为key：公司地址；decoded output为value：Bill信息)
-
不能生成
payee为自身的单据调用createBill函数，当前账户为payer（Car），payee为传入的公司地址，amount为单据金额
函数调用结果
-
不能生成
收款公司为Bank的单据调用createBill函数，当前账户为payer（Car），payee为传入的公司地址(Bank)，amount为单据金额
函数调用结果
-
先调用
billMap查看原来的Tyre公司持有的单据情况（特别是billBalance和ability）
-
再调用
billMap查看Hub公司的单据
-
调用
transferBill函数，当前账户为payer（Tyre），payee为Hub，amount为单据金额-
当payer的
bill余额小于amount时结果为
-
当payer的
bill余额不小于amount时结果为
-
-
单据转让后的结果为：
-
Tyre公司的单据更新：payer和payee的地址更新，单据交易次数(transactionCounts)加1，billBalance减去转让的金额（5000- 3000），ability不变
-
Hub公司的单据更新：payer和payee的地址更新，单据交易次数(transactionCounts)加1，billBalance加上转让的金额（0 + 3000），ability为payer的ability
-
-
调用
applyFinancing函数，Hub公司凭借单据（如上图）向银行借款（ability为true）(公司的初始property都为3000)-
借款金额超过
3000（5000），结果如下：
-
借款金额为低于3000（
2000），公司的property增加2000，单据的billBalance减少2000，结果如下：
-
-
Bill的ability为false时不能向Bank申请融资
-
financier不为Bank时，不能申请融资
-
先调用
billMap，查看Tyre的单据，如下： -
Car调用payBill函数，payee为Tyre，Car的property减去Tyre的bill的billBalance（10000 - 5000 = 5000），Tyre增加相应金额(3000 + 5000 = 8000)，然后Tyre的bill被重新初始化
-
非
Car公司不能调用此函数
-
bill的ability为false时不用还款
-
公司
property不足时不能结算
通过FISCO BCOS控制台提供的方法先将合约转换为Java类(源码地址)：
-
将合约文件放入
fisco-bcos/console/contracts/solidity下
-
在
console目录下指定包名运行sol2java.sh脚本
$ cd ~/fisco/console
$ ./sol2java.sh org.com.fisco
-
运行成功之后，将会在console/contracts/sdk目录生成java、abi和bin目录，如下所示：
-
在
fisco-bcos上部署SupplyChain.sol
前端使用vue框架搭建，npm安装框架
- 首先安装npm：sudo apt install npm(依赖nodejs，所以需要先安装node)
- 然后安装vue-cli脚手架：sudo npm install -g vue-cli（-g为安装到全局）
- node和npm版本要在4以上（node -v, npm -v）
- 由于最初的源使用npm install命令时非常的慢，所以可以通过命令npm config set registry https://registry.npm.taobao.org切换阿里的源
- 通过npm config get registry查看npm的源
- 然后进入vue项目中（含vue的目录结构），通过命令npm install安装依赖
- 通过命令npm run dev在本地端口8080启动项目
……
这次作业虽然真正只实现了链端，但收获还是蛮多的，学习了一门新的语言solidity，在有其他语言的基础下，solidity的学习还是比较容易的，只是要注意一些特别的变量和函数而已，像address、bytes、event、emit等。除此之外，还通过使用FISCO BCOS和WEBASE了解了区块链链端的知识，包括链的搭建，合约的部署以及合约的调用等等。