Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shanliu/lsys
[开发中] 一个用rust实现 面向内部应用的应用管理中心 [测试账号:aaaaa 密码:000000]
https://github.com/shanliu/lsys
rust rust-web web-development
Last synced: about 1 month ago
JSON representation
[开发中] 一个用rust实现 面向内部应用的应用管理中心 [测试账号:aaaaa 密码:000000]
- Host: GitHub
- URL: https://github.com/shanliu/lsys
- Owner: shanliu
- License: apache-2.0
- Created: 2023-01-23T09:40:07.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-20T07:27:22.000Z (9 months ago)
- Last Synced: 2024-04-20T13:52:04.857Z (9 months ago)
- Topics: rust, rust-web, web-development
- Language: Rust
- Homepage: https://lsys.cc
- Size: 2.15 MB
- Stars: 36
- Watchers: 2
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.MD
- License: LICENSE
Awesome Lists containing this project
README
### 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](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二次开发示例](server/examples/lsys-web-subapp-demo/)
```mermaid
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
```
##### 基于HTTP接口方式二次开发
> [通过HTTP接口接入文档](sdk/)
```mermaid
sequenceDiagram
par 普通应用实现[接入层处理业务逻辑]
前端->>外部应用接入层: 自行选择语言,实现方式等
外部应用接入层->>lsys服务: 通过以上协议 访问lsys提供的服务来实现部分你需要的功能
lsys服务-->>外部应用接入层: 处理结果返回到外部应用
外部应用接入层-->>前端: 返回结果
end
par 拆分接入层跟服务层的实现[服务层处理业务逻辑]
前端->>外部应用接入层: 自行选择语言,实现方式等
外部应用接入层->>外部应用服务层:自行选择语言,内部访问协议等,最好接入层 APPID 并传入
外部应用服务层->>lsys服务: 根据接入层传入的APPID,查询对应的APP信息
lsys服务-->>外部应用服务层: 可根据查询到的 APP信息
外部应用服务层->>外部应用服务层: 根据查询app信息及接入层传入APPID及其他参数 进行签名校验
外部应用服务层->>外部应用服务层: 校验请求通过后，继续完成内部服务层业务逻辑
外部应用服务层-->>外部应用接入层: 自行实现协议返回数据到接入层
外部应用接入层-->>前端: 返回结果
end
```