一、开源项目简介

PUPA

蛹，蜕变的开始

　　一款基于数据库，通过在线模板生成内容的代码生成工具，具备多项目管理、团队化管理、多数据源管理、自定义配置等功能。

二、开源协议

使用MIT开源协议

三、界面展示

四、功能概述

一款基于数据库表生成各种语言代码的在线代码生成器；支持多种模板语言，支持多数据源；高自由度自定义扩展参数，良好的参数查看交互，良好的在线模板编辑交互；具备多项目管理、团队化管理功能，助力约束团队内代码规范；所有配置均在线可调，即时生效。

系统结构

 

特点：

• 平台化，可管理多个项目，一次部署长期使用

• 轻量级，mvc单体项目结构，无需依赖额外环境，部署更简单

• 支持团队内共享，规范代码

• 支持多数据源，支持多种类型数据库（Mysql、Maria、SqlServer、Oracle、PostgreSql，支持扩展）

• 支持多种模板引擎（Enjoy、Freemarker、Vilocity，支持扩展）

• 支持同时生成多语言数据类型映射，如同时生成匹配Java和TypeScript数据类型的代码

• 在线模板编辑器使用Monaco控件，使用体验同Visual Studio Code相差无几

• 支持在项目、成员、数据源、表、字段等维度进行自定义参数的扩展配置，即配即用

• 可用参数随时查看，清晰了然

• 可直接克隆项目、配置，快速个性化定制

• 支持项目、配置导入导出，移植无压力

五、技术选型

环境、框架、组件：

• JDK版本：JDK 1.8

• 数据库：Mysql 5.7.3

• 框架：Spring-boot-web

• 登录控制：sa-token 1.34.0

• 前端UI框架：Layuimini 2.5.5 单页模式（jQuery + Html5）

• 编辑器控件：Monaco Editor

部署

1. 确保服务器已安装 Java 1.8+、Mysql 数据库，在数据库内运行项目目录下的 resources/sql/pupa.sql 初始化数据；

2. 修改项目配置文件 resources/application.yml 中的 datasource 数据库连接配置；

3. 修改前端配置 static/js/common/common.js，将 serverPath 参数中的地址设置为相应服务器地址；

4. 构建项目；

5. 复制项目目录下的 target/pupa-1.0-SNAPSHOT.java 到服务器自定目录；

6. 至此可直接通过服务器指令启动服务，也可使用提供的脚本启动运行，操作如下：

1、修改jar文件名为 pupa.jar；

2、复制项目目录下的 resources/run/start.sh 到服务器，与jar文件同一目录；

3、进入服务器项目目录，执行 ./start.sh 命令启动项目，如 start.sh 未授权，则执行 chmod u+x start.sh 命令进行授权，再启动项目；

4、在浏览器输入实际项目地址进行访问，例：http://192.168.0.1:7384。

默认管理员账号、密码：admin 123456

详细内容请查看 README.md 文档