sion/chat

Fork 0

Files

sion db90e7579b 优化

2026-04-25 16:36:34 +08:00

3.8 KiB

Raw Permalink Blame History

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. 安装依赖

cd client/flutter
flutter pub get

3. 配置后端地址

编辑 lib/services/api_service.dart:

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

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

4. 运行应用

# 开发模式
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):

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

API 路径:

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

Tailchat 插件模式

连接 Tailchat (端口 11000):

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

API 路径:

/invite/create - 创建邀请
/invite/my - 我的邀请
/stats/my - 个人统计

开发

代码规范

# 格式化代码
dart format .

# 静态分析
flutter analyze

# 运行测试
flutter test

环境配置

创建 .env 文件:

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

部署

Android

# 构建 APK
flutter build apk --release

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

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

iOS

# 构建 iOS
flutter build ios --release

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

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

Web

# 构建 Web
flutter build web --release

# 输出位置
# build/web/

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

故障排除

依赖问题

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

iOS 构建失败

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

Android 构建失败

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

许可证

MIT

3.8 KiB Raw Permalink Blame History