后端模块系统

VTJ.PRO 后端是一个基于 NestJS 的应用，其设计采用了模块化架构，将平台级服务与特定领域的业务逻辑分离开来。它为低代码引擎提供了坚实的基础，具有自动验证、标准化响应封装和全面的安全模型等特性。

AppModule 组合

AppModule 作为后端应用的根模块。它协调了核心基础设施、业务模块和全局配置的集成。

• 基础设施：通过 ConfigModule 加载环境变量，通过 TypeOrmModule 管理数据库连接，并通过 MulterModule 处理文件上传。
• 模块分离：系统区分了 CoreModules（身份认证、访问控制、系统设置）和 BusinessModules（低代码应用、DSL管理、AI智能体）。

后端系统架构

下图说明了主入口点、共享基础设施和模块层之间的关系。

全局中间件与请求生命周期

后端使用 NestJS 的原生组件实现标准化的请求/响应生命周期，以确保所有端点的一致性。

Swagger 文档

该平台使用 Swagger 自动生成 API 文档。在开发环境中，可通过 /docs 端点访问。该设置包括 JWT Bearer 认证配置，允许直接从 UI 测试受保护的路由。

核心模块与业务模块

代码库在 backend/src/ 中分为两个主要目录，以保持关注点的清晰分离。

核心模块

这些模块提供了任何企业应用所需的“平台”能力。

• 身份与访问：AuthModule 和 UserModule 处理认证（包括 OAuth）和用户资料。
• RBAC：RoleModule 和 PermissionModule 管理细粒度的访问控制列表。
• 系统服务：包括 CacheModule（Redis/内存）、SettingModule（全局配置）和 OssModule（对象存储）。

有关详细信息，请参阅 核心模块（用户、认证、RBAC、缓存、设置）。

业务模块

这些模块包含特定于 VTJ 低代码平台的领域逻辑。

• 低代码引擎：LowcodeAppModule 和 DSLModule 管理应用及其 JSON 模式的生命周期。
• AI 与智能：AgentModule 和 SkillModule 与大语言模型（LLMs）集成，提供 AI 辅助开发功能。
• 商业与运营：OrderModule 和 ProductModule 处理平台的商业化功能。

有关详细信息，请参阅 业务模块（应用、DSL、模板、订单、智能体、技能）。

代码实体映射

下图展示了逻辑模块组与其在代码中具体服务实现之间的映射关系。

参考资料

• 官网文档：https://vtj.pro/
• 在线平台：https://app.vtj.pro/
• 开源仓库：https://gitee.com/newgateway/vtj