# FateSeek

**Repository Path**: zhangkede/fate-seek

## Basic Information

- **Project Name**: FateSeek
- **Description**: 锦觅：社交 婚恋 SaaS
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-05
- **Last Updated**: 2026-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FateSeek - 婚恋交友 SaaS 平台

> 基于 Kotlin Multiplatform 和 Compose Multiplatform 构建的现代化婚恋交友平台

## 📋 项目概述

FateSeek 是一个功能完整的婚恋交友 SaaS 平台，提供用户注册、智能匹配、实时聊天、虚拟礼物、直播互动等核心功能。

### ✨ 核心特性

| 模块 | 功能 |
|------|------|
| **用户系统** | 注册、登录、资料完善、实名认证 |
| **智能匹配** | 多维度匹配算法、推荐系统、附近的人 |
| **实时聊天** | 文字、图片、语音、视频通话 |
| **虚拟礼物** | 礼物商城、特效展示、排行榜 |
| **直播互动** | 实时直播、弹幕互动、礼物打赏 |
| **短视频** | 视频上传、点赞评论、推荐流 |
| **AI助手** | 智能问答、情感分析、恋爱建议 |
| **会员体系** | VIP订阅、特权服务、成长任务 |

---

## 🛠️ 技术栈

### 后端技术

| 分类 | 技术 | 版本 |
|------|------|------|
| 语言 | Kotlin | 1.9.x |
| 框架 | Ktor | 2.3.x |
| 数据库 | PostgreSQL | 15.x |
| 缓存 | Redis | 7.x |
| ORM | SQLDelight | 2.0.x |
| 认证 | JWT | - |
| 依赖注入 | Koin | 3.4.x |

### 前端技术

| 分类 | 技术 | 版本 |
|------|------|------|
| 框架 | Compose Multiplatform | 1.5.x |
| UI组件 | Material3 | - |
| 路由 | Navigation Compose | 2.7.x |
| 状态管理 | ViewModel | - |

### 第三方服务

| 服务 | 用途 |
|------|------|
| 阿里云短信 | 验证码发送 |
| 支付宝 | 支付服务 |
| 极光推送 | 消息推送 |
| 百度AI | 人脸识别 |
| OpenAI | AI助手 |

---

## 📁 项目结构

```
FateSeek/
├── app/                      # 客户端应用
│   ├── android/              # Android 平台
│   ├── ios/                  # iOS 平台
│   ├── desktop/              # 桌面平台
│   └── shared/               # 共享代码
│       ├── commonMain/       # 通用代码
│       ├── androidMain/      # Android 专用
│       └── iosMain/          # iOS 专用
├── server/                   # 后端服务
│   ├── src/main/kotlin/
│   │   ├── service/          # 业务服务层
│   │   ├── repository/       # 数据访问层
│   │   ├── routes/           # API路由
│   │   ├── model/            # 数据模型
│   │   ├── security/         # 安全模块
│   │   ├── performance/      # 性能优化
│   │   └── observability/    # 可观测性
│   └── resources/            # 配置文件
├── core/                     # 核心模块
│   └── src/commonMain/       # 通用数据模型
└── buildSrc/                 # 构建配置
```

---

## 🚀 快速开始

### 环境要求

- JDK 21+
- Gradle 8.5+
- PostgreSQL 15+
- Redis 7+

### 启动步骤

1. **克隆项目**
```bash
git clone https://gitee.com/zhangkede/fate-seek.git
cd fate-seek
```

2. **配置数据库**
```bash
# 创建数据库
createdb fateseek

# 创建用户
createuser fateseek -P
```

3. **配置环境变量**
```bash
# 复制配置文件
cp server/src/main/resources/application.yml.example server/src/main/resources/application.yml

# 修改配置文件中的数据库连接信息
```

4. **启动后端服务**
```bash
cd server
./gradlew run
```

5. **启动前端应用**
```bash
# Android
cd app/android
./gradlew installDebug

# iOS
cd app/ios
pod install
open FateSeek.xcworkspace

# Desktop
cd app/desktop
./gradlew run
```

---

## 🔌 API 接口

### 认证接口

| 接口 | 方法 | 描述 |
|------|------|------|
| `/api/v1/auth/register` | POST | 用户注册 |
| `/api/v1/auth/login` | POST | 用户登录 |
| `/api/v1/auth/logout` | POST | 用户退出 |
| `/api/v1/auth/refresh` | POST | 刷新Token |

### 用户接口

| 接口 | 方法 | 描述 |
|------|------|------|
| `/api/v1/user/profile` | GET | 获取用户资料 |
| `/api/v1/user/profile` | PUT | 更新用户资料 |
| `/api/v1/user/photos` | POST | 上传照片 |
| `/api/v1/user/preferences` | PUT | 更新偏好设置 |

### 匹配接口

| 接口 | 方法 | 描述 |
|------|------|------|
| `/api/v1/match/recommend` | GET | 获取推荐列表 |
| `/api/v1/match/like` | POST | 喜欢用户 |
| `/api/v1/match/pass` | POST | 跳过用户 |
| `/api/v1/match/matches` | GET | 获取匹配列表 |

### 消息接口

| 接口 | 方法 | 描述 |
|------|------|------|
| `/api/v1/message/conversations` | GET | 获取会话列表 |
| `/api/v1/message/conversation/{id}` | GET | 获取会话消息 |
| `/api/v1/message/send` | POST | 发送消息 |

---

## 🧪 测试

### 运行单元测试

```bash
cd server
./gradlew test
```

### 运行集成测试

```bash
cd server
./gradlew integrationTest
```

### 测试覆盖

| 模块 | 测试数 |
|------|--------|
| 性能组件 | 8个 |
| 安全工具 | 9个 |
| API响应 | 4个 |
| 集成服务 | 7个 |
| 可观测性 | 6个 |

---

## 📊 性能优化

### 性能组件

- **Profiler**: 方法级性能计时（纳秒级精度）
- **CircuitBreaker**: 熔断器模式，防止服务雪崩
- **RateLimiter**: 滑动窗口限流，保护API

### 缓存策略

- 用户资料缓存（TTL 1小时）
- 推荐列表缓存（TTL 30分钟）
- 会话消息缓存（TTL 5分钟）

---

## 🔐 安全机制

- JWT Token 认证
- 密码哈希存储（BCrypt）
- XSS 攻击防护
- SQL 注入防护
- CSRF 攻击防护
- 数据脱敏处理

---

## 🌐 国际化

支持多语言：
- 中文简体
- 中文繁体
- 英文
- 日文

---

## 📝 版本历史

| 版本 | 日期 | 描述 |
|------|------|------|
| V1 | 2026-01 | 基础功能 |
| V2 | 2026-02 | 扩展功能 |
| V3 | 2026-03 | 进阶功能 |
| V4 | 2026-04 | 功能增强 |
| V5 | 2026-05 | 高级功能 |
| V6 | 2026-06 | 多端封装 |
| V7 | 2026-06 | 服务器端封装 |
| V8 | 2026-06 | AI生态完善 |

---

## 📄 License

MIT License

---

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

---

## 📞 联系方式

如有问题，请联系：
- 邮箱：dev@fateseek.com
- 地址：北京市朝阳区科技园区

---

*Made with ❤️ by FateSeek Team*