consensusnetworks/consensus-port

Port

:ship: Accumulate网络的供应链共识区块浏览器

镜像概述

Port区块浏览器帮助用户理解和处理Accumulate网络上来自供应链预言机数据的交易，展示该网络如何为数字经济提供桥梁。Accumulate是一款适用于DeFi的高性能***，可集成多种***、协议、预言机及应用。

默认情况下，该浏览器使用Accumulate测试网中ADIs acc://.../acme 和 acc://.../data 的测试供应链预言机数据。若需连接自定义预言机ADI以访问测试数据或供应链，可通过环境变量 ADI_LIST 覆盖默认ADI。此区块浏览器假设供应链预言机数据遵循 https://schema.org/%EF%BC%8C%E6%82%A8%E5%BA%94%E6%A0%B9%E6%8D%AE%E8%AF%A5 schema 的必填及可扩展属性结构化交易数据。

核心功能

1. 解析并展示供应链预言机数据的交易详情
2. 支持通过环境变量自定义预言机ADI列表
3. 提供GraphQL服务和微服务API与Accumulate网络集成
4. 前端使用Tailwind CSS和Chart.js呈现直观的数据分析结果
5. 基于NuxtJS SSR架构，可通过Docker容器部署到任意环境

使用场景

1. 供应链参与者查看交易数据，验证共识状态
2. 开发者测试自定义供应链预言机数据的展示效果
3. 研究人员分析Accumulate网络在供应链场景中的应用价值

配置说明

• 环境变量：ADI_LIST - 自定义预言机ADI列表，多个ADI用逗号分隔
• 端口：默认暴露3000端口，需映射到主机端口以访问浏览器界面

部署示例

Docker Run

bash
docker run -d --name consensus-port \
  -p 3000:3000 \
  -e ADI_LIST="acc://your-custom-adi-1,acc://your-custom-adi-2" \
  consensusnetworks/consensus-port

安装与开发

前提条件

• Node.js LTS
• Docker Desktop

依赖安装

bash
npm install

开发服务器

启动本地开发服务器（访问地址：http://localhost:3000%EF%BC%89%EF%BC%9A

bash
npm run dev

测试

后续将添加与Nuxt SSR和Docker兼容的测试脚本（如Nuxt 3的@nuxt/test-utils），并在GitHub Actions的拉取请求工作流中执行。长期计划引入更完善的工具，在本地Kubernetes集群（如Okteto）中测试应用，以更贴近生产环境。

版本发布

遵循https://semver.org/%E6%A0%87%E5%87%86%EF%BC%8C%E4%BD%BF%E7%94%A8https://github.com/release-it/release-it%E5%B7%A5%E5%85%B7%E8%87%AA%E5%8A%A8%E5%8C%96%E7%89%88%E6%9C%AC%E7%AE%A1%E7%90%86%EF%BC%9A

1. 执行发布命令：

   bash
   npm run release
   

2. 选择版本增量类型（major/minor/patch）并确认提交：

   bash
   ? Select increment (next version): patch (0.0.2)
   ✔ npx auto-changelog -p
   ? Commit (Release 0.0.2)? y
   

该流程将更新CHANGELOG.md、package.json及package-lock.json，并创建GitHub Release。

部署流程

通过GitHub Actions工作流实现镜像的测试、构建与推送：

• 向develop和master分支提交拉取请求时触发镜像构建
• 推送至master分支时，镜像推送到Docker Hub，标签为latest和**{commit-hash}**
• 从master分支创建Release时，镜像标签包含latest、{commit-hash}和{release-number}

Kubernetes集群及Pod配置将在单独仓库管理，以隔离环境配置与应用开发。示例Kubernetes清单位于kubernetes目录，用于参考部署该Nuxt应用到云服务商托管集群。

贡献指南

欢迎向develop分支提交拉取请求。对于重大变更，请先查看https://github.com/consensusnetworks/consensus-port/issues%E5%B9%B6%E5%88%9B%E5%BB%BA%E6%96%B0Issue%E5%90%8E%E5%86%8D%E5%BC%80%E5%A7%8B%E5%B7%A5%E4%BD%9C%E3%80%82%E8%AF%B7%E7%A1%AE%E4%BF%9D%E6%9B%B4%E6%96%B0%E7%9B%B8%E5%BA%94%E6%B5%8B%E8%AF%95%EF%BC%8C%E6%9C%AA%E6%9D%A5%E5%B0%86%E6%B7%BB%E5%8A%A0%E9%A3%8E%E6%A0%BC%E6%8C%87%E5%8D%97%E3%80%82

许可证

https://choosealicense.com/licenses/mit/