# flutter-we-easy

**Repository Path**: numeron/flutter-we-easy

## Basic Information

- **Project Name**: flutter-we-easy
- **Description**: 维易APP端，flutter编写，支持在Android、iOS、HarmonyOS、WEB运行。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-24
- **Last Updated**: 2025-08-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# flutter-we-easy

flutter-we-easy 是一个基于 Flutter 的应用程序框架，旨在简化企业级移动应用的开发流程。该框架提供了大量可复用的组件和模块，尤其适用于需要复杂用户权限管理、部门管理、角色管理以及用户登录认证等功能的业务场景。

## 项目结构概览

该项目包含两个主要目录：

- **app**: 包含应用程序的主代码，包括登录、首页、主题管理、初始化和导航控制等功能。
- **common**: 提供了跨平台的通用模块，包含数据加载、数据库连接、网络请求、用户认证、部门和角色管理等企业级功能支持。

此外，项目支持 **Android**, **iOS**, **OHOS** 和 **Web** 平台，确保多端一致性体验。

## 主要功能

- **用户认证与登录**: 提供完整的登录流程支持，包括认证 API、中间件、登录状态监听等。
- **部门管理**: 支持部门的创建、查询、列表展示等功能，适用于组织架构清晰的应用。
- **角色与权限管理**: 实现角色定义、权限分配、授权管理等企业级功能。
- **数据库支持**: 使用多平台数据库连接，支持本地数据持久化。
- **网络请求工具**: 提供统一的 HTTP 请求模块，并支持请求头拦截和未授权处理。
- **主题与设置管理**: 支持动态切换主题、管理应用设置等功能。
- **通用组件与工具**: 提供常用 UI 组件和实用工具，如点击文本、安全区域、网格视图、KV 存储等。

## 使用技术栈

- Flutter（跨平台开发）
- Dart（核心语言）
- Kotlin (Android 原生)
- Swift (iOS 原生)
- ETS / OpenHarmony (OHOS 原生)

## 安装与运行

### 前提条件

- 安装 Flutter SDK
- 安装 Android Studio / XCode / OHOS DevEco Studio 等对应平台开发工具
- 安装 Git

### 步骤

1. 克隆项目：
   ```bash
   git clone https://gitee.com/numeron/flutter-we-easy
   ```

2. 进入项目目录：
   ```bash
   cd flutter-we-easy
   ```

3. 获取依赖：
   ```bash
   flutter pub get
   ```

4. 运行项目：
   ```bash
   flutter run
   ```

## 贡献指南

我们欢迎社区贡献！你可以通过以下方式参与：

- 提交 Bug 报告或功能建议
- 提供 Pull Request 来改进代码或文档
- 参与讨论并帮助改进框架

请确保提交的代码遵循项目的代码规范，并提供必要的测试用例。

## 协议

本项目遵循 MIT 协议。详情请参阅 [LICENSE](common/LICENSE) 文件。

## 参考文档

- [Flutter 官方文档](https://flutter.dev/docs)
- [OpenHarmony 开发文档](https://developer.harmonyos.com/)

如需获取更多项目细节，请查看具体模块的 README.md 文件或项目注释代码。