shanliu / lsys

[开发中] 一个用rust实现 简易应用管理系统 [测试账号:aaaaa 密码:000000]

rust实现的 内部应用应用管理中心

适用场景：

1. 当你使用rust开发web应用时，使用本项目二次开发可以减少重复工作量。
2. 当你需要一个包含oauth的轻量级开放平台服务时,可基于本项目快速实现鉴权，应用管理等.
3. 当进行分模块独立开发（如：公司内分团队的各自独立开发）时，可用本项目作为一个内部应用管理中心。
4. 当你希望把一些常用服务（如：发送短信，邮件 等）抽离出来公用时,可用本项目实现.

在线示例: https://lsys.site/ [账号:aaaaa 密码:000000]

配置跟编译

1. 执行编译

编译生成文件在 ./build 中,并同时可生成 ./build 目录的压缩包

仅拷贝生成的 ./build 到你的服务器即可,其他文件可以删除.

Windows(64bit)系统下可以下载 lsys-for-windows.zip 跳过此编译过程

windows

.\build.cmd zip assets 
#zip :可选,生成 lsys-for-windows.zip 
#assets :可选,从github下载对应资源

linux or macos

bash ./build.sh tar assets
#zip :可选,生成 lsys.tar.gz
#assets :可选,从github下载对应资源

2. 导入SQL到数据库

mysql -u your_username -p your_database < ./build/assets/tables.sql #导入到你的MYSQL

3. 修改项目配置

修改服务器配置。

./build/.env  # 配置文件

修改UI访问后台服务地址

./build/ui/config.js # ui 使用内置HTTP服务无需修改,自行部署(如nginx)时指定,示例: "serverURL": "//lsys.site/"

4. 启动服务

源码编译时，可在 https://github.com/shanliu/lsys/releases/tag/v0.0.0 下载项目使用的资源文件,下载后放置于 build/data 中。

执行 ./actix-web-dome 启动服务。注意:初次启动会慢一些。

可使用 nohup ./actix-web-dome & 后台执行

根据.env配置访问服务.默认地址:http://127.0.0.1:8080/

二次开发时序参考

基于rust二次开发

基于rust二次开发示例

sequenceDiagram
    par 管理ui实现
    前端->>lsys服务: 前端请求到 lsys-actix-web[actix-web] 服务
    lsys服务-->>前端: 返回结果
    end
    par 自行开发RUST内部应用实现
    前端->>lsys服务: 前端请求到 lsys-actix-web[actix-web] 服务
    lsys服务->>内部rust实现: 由 actix-web 进行接入，可换其他支持tokio运行时框架
    内部rust实现->>内部rust实现: 实现你的业务逻辑，示例应用[lsys-web-subapp-dome]
    内部rust实现-->>lsys服务: 可以库调用访问lsys服务[lsys-rbac,lsys-user等]
    lsys服务-->>前端: 返回结果
    end

Loading

基于HTTP接口方式二次开发

通过HTTP接口接入文档

sequenceDiagram
    par 普通应用实现[接入层处理业务逻辑]
    前端->>外部应用接入层: 自行选择语言,实现方式等
    外部应用接入层->>lsys服务: 通过以上协议 访问lsys提供的服务来实现部分你需要的功能
    lsys服务-->>外部应用接入层: 处理结果返回到外部应用
    外部应用接入层-->>前端: 返回结果
    end
    par 拆分接入层跟服务层的实现[服务层处理业务逻辑]
    前端->>外部应用接入层: 自行选择语言,实现方式等
    外部应用接入层->>外部应用服务层:自行选择语言,内部访问协议等,最好接入层 APPID 并传入
    外部应用服务层->>lsys服务: 根据接入层传入的APPID,查询对应的APP信息
    lsys服务-->>外部应用服务层: 可根据查询到的 APP信息 
    外部应用服务层->>外部应用服务层: 根据查询app信息及接入层传入APPID及其他参数 进行签名校验
    外部应用服务层->>外部应用服务层: 校验请求通过后，继续完成内部服务层业务逻辑
    外部应用服务层-->>外部应用接入层: 自行实现协议返回数据到接入层
    外部应用接入层-->>前端: 返回结果
    end

Loading