VTJ 低代码开发平台概述
目的和范围
本文档全面概述了 VTJ 低代码开发平台（LCDP），这是一个支持快速创建和部署应用程序的多平台开发环境。平台采用 Vue.js 前端应用与 NestJS 后端 API 架构，支持多种部署目标，包括 Web 浏览器、移动 H5 应用和跨平台 UniApp 环境。
本文档涵盖平台整体架构、核心技术和系统组织。
系统架构概述
VTJ LCDP 采用现代化 Web 应用架构，实现前端展示层、后端服务层和多平台构建系统的清晰分离。
整体架构设计
分层架构模式
平台采用分层架构设计，各层职责明确：
- 用户界面层：基于 Vue.js 的可视化开发环境
- 应用服务层：NestJS 实现的核心业务逻辑
- 数据服务层：统一 API 网关和微服务架构
- 基础设施层：容器化部署和云原生支持
多平台构建系统
平台支持四个核心构建目标，每个目标针对特定部署场景优化：
| 构建目标 | 环境变量 | 输出类型 | 主要应用场景 | 技术实现细节 |
|---|---|---|---|---|
| main | BUILD_TYPE=main | 核心应用包 | 主 Web 应用部署 | 包含完整业务逻辑，支持 SSR |
| web | BUILD_TYPE=web | Web 优化包 | 标准 Web 浏览器 | 响应式设计，PC 端体验优化 |
| h5 | BUILD_TYPE=h5 | 移动 H5 包 | 移动 Web 应用 | 触控优化，移动端适配 |
| uniapp | BUILD_TYPE=uniapp | 跨平台包 | 多端应用部署 | 编译为微信小程序、Android/iOS 等 |
构建脚本配置说明
构建系统通过 npm 脚本支持环境特定配置：
bash
# 开发环境 (热重载)
npm run dev # ENV_TYPE=local，启动开发服务器
# SIT环境构建 (系统集成测试)
npm run sit:main # ENV_TYPE=sit BUILD_TYPE=main
npm run sit:web # ENV_TYPE=sit BUILD_TYPE=web
npm run sit:h5 # ENV_TYPE=sit BUILD_TYPE=h5
npm run sit:uniapp # ENV_TYPE=sit BUILD_TYPE=uniapp
# 生产环境构建
npm run build:main # ENV_TYPE=live BUILD_TYPE=main
npm run build:web # ENV_TYPE=live BUILD_TYPE=web
npm run build:h5 # ENV_TYPE=live BUILD_TYPE=h5
npm run build:uniapp # ENV_TYPE=live BUILD_TYPE=uniapp核心技术与依赖项
前端核心依赖
| 包名称 | 版本范围 | 功能描述 | 技术特性 |
|---|---|---|---|
| vue | ~3.5.0 | 核心 Vue.js 框架 | 组合式 API，响应式系统 |
| vue-router | ~4.5.0 | 客户端路由管理 | 动态路由，导航守卫 |
| @vtj/web | latest | VTJ Web 平台集成库 | 组件库，工具函数集 |
| @vtj/h5 | latest | VTJ 移动 H5 平台适配 | 移动端组件，手势支持 |
| @vtj/uni | latest | VTJ UniApp 跨平台支持 | 多端适配，原生能力封装 |
| @dcloudio/uni-h5-vue | 3.0.0-4070620250821001 | UniApp H5 环境 Vue 运行时 | H5 与小程序统一运行时 |
开发工具链
| 工具名称 | 版本 | 功能描述 | 技术优势 |
|---|---|---|---|
| @vtj/cli | latest | VTJ 命令行工具 | 项目脚手架，代码生成 |
| @vtj/pro | latest | VTJ 专业开发工具套件 | 可视化调试，性能分析 |
| node-ssh | ~13.2.0 | SSH 远程部署支持 | 安全连接，自动化部署 |
| vite | ^5.0.0 | 构建工具核心 | 快速冷启动，按需编译 |
| typescript | ~5.4.0 | 类型安全支持 | 静态类型检查，高级类型特性 |
后端模块架构
后端采用模块化 NestJS 架构，包含以下核心功能模块：
核心模块功能说明
| 模块名称 | 主要职责 | 技术实现 |
|---|---|---|
| 应用管理 | 应用生命周期管理 | 微服务注册发现，健康检查 |
| 权限控制 | 访问授权管理 | RBAC 模型，JWT 认证 |
| 数据服务 | 数据持久化操作 | TypeORM，事务管理 |
| 文件存储 | 资源管理 | OSS 集成，分块上传 |
| 消息队列 | 异步任务处理 | RabbitMQ，任务调度 |
| 监控告警 | 系统监控 | Prometheus，Grafana 仪表盘 |
| 日志服务 | 集中式日志管理 | ELK Stack，结构化日志 |
开发环境配置
平台支持三种环境配置，满足不同阶段需求：
| 环境类型 | 配置标识 | 主要特点 | 适用场景 |
|---|---|---|---|
| 开发环境 | ENV_TYPE=local | 热重载，源码映射 | 本地开发，实时调试 |
| 测试环境 | ENV_TYPE=sit | 完整功能验证，集成测试 | 预发布环境，QA 测试 |
| 生产环境 | ENV_TYPE=live | 性能优化，安全加固 | 线上部署，用户使用 |
构建配置关键技术
- 多目标支持：支持 12 种环境与平台组合配置，满足全场景需求
- TypeScript 处理：通过
vue-tsc实现严格类型检查和编译 - 环境变量注入：使用
cross-env实现跨平台环境变量管理 - 构建优化：生产环境启用代码压缩、Tree Shaking 和代码分割
- 增量构建：开发环境支持模块热替换(HMR)，提升开发效率
VTJ 低代码平台通过模块化架构和灵活的多平台构建系统，为开发者提供高效的应用开发和部署体验。