# 微校园

**Repository Path**: nycticebus/campus

## Basic Information

- **Project Name**: 微校园
- **Description**: 基于SpringBlade框架开发，目标是利用微服务整合主流技术，开发校园内部的应用开发。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 2
- **Created**: 2020-09-08
- **Last Updated**: 2021-06-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 微校园平台

#### 介绍
基于校园场景，开发有关校园的业务。
根据校园社团为中心，校园认证，实现校园社团管理，各级之间
的管理，不同校园社团之间的申请管理，完成社团事物的工作流。
整合多种技术，实现微服务拆分模块的特性。
支持微校园多应用扩展，校内自研项目，校外应用对接等。
* SpringBlade 同步 70f59b9 版本
* Saber 同步 265f324 版本

#### 软件架构
基于SpringBlade开发微校园平台，整合七牛，微信，钉钉，支付宝等平台接口。
整合xxl-job调度中心
```
# token
1. 长期token，即前后端耦合较强，每次请求给token刷新失效时间
2. 限时token，即前后端耦合一般，token在限时内不会失效
3. 单次消费token，即前后端耦合不强，一次token只能消费一次，适用于外部系统接入
# 登录
A:单点登录JSON：用户密码应用ID验证码第三方登录，直接获取永久token（saber管理系统，返回JSON数据，所有应用可用）
B:单点登录重定向：用户密码应用ID获取code，带应用地址重定向到单点登录接口，单点登录接口校验密钥code，最后带限时用户token重定向到应用地址（内外部应用，重定向到应用地址）
B:外部应用授权登录：用户密码应用ID，带code重定向到应用地址，根据密钥code获取一次性用户token
C:外部应用授权：应用ID密钥获取code，消费code获取一次性应用token
```

#### 安装教程
* 基础启动模块
1.  campus-auth
2.  campus-gateway
3.  campus-desk
4.  campus-system
5.  campus-user
6.  campus-log
7.  Saber

#### 使用说明

* 系统结构
```
├── campus-app 应用模块
    ├── Saber -- 微校园系统
├── campus-auth -- 授权模块
├── campus-common -- 公共常量
├── campus-gateway -- 鉴权网关
├── campus-ops -- 模型存储
    ├── campus-admin
    ├── campus-develop
    ├── campus-resource
    ├── campus-seata-order
    ├── campus-seata-storage
├── campus-process -- 原始模块（空）
├── campus-production -- 数据产生模块
    ├── campus-production-service -- 数据产生业务
    ├── campus-production-api -- 数据产生API
├── campus-queue -- 消息队列模块
    ├── campus-queue-active -- ActiveMQ消息队列
├── campus-service -- SpringBlade原始业务
    ├── campus-demo -- 样例
    ├── campus-desk -- 工作台模块
    ├── campus-log -- 日志模块
    ├── campus-system -- 系统模块
    ├── campus-user -- 用户模块
├── campus-service-api -- SpringBlade原始API
    ├── campus-demo-api -- 样例API
    ├── campus-desk-api -- 工作台模块API
    ├── campus-dict-api -- 字典模块API
    ├── campus-system-api -- 系统模块API
    ├── campus-user-api -- 用户模块API
├── campus-weixin -- 微信模块
    ├── campus-weixin-service -- 微信业务
    ├── campus-weixin-service-api -- 微信API
├── campus-workflow -- 工作流模块
    ├── campus-workflow-flowable -- flowable工作流模块
├── campus-task -- 引入xxl-job任务调度中心
```
* 端口占用
```
├── Saber 
    ├── app[all:1888]
├── campus-gateway
    ├── app[all:88]
├── campus-auth
    ├── app[all:8100]
├── campus-user
    ├── app[all:8102]
├── campus-log
    ├── app[all:8103]
├── campus-desk
    ├── app[all:8105]
├── campus-system
    ├── app[all:8106]
├── campus-demo
    ├── app[all:8200]
    ├── xxl-job[all:9999]
├── campus-admin
    ├── app[all:7002]
├── campus-develop
    ├── app[all:7007]
├── campus-resource
    ├── app[all:8010]
├── campus-seata-order
    ├── app[all:8501]
├── campus-seata-storage
    ├── app[all:8502]
├── campus-workflow-flowable
    ├── app[all:9110]
├── campus-queue-active
    ├── app[all:9210]
├── campus-weixin-service
    ├── app[all:9310]
├── campus-production-service
    ├── app[all:9410]
```

* 开发任务
1.  利用数据生产模块生成：用户、部门、岗位等数据
2.  菜单添加级别、租户用户部门岗位次级关系表
3.  登录页添加租户选择（租户即学校）、租户申请
4.  单点登录，二次认证登录、多应用跳转、微信网页授权登录
5.  xxl-job实现单点登录
6.  角色授予应用权限，用户授予应用权限

#### 参与贡献

1.  hy
2.  Jongsuk
3.  jiawei-del


#### 码云特技

1.  SpringBlade官网地址：https://bladex.vip
2.  SpringBlade开源地址：https://gitee.com/smallc/SpringBlade
2.  xxl-job开源地址：https://gitee.com/xuxueli0323/xxl-job