当前位置：首页 > news >正文

一二三应用开发平台应用开发示例——概述、应用开发示例简介及创建前后端模块

news 2025/6/30 20:02:53

概述

对于应用开发平台的核心基石——系统管理模块，我精心撰写了一份详尽的说明手册。该手册旨在从使用者的角度出发，不仅全面阐述系统的各项属性和功能，更着重强调使用过程中的注意事项和最佳实践。

在手册的编写过程中，我特别注重解释每个设计背后的原因，以及这些设计所带来的优点和可能存在的局限。这样做的目的是为了让使用者能够更深入地理解平台的设计理念，从而更快地掌握使用方法，遵循平台的设计原则，并充分发挥平台的潜力。

为了更直观地展示如何基于平台进行业务应用开发，我将以一个真实的业务系统为例进行详细说明。在这个过程中，我们将涵盖从新增前后端功能模块，到通过低代码配置实体、模型、视图，再到生成库表和代码的全过程。此外，我们还将讨论如何配置权限和菜单，以及如何使用数据字典等辅助功能。

值得一提的是，在平台生成的代码基础上，我们还将指导使用者如何进行前端界面的调整和后端业务逻辑的实现。这将有助于使用者更好地发挥平台的灵活性，根据实际需求进行定制化的开发。

通过这份手册的指引，我相信使用者将能够快速上手应用开发平台，充分利用平台提供的各项功能，实现高效、稳定的业务应用开发。同时，遵循最佳实践也将有助于发挥平台的最大价值，提升整体的开发效率和质量。

示例简介
应用名称：一二三文档管理系统
应用简介：企事业单位一站式文档管理系统，让组织内文档管理有序，协作高效、安全可控
设计文档：csdn专栏
开源地址：Gitee
开源协议：MIT

强烈建议您在继续阅读后文之前，先浏览一下系统整体介绍和系统设计部分的内容。这将有助于您对整个系统有一个直观的了解，从而更好地掌握如何运用平台来实现业务应用。通过先了解整体架构和设计思路，您将能够更顺利地理解后续的操作步骤和最佳实践，进而充分发挥平台的潜力，实现高效、稳定的业务应用开发。

创建后端模块

拷贝新增

拷贝项目中的platform-boot-starter-demo模块，并将其重命名为abc-edoc，是一个高效且实用的方法。选择这种拷贝而非使用spring.io向导新建Spring Boot模块的方式，主要是出于以下考虑：

首先，platform-boot-starter-demo模块本身就是一个现成的、基于开发平台实现的业务系统模拟。这个模块直接为我们提供一个良好的起点。通过拷贝这个模块并重命名，我们可以快速获得一个具备相似结构和功能的新模块，大大减少了从零开始搭建的时间和精力。

其次，拷贝方式允许我们在已有的基础上进行微调，以满足新模块abc-edoc的具体需求。这意味着我们可以直接利用platform-boot-starter-demo中的现有配置和代码，然后针对新模块的特性进行必要的修改和扩展。这种方式不仅提高了开发效率，还能确保新模块与原始模块在结构和功能上保持一致性。

相比之下，使用spring.io向导新建Spring Boot模块虽然也能创建一个新的项目结构，但需要我们手动进行大量的配置和代码编写工作。这种方式虽然提供了更大的灵活性，但在面对类似platform-boot-starter-demo这样已经具备完善配置的模块时，显然不是最高效的选择。

因此，综合考虑时间效率、代码复用和一致性等因素，我们选择通过拷贝并重命名platform-boot-starter-demo模块的方式来新增abc-edoc模块。

调整配置

虽然拷贝的模式减轻了配置工作，但免不了有一点相关工作需要调整，具体如下：

修改模块pom文件

<artifactId>abc-edoc</artifactId>
<name>abc-edoc</name>  
<version>1.0.0</version>
<description>基于开发平台实现的文档管理系统</description>

修改项目pom文件

将新加的模块edoc放到项目模块下

