# pithy-app-flutter

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

## Basic Information

- **Project Name**: pithy-app-flutter
- **Description**: No description available
- **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-02-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">金鹿Flutter移动应用 v1.0.0</h1>
<h4 align="center">基于Flutter框架的跨平台移动应用解决方案</h4>

## 📱 项目简介

金鹿Flutter移动应用是基于Flutter框架开发的企业级跨平台移动客户端，采用一套代码多终端适配的技术方案，同时支持Windows、iOS、macOS、Linux、Android、Web等多个平台。该应用与金鹿后台管理系统深度集成，为企业提供完整的移动端解决方案。

目前应用已实现用户认证、个人中心、工作台、CRM客户关系管理、巡检管理、系统管理等核心功能模块。

## 🚀 核心特性

### 🔧 技术架构
- **跨平台支持**: 一套代码适配六大平台（Android/iOS/Web/Windows/macOS/Linux）
- **现代化框架**: 基于Flutter 3.x + GetX状态管理
- **响应式设计**: 自适应不同屏幕尺寸和设备类型
- **组件化开发**: 模块化架构，便于维护和扩展

### 💼 业务功能
- **用户认证**: 完善的登录鉴权体系
- **个人中心**: 用户信息管理、设置、帮助等
- **工作台**: 首页展示、通知公告、快捷入口
- **CRM系统**: 线索管理、客户管理、订单管理、公海池
- **巡检管理**: 线路管理、巡检执行、问题上报
- **系统管理**: 用户管理、角色权限、部门组织等

## 🛠️ 技术栈

### 前端技术
- **Flutter**: 3.x 版本
- **状态管理**: GetX
- **网络请求**: Dio
- **本地存储**: Shared Preferences + Get Storage
- **UI组件**: Material Design + 自定义组件
- **图标字体**: 自定义IconFont

### 第三方依赖
```yaml
flutter_localizations: 国际化支持
dio: 网络请求库
shared_preferences: 本地数据存储
get_storage: 轻量级数据存储
webview_flutter: WebView组件
url_launcher: URL跳转
pull_to_refresh: 下拉刷新
flutter_swiper_null_safety_flutter3: 轮播图
like_button: 点赞按钮
flutter_svg: SVG图片支持
flutter_simple_treeview: 树形视图
```

## 📁 项目结构

```
lib/
├── api/                    # API接口层
│   ├── crm/               # CRM相关接口
│   ├── report/            # 巡检相关接口
│   ├── system/            # 系统管理接口
│   └── login.dart         # 登录接口
├── components/            # 公共组件
│   └── notice_banner.dart # 通知横幅组件
├── icon/                  # 自定义图标
│   └── ruoyi_icon.dart    # 图标定义
├── pages/                 # 页面组件
│   ├── common/            # 通用页面
│   ├── crm/               # CRM功能模块
│   ├── home/              # 首页
│   ├── mine/              # 我的页面
│   ├── report/            # 巡检管理
│   ├── system/            # 系统管理
│   ├── tool/              # 工具页面
│   ├── work/              # 工作台
│   └── login.dart         # 登录页面
├── routes/                # 路由配置
├── utils/                 # 工具类
│   ├── request.dart       # 网络请求封装
│   └── sputils.dart       # 存储工具
└── main.dart              # 应用入口
```

## 🎯 功能模块详解

### 🔐 认证模块
- 用户登录（支持验证码）
- Token自动刷新
- 登录状态持久化
- 权限校验

### 👤 个人中心
- 用户信息展示与编辑
- 头像管理
- 修改密码
- 系统设置
- 关于我们
- 帮助文档

### 🏠 工作台
- 首页仪表板
- 通知公告展示
- 快捷功能入口
- 数据统计概览

### 📊 CRM系统
- **线索管理**: 线索录入、分配、转化
- **客户管理**: 客户信息维护、跟进记录
- **订单管理**: 订单创建、审批流程
- **公海池**: 客户资源池管理

### 🔍 巡检管理
- **线路管理**: 巡检线路配置
- **巡检执行**: 现场巡检任务
- **问题上报**: 异常情况记录
- **报告生成**: 巡检报告汇总

### ⚙️ 系统管理
- 用户管理
- 角色权限
- 部门组织
- 字典管理
- 通知公告
- 系统日志

## 🚀 快速开始

### 环境准备
```bash
# Flutter环境要求
Flutter SDK >= 2.17.6
Dart SDK >= 2.17.6
```

### 项目初始化
```bash
# 清理缓存
flutter clean

# 获取依赖
flutter pub get

# 运行项目
flutter run
```

### 构建发布
```bash
# Android构建
flutter build apk --release

# iOS构建
flutter build ios --release

# Web构建
flutter build web

# Windows构建
flutter build windows
```

### 平台特定配置
```bash
# 重新生成Android平台
flutter create --platforms android .

# 重新生成iOS平台
flutter create --platforms ios .
```

## 🔧 开发指南

### 路由管理
项目采用GetX进行路由管理，在`routes/app_pages.dart`中配置所有页面路由。

### 网络请求
使用`utils/request.dart`封装的Dio实例进行API调用，支持拦截器、错误处理等功能。

### 状态管理
采用GetX的状态管理方案，通过Controller管理页面状态和业务逻辑。

### 组件复用
公共组件放在`components/`目录下，可在多个页面中复用。

## 📱 界面预览

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

## 📚 API文档

项目包含完整的API接口文档：
- [`crm-api-documentation.md`](./crm-api-documentation.md) - CRM系统接口文档
- [`inspection-api-documentation.md`](./inspection-api-documentation.md) - 巡检管理系统接口文档
- [`notice-api-documentation.md`](./notice-api-documentation.md) - 通知公告系统接口文档

## 🤝 贡献指南

1. Fork 本仓库
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 📞 联系方式

- **项目地址**: [GitHub仓库地址]
- **问题反馈**: [Issues页面]
- **交流群**: QQ群 140586555

## 🙏 致谢

感谢以下开源项目和技术的支持：
- [Flutter](https://flutter.dev/)
- [GetX](https://pub.dev/packages/get)
- [Dio](https://pub.dev/packages/dio)