示例：开发中心应用

管理模型

在示例应用中的业务域和商业能力页面，您可以看到示例应用的业务域和商业能力分别已经关联了商品域和商品发布。

通过模型管理功能，您可以变更当前应用关联的业务域和商业能力以及其版本，并可在应用中继续对模型进行调整。具体操作，请参见管理模型。

管理接口

模型设计完成后，采用全代码的开发方式，需要明确接口定义。中心应用的接口管理，可以基于模型自动生成对应的接口定义、以及补充接口文档的相关信息，起到承前启后的作用。

在示例应用的接口管理页面，您可以查看到当前业务域和商业能力自动生成的接口定义。

接口管理参考OAS（OpenAPI Specification）2.0的标准将模型（业务域、商业能力）的服务方法生成HTTP REST API的接口定义。

本文以查看商品域下的某个应用服务方法对应的API定义为例，说明如何查看系统自动生成的接口。

1. 查看商品域下的某个应用服务方法，比如：商品域 > 产品服务（应用服务）> 创建SPU（应用服务方法），在模型管理中具体如下图所示。
   更多信息，请参见创建和管理应用服务。
2. 在接口管理页面，单击商品域右侧操作列下的查看OAS定义，您可以在商品域 - 接口OAS定义面板看到商品域v1.0.0版本的HTTP REST API的接口定义。
   说明 目前的默认规则是将业务域下的应用服务方法都生成HTTP REST API。
3. 在Postman中查看该应用服务方法对应的API定义。
   1. 在商品域 - 接口OAS定义面板单击复制，将OAS内容拷贝到您的本地电脑文件中（如Windows下的.txt文件，文件编码需要为UTF-8格式）。
   2. 使用Postman的Import功能将该文件导入到Postman中，导入成功后您可在Postman中查看该API接口的定义，具体如下图所示。
   

更多关于接口管理的信息，请参见管理接口。

生成代码

1. 在示例应用（示例商品中心）的代码生成页面，单击代码生成。在代码生成面板中所有的必配项都已经默认配置就绪，您可以直接单击生成代码。
   示例应用的代码生成配置，主要包括：采用新分支的方法保存生成的代码脚手架、代码结构默认使用二级Module、代码中使用MyBatis作为数据ORM的技术组件。更多信息，请参见生成代码。
2. 在代码生成页面，单击刚生成的代码分支名称右侧操作列下的下载代码。将生成的代码下载到本地，解压后查看生成的代码结构。
   说明 只有示例应用的代码生成后，才为您提供下载代码的方式进行查看。如果您使用BizWorks正常流程创建的中心应用，代码生成后，您可以通过本地IDE打开该中心应用使用的代码仓库进行查看和编辑。

   • 下载代码并完成解压后，您可以看到第一级对应的是业务域、商业能力等。
   • 进入businessdomain-commodity（商品域）文件夹，里面的结构是按DDD架构实践的分层。
     Module的定位主要如下：

     Module	职责	说明
     Entry	核心业务入口。	业务入口，当应用通过SpringCloud实现则Controller在该模块编写，通过Controller调用底层业务逻辑形成闭环。
     App	业务调用入口。	Entry通过调用App层实现业务逻辑调用。App层需要负责调用Domain层业务逻辑，且将DTO与Domain Entity进行转换。
     Domain	领域实现层：核心业务逻辑。	Domain层主要编写业务逻辑，业务通过建模后，业务逻辑通过Domain Entity和Domain Service来承载，因此是充血模型的方式来完成代码开发。 当涉及对外调用时，则通过调用Domain层定义的Repository Interface来完成，而具体外部访问的技术实现由Infrastructure实现。
     Infrastructure	基础设施层：负责技术实现，包括访问DB、Cache、RPC、MQ等。	Domain会实现业务逻辑，而业务逻辑中涉及到技术实现的部分（例如：保存、RPC请求、MQ发送消息、缓存等）都通过Infrastructure在Repository Impl实现。 Infrastructure除了技术实现，还包括DO定义、DO与Domain Entity的互相转换，以及集成并调用外部服务的Client。
     Starter	应用启动。	独立应用启动的包，方便启动方式插拔变更。
     Client	商业能力、域服务接口定义。	外部应用集成的SDK，便于能力调用。在SDK中定义包括：商业能力、域服务接口定义、接口入参和返回值DTO、接口返回错误码定义、业务自定义异常定义等。
     ExtensionPoint	负责扩展点接口定义。	外部应用集成SDK，便于根据扩展点定义实现自定义扩展点业务逻辑。

扫描代码与合并模型

更多信息，请参见扫描代码与合并模型。

部署中心应用实例

在中台研发过程中，完成脚手架代码的生成后，应用开发人员将进入详细设计和编码过程。开发人员在完成本地开发和单元调试后，需要各个模块进行微服务的部署联调，此时会需要将应用部署在容器环境中。

由于示例应用并不涉及到具体的编码实现过程，因此跳过此步骤，在完成代码生成后，您可以直接进入到开发环境的打包部署步骤。BizWorks默认提供了基本的CICD过程，也支持与三方DevOps产品进行集成对接。本文在示例应用中重点演示如何使用内置CICD完成中心应用的部署过程。

1. 在示例应用的应用部署页面，您可以看到已经自动为示例项目创建了两个示例环境，环境类型分别为开发环境和生产环境。
   关于如何创建和管理环境，请参见创建和管理环境。
2. 单击示例开发环境卡片，在新建实例部署 - 部署配置面板，完成代码分支（选择生成代码时的代码分支）、部署流水线（只能选择默认流水线）、资源配置（默认不能修改）配置，单击下一步。
3. 在新建实例部署 - 部署配置面板，启动命令、环境变量、存储和应用生命周期管理都不支持配置，单击开始部署。
   说明 示例项目的应用部署，在流水线选择和实例资源配置方面都有固定限制，所以启动命令、环境变量和应用生命周期管理高级选项都不支持配置。
4. 单击正在部署应用的环境（示例开发环境）卡片，在应用部署实例面板的部署记录区域，先找到状态为部署中的部署记录，再单击其右侧日志列下的查看，您能够了解到当前部署记录的运行情况和详细信息。
5. 刷新页面，待部署状态为部署成功后，单击示例开发环境卡片。在应用部署实例面板，您可以查看到该环境下的应用调用域名。
   在浏览器中直接访问此调用域名，您可以看到Hello BizWorks的页面（证明示例应用实例已经能够访问）。

   说明

   • 该调用域名是激活示例项目过程中为您自动创建的域名，并自动完成了DNS配置，因此可以直接访问。关于环境和环境上绑定的域名，请参见创建和管理环境。
   • Hello BizWorks的页面仅在示例应用中生成的代码中出现，用于辅助示例项目的实验过程。您正常创建的中心应用的代码生成中不包含此部分代码和功能。
6. 可选：访问接口（创建SPU）。将API的请求URL使用此应用实例的访问地址补全，Request Body使用默认信息，单击Send，您即可看到接口请求过程。具体如下图所示：Response Status为200 OK，Response Body内容为JSON结构，code=200。
   说明 由于在示例应用中仅是生成了脚手架代码，部署的代码中并未补充对应的逻辑实现，因此上图仅为示例中心应用的接口调用过程。

   中心应用的部署功能，除了上述演示的内容之外，还包含了对应用实例的管控、应用运行情况监控等功能。更多信息，请参见以下文档：

   • 部署中心应用实例
   • 添加和管理中心应用的三方流水线
   • 管理中心应用实例