# misse-flutter

**Repository Path**: guoleidehao/misse-flutter

## Basic Information

- **Project Name**: misse-flutter
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-15
- **Last Updated**: 2025-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Misse 社交应用

一个基于 Flutter 开发的社交应用，提供用户匹配、聊天、关注等功能。

## 项目功能

### 1. 首页用户展示
- 展示推荐用户信息
- 图片轮播功能
- 用户基本信息展示（昵称、年龄、身高、职业等）
- 底部固定互动按钮（喜欢、不喜欢、打招呼）

### 2. 消息系统
- 聊天消息列表
- 关注用户列表
- 未读消息提示
- 在线状态显示
- 点击用户进入聊天界面

### 3. 聊天功能
- 实时消息发送
- 消息气泡样式
- 头像和在线状态
- 图片发送（预留接口）

### 4. 用户信息
- 用户基本资料
- 个人动态
- 关注/粉丝管理

## 技术栈

- **框架**: Flutter
- **状态管理**: 原生 StatefulWidget
- **网络请求**: Dio
- **数据存储**: SharedPreferences
- **UI组件**:
  - CarouselSlider (图片轮播)
  - TabBar (标签页切换)
  - ListView (列表展示)
  - Stack (图层布局)

## 项目结构

```
lib/
├── api/                  # API服务层
│   ├── httpClient/      # HTTP客户端配置
│   ├── user_service.dart # 用户相关API
│   └── message_service.dart # 消息相关API
├── components/          # 通用组件
│   ├── ChatPage.dart    # 聊天页面组件
│   └── readme/          # 组件文档
├── models/              # 数据模型
│   ├── app_user.dart    # 用户模型
│   └── message.dart     # 消息模型
├── pages/               # 页面组件
│   ├── view/           # 主页面
│   └── Readme/         # 页面文档
├── routes/              # 路由配置
├── storage/             # 存储服务
├── utills/              # 工具类
└── main.dart            # 应用入口
```

## 快速开始

### 1. 安装依赖

```bash
flutter pub get
```

### 2. 运行应用

```bash
flutter run
```

### 3. 构建应用

```bash
flutter build apk
flutter build ios
```

## 核心功能实现

### 用户数据获取

```dart
Future<void> _fetchFollowUsers() async {
  setState(() {
    _isLoading = true;
  });

  try {
    final userService = UserService();
    final result = await userService.getFollow();

    if (!mounted) return;

    if (result.success) {
      setState(() {
        _users = result.data ?? [];
      });
      ToastUtil.showSuccess(context, '获取关注列表成功');
    } else {
      ToastUtil.showError(
        context, 
        result.errorMessage ?? '获取关注列表失败',
        code: result.errorCode
      );
    }
  } catch (e) {
    if (mounted) {
      ToastUtil.showError(context, '获取关注列表异常: ${e.toString()}');
    }
  } finally {
    if (mounted) {
      setState(() {
        _isLoading = false;
      });
    }
  }
}
```

### 聊天页面跳转

```dart
// 构建关注用户列表项
Widget _buildUserItem(AppUser user) {
  return GestureDetector(
    onTap: () {
      // 跳转到聊天页面
      Navigator.push(
        context,
        MaterialPageRoute(
          builder: (context) => ChatPage(user: user),
        ),
      );
    },
    child: Container(
      // 用户信息展示...
    ),
  );
}
```

## 文档说明

- **页面文档**: `lib/pages/Readme/` 目录下包含各页面组件的详细说明
- **组件文档**: `lib/components/readme/` 目录下包含各通用组件的详细说明
- **工具类文档**: `lib/utills/README.md` 包含ToastUtil的使用说明

## 开发注意事项

1. 所有网络请求都通过 `ApiService` 进行，确保统一的错误处理
2. 使用 `ToastUtil` 显示用户操作反馈，保持提示风格一致
3. 页面组件继承自 `StatefulWidget`，使用 `setState` 更新状态
4. 异步操作中使用 `mounted` 检查确保Widget仍然在树中
5. 图片加载失败时提供默认显示

## 后续计划

1. 实现真实的聊天功能
2. 添加用户认证系统
3. 实现动态发布功能
4. 优化UI/UX设计
5. 添加更多社交功能（如点赞、评论等）