# mood_harbor

**Repository Path**: mrbytes/mood_harbor

## Basic Information

- **Project Name**: mood_harbor
- **Description**: 心境港湾 🌿 一站式心灵成长平台

- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-08
- **Last Updated**: 2025-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 心灵港湾 (Mood Harbor) - 心理健康与性格测试平台

## 项目简介

心灵港湾是一个专注于心理健康和性格分析的综合性平台，包含移动端MBTI性格测试应用和后台管理系统。项目基于若依(RuoYi)快速开发框架构建，采用前后端分离架构，提供用户管理、订单管理、性格测试等核心功能。

## 技术架构

### 后端技术栈
- **核心框架**: Spring Boot 2.5.15 + MyBatis
- **安全框架**: Spring Security + JWT
- **数据库**: MySQL 8.0
- **连接池**: Druid 1.2.23
- **API文档**: Swagger3
- **工具类**: FastJSON2, Apache Commons, PageHelper
- **缓存**: Redis
- **定时任务**: Quartz
- **构建工具**: Maven

### 前端技术栈
- **管理后台**: Vue 2.6.12 + Element UI
- **移动端**: UniApp (支持微信小程序、H5、App)
- **构建工具**: Webpack + Vue CLI
- **HTTP客户端**: Axios
- **图表库**: ECharts

### 移动端技术栈
- **框架**: UniApp (Vue3)
- **UI组件**: 内置组件库
- **部署**: 支持微信小程序、H5、原生App

## 项目结构

```
mood_harbor/
├── server/                    # 后端服务
│   └── RuoYi-Vue/            # 基于若依框架的后端项目
│       ├── mh-apiserver/     # API服务模块
│       ├── mh-members/       # 会员模块
│       ├── ruoyi-admin/      # 管理后台启动模块
│       ├── ruoyi-common/     # 公共模块
│       ├── ruoyi-framework/  # 核心框架
│       ├── ruoyi-system/     # 系统模块
│       ├── ruoyi-ui/         # 管理后台前端
│       └── sql/              # 数据库脚本
├── uniapp/                   # 移动端应用
│   └── mood_harbor_uniapp/   # UniApp项目
└── admin_vue/                # 管理后台前端(可能的独立部署)
```

## 核心功能模块

### 1. 移动端MBTI性格测试
- **手机号验证登录**: 支持微信一键获取手机号和手动输入
- **MBTI测试**: 8道经典题目，涵盖EI、SN、TF、JP四个维度
- **结果分析**: 提供性格类型、特点分析、职业建议、人际关系指导
- **付费解锁**: 部分高级内容需付费解锁
- **分享功能**: 支持测试结果分享

### 2. 用户管理系统
- **用户注册/登录**: 手机号+密码方式
- **用户信息管理**: 昵称、头像、性别、生日等个人信息
- **第三方登录**: 微信、QQ等第三方登录支持
- **账户状态管理**: 启用/禁用用户账户

### 3. 订单管理系统
- **订单创建**: 支持创建测试报告解锁订单
- **订单查询**: 按状态、时间等条件查询订单
- **订单状态管理**: 待支付、已支付、已完成、已取消等状态
- **支付集成**: 支持微信支付、支付宝等主流支付方式

### 4. 后台管理系统
- **仪表板**: 数据统计和可视化展示
- **会员管理**: 用户信息查看、编辑、删除
- **订单管理**: 订单状态跟踪和管理
- **系统配置**: 参数配置、字典管理等
- **权限管理**: 角色、菜单、部门权限控制

## 数据库设计

### 核心数据表
1. **mh_user** (会员信息表)
   - 用户基本信息：账号、密码、昵称、手机号等
   - 第三方登录信息：openid、来源方式
   - 账户状态和余额管理

2. **mh_order** (订单信息表)
   - 订单基本信息：订单编号、商品名称、价格
   - 用户关联信息：用户ID
   - 订单状态管理：支付时间、订单状态

## API接口设计

### 用户相关接口
- `POST /api/user/login` - 用户登录
- `POST /api/user/register` - 用户注册
- `GET /api/user/info` - 获取用户信息

### 订单相关接口
- `GET /api/order/list` - 查询订单列表
- `GET /api/order/{id}` - 获取订单详情
- `POST /api/order` - 创建订单
- `PUT /api/order` - 修改订单
- `DELETE /api/order/{ids}` - 删除订单

## 部署说明

### 后端服务部署
1. 确保安装Java 8+和Maven
2. 创建MySQL数据库并执行sql目录下的初始化脚本
3. 修改[application.yml](file:///D:/project/mood_harbor/server/RuoYi-Vue/mh-apiserver/src/main/resources/application.yml)配置文件中的数据库连接信息
4. 在项目根目录执行 `mvn clean install`
5. 运行 `java -jar mh-apiserver/target/mh-apiserver.jar`

### 管理后台部署
1. 进入[ruoyi-ui](file:///D:/project/mood_harbor/server/RuoYi-Vue/ruoyi-ui)目录
2. 安装依赖：`npm install`
3. 构建项目：`npm run build:prod`
4. 部署dist目录到Nginx或其它Web服务器

### 移动端部署
1. 进入[mood_harbor_uniapp](file:///D:/project/mood_harbor/uniapp/mood_harbor_uniapp)目录
2. 安装依赖：`npm install`
3. 编译到对应平台：
   - 微信小程序：`npm run dev:mp-weixin`
   - H5：`npm run dev:h5`
   - App：`npm run dev:app`

## 项目特点

1. **模块化设计**: 采用微服务思想，将功能拆分为独立模块
2. **前后端分离**: 前后端完全分离，便于独立开发和部署
3. **权限控制**: 完善的RBAC权限管理系统
4. **响应式设计**: 管理后台支持多种设备访问
5. **代码生成**: 集成若依代码生成器，快速开发新功能
6. **文档完善**: 集成Swagger API文档，便于接口调试

## 开发规范

### 后端开发规范
1. 遵循RESTful API设计规范
2. 使用统一的响应格式[AjaxResult](file:///D:/project/mood_harbor/server/RuoYi-Vue/ruoyi-common/src/main/java/com/ruoyi/common/core/domain/AjaxResult.java)
3. 实体类继承[BaseEntity](file:///D:/project/mood_harbor/server/RuoYi-Vue/ruoyi-common/src/main/java/com/ruoyi/common/core/domain/BaseEntity.java)，包含创建时间和更新时间
4. 使用PageHelper进行分页处理

### 前端开发规范
1. 使用Element UI组件库
2. 遵循Vue组件化开发模式
3. 使用axios进行HTTP请求
4. 统一使用[request.js](file:///D:/project/mood_harbor/server/RuoYi-Vue/ruoyi-ui/src/utils/request.js)封装的请求拦截器

## 未来规划

1. **功能扩展**:
   - 增加更多心理测试类型
   - 集成AI心理咨询服务
   - 社区功能，用户可以分享心得

2. **技术优化**:
   - 升级到Spring Boot 3.x
   - 前端升级到Vue 3 + Element Plus
   - 引入消息队列处理异步任务

3. **用户体验优化**:
   - 个性化推荐系统
   - 更丰富的测试结果可视化
   - 多语言支持

## 贡献指南

1. Fork项目到自己的仓库
2. 创建功能分支进行开发
3. 提交代码前确保通过所有测试
4. 发起Pull Request到主仓库

## 许可证

本项目基于MIT许可证开源，详细信息请查看[LICENSE](file:///D:/project/mood_harbor/server/RuoYi-Vue/LICENSE)文件。