# lumin-app-flutter

**Repository Path**: xfcode-source/lumin-app-flutter

## Basic Information

- **Project Name**: lumin-app-flutter
- **Description**: lumin-app-flutter  是 Lumin 生态体系中的高性能原生移动端解决方案。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-26
- **Last Updated**: 2026-03-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Lumin Flutter APP</h1>
<h4 align="center">基于 Flutter 框架的企业移动应用解决方案</h4>

## 项目简介

Lumin Flutter APP 是基于 RuoYi-Vue 后端框架的移动端解决方案，采用 Flutter 框架实现，一套代码多端适配（iOS / Android / Web / Windows / macOS / Linux）。目前已完成登录认证、工作台、个人中心、系统管理等功能模块，适用于企业内部管理系统、移动办公等场景。

> 🔗 后端项目：[RuoYi-Vue](https://gitee.com/y_project/RuoYi-Vue)

## 技术栈

| 分类 | 技术 | 说明 |
|------|------|------|
| 框架 | Flutter | 跨平台移动应用框架 |
| 路由 | GetX | 路由管理、导航、状态管理 |
| 网络 | Dio | HTTP 客户端 |
| WebView | webview_flutter | 内嵌网页 |
| 存储 | shared_preferences | 本地轻量数据持久化 |
| UI | flutter_screenutil | 屏幕适配 |

## 项目结构

```
lib/
├── api/                    # API 接口层
│   ├── login.dart         # 登录相关接口
│   └── system/            # 系统管理接口
├── icon/                  # 自定义图标
├── pages/                 # 页面
│   ├── common/           # 通用页面
│   │   └── webview/     # WebView 内嵌页
│   ├── home/            # 首页
│   ├── login.dart        # 登录页
│   ├── mine/            # 个人中心
│   │   ├── about/       # 关于我们
│   │   ├── help/        # 帮助中心
│   │   ├── info/        # 个人信息
│   │   ├── pwd/         # 修改密码
│   │   └── setting/     # 设置
│   ├── pages_index.dart  # 底部导航页
│   ├── system/          # 系统管理
│   │   ├── config/      # 系统配置
│   │   ├── dept/        # 部门管理
│   │   ├── dict/        # 字典管理
│   │   ├── menu/        # 菜单管理
│   │   ├── notice/      # 通知公告
│   │   ├── post/        # 岗位管理
│   │   └── user/        # 用户管理
│   ├── tool/            # 工具
│   │   └── swagger/     # Swagger 接口文档
│   └── work/            # 工作台
├── routes/               # 路由配置
│   ├── app_pages.dart   # 页面路由定义
│   ├── app_routes.dart  # 路由名称常量
│   └── routes.dart      # 路由汇总
└── main.dart            # 入口文件
```

## 功能模块

### 认证模块
| 功能 | 说明 | 状态 |
|------|------|------|
| 账号密码登录 | 用户名 + 密码 | ✅ |
| 隐私政策 | 跳转 WebView 查看 | ✅ |
| 修改密码 | 旧密码 + 新密码 | ✅ |

### 首页
| 功能 | 说明 | 状态 |
|------|------|------|
| 首页概览 | 快速入口展示 | ✅ |
| WebView 内嵌 | 支持加载外部 H5 页面 | ✅ |

### 工作台
| 功能 | 说明 | 状态 |
|------|------|------|
| 工作台主页 | 常用功能快捷入口 | ✅ |

### 个人中心
| 功能 | 说明 | 状态 |
|------|------|------|
| 个人信息 | 查看/编辑个人资料 | ✅ |
| 设置 | 应用偏好设置 | ✅ |
| 修改密码 | 登录密码修改 | ✅ |
| 帮助中心 | 常见问题解答 | ✅ |
| 关于我们 | 应用版本信息 | ✅ |

### 系统管理（管理员功能）
| 功能 | 说明 | 状态 |
|------|------|------|
| 用户管理 | 增删改查用户 | ✅ |
| 角色管理 | 角色权限配置 | ✅ |
| 菜单管理 | 权限菜单维护 | ✅ |
| 部门管理 | 组织架构管理 | ✅ |
| 岗位管理 | 岗位配置 | ✅ |
| 字典管理 | 数据字典维护 | ✅ |
| 通知公告 | 公告发布查看 | ✅ |
| 系统配置 | 系统参数配置 | ✅ |

### 工具
| 功能 | 说明 | 状态 |
|------|------|------|
| Swagger 文档 | API 接口文档查看 | ✅ |

## 核心配置

```dart
// API 基础地址（开发环境）
// 请根据实际后端服务地址修改
static const String baseUrl = 'https://mouor.cn';

// 隐私政策地址
static const String privacyUrl = 'https://ruoyi.vip/protocol.html';

// Swagger 接口文档地址
static const String swaggerUrl = 'https://mouor.cn:8081/swagger-ui/index.html';
```

## 主要依赖

```yaml
dependencies:
  flutter:
    sdk: flutter
  cupertino_icons: ^1.0.8

  # 状态管理与路由
  get: ^4.6.6

  # 网络请求
  dio: ^5.4.0

  # WebView
  webview_flutter: ^4.13.1

  # 本地存储
  shared_preferences: ^2.2.2

  # 屏幕适配
  flutter_screenutil: ^5.9.0

  # 图片缓存
  cached_network_image: ^3.3.1
```

## 开发环境

- **Flutter SDK**: >=3.0.0
- **Dart**: >=3.0.0
- **Android SDK**: >=21
- **iOS**: >=12.0

## 运行项目

```bash
# 克隆代码
git clone https://gitee.com/xfcode-source/lumin-app-flutter.git
cd lumin-app-flutter

# 安装依赖
flutter pub get

# 运行调试
flutter run

# 构建 Android APK
flutter build apk --release

# 构建 iOS（macOS only）
flutter build ios --release
```

## 构建配置

项目已配置好现代化 Gradle 构建体系：

| 配置项 | 值 |
|--------|-----|
| AGP 版本 | 8.9.1 |
| Gradle 版本 | 8.11.1 |
| Kotlin 版本 | 2.1.0 |
| compileSdk | 36 |
| targetSdk | 36 |
| minSdk | 21 |
| Java 版本 | 11 |

## 相关项目

| 项目 | Git 地址 | 说明 |
|------|---------|------|
| lumin-app-flutter | https://gitee.com/xfcode-source/lumin-app-flutter | Flutter 移动端 |
| RuoYi-Vue | https://gitee.com/y_project/RuoYi-Vue | Java 后端 |

## 演示截图

<table>
    <tr>
        <td><img src="https://mouor001.oss-cn-beijing.aliyuncs.com/login.png" width="250"/></td>
        <td><img src="https://mouor001.oss-cn-beijing.aliyuncs.com/work.png" width="250"/></td>
        <td><img src="https://mouor001.oss-cn-beijing.aliyuncs.com/my.png" width="250"/></td>
    </tr>
    <tr>
        <td>登录页</td>
        <td>工作台</td>
        <td>个人中心</td>
    </tr>
    <tr>
        <td><img src="https://mouor001.oss-cn-beijing.aliyuncs.com/info.png" width="250"/></td>
        <td><img src="https://mouor001.oss-cn-beijing.aliyuncs.com/settings.png" width="250"/></td>
        <td><img src="https://mouor001.oss-cn-beijing.aliyuncs.com/editpwd.png" width="250"/></td>
    </tr>
    <tr>
        <td>个人信息</td>
        <td>设置</td>
        <td>修改密码</td>
    </tr>
</table>

## 开发规范

1. **命名规范**
   - 文件名：小写 + 下划线（`login_page.dart`）
   - 类名：大驼峰（`LoginPage`）
   - 变量名：小驼峰（`userName`）

2. **页面组织**
   - 每个功能模块单独文件夹
   - 页面文件放在 `pages/` 目录下
   - API 接口放在 `api/` 目录下

3. **路由管理**
   - 使用 GetX 进行路由管理
   - 路由名称统一在 `app_routes.dart` 中定义
   - 页面参数通过 `Get.arguments` 获取

4. **状态管理**
   - 使用 GetX 的响应式状态管理
   - 按模块划分控制器

---

*最后更新: 2026-03-31*