项目代码采用前后端分离,同时分为业务端和管理端两部分,管理端是进行功能管理与设计的,包括数据模型管理、菜单管理、表单管理、按钮管理、权限管理等等管理相关的功能。
为了比较直观的说明此框架的功能,接下来会用一个贷款申请项目来逐步完善功能,来说明LuBase框架的功能与使用方法
1、数据库管理
如果私有化部署,需要搭建数据库服务,并且在数据库服务建立需要的数据库。
此项目我们以mysql为例,新建了一个数据loan。用管理员登录并在lubase下进行数据库管理如图:
数据库维护字段说明:
字段 | 要求 |
数据库类型 | 目前支持MySql、MSSqlsever 数据库,pg后续安排支持 |
端口 | 数据库连接的端口 |
testSql | 如: select 1 |
数据源名称 | 数据库中文名称,用于创建应用时中文好识别 |
数据库代码 | 数据库英文代码 |
SQLSERVER实例 | 实例,在数据库类型为MSSqlserver时可能需要填写,如:SQLEXPRESS |
登录用户 | 登录用户名 |
登录密码 | 登录密码 |
服务地址 | 服务器ip |
建好数据库连接信息如图:
云端测试环境中已经添加好数据库管理,大家可跳过此步,直接从应用创建开始。
2、应用管理
在【应用管理】下,创建我们需要的应用,可以选择已经维护好的数据库信息。
应用维护字段说明
字段 | 要求 |
应用名称(必填) | 应用名称,可输入好识别或好区分的名字。如:贷款信息系统 |
数据库(必填) | 选择已创建的数据库连接中的数据库名字。允许基于一个数据库创建多个应用,但是不建议这么做 |
应用访问地址 | 预览时前端部署地址 |
前端部署方式 | 主框架运行:前端无二开的场景,直接访问主框架的前端地址 独立部署:前端有二开的场景,需要重新部署前端包 |
配置管理员 | 为每个应用配置管理员,配置管理员可以由业务负责人使用。可以授予配置管理员,代码表、功能权限等权限 |
建好应用信息如图:
此时就可以点击【配置】,会进行到当前应用的管理界面,就可以对当前应用进行设计了。我们先对数据模型进行设计。如下图
3、数据模型设计
简单的对数据表进行简单的设计,尽量包括全的字段类型,来说明LuBase支持的字段类型。先设计三张表包括:申请基本信息表、联系人表、联系地址表
先表一下lubase支持的字段类型,如下
- 申请基本信息【ln_application】
字段名称 | 字段描述 | 字段类型 | LuBase对应类型 |
id | id | bigint | 大整型 |
name | 姓名 | varchar(50) | 文本 |
age | 年龄 | int | 整数 |
birthday | 生日 | date | 日期时间 |
sex | 性别 | varchar(5) | 关联-码表 |
phone | 电话 | varchar(11) | 文本(手机输入框) |
id_card_num | 身份证号 | varchar(18) | 文本(身份证输入框) |
picture | 照片 | varchar(50) | 图片 |
loan_amount | 申请金额 | decimal | 小数 |
doc_file | 申请资料 | varchar(50) | 附件 |
- 联系地址信息表【ln_address】
字段名称 | 字段描述 | 字段类型 | LuBase对应类型 |
city | 所在城市 | varchar(18) | 关联-码表(多级码表) |
address | 详细地址 | varchar(50) | 文本 |
address_type | 地址类型 | varchar(5) | 关联-码表 |
home_type | 房产类型 | varchar(5) | 关联-码表 |
app_id | 申请表id(外键) | bigint | 关联-数据表 |
- 联系人信息表【ln_contacts】
字段名称 | 字段描述 | 字段类型 | LuBase对应类型 |
contacts_type | 联系人类型 | varchar(5) | 关联-码表 |
name | 姓名 | varchar(50) | 文本 |
phone | 手机号 | varchar(11) | 文本(手机输入框) |
app_id | 申请表id(外键) | bigint | 关联-数据表 |
- 码值设定
sex(性别):1男,2女。
address_type(地址类型):1居住地址,2办公地址
home_type(房产类型):1自建房,2住宅房,3商品房
contacts_type(联系人类型)1夫妻,2父母,3兄弟姊妹,4朋友
city(城市):
- 其它
4、数据模型管理
对第三步的数据表的设计,在lubase框架上进行实现。
4.1分组管理
点击当前用的【数据模型管理】会提示建立添加模型分组,如图
因为应用的功能比较大,会分不同的模块且表数量会比较多,所以引入了一个数据模型分组的概念,每个分组设定不同前缀进行表的区分。所以在创建数据模型之前,需要先定义好数据模型分组,每个分组需要定义一个表前缀(建议2-3为字符),之后此组下的模型必须以此前缀开头。
我们的此项目建立一个分组,如图
4.2建表管理
选新建的分组,然后点击上面的新增模型,填写【表代码】与【中文名称】点击确定即可
并会自动创建必要及通用字段:
4.3字段管理
选中表,就可以选择不用的建立字段的方式:
本节先对一个文本字段建立进行说明,先看一个整体界面:
1、字段代码与字段名称必填,保存后字段代码不可编辑。
2、字段类型,包括所有的字段类型,如图:
3、显示类型,不同的字段类型可以有不同的显示类型,可扩展。如文本字段,可以有电话、身份证等不同的显示类型,可以在业务端进行相应的效果的渲染展示。
4、列可见性,设置字段是只读,还是可编辑 等属性。
其它属性后续在介绍,本节就说到这里。
开源地址: https://gitee.com/lubase,可以加群主进群获取更多信息: