water-management-system/mobile-app

供水管理系统 - 移动端APP

三合一移动应用：供水管理 / 巡检管理 / 营收管理

技术栈

• 框架: Flutter 3.x
• 状态管理: Provider
• 路由: GoRouter
• HTTP: Dio
• 本地存储: Hive + SharedPreferences
• 定位: Geolocator
• 相机: Image Picker
• 通知: Flutter Local Notifications

项目结构

mobile-app/
├── lib/
│   ├── main.dart                    # 入口文件
│   ├── core/                        # 核心模块
│   │   ├── theme/                   # 主题配置
│   │   ├── constants/               # 常量定义
│   │   ├── network/                 # 网络层（Dio + 拦截器）
│   │   └── utils/                   # 工具类
│   ├── features/                    # 功能模块
│   │   ├── auth/                    # 认证（登录/Token）
│   │   ├── main_shell/              # 主框架（Tab导航）
│   │   ├── water_supply/            # 供水管理
│   │   ├── patrol/                  # 巡检管理
│   │   └── revenue/                 # 营收管理
│   ├── shared/                      # 共享模块
│   │   ├── widgets/                 # 通用组件
│   │   └── services/                # 共享服务
│   └── config/                      # 配置（路由等）
├── android/                         # Android 配置
├── ios/                             # iOS 配置
└── pubspec.yaml                     # 依赖配置

功能模块

1. 统一登录 + Token 管理

• 账号密码登录
• Token 自动附加（AuthInterceptor）
• Token 刷新机制
• 登录状态持久化

2. 三合一 Tab 导航

• 供水管理 Tab
• 巡检管理 Tab
• 营收管理 Tab

3. 供水管理

• 监测站点列表
• 实时水压/流量/水质数据
• 状态告警

4. 巡检管理

• 巡检任务列表（按状态筛选）
• 任务进度展示
• 支持新建巡检任务

5. 营收管理

• 抄表任务列表
• 账单列表（缴费状态筛选）
• 抄表数据录入

6. 核心服务

• PushService: 消息推送（初始化 + 回调）
• LocationService: GPS定位 + 权限管理
• CameraService: 拍照/相册选择
• CacheService: 离线缓存（Hive）

运行

# 安装依赖
flutter pub get

# 运行开发模式
flutter run

# 构建 APK
flutter build apk

# 构建 iOS
flutter build ios