138 lines
4.5 KiB
Markdown
138 lines
4.5 KiB
Markdown
# 相宜相亲
|
||
|
||
一站式相亲交友平台，包含微信小程序、后台管理系统、官方网站三端，采用 .NET 8 + Vue 3 + uni-app 技术栈。
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
xiangyixiangqin/
|
||
├── server/ # 后端服务（.NET 8）
|
||
│ ├── src/
|
||
│ │ ├── XiangYi.Core/ # 核心层：实体、枚举、常量、接口
|
||
│ │ ├── XiangYi.Application/ # 应用层：业务服务、DTO、校验、定时任务
|
||
│ │ ├── XiangYi.Infrastructure/ # 基础设施层：数据库、缓存、微信、支付、存储、短信
|
||
│ │ ├── XiangYi.AppApi/ # 小程序端 API + SignalR 聊天
|
||
│ │ └── XiangYi.AdminApi/ # 后台管理端 API
|
||
│ └── tests/ # 单元测试 & 集成测试
|
||
├── admin/ # 后台管理前端（Vue 3 + Element Plus）
|
||
├── miniapp/ # 微信小程序（uni-app）
|
||
├── website/ # 官方网站（静态页面）
|
||
├── deploy/ # 生产部署配置
|
||
├── docs/ # 需求文档、协议文本
|
||
└── scripts/ # 运维脚本
|
||
```
|
||
|
||
## 技术栈
|
||
|
||
### 后端
|
||
|
||
| 类别 | 技术 | 说明 |
|
||
|------|------|------|
|
||
| 运行时 | .NET 8 | LTS 版本 |
|
||
| Web 框架 | ASP.NET Core WebAPI | RESTful API，双 API 独立部署 |
|
||
| ORM | FreeSql | CodeFirst，支持迁移 |
|
||
| 数据库 | SQL Server | 主数据库 |
|
||
| 缓存 | Redis | 验证码、Token、热点数据 |
|
||
| 认证 | JWT | 身份认证 |
|
||
| 实时通信 | SignalR | 聊天消息推送 |
|
||
| 后台任务 | Hangfire | 每日推荐刷新、通知推送等 |
|
||
| 日志 | Serilog | 结构化日志 |
|
||
| 对象映射 | Mapster | 轻量级映射 |
|
||
| 参数校验 | FluentValidation | 请求验证 |
|
||
|
||
### 后台管理前端
|
||
|
||
| 类别 | 技术 |
|
||
|------|------|
|
||
| 框架 | Vue 3 + TypeScript |
|
||
| 构建 | Vite |
|
||
| UI | Element Plus |
|
||
| 状态管理 | Pinia |
|
||
| 图表 | ECharts |
|
||
|
||
### 小程序端
|
||
|
||
| 类别 | 技术 |
|
||
|------|------|
|
||
| 框架 | uni-app (Vue 3) |
|
||
| UI | uView Plus |
|
||
| 状态管理 | Pinia |
|
||
|
||
### 第三方服务
|
||
|
||
| 服务 | 方案 |
|
||
|------|------|
|
||
| 文件存储 | 腾讯云 COS（可切换阿里云 OSS） |
|
||
| 短信 | 阿里云 SMS（可切换腾讯云 SMS） |
|
||
| 实名认证 | 阿里云实人认证（可切换腾讯云） |
|
||
| 支付 | 微信支付 V3 |
|
||
|
||
所有第三方云服务采用接口抽象 + 依赖注入模式，可通过配置切换服务商。
|
||
|
||
## 核心功能
|
||
|
||
- **用户体系** — 微信登录、手机绑定、实名认证、相亲编号
|
||
- **相亲资料** — 资料提交/编辑、照片管理、择偶条件
|
||
- **智能推荐** — 基于择偶条件的每日推荐匹配
|
||
- **即时聊天** — 基于 SignalR 的实时消息、在线状态
|
||
- **会员服务** — 会员等级、联系方式解锁、微信支付
|
||
- **互动功能** — 浏览、收藏、点赞、送花、关注
|
||
- **内容管理** — Banner 轮播、首页弹窗、系统通知
|
||
- **后台管理** — 用户审核、数据统计、系统配置、操作日志
|
||
|
||
## 本地开发
|
||
|
||
### 后端
|
||
|
||
```bash
|
||
cd server
|
||
dotnet restore
|
||
dotnet run --project src/XiangYi.AppApi # 小程序 API，默认 http://localhost:5000
|
||
dotnet run --project src/XiangYi.AdminApi # 管理端 API，默认 http://localhost:5001
|
||
```
|
||
|
||
### 后台管理前端
|
||
|
||
```bash
|
||
cd admin
|
||
npm install
|
||
npm run dev # 默认 http://localhost:5173
|
||
```
|
||
|
||
### 小程序
|
||
|
||
```bash
|
||
cd miniapp
|
||
npm install
|
||
npm run dev:mp-weixin # 生成到 unpackage/dist/dev/mp-weixin
|
||
```
|
||
|
||
用微信开发者工具打开 `unpackage/dist/dev/mp-weixin` 目录进行调试。
|
||
|
||
## 部署
|
||
|
||
项目使用 **Drone CI + Harbor + Docker Compose** 进行自动化部署。
|
||
|
||
推送代码到 `master` 分支后，Drone 自动执行：
|
||
|
||
1. 并行构建 3 个 Docker 镜像（admin-api、app-api、admin-web）
|
||
2. 推送到内网 Harbor 镜像仓库
|
||
3. SSH 到目标服务器执行 `docker compose pull && docker compose up -d`
|
||
|
||
| 服务 | 默认端口 |
|
||
|------|---------|
|
||
| Admin API | 2801 |
|
||
| App API | 2802 |
|
||
| Admin Web | 2803 |
|
||
|
||
详见 [CI-CD部署文档.md](CI-CD部署文档.md)。
|
||
|
||
## 相关文档
|
||
|
||
| 文档 | 说明 |
|
||
|------|------|
|
||
| [技术栈与开发规范](server/技术栈与开发规范.md) | 技术选型、项目结构、API 设计、安全规范 |
|
||
| [数据库设计](server/数据库设计.md) | 表结构、字段说明、索引设计 |
|
||
| [CI-CD部署文档](CI-CD部署文档.md) | Drone CI 流水线、Harbor 镜像管理、部署步骤 |
|
||
| [需求文档](docs/需求文档.md) | 产品需求说明 |
|