# Plus-One-UI

**Repository Path**: lkShi/plus-one-ui

## Basic Information

- **Project Name**: Plus-One-UI
- **Description**: Plus One UI 是一个专注于企业级后台管理场景的 React + Semi Design 模板，基于 semi-design-pro 深度优化，提供开箱即用的实用组件与简洁架构，践行“+1”理念——在工程细节中持续精进。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-11
- **Last Updated**: 2025-12-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Plus One UI

**Plus One UI** 是一个基于 [React](https://reactjs.org/) 与 [Semi Design](https://semi.design/zh-CN) 构建的现代化后台管理系统模板。项目源自 [semi-design-pro](https://github.com/xieyezi/semi-design-pro)，在保留其优秀架构的基础上，聚焦于企业级后台管理场景，进行了针对性增强。

> **Plus One 的理念是 '+1'** —— 在现有基础上，多做一点，更好一点。

---

## ✨ 核心增强模块

相比原仓库 `semi-design-pro`，本项目专注于提升后台系统的开发效率与一致性，新增以下实用模块：

- **OneSelect**  
  基于系统配置表动态渲染下拉选项，自动对接后端字典数据。

- **OneTable**  
  简化表格开发：只需定义 `columns`，无需手动处理分页、加载状态等逻辑，开箱即用。

- **MINIO 上传组件 OneUpload**  
  深度集成 [Plus-One-System](https://gitee.com/lkShi/plus-one-system.git) 与 `rustfs`，通过 MINIO 协议实现文件上传与预览，适用于私有化部署场景。

- **菜单后端配置 动态加载**
> 💡 **建议搭配 [Plus-One 后端项目](https://gitee.com/lkShi/plus-one-system.git) 一同使用，以获得完整功能体验。**

---

## 🚀 特性亮点

- 基于 **React 18+** 与 **TypeScript**，类型安全，工程健壮
- 采用 **Semi Design** 组件库，UI 美观、主题可定制、无障碍友好
- 内置 **国际化（i18n）** 支持
- 集成 **Mock 数据方案**，前端独立开发无依赖
- 使用 **Zustand** 进行轻量级状态管理
- 支持 **Vite** 快速构建与热更新

---

## 📦 快速开始

### 安装依赖

```bash
yarn
# 或
npm install
```

### 开发环境
```bash
yarn dev
# 或
npm run dev
```
### 打包
```bash
npm run build:test
```


## 项目结构

该项目包含多个模块，如布局组件、路由配置、状态管理、工具函数等，支持快速搭建企业级后台管理系统。

### 主要模块

- `src/App.tsx`: 主应用入口
- `src/pages/`: 页面组件，包含各种模板页面
- `src/router/`: 路由配置
- `src/store/`: 状态管理模块
- `src/components/`: 自定义组件
- `mock/`: 模拟数据模块
- `src/utils/`: 工具函数模块

## 截图效果
### 登录页
![登录页](./images/login.jpg)
### 部门列表
![部门列表](./images/dept-list.jpg)
### 角色列表
![角色列表](./images/role-back.jpg)
### 用户列表
![用户列表](./images/account-back.jpg)
## 技术支持  如需技术支持 咨询请扫码加信
![微信图片](./images/wechat.jpg)
## 浏览器支持

项目支持现代浏览器，推荐使用 Chrome、Firefox 或 Edge 进行开发与运行。

## 贡献

欢迎提交 issue 与 PR。如果你在使用过程中遇到问题，或者有改进意见，请在仓库中提交 issue。

## 许可证

本项目遵循原仓库的许可协议。有关详细信息，请查看仓库中的 LICENSE 文件。