# 整体结构

Hyperledger Fabric 从 1.0.0 开始，架构已经解耦为三个主要部分：

* fabric-peer：主要起到 peer 作用，包括 endorser、committer 两种角色；
* fabric-ca：即原先的 membersrvc，独立成一个新的项目。
* fabric-order：起到 order 作用。

其中，fabric-peer 和 fabric-order 代码暂时都在 fabric 项目中，未来可能进一步拆分。

## 核心代码

fabric 项目中主要包括代码、工具、脚本等部分，核心源代码目前（v2.5.2）为 797 个文件，157K 行。

```sh
$ cd fabric
$ find bccsp ccaas_builder cmd common core discovery gossip internal msp orderer pkg protoutil tools \
    -not -path "*/vendor/*" \
    -not -path "*mock*" \
    -name "*.go"  \
    -not -name "*_test.go" \
    -not -name "test_*.go" \
    | wc -l

     797
$ find bccsp ccaas_builder cmd common core discovery gossip internal msp orderer pkg protoutil tools \
    -not -path "*/vendor/*" \
    -not -path "*mock*" \
    -name "*.go"  \
    -not -name "*_test.go" \
    -not -name "test_*.go" \
    | xargs cat | wc -l

156982
```

### 源代码

实现 fabric 功能的核心代码，包括：

* [bccsp](https://yeasy.gitbook.io/hyperledger_code_fabric/bccsp) 包：实现对加解密算法和机制的支持。
* [common](https://yeasy.gitbook.io/hyperledger_code_fabric/common) 包：一些通用的模块；
* [core](https://yeasy.gitbook.io/hyperledger_code_fabric/core) 包：大部分核心实现代码都在本包下。其它包的代码封装上层接口，最终调用本包内代码；
* [events](https://github.com/yeasy/hyperledger_code_fabric/blob/master/events/README.md) 包：支持 event 框架；
* [examples](https://yeasy.gitbook.io/hyperledger_code_fabric/examples) 包：包括一些示例的 chaincode 代码；
* [gossip](https://yeasy.gitbook.io/hyperledger_code_fabric/gossip) 包：实现 gossip 协议；
* [msp](https://yeasy.gitbook.io/hyperledger_code_fabric/msp) 包：Member Service Provider 包；
* [order](https://github.com/yeasy/hyperledger_code_fabric/blob/master/order/README.md) 包：order 服务相关的入口和框架代码；
* [peer](https://yeasy.gitbook.io/hyperledger_code_fabric/peer) 包：peer 的入口和框架代码；
* [protos](https://yeasy.gitbook.io/hyperledger_code_fabric/protos) 包：包括各种协议和消息的 protobuf 定义文件和生成的 go 文件。

### 源码相关工具

一些辅助代码包，包括：

* [bddtests](https://github.com/yeasy/hyperledger_code_fabric/blob/master/bddtests/README.md)：测试包，含有大量 bdd 测试用例；
* [gotools](https://yeasy.gitbook.io/hyperledger_code_fabric/gotools)：golang 开发相关工具安装；
* [vendor](https://github.com/yeasy/hyperledger_code_fabric/blob/master/vendor/README.md) 包：管理依赖；

### 安装部署

包括：

* [busybox](https://github.com/yeasy/hyperledger_code_fabric/blob/master/busybox/README.md)：busybox 环境，精简的 linux；
* [devenv](https://github.com/yeasy/hyperledger_code_fabric/blob/master/devenv/README.md)：配置开发环境；
* [images](https://yeasy.gitbook.io/hyperledger_code_fabric/images)：镜像生成模板等。
* [scripts](https://yeasy.gitbook.io/hyperledger_code_fabric/scripts)：各种安装配置脚本；

### 其它工具

其他工具，包括：

* [docs](https://yeasy.gitbook.io/hyperledger_code_fabric/docs)：文档，大部分文档都可以 [在线查阅](http://hyperledger-fabric.readthedocs.io)；

## 配置、脚本和文档

除了些目录外，还包括一些说明文档、安装需求说明、License 信息文件等。

### Docker 相关文件

* .baseimage-release：生成 baseimage 时候的版本号。
* .dockerignore：生成 Docker 镜像时忽略一些目录，包括 .git 目录。

### git 相关文件

* .gitattributes：git 代码管理时候的属性文件，带有不同类型文件中换行符的规则，默认都为 linux 格式，即 。
* .gitignore：git 代码管理时候忽略的文件和目录，包括 build 和 bin 等中间生成路径。
* .gitreview：使用 git review 时候的配置，带有项目的仓库地址信息。
* README.md：项目的说明文件，包括一些有用的链接等。

### travis 相关文件

* .travis.yml：travis 配置文件，目前是使用 golang 1.6 编辑，运行了三种测试：unit-test、behave、node-sdk-unit-tests。

### 其它

* LICENSE：Apache 2 许可文件。
* docker-env.mk：被 Makefile 引用，生成 Docker 镜像时的环节变量。
* Makefile：执行测试、格式检查、安装依赖、生成镜像等操作。
* mkdocs.yml：生成 <http://hyperledger-fabric.readthedocs.io> 在线文档的配置文件。
* TravisCI\_Readme.md