diff --git a/docs/images/arch.jpg b/docs/images/arch.jpg
new file mode 100644
index 00000000..285f8085
Binary files /dev/null and b/docs/images/arch.jpg differ
diff --git a/docs/zh_cn/SUMMARY.md b/docs/zh_cn/SUMMARY.md
index a0bf864f..65e757ef 100644
--- a/docs/zh_cn/SUMMARY.md
+++ b/docs/zh_cn/SUMMARY.md
@@ -20,6 +20,9 @@
 [comment]: <> "For developer"
 * [参与贡献](contribute/how-to-contribute.md)
     * [如何贡献代码](contribute/contribute-codes.md)
+      * [代码结构说明](development/source-code-layout.md)
+      * [核心工作原理](development/core-logic.md)
+      * [Annotation 开发指南](development/annotation-implement-guide.md)
     * [如何贡献文档](contribute/contribute-documents.md)
     * [版本发布说明](https://www.bfe-networks.net/zh_cn/development/release_regulation/)
 
diff --git a/docs/zh_cn/development/annotation-implement-guide.md b/docs/zh_cn/development/annotation-implement-guide.md
new file mode 100644
index 00000000..ecd89e56
--- /dev/null
+++ b/docs/zh_cn/development/annotation-implement-guide.md
@@ -0,0 +1,356 @@
+# Annotation 开发指南
+
+## 概述
+
+在为 BFE Ingress Controller 中开发 Annotation 时，可参考本开发设计指南。
+
+核心关注以下方面：
+- Annotation 的定义
+- Annotation 的解析
+- BFE 配置的生成
+- BFE 配置的热加载
+
+下面的讲述中，将结合 `bfe.ingress.kubernetes.io/balance.weight` 的实现作为例子。
+该Annotation用于支持多个Service之间的[负载均衡][]。
+> [balance.go][]
+
+## 1. Annotation 的定义
+根据需求不同，您可能需要定义并实现一个BFE Ingress Controller 的 Annotation，或者对 k8s Ingress 已定义的 Annotation 进行实现。
+
+### 命名规范
+- Key:
+    - BFE Ingress Controller 的 Annotation
+        - `bfe.ingress.kubernetes.io/{module}.{key}`
+        - `bfe.ingress.kubernetes.io/{key}`
+    - k8s Ingress 约定的 Annotation
+        - `kubernetes.io/{key}`
+        - `ingressclass.kubernetes.io/{key}`
+- Value: 根据需求设计定义
+
+### 案例分析
+
+- Key: `bfe.ingress.kubernetes.io/balance.weight`
+- Value: 详见[负载均衡][]
+    - Demo: `{"service": {"service1":80, "service2":20}}`
+- 源码
+    - /internal/bfeConfig/annotations/[balance.go][]
+
+    ```go
+    const (
+      WeightKey        = "balance.weight"
+      WeightAnnotation = BfeAnnotationPrefix + WeightKey
+    )
+    
+    // ServicesWeight define struct of annotation "balance.weight"
+    // example: {"service": {"service1":80, "service2":20}}
+    type ServicesWeight map[string]int
+    type Balance map[string]ServicesWeight
+    ```
+
+### 已有的 Annotation
+
+| Annotation 名  | 作用 |
+| :--- | :---: |
+| bfe.ingress.kubernetes.io/balance.weight | [负载均衡][] |
+| bfe.ingress.kubernetes.io/router.cookie | 路由匹配条件：[匹配 Cookie](../ingress/basic.md#cookie) |
+| bfe.ingress.kubernetes.io/router.header | 路由匹配条件：[匹配 Header](../ingress/basic.md#header) |
+| bfe.ingress.kubernetes.io/bfe-ingress-status | [生效状态](../ingress/validate-state.md) |
+| kubernetes.io/ingress.class | [申明 Ingress 类](https://kubernetes.io/zh/docs/concepts/services-networking/ingress/#deprecated-annotation) |
+| ingressclass.kubernetes.io/is-default-class | [申明默认 Ingress 类](https://kubernetes.io/docs/concepts/services-networking/ingress/#default-ingress-class) |
+
+### 注意事项
+
+新 BFE Ingress Controller Annotation 的定义需兼容已有的 Annotation，在实现指定功能的基础上，尽量做到：
+
+- 设计简洁
+- 避免与已有 Annotation 功能重复
+
+更多细节建议在 [Issue][] 中讨论
+
+## 2. Annotation 的解析
+
+### 触发时机
+
+1. [Kubernetes controller-runtime][] 监听事件后，触发 Reconcile
+2. Reconciler 在[回调函数][ingress_controller.go]中，触发 configBuilder 的更新
+3. configBuilder 更新过程中，根据输入的 Ingress 资源 [解析][balance.go] 指定 Annotation，用于后续生成 BFE 配置
+
+### 案例分析
+
+- 指定 Annotation： `bfe.ingress.kubernetes.io/balance.weight`
+- 源码
+    - /internal/controllers/ingress/netv1/[ingress_controller.go][]
+
+    ```go
+    func ReconcileV1Ingress(ctx context.Context, r client.Client, configBuilder *bfeConfig.ConfigBuilder, ingress *netv1.Ingress) error {
+      // ...
+    
+      if err = configBuilder.UpdateIngress(ingress, service, endpoints, secrets); err != nil {
+          configBuilder.DeleteIngress(ingress.Namespace, ingress.Name)
+          return err
+      }
+    
+      return nil
+    }
+    ```
+
+    - /internal/bfeConfig/configs/[clusterConfig.go][]
+
+    ```go
+    func (c *ConfigBuilder) UpdateIngress(ingress *netv1.Ingress, services map[string]*corev1.Service, endpoints map[string]*corev1.Endpoints, secrets []*corev1.Secret) error {
+      // ...
+    
+      // update cluster conf
+      if err := c.clusterConf.UpdateIngress(ingress, services, endpoints); err != nil {
+          c.serverDataConf.DeleteIngress(ingress.Namespace, ingress.Name)
+          return err
+      }
+    
+      // ...
+    }
+    ```    
+
+    - /internal/bfeConfig/configs/[clusterConfig.go][]
+
+    ```go
+    func (c *ClusterConfig) UpdateIngress(ingress *netv1.Ingress, services map[string]*corev1.Service, endpoints map[string]*corev1.Endpoints) error {
+      // ...
+    
+      balance, _ := annotations.GetBalance(ingress.Annotations)
+    
+      // ...
+    }
+    ```
+
+    - /internal/bfeConfig/annotations/[balance.go][]
+
+    ```go
+    // GetBalance parse annotation "balance.weight"
+    func GetBalance(annotations map[string]string) (Balance, error) {
+      value, ok := annotations[WeightAnnotation]
+      if !ok {
+          return nil, nil
+      }
+    
+      var lb = make(Balance)
+      err := json.Unmarshal([]byte(value), &lb)
+      if err != nil {
+          return nil, fmt.Errorf("annotation %s is illegal, error: %s", WeightAnnotation, err)
+      }
+    
+      // check whether weight sum > 0
+      for _, services := range lb {
+          sum := 0
+          for _, weight := range services {
+              if weight < 0 {
+                  return nil, fmt.Errorf("weight of load balance service should >= 0")
+              }
+              sum += weight
+          }
+          if sum == 0 {
+              return nil, fmt.Errorf("sum of all load balance service weight should > 0")
+          }
+      }
+      return lb, nil
+    }
+    ```
+
+## 3. BFE 配置的生成
+
+### 触发时机
+
+1. [Kubernetes controller-runtime][] 监听事件后，触发 Reconcile
+2. Reconciler 在[回调函数][ingress_controller.go]中，触发 configBuilder 的更新
+3. configBuilder 更新过程中，根据输入的 Ingress 资源 [生成][clusterConfig.go] 多种 BFE 配置对象
+
+### 案例分析
+
+- 更新的配置对象：`configBuilder.clusterConf`
+- 生成的负载均衡配置： [字段与格式说明](https://www.bfe-networks.net/zh_cn/configuration/cluster_conf/gslb.data/)
+- 源码
+    - /internal/controllers/ingress/netv1/[ingress_controller.go][]
+
+    ```go
+    func ReconcileV1Ingress(ctx context.Context, r client.Client, configBuilder *bfeConfig.ConfigBuilder, ingress *netv1.Ingress) error {
+      // ...
+    
+      if err = configBuilder.UpdateIngress(ingress, service, endpoints, secrets); err != nil {
+          configBuilder.DeleteIngress(ingress.Namespace, ingress.Name)
+          return err
+      }
+    
+      return nil
+    }
+    ```
+
+    - /internal/bfeConfig/configs/[clusterConfig.go][]
+
+    ```go
+    func (c *ConfigBuilder) UpdateIngress(ingress *netv1.Ingress, services map[string]*corev1.Service, endpoints map[string]*corev1.Endpoints, secrets []*corev1.Secret) error {
+      // ...
+    
+      // update cluster conf
+      if err := c.clusterConf.UpdateIngress(ingress, services, endpoints); err != nil {
+          c.serverDataConf.DeleteIngress(ingress.Namespace, ingress.Name)
+          return err
+      }
+    
+      // ...
+    }
+    ```    
+
+    - /internal/bfeConfig/configs/[clusterConfig.go][]
+
+    ```go
+    func (c *ClusterConfig) UpdateIngress(ingress *netv1.Ingress, services map[string]*corev1.Service, endpoints map[string]*corev1.Endpoints) error {
+      if len(ingress.Spec.Rules) == 0 {
+          return nil
+      }
+    
+      balance, _ := annotations.GetBalance(ingress.Annotations)
+    
+      ingressName := util.NamespacedName(ingress.Namespace, ingress.Name)
+      for _, rule := range ingress.Spec.Rules {
+          for _, path := range rule.HTTP.Paths {
+              // create cluster && subcluster for each Service
+              clusterName := util.ClusterName(ingressName, path.Backend.Service)
+    
+              // cluster config
+              (*c.clusterTableConf.Config)[clusterName] = c.newClusterBackend(ingress.Namespace, path.Backend.Service, balance, services, endpoints)
+    
+              // gslb config
+              (*c.gslbConf.Clusters)[clusterName] = c.newGslbClusterConf(ingress.Namespace, path.Backend.Service.Name, balance)
+    
+              // put into map
+              c.ingress2Cluster.Put(ingressName, clusterName)
+              for service := range (*c.gslbConf.Clusters)[clusterName] {
+                  c.service2Cluster.Put(service, clusterName)
+              }
+          }
+      }
+    
+      if len(option.Opts.Ingress.DefaultBackend) > 0 {
+          c.addDefautBackend(endpoints[option.Opts.Ingress.DefaultBackend])
+      }
+    
+      if err := cluster_table_conf.ClusterTableConfCheck(c.clusterTableConf); err != nil {
+          c.DeleteIngress(ingress.Namespace, ingress.Name)
+          return err
+      }
+    
+      c.setVersion()
+      return nil
+    }
+    ```
+
+### 注意事项
+
+- Ingress 资源的新增、更新、删除需分别适当处理
+- BFE 配置对象`configBuilder.*`可能存在缓存，注意对缓存内容的更新
+
+## 4. BFE 配置的热加载
+
+### 触发时机
+
+根据配置时间间隔，定时触发
+
+### 实现逻辑
+
+对于多种 BFE 配置对象`configBuilder.*`，分别执行以下逻辑：
+
+1. 将配置对象以指定格式 [持久化为文件][clusterConfig.go]，存放在 BFE 指定路径
+2. 调用 BFE 进程 [reload 指令][clusterConfig.go]，完成相关配置的热加载
+
+### 案例分析
+
+- 负载均衡配置的热加载方式：[热加载接口说明](https://www.bfe-networks.net/zh_cn/operation/reload/#_5)
+- 源码
+    - /internal/bfeConfig/[configBuilder.go][]
+
+    ```go
+    func (c *ConfigBuilder) InitReload(ctx context.Context) {
+      tick := time.NewTicker(option.Opts.Ingress.ReloadInterval)
+    
+      go func() {
+          defer tick.Stop()
+          for {
+              select {
+              case <-tick.C:
+                  if err := c.reload(); err != nil {
+                      log.Error(err, "fail to reload config")
+                  }
+              case <-ctx.Done():
+                  log.Info("exit bfe reload")
+                  return
+              }
+          }
+      }()
+    
+    }
+    
+    func (c *ConfigBuilder) reload() error {
+      // ...
+    
+      if err := c.clusterConf.Reload(); err != nil {
+          log.Error(err, "Fail to reload config",
+              "clusterConf",
+              c.clusterConf)
+          return err
+      }
+    
+      // ...
+    }
+    ```
+
+    - /internal/bfeConfig/configs/[clusterConfig.go][]
+
+    ```go
+    func (c *ClusterConfig) Reload() error {
+      reload := false
+      if *c.gslbConf.Ts != c.gslbVersion {
+          err := util.DumpBfeConf(GslbData, c.gslbConf)
+          if err != nil {
+              return fmt.Errorf("dump gslb.data error: %v", err)
+          }
+    
+          reload = true
+      }
+      if *c.clusterTableConf.Version != c.clusterTableVersion {
+          err := util.DumpBfeConf(ClusterTableData, c.clusterTableConf)
+          if err != nil {
+              return fmt.Errorf("dump cluster_table.data error: %v", err)
+          }
+          reload = true
+      }
+    
+      if reload {
+          if err := util.ReloadBfe(ConfigNameclusterConf); err != nil {
+              return err
+          }
+          c.gslbVersion = *c.gslbConf.Ts
+          c.clusterTableVersion = *c.clusterTableConf.Version
+      }
+    
+      return nil
+    }
+    ```
+
+## FAQ
+
+- [如何查询特定 BFE 配置的格式？](core-logic.md#BFE配置如何定义)
+- [如何查询指定 BFE 配置的文件路径和热加载方式？][配置热加载]
+
+[Issue]: https://github.com/bfenetworks/ingress-bfe/labels/enhancement
+
+[Kubernetes controller-runtime]: https://github.com/kubernetes-sigs/controller-runtime
+
+[负载均衡]: ../ingress/load-balance.md
+[配置热加载]: https://www.bfe-networks.net/zh_cn/operation/reload/
+
+[balance.go]: ../../../internal/bfeConfig/annotations/balance.go
+
+[clusterConfig.go]: ../../../internal/bfeConfig/configs/clusterConfig.go
+
+[configBuilder.go]: ../../../internal/bfeConfig/configBuilder.go
+
+[ingress_controller.go]: ../../../internal/controllers/netv1/ingress_controller.go
diff --git a/docs/zh_cn/development/core-logic.md b/docs/zh_cn/development/core-logic.md
new file mode 100644
index 00000000..f12c99d1
--- /dev/null
+++ b/docs/zh_cn/development/core-logic.md
@@ -0,0 +1,51 @@
+# BFE Ingress Controller 工作原理
+
+## 核心处理逻辑
+
+> 前置知识
+> - 什么是 [Ingress](https://kubernetes.io/docs/concepts/services-networking/ingress/)
+> - 什么是 [Ingress Controller](https://kubernetes.io/docs/concepts/services-networking/ingress-controllers/)
+
+![arch](../../images/arch.jpg)
+BFE Ingress Controller 的核心处理逻辑是：
+1. 监听获取 k8s 集群中的 Ingress 资源
+2. 解析 Ingress 资源中定义的配置逻辑，生成对应的 BFE 配置
+3. 使新生成的 BFE 配置在 BFE进程中生效
+
+## 如何实现 Ingress 资源的监听
+
+通过 [Kubernetes controller-runtime][] 框架实现：
+1. 创建 Manager，Manager 内部维护了 Client、Cache 和 Schema 等
+2. 创建 Reconciler，并实现回调逻辑
+3. 使用 Builder 模式创建 Controller，并指定监听 Ingress 资源和对应的 Reconcile
+4. 启动 Manager
+
+## BFE配置如何定义
+
+BFE 的配置定义可以通过以下方式获得：
+1. 官网文档：[配置概述][]（主要关注动态配置）
+2. BFE 源码： bfe/[bfe_modules][]/mod_\*/\*_load.go 
+
+官网更新可能存在延迟，以源代码为准。
+
+> 常见动态配置：
+> - 流量路由配置
+>   - [域名规则配置](https://www.bfe-networks.net/zh_cn/configuration/server_data_conf/host_rule.data/)
+>   - [分流规则配置](https://www.bfe-networks.net/zh_cn/configuration/server_data_conf/route_rule.data/)
+> - 负载均衡配置
+>   - [子集群负载均衡配置](https://www.bfe-networks.net/zh_cn/configuration/cluster_conf/gslb.data/)
+> - 接入协议配置
+>   - [TLS协议配置](https://www.bfe-networks.net/zh_cn/configuration/tls_conf/tls_rule_conf.data/)
+> - 扩展模块配置
+>   - [mod_header 配置](https://www.bfe-networks.net/zh_cn/modules/mod_header/mod_header/)
+>   - [mod_redirect 配置](https://www.bfe-networks.net/zh_cn/modules/mod_header/mod_redirect/)
+>   - [mod_rewrite 配置](https://www.bfe-networks.net/zh_cn/modules/mod_header/mod_rewrite/)
+
+## BFE配置如何生效
+
+通过 BFE [配置热加载][]，完成在 BFE 不停机的情况下更新动态配置。
+
+[Kubernetes controller-runtime]: https://github.com/kubernetes-sigs/controller-runtime
+[配置概述]: https://www.bfe-networks.net/zh_cn/configuration/config/
+[bfe_modules]: https://github.com/bfenetworks/bfe/tree/develop/bfe_modules
+[配置热加载]: https://www.bfe-networks.net/zh_cn/operation/reload/
\ No newline at end of file
diff --git a/docs/zh_cn/development/source-code-layout.md b/docs/zh_cn/development/source-code-layout.md
new file mode 100644
index 00000000..d3bfe915
--- /dev/null
+++ b/docs/zh_cn/development/source-code-layout.md
@@ -0,0 +1,78 @@
+# BFE Ingress 源代码框架
+
+```shell
+.
+├── .github       : Github 工作流目录
+├── build         : 编译脚本目录
+├── charts        : BFE Ingress Controller 的 Helm Charts目录
+├── cmd
+│   └── ingress-controller  : 主程序目录
+├── docs          : 中英文用户文档及其素材目录
+├── examples      : k8s 资源描述文件示例目录
+├── internal      : 核心源码目录
+│   ├── bfeConfig     : BFE Ingress Controller 配置选项定义代码
+│   ├── controllers   : k8s 集群交互相关代码，主要包含各资源的controller的实现以及reconcile逻辑
+│   └── option        : BFE 配置相关代码，主要包含各 BFE 配置的生成和热加载逻辑
+├── scripts       : 镜像依赖的脚本目录
+├── CHANGELOG.md  : 版本修改日志
+├── Dockerfile    : 构建镜像的指令文件
+├── LICENSE       : License 协议
+├── Makefile      : 程序编译与镜像制作的指令文件
+├── SECURITY.md   : 安全策略
+├── VERSION       : 程序版本
+├── go.mod        : Go 语言依赖管理文件
+└── go.sum        : Go 语言依赖管理文件
+```
+
+## 核心代码
+- /[internal][]: 核心源码目录
+  - /[option][]: BFE Ingress Controller 配置选项定义代码
+  - /[controllers][]: k8s 集群交互相关代码，主要包含各资源的controller的实现以及reconcile逻辑
+  - /[bfeConfig][]: BFE 配置相关代码，主要包含各 BFE 配置的生成和热加载逻辑
+
+## 持续集成
+
+### 工作流
+- /[.github][]: Github 工作流目录
+- /[Makefile][]: 程序编译与镜像制作的指令文件
+
+### 程序编译
+- /cmd/[ingress-controller][]: 主程序目录
+- /[VERSION][]: 程序版本
+- /[build][]: 编译脚本目录
+- /[go.mod][]: Go 语言依赖管理文件
+- /[go.sum][]: Go 语言依赖管理文件
+
+### 镜像制作
+- /[Dockerfile][]: 构建镜像的指令文件
+- /[scripts][]: 镜像依赖的脚本目录（如镜像启动脚本）
+
+## Helm 支持
+- /[charts][]: BFE Ingress Controller 的 Helm Charts
+
+## 项目文档
+- /[docs][]: 中英文用户文档及其素材目录
+- /[examples][]: k8s 资源描述文件示例目录
+- /[CHANGELOG.md][]: 版本修改日志
+- /[LICENSE][]: License 协议
+- /[SECURITY.md][]: 安全策略
+
+[.github]: ../../../.github
+[build]: ../../../build
+[charts]: ../../../charts
+[ingress-controller]: ../../../cmd/ingress-controller
+[docs]: ../../../docs
+[examples]: ../../../examples
+[internal]: ../../../internal
+[bfeConfig]: ../../../internal/bfeConfig
+[controllers]: ../../../internal/controllers
+[go.mod]: ../../../go.mod
+[go.sum]: ../../../go.sum
+[option]: ../../../internal/option
+[scripts]: ../../../scripts
+[CHANGELOG.md]: ../../../CHANGELOG.md
+[Dockerfile]: ../../../Dockerfile
+[LICENSE]: ../../../LICENSE
+[Makefile]: ../../../Makefile
+[SECURITY.md]: ../../../SECURITY.md
+[VERSION]: ../../../VERSION
\ No newline at end of file
diff --git a/internal/bfeConfig/annotations/balance.go b/internal/bfeConfig/annotations/balance.go
index f553cced..a5e45702 100644
--- a/internal/bfeConfig/annotations/balance.go
+++ b/internal/bfeConfig/annotations/balance.go
@@ -23,7 +23,7 @@ const (
 	WeightAnnotation = BfeAnnotationPrefix + WeightKey
 )
 
-// Balance define struct of annotation "balance.weight"
+// ServicesWeight define struct of annotation "balance.weight"
 // example: {"service": {"service1":80, "service2":20}}
 type ServicesWeight map[string]int
 type Balance map[string]ServicesWeight