<modules><module>platform-common</module><module>platform-system</module><module>platform-framework</module><module>platform-support</module><module>platform-entity-config</module><module>platform-workflow</module><module>platform-businessflow</module><module>platform-boot-starter</module><module>platform-boot-starter-demo</module><module>platform-cip-common</module><module>platform-cip-api</module><module>platform-cip-message</module><module>platform-cip-manage</module><module>platform-boot-starter-oss</module><module>platform-boot-starter-scheduler</module><module>platform-boot-starter-mail</module><module>platform-boot-starter-notification</module><!--文档管理系统--><module>abc-edoc</module>
</modules>

修改SpringBoot启动类

将启动类PlatformBootApplication重命名为EdocBootApplication。

编译运行

使用maven刷新项目引用，然后执行clean和install，完成编译工作。
启动项目，测试前端可以正常访问后端服务完成登录及其他功能。
此时新建的文档管理系统模块相当于替代了原来的platform-boot-starter-demo模块功能。
至此，完成了文档管理系统的后端模块搭建工作。

创建前端模块

平台的前端目录是platform-web，在src\modeles目录下存放各业务模块。

拷贝新增

为了提升效率，前端模块预置了一个模板，位于src\modules\template，拷贝该目录后，重命名为edoc。

调整配置

模块调整

api目录下的index，将模板内容调整为实际的edoc模块和folder实体

import { COMMON_METHOD } from '@/constant/common'
import request from '@/config/axios'const moduleName = 'edoc'// 文件夹
export const folder = Object.assign({}, COMMON_METHOD, {serveUrl: '/' + moduleName + '/' + 'folder' + '/'
})

项目调整

需要将新增的模块，通过配置加入到项目中，具体如下：
添加api，对应文件src\api\index.ts

import * as system from '@/modules/system/api'
import * as support from '@/modules/support/api'
import * as entityconfig from '@/modules/entityconfig/api'
import * as cip from '@/modules/cip/api'
import * as scheduler from '@/modules/scheduler/api'
import * as notification from '@/modules/notification/api'
import * as workflow from '@/modules/workflow/api'
import * as businessflow from '@/modules/businessflow/api'
import * as edoc from '@/modules/edoc/api'
export default {system,support,entityconfig,cip,scheduler,notification,workflow,businessflow,// 文档管理系统edoc
}

添加常量，对应文件src\constant\index.ts

import * as system from '@/modules/system/api'
import * as support from '@/modules/support/api'
import * as entityconfig from '@/modules/entityconfig/api'
import * as cip from '@/modules/cip/api'
import * as scheduler from '@/modules/scheduler/api'
import * as notification from '@/modules/notification/api'
import * as workflow from '@/modules/workflow/api'
import * as businessflow from '@/modules/businessflow/api'
import * as edoc from '@/modules/edoc/api'
export default {system,support,entityconfig,cip,scheduler,notification,workflow,businessflow,// 文档管理系统edoc
}

配置路由转发，对应文件vite.config.ts

server: {port: 4000,proxy: {//  系统管理模块'/system': {target: env.VITE_BASE_URL,changeOrigin: true},//  实体配置模块'/entityconfig': {target: env.VITE_BASE_URL,changeOrigin: true},//  接口平台模块'/cip': {target: env.VITE_BASE_URL,changeOrigin: true},//  业务支撑模块'/support': {target: env.VITE_BASE_URL,changeOrigin: true},//  任务调度模块'/scheduler': {target: env.VITE_BASE_URL,changeOrigin: true},//  系统通知模块'/notification': {target: env.VITE_BASE_URL,changeOrigin: true},//  工作流模块'/workflow': {target: env.VITE_BASE_URL,changeOrigin: true},//  业务流程模块'/businessflow': {target: env.VITE_BASE_URL,changeOrigin: true},//  文档管理系统'/edoc': {target: env.VITE_BASE_URL,changeOrigin: true}}
}