From eaeb3bfbf4f849c6a01e8e976ab1a4c4f0ace441 Mon Sep 17 00:00:00 2001 From: wenlinli <1574249665@qq.com> Date: Fri, 19 Apr 2024 14:27:52 +0800 Subject: [PATCH] add 3.7.1 & 3.2.7 doc and fix image error --- .../application_westlake_longjingtea_yifei.md | 76 ++++++--------- .../docs/introduction/change_log/3_2_7.md | 90 +++++++++++++++++ .../docs/introduction/change_log/3_7_1.md | 97 +++++++++++++++++++ .../docs/introduction/change_log/index.rst | 2 + 4 files changed, 217 insertions(+), 48 deletions(-) create mode 100644 3.x/zh_CN/docs/introduction/change_log/3_2_7.md create mode 100644 3.x/zh_CN/docs/introduction/change_log/3_7_1.md diff --git a/3.x/zh_CN/docs/articles/6_application/application_westlake_longjingtea_yifei.md b/3.x/zh_CN/docs/articles/6_application/application_westlake_longjingtea_yifei.md index 6854d18bf..2865507a5 100644 --- a/3.x/zh_CN/docs/articles/6_application/application_westlake_longjingtea_yifei.md +++ b/3.x/zh_CN/docs/articles/6_application/application_westlake_longjingtea_yifei.md @@ -6,90 +6,70 @@ ##
***01 项目背景*** #### 1.1 业务需求 -西湖龙井是十大名茶之首，也是杭州独具特色名片之一。位于龙井村狮峰山脚下之龙井路上的杭州西湖龙井茶叶有限公司，是一家实力雄厚，颇具规模的西湖龙井茶生产企业。公司打造的“贡”牌西湖龙井，作为国家的礼茶，在国内外享有盛誉。希望通过数字化转型利用前沿技术，打破传统茶叶产业链格局，逐步朝着数字化、智慧化发展 。 +西湖龙井是十大名茶之首，也是杭州独具特色名片之一。位于龙井村狮峰山脚下之龙井路上的杭州西湖龙井茶叶有限公司，是一家实力雄厚，颇具规模的西湖龙井茶生产企业。公司打造的“贡”牌西湖龙井，作为国家的礼茶，在国内外享有盛誉。希望通过数字化转型利用前沿技术，打破传统茶叶产业链格局，逐步朝着数字化、智慧化发展 。 + +![](../../../images/articles/application_westlake_longjingtea_yifei/IMG_5647.PNG) +![](../../../images/articles/application_westlake_longjingtea_yifei/IMG_5648.PNG) -
- - -
- #### 1.2 解决方案 -- 建立以打造“数字贡牌”为目标，围绕品种保护、生态茶园、生产管理、茶文旅等方面，构建“数字贡牌”产业数字化基础，运用物联网、区块链、5G等技术作为“数字贡牌”建设的技术支撑。用数字赋能产业，提升产业价值。 + +- 建立以打造“数字贡牌”为目标，围绕品种保护、生态茶园、生产管理、茶文旅等方面，构建“数字贡牌”产业数字化基础，运用物联网、区块链、5G等技术作为“数字贡牌”建设的技术支撑。用数字赋能产业，提升产业价值。 - 建立“数字茶园”、“数字生产”、“数字展示”等三大数字化体系，可为生产经营、监管服务、决策分析提供多维度、多场景的品牌建设服务，实现“用数据说话、用数据决策、用数据管理、用数据创新”，用数据赋能“数字贡牌”品牌建设。 ##
***02 技术方案*** -
- -
+ +![](../../../images/articles/application_westlake_longjingtea_yifei/IMG_5649.PNG) #### 2.1 数字茶园 + - 气象环境监测 - 土壤墒情监测 - 可视化视频监控 - 病虫害监测预警 - -
- - -
+ ![](../../../images/articles/application_westlake_longjingtea_yifei/IMG_5650.PNG) + ![](../../../images/articles/application_westlake_longjingtea_yifei/IMG_5651.PNG) #### 2.2 数字生产-生产计划管理 -生产计划管理系统是对企业计划的管理，具体包括制定计划、执行计划、完成计划等三方面的工作。企业生产计划主要分为田间管理计划、灌溉计划、植保计划、施肥计划、采收计划等方面。只有制定生产计划，企业才能合理安排产品生产过程的操作与管理。 -
- -
+生产计划管理系统是对企业计划的管理，具体包括制定计划、执行计划、完成计划等三方面的工作。企业生产计划主要分为田间管理计划、灌溉计划、植保计划、施肥计划、采收计划等方面。只有制定生产计划，企业才能合理安排产品生产过程的操作与管理。 +![](../../../images/articles/application_westlake_longjingtea_yifei/IMG_5652.PNG) #### 2.3 数字生产-种植管理 系统实现对种植产品种植过程提供专业和标准的生产档案信息表格，生产档案按照茶树特点和生产标准及企业标准进行定制，按照企业生产批次采集生产档案，实现生产档案数据的完整性，确保企业的每一个生产批次都有据可查。 - -
- -
+![](../../../images/articles/application_westlake_longjingtea_yifei/IMG_5653.PNG) #### 2.4 数字展示-大数据平台 -
- -
+ +![](../../../images/articles/application_westlake_longjingtea_yifei/IMG_5654.PNG) #### 2.5 数字展示-溯源 -
- -
+ +![](../../../images/articles/application_westlake_longjingtea_yifei/IMG_5655.PNG) ##
***03 区块链 + 溯源*** #### 3.1 什么是溯源 -
- -
+ +![](../../../images/articles/application_westlake_longjingtea_yifei/IMG_5656.PNG) #### 3.2 如何溯源 消费者买到产品后，只需扫一扫产品上的二维码身份证,即可了解产品源产地、生产者、种养殖信息、农药施肥信息各类检测和流通信息、生产企业、产品品牌故事等。 -
- -
+![](../../../images/articles/application_westlake_longjingtea_yifei/IMG_5657.PNG) #### 3.3 业务痛点 有了追溯体系，每件地方特色产品从哪来到哪去，中间经过哪些流通环节，皆可全程跟踪溯源 -
- -
+![](../../../images/articles/application_westlake_longjingtea_yifei/IMG_5658.PNG) #### 3.4 区块链 + 溯源 -
- -
+ +![](../../../images/articles/application_westlake_longjingtea_yifei/IMG_5659.PNG) 利用区块链的去中心化和防篡改的特性。将农产品溯源的过程数据上链。当溯源过程数据上链后，数据将被痕迹化且不可篡改，这样可以有效的证明溯源数据的真实有效。 ##
***04 技术探讨*** #### 4.1 区块链+IoT -通过IoT设备自动化采集农情数据，对比传统的人工填报方式，从源头上保障了过程数据来源真实性，基于BSN联盟链，我们通过智能合约机制进行数据上链，保障了上链过程的透明化，同时基于拜占庭容错的共识机制实现数据防篡改。在面向消费者的溯源码中，“兴农码”基于一品一码模式，为每一份茶叶商品提供了具有全球唯一标识的区块链认证证书，电子证书中详细记录了茶叶种植过程各个环节的上链数据hash，上链时间戳等信息， 证书中的全过程溯源数据都存储于BSN联盟链的城市节点上，通过“物链网”解决方案区块链+溯源应用的落地性得到了很大提升。 -
- -
+通过IoT设备自动化采集农情数据，对比传统的人工填报方式，从源头上保障了过程数据来源真实性，基于BSN联盟链，我们通过智能合约机制进行数据上链，保障了上链过程的透明化，同时基于拜占庭容错的共识机制实现数据防篡改。在面向消费者的溯源码中，“兴农码”基于一品一码模式，为每一份茶叶商品提供了具有全球唯一标识的区块链认证证书，电子证书中详细记录了茶叶种植过程各个环节的上链数据hash，上链时间戳等信息， 证书中的全过程溯源数据都存储于BSN联盟链的城市节点上，通过“物链网”解决方案区块链+溯源应用的落地性得到了很大提升。 +![](../../../images/articles/application_westlake_longjingtea_yifei/IMG_5660.PNG) #### 4.2 5G、AI技术融合 -
- -
+ +![](../../../images/articles/application_westlake_longjingtea_yifei/IMG_5661.PNG) diff --git a/3.x/zh_CN/docs/introduction/change_log/3_2_7.md b/3.x/zh_CN/docs/introduction/change_log/3_2_7.md new file mode 100644 index 000000000..9350b4aae --- /dev/null +++ b/3.x/zh_CN/docs/introduction/change_log/3_2_7.md @@ -0,0 +1,90 @@ +# v3.2.7 + +#### 新增 + +* [build_chain.sh脚本新增轻节点扩容功能](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4348) + +#### 修复 + +* [同步3.6.0中修复的bug](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4237) +* [同步3.7.0中修复的bug](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4364) +* [修复keyPage哈希不一致的兼容问题](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4230) + +#### 升级描述 + +* 升级节点可执行程序 + + 效果：修复bug，并带来稳定性、性能的提升 + + 操作：停止节点服务，升级节点可执行程序为当前版本，重启节点服务 + + 注意事项：推荐逐步替换可执行程序进行灰度升级 + + 支持升级的版本：v3.0.0+ + +* 升级链数据版本 + + 效果：可使用当前版本的最新特性 + + 操作：先完成升级所有节点可执行程序，再参考[文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/introduction/change_log/3_2_1.html#id5) + 发送交易升级链数据版本至 v3.2.0 + + 注意事项：务必备份原节点的所有账本数据，若操作失误造成升级失败，可通过原数据回滚到升级前的状态 + 支持升级的版本：v3.0.0+ + +* 组件兼容性 + + 请查阅[完整描述](https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/compatibility.html) + +| | 推荐版本 | 最低版本 | 说明 | +|------------|-------------|---------------------|-------------------| +| WeBASE | 3.0.2 | 3.0.2 | | +| WeIdentity | v3.0.0-rc.1 | v3.0.0-rc.1 | | +| Console | 3.2.0 | 3.0.0 | | +| Java SDK | 3.2.2 | 3.0.0 | | +| CPP SDK | 3.2.2 | 3.0.0 | | +| Solidity | 0.8.11 | 最低 0.4.25，最高 0.8.11 | 需根据合约版本下载编译器（控制台） | +| WBC-Liquid | 1.0.0-rc3 | 1.0.0-rc3 | | + +#### 升级方法 + +该操作仅支持将3.x版本升级为本版本，不支持3.0-rc或2.x的升级。 + +##### 查询数据兼容版本号（compatibility_version） + +用[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/operation_and_maintenance/console/console_commands.html#getsystemconfigbykey) +进行查询，如当前返回的版本为3.0.0 + +``` +[group0]: /apps> getSystemConfigByKey compatibility_version +3.0.0 +``` + +##### 替换节点二进制 + +需将**所有节点** +的二进制逐步替换为当前版本。为了不影响业务，替换过程能够以灰度方式进行，逐个替换并重启节点。替换过程中，当前的链仍然会以旧的数据兼容版本号的逻辑继续执行。当所有节点二进制替换完成并重启后，需用控制台修改数据兼容版本号为当前版本。 + +##### 设置数据兼容版本号（compatibility_version） + +用[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/operation_and_maintenance/console/console_commands.html#setsystemconfigbykey) +设置数据兼容版本号，如当前版本为3.2.0。 + +``` +[group0]: /apps> setSystemConfigByKey compatibility_version 3.2.0 +{ + "code":0, + "msg":"success" +} + +注：若开启权限治理功能，需要使用 setSysConfigProposal 命令 +``` + +设置成功，再次查询，得到当前版本已升级为3.2.0 + +``` +[group0]: /apps> getSystemConfigByKey compatibility_version +3.2.0 +``` + +当前链已经完成升级，至此，**链开始以新的逻辑继续运行**，并支持了新的特性。 \ No newline at end of file diff --git a/3.x/zh_CN/docs/introduction/change_log/3_7_1.md b/3.x/zh_CN/docs/introduction/change_log/3_7_1.md new file mode 100644 index 000000000..0d882f4d5 --- /dev/null +++ b/3.x/zh_CN/docs/introduction/change_log/3_7_1.md @@ -0,0 +1,97 @@ +# v3.7.1 + +#### 新增 + +* [新增节点只读模式开关](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4335) + +#### 修改 + +* [通过修改boost-asio版本，修复timer_remove会core的问题](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4336) +* [修改网络disconnect日志为INFO级别](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4351) + + +* 历史版本升级 + + 需要升级的链的“数据兼容版本号（[compatibility_version](#id5)）”为如下版本时： + + * 3.4.x、3.5.x，3.6.x、3.7.x：数据完全兼容当前版本，直接替换二进制即可完成升级 + * + 3.3.x、3.2.x、3.1.x、3.0.x：支持通过替换二进制进行灰度升级，若需使用当前版本的新特性，需升级数据兼容版本号，操作见[文档](#id5) + * 3.0-rc x：数据不兼容，无法升级，可考虑逐步将业务迁移至3.x正式版 + * 2.x：数据不兼容，2.x版本仍持续维护，可考虑升级为2.x的最新版本 + + +* 开启实验功能 + + 效果：通过feature开关控制实验功能的开启 + + 操作：升级节点可执行程序后，通过控制台命令`setSystemConfigByKey 1` 开启对应实验功能，具体操作见文档升级方法部分 + + 注意事项： + * feature操作不可逆，打开后不可关闭 + * 需确认所有可执行程序版本相同后，再进行feature开启操作 + +| | Feature 名 | 默认状态 | 说明 | +|-----------|----------------------------|------|--------------------------------------------| +| 资产管理 | feature_balance | 关：0 | 默认关闭 | +| 资产操作预编译合约 | feature_balance_precompile | 关：0 | 默认关闭 | +| 计费模式 | feature_policy1 | 关：0 | 默认关闭 | +| 块内分片 | feature_sharding | 关：0 | 默认关闭，仅在从3.3、3.4升级至当前版本时，feature_sharding打开 | +| 同态加密 | feature_paillier | 关：0 | 默认关闭 | +| rpbft共识 | feature_rpbft | 关：0 | 默认关闭 | +| bug修复 | bugfix_\ | 开：1 | 从低版本升级默认关闭 | + +**组件兼容性** + +| | 推荐版本 | 最低版本 | 说明 | +|------------|-------------|---------------------|-------------------| +| WeBASE | 3.0.2 | 3.0.2 | | +| WeIdentity | v3.0.0-rc.1 | v3.0.0-rc.1 | | +| Console | 3.7.0 | 3.0.0 | | +| Java SDK | 3.7.0 | 3.0.0 | | +| CPP SDK | 3.7.0 | 3.0.0 | | +| Solidity | 0.8.11 | 最低 0.4.25，最高 0.8.11 | 需根据合约版本下载编译器（控制台） | +| WBC-Liquid | 1.0.0-rc3 | 1.0.0-rc3 | | + +#### 升级方法 + +该操作仅支持将3.x版本升级为本版本，不支持3.0-rc或2.x的升级。 + +##### 查询数据兼容版本号（compatibility_version） + +用[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/operation_and_maintenance/console/console_commands.html#getsystemconfigbykey) +进行查询，如当前返回的版本为3.6.0 + +``` +[group0]: /apps> getSystemConfigByKey compatibility_version +3.6.0 +``` + +##### 替换节点二进制 + +需将**所有节点** +的二进制逐步替换为当前版本。为了不影响业务，替换过程能够以灰度方式进行，逐个替换并重启节点。替换过程中，当前的链仍然会以旧的数据兼容版本号的逻辑继续执行。当所有节点二进制替换完成并重启后，需用控制台修改数据兼容版本号为当前版本。 + +##### 设置数据兼容版本号（compatibility_version） + +用[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/operation_and_maintenance/console/console_commands.html#setsystemconfigbykey) +设置数据兼容版本号，如当前版本为3.7.0。 + +``` +[group0]: /apps> setSystemConfigByKey compatibility_version 3.7.0 +{ + "code":0, + "msg":"success" +} + +注：若开启权限治理功能，需要使用 setSysConfigProposal 命令 +``` + +设置成功，再次查询，得到当前版本已升级为3.7.0 + +``` +[group0]: /apps> getSystemConfigByKey compatibility_version +3.7.0 +``` + +当前链已经完成升级，至此，**链开始以新的逻辑继续运行**，并支持了新的特性。 diff --git a/3.x/zh_CN/docs/introduction/change_log/index.rst b/3.x/zh_CN/docs/introduction/change_log/index.rst index 20dff4b33..481f39ca1 100644 --- a/3.x/zh_CN/docs/introduction/change_log/index.rst +++ b/3.x/zh_CN/docs/introduction/change_log/index.rst @@ -41,6 +41,7 @@ v3.7.x :maxdepth: 0 3_7_0.md + 3_7_1.md v3.6.x ------------------ @@ -160,6 +161,7 @@ v3.2.x :hidden: :maxdepth: 0 + 3_2_7.md 3_2_6.md 3_2_5.md 3_2_4.md