# client

**Repository Path**: yu-yantao/client

## Basic Information

- **Project Name**: client
- **Description**: 基于Kotlin实现正念冥想App（安卓端）
- **Primary Language**: Kotlin
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2024-02-18
- **Last Updated**: 2026-02-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Android, Jetpack-Compose, Kotlin, Kotlin-DSL, Material3

## README



该项目目前没有现成的 README.md 文件或相关说明文档。请根据项目结构和代码内容，参考以下通用模板，手动创建 README.md 文件：

---

# 项目名称

## 项目简介
这是一个基于 Android 平台的 Kotlin 项目，采用 Jetpack Compose 和 Hilt 构建，具有用户登录注册、好友管理、动态发布、正念练习、情绪日志与回避痛苦记录等多种功能模块。项目使用 Room 数据库进行本地数据管理，通过 Retrofit 与服务器 API 通信，并支持 WebSocket 实时聊天功能。

## 主要功能
- **用户系统**：登录、注册、用户信息管理与头像上传。
- **好友管理**：搜索好友、发送/处理好友请求、更新昵称。
- **动态发布与浏览**：支持发布带图片的动态内容，查看动态详情与点赞。
- **正念练习模块**：包括推荐正念内容、加入正念小组、评分与日志记录。
- **情绪日志与痛苦回避记录**：记录用户情绪与痛苦等级，支持数据展示与删除。

## 技术栈
- Kotlin
- Android Jetpack Compose
- Hilt 依赖注入
- Retrofit + OkHttp 网络请求
- Room 数据库
- WebSocket 实时通信
- Moshi 数据解析
- Navigation Compose 页面导航

## 项目结构
- `MainActivity.kt`：主界面，负责 UI 的组合和导航。
- `ViewModel`：各个页面的 ViewModel，如 `SignInViewModel`, `DynamicViewModel`, `FriendViewModel` 
- `Repository`：网络请求封装类，如 `SignInRepository`, `DynamicRepository`。
- `data/remoteData/bean`：数据模型类定义，包含 API 的响应与请求数据。
- `di`：Hilt 的依赖注入模块。
- `ui/view`：UI 页面实现，如登录页、注册页、动态页、好友页等。
- `ui/components`：可复用的 UI 组件。
- `utils`：工具类，如 Uri 转 File 工具。

## 如何运行
1. 确保你已安装 [Android Studio](https://developer.android.com/studio)。
2. 打开项目并同步 Gradle。
3. 连接真机或启动模拟器。
4. 点击运行按钮 (Run) 或使用命令 `./gradlew installDebug` 运行项目。

## 贡献者
欢迎社区贡献！请查看具体模块的实现并提交 PR。

## 许可证
本项目采用 MIT 许可证。详情请查看 [LICENSE](LICENSE) 文件。