# LinkHub

**Repository Path**: zhangkede/link-hub

## Basic Information

- **Project Name**: LinkHub
- **Description**: LinkHub：Link 连接 + Hub 枢纽，寓意社区生活服务枢纽，连接居民与便民服务。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-15
- **Last Updated**: 2026-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LinkHub - 社区便民服务平台

一个基于 Kotlin Multiplatform 的社区便民服务平台，支持用户发布生活服务需求、系统自动生成参考价格、服务提供者接单及审核管理的完整闭环。

## 🏗️ 项目结构

```
LinkHub/
├── app/                  # 多端应用模块
│   ├── iosApp/           # iOS 应用入口
│   ├── androidApp/       # Android 应用入口
│   ├── desktopApp/       # Desktop 应用入口
│   ├── webApp/           # Web 应用入口
│   └── shared/           # 共享 UI 代码 (Compose Multiplatform)
├── core/                 # 核心业务逻辑模块
│   └── src/commonMain/   # 跨平台共享代码
│       ├── kotlin/       # Kotlin 代码
│       └── sqldelight/   # SQLDelight 数据库定义
└── server/               # Ktor 后端服务
    └── src/main/kotlin/  # 服务器代码
```

## ✨ 功能特性

### 📋 需求发布
- 支持多种服务类型选择（家政保洁、家电维修、搬家搬运、管道疏通、上门安装等）
- 完整的表单验证（标题、描述、位置、难度）
- 实时价格估算
- 多图上传支持

### 💰 智能价格估算
- 基于服务类型基础单价计算
- 位置系数调整（0.8-1.5）
- 难度系数调整（1.0-2.0）
- 响应时间 ≤ 200ms

### 🤝 服务提供者管理
- 服务提供者注册与认证
- 资质审核流程
- 接单权限管理

### 📦 订单管理
- 完整订单状态流转（待接单 → 审核中 → 已接单 → 服务中 → 完成）
- 接单申请与审核
- 订单详情查看

### ⭐ 用户评价
- 1-5星评分系统
- 文字评语支持
- 评价记录展示

### 🔍 搜索筛选
- 关键词搜索（标题、描述）
- 服务类型筛选
- 位置筛选
- 价格区间筛选
- 组合条件筛选

### 🔔 消息通知
- 订单状态变更通知
- 需求匹配通知
- 审核结果通知
- 系统通知
- 未读数量徽章

### 👤 用户中心
- 个人信息展示与编辑
- 头像上传
- 发布的需求列表
- 接单记录
- 评价记录

### 📊 数据统计
- 订单概览（总数、完成数、完成率、平均评分）
- 服务类型分布统计
- 订单状态分布
- 时间趋势统计
- 图表可视化（柱状图、饼图、折线图）

### 🖼️ 图片上传
- 需求图片上传
- 用户头像上传
- 服务提供者证件上传
- 图片预览与删除

## 🛠️ 技术栈

| 模块 | 技术 |
|------|------|
| 跨平台框架 | Kotlin Multiplatform |
| UI 框架 | Compose Multiplatform |
| 后端框架 | Ktor |
| 数据库 | SQLite + SQLDelight |
| 序列化 | Kotlinx Serialization |
| 构建工具 | Gradle |

## 🚀 运行方式

### 服务端
```bash
./gradlew :server:run
```
服务启动后访问: http://localhost:8080

### 桌面端
```bash
# 热重载模式
./gradlew :app:desktopApp:hotRun --auto

# 标准运行
./gradlew :app:desktopApp:run
```

### Web 端
```bash
# Wasm 目标（推荐）
./gradlew :app:webApp:wasmJsBrowserDevelopmentRun

# JS 目标
./gradlew :app:webApp:jsBrowserDevelopmentRun
```

### Android
```bash
./gradlew :app:androidApp:assembleDebug
```

### iOS
打开 `app/iosApp` 目录在 Xcode 中运行

## 🧪 测试

```bash
# Android 测试
./gradlew :app:shared:testAndroidHostTest

# Desktop 测试
./gradlew :app:shared:jvmTest

# Server 测试
./gradlew :server:test

# Web 测试
./gradlew :app:shared:wasmJsTest

# iOS 测试
./gradlew :app:shared:iosSimulatorArm64Test
```

## 🔌 API 接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/` | GET | 健康检查 |
| `/service-types` | GET | 获取服务类型列表 |
| `/locations` | GET | 获取位置列表 |
| `/difficulties` | GET | 获取难度等级列表 |
| `/price/estimate` | GET | 价格估算 |
| `/requirements` | GET/POST | 需求管理 |
| `/orders` | GET/POST | 订单管理 |
| `/reviews` | GET/POST | 评价管理 |
| `/providers` | GET/PUT | 服务提供者管理 |
| `/notifications` | GET/PUT | 通知管理 |
| `/images/upload` | POST | 图片上传 |
| `/statistics/overview` | GET | 统计概览 |

## 📄 许可协议

MIT License

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

---

Learn more about [Kotlin Multiplatform](https://www.jetbrains.com/help/kotlin-multiplatform-dev/get-started.html),
[Compose Multiplatform](https://github.com/JetBrains/compose-multiplatform/#compose-multiplatform),
[Kotlin/Wasm](https://kotl.in/wasm/)

We would appreciate your feedback on Compose/Web and Kotlin/Wasm in the public Slack channel [#compose-web](https://slack-chats.kotlinlang.org/c/compose-web).
If you face any issues, please report them on [YouTrack](https://youtrack.jetbrains.com/newIssue?project=CMP).