技术栈快速参考

🎯 一、项目结构

XINxiangqin/
├── gateway/              # API网关 (Spring Cloud Gateway)
├── common/               # 公共模块
├── service/              # 业务服务
│   ├── login/           # 登录服务
│   ├── homePage/        # 首页服务 (8081)
│   ├── dynamic/         # 动态服务 (8086)
│   ├── websocket/       # 聊天服务 (1004)
│   ├── randomMatch/     # 匹配服务 (1003)
│   ├── Essential/       # 基础服务 (1005)
│   ├── Recommend/       # 推荐服务
│   └── admin/           # 管理端服务 (8088)
├── LiangZhiYUMao/        # 小程序前端 (uni-app)
└── marriageAdmin-vue/    # 管理后台 (Vue3)

🔧 二、技术栈清单

后端技术栈

技术	版本	用途
Java	8	开发语言
Spring Boot	2.7.15	核心框架
Spring Cloud	2021.0.8	微服务框架
Spring Cloud Alibaba	2021.0.5.0	阿里云组件
MyBatis-Plus	3.5.3	ORM框架
MySQL	8.0.33	数据库
Redis	-	缓存/Token存储
MinIO	7.1.0	对象存储
Lombok	1.18.30	代码简化
Maven	-	构建工具

前端技术栈

小程序端

技术	版本	用途
uni-app	-	跨平台框架
Vue	2	前端框架
Axios	1.12.2	HTTP客户端
tim-wx-sdk	2.27.6	腾讯云IM

管理后台

技术	版本	用途
Vue	3.5.22	前端框架
Element Plus	2.11.5	UI组件库
Pinia	3.0.3	状态管理
Vue Router	4.5.1	路由管理
Vite	7.1.7	构建工具
ECharts	6.0.0	图表库
Axios	1.12.2	HTTP客户端

🌐 三、服务端口映射

服务名称	端口	路由前缀	说明
Gateway	8083	-	API网关（统一入口）
HomePage	8081	`/api/**`	首页、公告服务
Dynamic	8086	`/api/dynamic/**`	动态、系统消息
WebSocket	1004	`/ws/chat/`, `/api/chat/`	聊天服务
RandomMatch	1003	`/match/**`	匹配服务
Essential	1005	`/api/user/**`	用户基础服务
Admin	8088	`/admin/`, `/api/admin/`	管理端服务

📁 四、关键目录结构

后端关键目录

service/{module}/src/main/java/com/zhentao/
├── controller/          # 控制器层
├── service/             # 服务层
├── mapper/              # 数据访问层
├── pojo/                # 实体类
└── config/              # 配置类

service/{module}/src/main/resources/
├── application.yml      # 服务配置
└── sql/                 # SQL脚本

小程序关键目录

LiangZhiYUMao/
├── pages/               # 页面文件
├── components/          # 组件
├── utils/               # 工具函数
│   ├── api.js          # API封装
│   ├── chat-api.js     # 聊天API
│   └── userAuth.js     # 用户认证
├── config/              # 配置文件
│   ├── api-config.js   # API配置
│   └── match-config.js  # 匹配配置
└── static/              # 静态资源

管理后台关键目录

marriageAdmin-vue/src/
├── views/               # 页面组件
├── components/         # 通用组件
├── router/              # 路由配置
├── stores/              # 状态管理
├── utils/               # 工具函数
└── config/              # 配置文件
    └── api.js          # API配置

🔑 五、核心配置文件

1. 网关配置

文件: gateway/src/main/resources/application.yml

路由规则
CORS配置
WebSocket支持

2. 小程序API配置

文件: LiangZhiYUMao/config/api-config.js

天行数据API配置
极速数据API配置
第三方API Key

3. 管理后台API配置

文件: marriageAdmin-vue/src/config/api.js

API基础地址
接口端点定义

4. 小程序路由配置

文件: LiangZhiYUMao/pages.json

页面路由
导航栏配置

5. 管理后台路由配置

文件: marriageAdmin-vue/src/router/index.js

路由定义
路由守卫

🗄️ 六、核心数据表

用户相关

users - 用户主表
user_profile - 用户扩展信息
vip - VIP会员
blacklist - 黑名单

社交相关

user_dynamics - 用户动态
dynamic_comments - 动态评论
dynamic_likes - 动态点赞
dynamic_reports - 动态举报

聊天相关

chat_messages - 聊天消息
chat_sessions - 聊天会话

业务相关

activities - 活动
matchmakers - 红娘
courses - 课程
success_cases - 成功案例
announcements - 公告
banners - 轮播图

🔐 七、安全机制

安全措施	实现方式
手机号加密	AES-256加密
密码加密	bcrypt哈希
Token认证	JWT + Redis
CORS	网关统一处理
跨域	网关配置

📡 八、API接口分类

用户相关

/api/user/** - 用户信息、资料管理

动态相关

/api/dynamic/** - 动态CRUD
/api/message/** - 系统消息

匹配相关

/match/** - 匹配算法

聊天相关

/api/chat/** - 聊天REST API
/ws/chat/** - WebSocket实时聊天

管理相关

/admin/** - 管理端页面
/api/admin/** - 管理端API

🚀 九、启动顺序建议

基础服务
- MySQL数据库
- Redis缓存
- MinIO对象存储
后端服务（按依赖顺序）
- common模块（公共模块）
- Essential服务（基础服务）
- HomePage服务
- Dynamic服务
- WebSocket服务
- RandomMatch服务
- Recommend服务
- Admin服务
- Gateway网关（最后启动）
前端服务
- 管理后台：npm run dev (端口: 5173)
- 小程序：使用HBuilderX或微信开发者工具

🔍 十、常见问题排查

问题	检查项
跨域问题	网关CORS配置
路由404	网关路由配置顺序
Token失效	Redis连接、Token过期时间
API调用失败	服务端口、网关路由
文件上传失败	MinIO配置、权限

📚 十一、第三方服务

服务	用途	配置位置
天行数据API	星座、生肖、八字	`LiangZhiYUMao/config/api-config.js`
极速数据API	八字排盘	`LiangZhiYUMao/config/api-config.js`
腾讯云IM	实时聊天	`LiangZhiYUMao/utils/tim-manager.js`

🎯 十二、开发工具推荐

后端: IntelliJ IDEA
前端: VS Code / HBuilderX
数据库: Navicat / DBeaver
API测试: Postman
版本控制: Git

最后更新: 2025-01-27

技术栈快速参考.md 6.7 KB Historie Surový

技术栈快速参考

🎯 一、项目结构

🔧 二、技术栈清单

后端技术栈

前端技术栈

小程序端

管理后台

🌐 三、服务端口映射

📁 四、关键目录结构

后端关键目录

小程序关键目录

管理后台关键目录

🔑 五、核心配置文件

1. 网关配置

2. 小程序API配置

3. 管理后台API配置

4. 小程序路由配置

5. 管理后台路由配置

🗄️ 六、核心数据表

用户相关

社交相关

聊天相关

业务相关

🔐 七、安全机制

📡 八、API接口分类

用户相关

动态相关

匹配相关

聊天相关

管理相关

🚀 九、启动顺序建议

🔍 十、常见问题排查

📚 十一、第三方服务

🎯 十二、开发工具推荐

技术栈快速参考.md 6.7 KB

Historie Surový