VTJ.PRO 在线应用开发平台入门与项目初始化

入门与项目初始化本文档提供了设置 VTJ.PRO 开发环境的技术规范。涵盖了 monorepo 配置、通过pnpm进行的依赖管理以及在本地运行前端和后端服务所需的初始化步骤。环境要求该平台以 monorepo 形式构建需要特定的 node-linker 行为和注册表配置来处理低代码引擎的复杂依赖关系。包管理器配置项目使用pnpm并需要在根目录的.npmrc文件中定义特定的提升hoisting设置。这些设置确保了构建工具和运行时能够访问到对等依赖项以及深度嵌套的包例如vtj/core或vtj/renderer。KeyValuePurposehoisttrue启用将依赖提升到根node_modules目录。shamefully-hoisttrue强制提升所有依赖解决嵌套对等依赖的问题。node-linkerhoisted使用标准的node_modules结构而不是符号链接。registryhttps://registry.npmmirror.com将默认注册表设置为 npmmirror以便在特定区域更快地访问。项目结构与 Monorepo 初始化VTJ.PRO 平台分为几个核心目录必须按顺序进行初始化。该系统依赖于 NestJS 后端和 Vue 3 前端的组合并由静态模板和文档提供支持。核心目录backend/ 处理 DSL 管理、AI 代理和 RBAC 的 NestJS 服务器。frontend/ 包含工作台和管理界面的 Vue 3 应用程序。templates/ 用于代码生成的 Web、H5 和 UniApp 项目模板的源代码。scripts/ 维护和发布的自动化脚本。_docs/ 技术文档和初始化指南。初始化流程初始化过程遵循从环境配置到依赖安装最后到服务执行的特定数据流。1. 依赖安装由于.npmrc中设置了shamefully-hoist开发者应从根目录运行pnpm install。这将为所有工作区包括前端和后端填充node_modules。2. 环境配置前端和后端都需要.env文件。后端需要数据库凭据MySQL、Redis 配置用于缓存和用于文件管理的 OSS对象存储服务密钥。前端需要将VITE_API_URL指向本地或远程的后端服务。3. 数据库播种后端包含一个迁移和播种系统。首次运行时MigrationService会检查所需表是否存在并填充初始数据角色、权限和默认的 LLM 提供商。技术架构初始化序列下图说明了配置文件、包管理器以及最终环境状态之间的关系。系统引导图“此图将设置步骤的‘自然语言空间’映射到配置文件的‘代码实体空间’。”本地运行平台一旦依赖安装完成且数据库配置好就可以使用以下脚本启动平台。后端执行后端是平台的核心为低代码引擎提供 API。它处理DslService和AiService。cd backend npm run start:dev前端执行前端提供可视化编辑器和管理仪表板。cd frontend npm run dev模板打包在平台可以生成新项目之前必须将模板打包到后端的发布文件夹中。这由一个自定义脚本处理。node scripts/template.mjs此脚本压缩templates/目录的内容并将其放置到backend/zip/中DslService可以在那里访问这些内容以进行项目初始化。配置实体总结下表列出了初始化过程中涉及的关键文件及其作用。File/PathEntity RoleDescription.npmrc环境配置定义了vtj包所需的hoistednode-linker 策略。scripts/template.mjs构建工具将templates/源代码与backend/运行时资源同步。backend/src/main.ts入口点初始化 NestJS 应用程序和全局拦截器。frontend/src/main.ts入口点挂载 Vue 3 应用程序并初始化vtj/renderer。参考资料官方文档https://vtj.pro/在线平台https://app.vtj.pro/开源仓库https://gitee.com/newgateway/vtj