# Sales Chat Flutter App

销售聊天系统 Flutter 移动端应用

## 项目说明

这是一个独立的 Flutter 应用，用于销售邀请追踪和数据统计。

**技术栈**: Flutter + Provider + Dio

## 功能特性

- 📱 群组聊天
- 🎫 邀请码管理
- 📊 销售数据统计
- 📈 个人/团队排行榜
- 🔍 消息搜索

## 快速开始

### 1. 环境要求

- Flutter SDK >= 3.0.0
- Dart >= 3.0.0
- iOS: Xcode >= 14 (macOS only)
- Android: Android Studio / SDK

### 2. 安装依赖

```bash
cd client/flutter
flutter pub get
```

### 3. 配置后端地址

编辑 `lib/services/api_service.dart`:

```dart
// 开发环境 - 连接独立后端
static const String _baseUrl = 'http://localhost:3001/api';

// 或者连接 Tailchat 插件 API
// static const String _baseUrl = 'http://localhost:11000/api/plugin/com.msgbyte.saleschat';
```

### 4. 运行应用

```bash
# 开发模式
flutter run

# 指定设备
flutter run -d chrome    # Web
flutter run -d iphone    # iOS
flutter run -d android   # Android

# 生产构建
flutter build apk        # Android APK
flutter build ios        # iOS (需要 Xcode)
flutter build web        # Web
```

## 项目结构

```
lib/
├── main.dart                 # 应用入口
├── models/                   # 数据模型
│   ├── invite.dart
│   ├── message.dart
│   └── stats.dart
├── screens/                  # 页面
│   ├── home/
│   ├── chat/
│   ├── invite/
│   └── stats/
├── services/                 # 服务
│   ├── api_service.dart     # API 调用
│   ├── auth_service.dart    # 认证
│   └── storage_service.dart # 本地存储
├── providers/                # 状态管理
│   ├── auth_provider.dart
│   ├── chat_provider.dart
│   └── stats_provider.dart
└── widgets/                  # 通用组件
    ├── invite_card.dart
    ├── message_bubble.dart
    └── stats_chart.dart
```

## API 配置

### 独立后端模式

连接 `sales-chat-backend` (端口 3001):

```dart
static const String _baseUrl = 'http://localhost:3001/api';
```

API 路径:
- `/auth/login` - 登录
- `/invites` - 邀请管理
- `/stats/my` - 个人统计
- `/groups` - 群组管理

### Tailchat 插件模式

连接 Tailchat (端口 11000):

```dart
static const String _baseUrl = 'http://localhost:11000/api/plugin/com.msgbyte.saleschat';
```

API 路径:
- `/invite/create` - 创建邀请
- `/invite/my` - 我的邀请
- `/stats/my` - 个人统计

## 开发

### 代码规范

```bash
# 格式化代码
dart format .

# 静态分析
flutter analyze

# 运行测试
flutter test
```

### 环境配置

创建 `.env` 文件:

```env
API_BASE_URL=http://localhost:3001/api
ENABLE_LOGGING=true
```

## 部署

### Android

```bash
# 构建 APK
flutter build apk --release

# 构建 App Bundle (Google Play)
flutter build appbundle --release

# 输出位置
# build/app/outputs/flutter-apk/app-release.apk
```

### iOS

```bash
# 构建 iOS
flutter build ios --release

# 在 Xcode 中打开
open ios/Runner.xcworkspace

# 上传到 App Store Connect
# 使用 Xcode 或 Transporter
```

### Web

```bash
# 构建 Web
flutter build web --release

# 输出位置
# build/web/

# 本地预览
cd build/web
python3 -m http.server 8080
```

## 故障排除

### 依赖问题

```bash
# 清理并重新获取依赖
flutter clean
flutter pub get
```

### iOS 构建失败

```bash
# 更新 CocoaPods
cd ios
pod install --repo-update
```

### Android 构建失败

```bash
# 清理 Gradle 缓存
cd android
./gradlew clean
```

## 相关项目

- **后端插件**: `server/plugins/com.msgbyte.saleschat/`
- **原项目**: `/Users/sion/Desktop/projects/sales-chat/`
- **Tailchat**: https://github.com/msgbyte/tailchat

## 许可证

MIT