# sss-module

**Repository Path**: rocky00yu00/sss-module

## Basic Information

- **Project Name**: sss-module
- **Description**: 组件化、模块化通用后台管理系统的后端代码
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-03-09
- **Last Updated**: 2026-01-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# sss-module

## 介绍

**SSS** 是一个通用的管理系统的后台代码，旨在将代码组件化、模块化，然后以堆积木的方式进行组合，生成不同功能的产品，以此来提高代码的复用率及开发效率。

此项目为后端代码。

**欢迎加入**

**试用地址：**

PC端：
http://152.136.203.133/#/login

移动端：
http://152.136.203.133/app/

## 文化

1. 合作共创，持久共赢
2. 用简单但合适的方案实现需求
3. 用整洁但合适的代码实现需求
4. 用高效但合适的设计实现需求
5. 编程是一门艺术
6. 助力企业标准化、信息化、数字化、智能化

## 软件架构

从单体开始，化繁为简，衍化至繁。

架构是一门划分边界的艺术；

### 技术选型

#### 前端技术选型：

- Vue
- Router
- Pinia
- Vite

#### 后端技术选型：

- SpringBoot: 3.5.8
- MybatisPlus
- Flyway（数据库脚本版本管理工具）
- MapStruct（对象属性映射工具）
- Lombok
- 微服务模块：
  - SpringCloud: 2025.0.1
  - Spring Cloud Consul
    - Consul: 1.21.5
  - Spring Cloud Gateway
  - Spring Cloud OpenFeign
  - Spring Cloud Circuit Breaker
  - Spring Cloud Netflix
  - Spring Cloud LoadBalancer
  

#### 存储技术选型：

- MySQL: 8

### 技术架构

主要是对各层所用技术栈的展示

![技术架构](./other-resources/images/SSS-technology-architecture-1.0.0.png)

### 功能架构

主要是对整个项目功能组成、功能边界及功能关系的展示。

![功能架构](./other-resources/images/SSS-feature-architecture-1.0.0.png)

#### 功能介绍

##### 基础功能

**介绍：** 该层主要包含系统中的通用管理功能，包括用户管理、菜单管理、角色管理、权限管理等。

- **用户管理**：系统登录用户信息管理，同时也是统一身份认证的身份信息。
- **菜单管理**：系统菜单信息管理，分为目录、菜单和按钮三种类型的菜单信息。
- **角色管理**： 
- **权限管理:**  按钮级别的权限管理及后端的接口权限管理
- 部门管理：部门信息管理
- 字典管理：通用字典信息管理

##### 业务功能：

###### 统一身份认证：

**介绍：** 支持基于`Oauth2`协议的统一身份认证，主要功能包括应用管理、单点登录。

- **应用管理：** 对需要进行单点登录的应用的基本信息管理



###### IPAM（IP地址管理）

**介绍：** 主要进行IPv4的信息管理及子网信息管理

- **子网管理**：对子网信息的管理
- **IP管理**：对IPv4信息的管理

###### 人事管理

- 员工管理
- 职位管理
- 假勤管理
    - 排班管理
    - 考勤管理
    - 班次管理
    - 工作地点

###### MALL（商城）

- 会员管理
- 订单管理
- 商品管理


### 模块化架构


## 安装教程

1. 修改相关配置信息：端口、数据库地址 
2. 打包sss-module-server-base模块
3. 用`java -jar ` 启动jar包

## 使用说明

合作共创，持久共赢

## 参与贡献

1. Fork 本仓库
2. 从develop分支上新建 feature_xxx 分支
3. 提交代码
4. 向develop分支上新建 Pull Request


## 特技

1. 使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md