# backend-admin

**Repository Path**: MetaLite/backend-admin

## Basic Information

- **Project Name**: backend-admin
- **Description**: 【独立部署应用】元界MetaLite后端应用的管理后台，包括权限管理、业务配置中心、登录、操作日志、公网API管理等功能模块。
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-07-11
- **Last Updated**: 2026-05-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# backend-admin

## 简介

`backend-admin` 是 MetaLite 微服务架构的**管理后台服务**，提供系统基础管理能力，需独立部署。

### 定位与职责

| 定位 | 职责 |
|------|------|
| 管理后台 | 用户、组织、权限、字典等基础管理 |
| 独立部署 | 作为独立服务运行 |
| 权限中心 | 统一权限管理和校验 |
| 公共服务 | 提供client包供其他服务使用 |

---

## 设计思想

### RBAC权限模型

采用标准的RBAC权限模型：用户 → 组织 → 资源（API/菜单/按钮），支持数据权限（本部门/本部门及子部门/全部数据/仅本人）。

### Client包使用

```xml
<!-- 其他服务引入client依赖，使用admin的领域对象 -->
<dependency>
    <groupId>com.metalite</groupId>
    <artifactId>backend-admin</artifactId>
    <classifier>client</classifier>
</dependency>
```

---

## 核心能力

| 能力 | API | 说明 |
|------|-----|------|
| 用户管理 | SysUserApi | 用户CRUD、登录/登出、密码管理 |
| 多端登录 | SysUserApi | SSO多端登录，支持同一用户在多个App端同时登录，独立userToken管理 |
| 组织管理 | SysOrgApi | 组织树、用户-组织关联、资源转移 |
| 权限管理 | SysResApi | 资源树、功能权限、数据权限分配 |
| 字典管理 | SysDictApi | 系统字典维护 |
| 公告管理 | SysNoticeApi | 系统公告发布、有效期控制 |
| 调用方管理 | SysExternalCallerApi | 第三方应用接入、加密/签名配置 |
| API管理 | SysExternalApiApi | 接口权限配置 |
| 限流管理 | SysExternalRateLimitApi | 三层维度限流规则配置 |
| 操作日志 | SysUserOperateLogApi | 自动记录所有关键操作，支持按用户、操作类型、时间维度查询审计 |
| 数据权限 | SysDataPermissionApi | 数据范围配置 |
| 密码检查 | PwdExpireCheckJob | 密码过期检查定时任务 |

---

## 模块结构

```
backend-admin/
├── src/main/java/com/metalite/admin/
│   ├── AdminApplication.java            # 启动类
│   ├── sys/
│   │   ├── entrance/api/                # API接口层
│   │   ├── entrance/job/                # 定时任务
│   │   ├── service/                     # 业务逻辑层
│   │   ├── dao/                         # 数据访问层
│   │   └── domain/                      # 领域对象
│   └── common/
│       ├── aspect/                      # 权限切面
│       └── config/                      # 配置
└── src/main/resources/
    ├── application.yml                  # 主配置文件
    ├── application-dev.yml              # 开发环境配置
    ├── application-test.yml             # 测试环境配置（可选）
    ├── application-prod.yml             # 生产环境配置（可选）
    ├── logback-spring.xml               # 日志配置
    └── scripts/mysql/                   # MySQL脚本
        └── init.sql                # 初始化脚本
```

---

## 许可证

MIT License