Manifest事件驱动架构：松耦合系统设计

Manifest事件驱动架构：松耦合系统设计

【免费下载链接】manifest Effortless backends ✨ 项目地址: https://gitcode.com/GitHub_Trending/manifest7/manifest

Manifest框架通过事件驱动架构实现系统解耦，允许组件间通过事件通信而非直接依赖。本文将从核心概念、架构设计、实践案例三个维度，详解如何基于Manifest构建松耦合系统。

核心架构概览

Manifest的事件驱动设计体现在两个层面：实体关系定义与事件流处理。架构核心文件为src/manifest/json-schema/schema.json，其中定义了应用清单的JSON Schema规范，确保事件结构一致性。

实体关系模型

在Manifest中，实体间关系通过YAML配置定义，如examples/standalone/manifest/backend.yml所示：

entities:
  😃 Owner:
    properties:
      - name
      - { name: email, type: email }

  😺 Cat:
    properties:
      - name
      - { name: age, type: number }
    belongsTo:
      - Owner

这种声明式定义自动生成事件触发点，当Cat实体状态变化时，会自动向关联的Owner实体发送事件通知。

事件处理流程

事件生成

实体操作事件由src/entity/services/entity/entity.service.ts生成，核心逻辑包括：

• 实体创建/更新/删除时自动触发事件
• 事件包含实体ID、操作类型、变更数据三要素
• 通过src/crud/services/crud.service.ts统一分发

事件消费

管理后台通过src/admin/src/app/modules/crud/services/crud.service.ts订阅事件，实现UI实时更新。典型订阅代码如下：

this.crudService.getEntityEvents('Cat').subscribe(event => {
  this.flashMessageService.show(`Cat ${event.action}: ${event.data.name}`);
  this.refreshCatList();
});

实践案例：宠物管理系统

以examples/standalone/manifest/backend.yml定义的宠物系统为例，展示事件驱动架构的实际应用。

1. 实体定义与事件绑定

系统包含Owner和Cat两个实体，通过belongsTo建立一对多关系。当创建新猫咪时，会自动触发CAT_CREATED事件，并通知所属用户。

2. 权限控制事件

权限验证通过src/admin/src/app/modules/auth/guards/auth.guard.ts实现，登录事件会更新全局权限状态：

canActivate(): Observable<boolean> {
  return this.authService.isLoggedIn().pipe(
    tap(loggedIn => {
      if (!loggedIn) {
        this.eventBusService.emit('AUTH_REQUIRED', { route: this.router.url });
      }
    })
  );
}

3. UI事件响应

管理界面通过src/admin/src/app/modules/layout/flash-message/flash-message.component.ts实时展示事件通知，组件会订阅全局事件总线并显示提示信息。

事件通知UI

扩展开发指南

自定义事件类型

通过扩展src/types/src/manifests/EntityManifest.ts定义新事件类型：

export enum CustomEventTypes {
  CAT_ADOPTED = 'CAT_ADOPTED',
  MEDICAL_CHECKUP = 'MEDICAL_CHECKUP'
}

事件持久化

修改src/manifest/src/entity/core-entities/base-entity.ts，添加事件日志存储逻辑，实现事件溯源能力。

总结

Manifest的事件驱动架构通过声明式配置降低了系统耦合度，主要优势体现在：

1. 组件独立开发与部署
2. 系统行为可观测性提升
3. 扩展功能无需修改核心代码

通过本文介绍的架构设计和实践案例，开发者可以快速构建弹性扩展的后端系统。完整示例代码参见examples/standalone/目录，官方文档可参考packages/core/manifest/README.md。

【免费下载链接】manifest Effortless backends ✨ 项目地址: https://gitcode.com/GitHub_Trending/manifest7/manifest