# 疗愈肇庆

**Repository Path**: AchieveMiniMax/healing-zhaoqing

## Basic Information

- **Project Name**: 疗愈肇庆
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-17
- **Last Updated**: 2026-04-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 疗愈生活平台

> 身心放松 · 心灵疗愈

[![React](https://img.shields.io/badge/React-19.2.4-61DAFB?logo=react)](https://react.dev/)
[![TypeScript](https://img.shields.io/badge/TypeScript-6.0.2-3178C6?logo=typescript)](https://www.typescriptlang.org/)
[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.1.5-6DB33F?logo=spring-boot)](https://spring.io/projects/spring-boot)
[![Java](https://img.shields.io/badge/Java-17-007396?logo=java)](https://www.oracle.com/java/)

## 项目简介

疗愈生活平台是一款专注于身心健康、自然疗愈的养生类Web应用。平台整合了疗愈音乐、养生食谱、疗愈景点等自然疗愈内容，并集成AI智能助手，为用户提供个性化健康建议和咨询服务，帮助用户缓解压力、改善身心健康。

## 功能特性

### 核心功能

- 🏠 **首页模块** - 轮播图展示、精选推荐、疗愈景点介绍
- 🎵 **音乐模块** - 疗愈音乐播放器、分类浏览（推荐/音乐/播客/冥想/助眠）
- 🤖 **AI助手** - 基于MiniMax的智能对话，提供健康咨询和养生建议
- 👤 **我的模块** - 个人中心、健康档案、疗愈食谱、收藏管理
- 🔍 **搜索模块** - 全局搜索音乐、食谱、景点内容

### 技术亮点

- 简易登录机制，无需手机号/微信授权
- JWT Token认证，支持Token自动刷新
- AI智能推荐，根据对话内容推荐相关疗愈内容
- 响应式设计，适配PC/平板/手机多端访问

## 项目结构

```
.
├── 01_Frontend/              # 前端项目 (React + TypeScript + Vite)
│   ├── src/
│   │   ├── components/       # 公共组件
│   │   ├── pages/            # 页面组件
│   │   │   ├── Home.tsx      # 首页
│   │   │   ├── Music.tsx     # 音乐页
│   │   │   ├── Mine.tsx      # 我的页
│   │   │   └── Search.tsx    # 搜索页
│   │   ├── App.tsx           # 根组件
│   │   └── main.tsx          # 应用入口
│   ├── package.json
│   └── vite.config.ts
│
├── 02_Backend/               # 后端项目 (Spring Boot)
│   └── healing-app/
│       ├── src/main/java/com/healing/
│       │   ├── ai/           # AI助手模块 (MiniMax对接)
│       │   ├── auth/         # 认证授权模块
│       │   ├── user/         # 用户管理模块
│       │   └── common/       # 公共组件
│       ├── src/main/resources/
│       │   └── application.yml
│       └── pom.xml
│
├── 03_old_wx/                # 旧版微信小程序代码
│   └── WX_BM_FB/
│
├── PRD.md                    # 产品需求文档
├── API_DOCUMENT.md           # API接口文档
├── TECHNICAL_DESIGN.md       # 技术方案设计文档
└── PROJECT_STRUCTURE.md      # 项目目录结构说明
```

## 技术栈

### 前端

| 技术 | 版本 | 用途 |
|------|------|------|
| React | 19.2.4 | UI框架 |
| TypeScript | 6.0.2 | 类型系统 |
| Vite | 8.0.4 | 构建工具 |
| React Router | 7.14.0 | 路由管理 |
| Lucide React | 1.8.0 | 图标库 |

### 后端

| 技术 | 版本 | 用途 |
|------|------|------|
| Java | 17 LTS | 开发语言 |
| Spring Boot | 3.1.5 | 基础框架 |
| Spring Security | 6.x | 安全框架 |
| MyBatis-Plus | 3.5.5 | ORM框架 |
| MySQL | 8.0 | 关系型数据库 |
| Redis | 7.x | 缓存 |
| Elasticsearch | 8.7.1 | 搜索引擎 |
| JWT | 4.4.0 | Token认证 |
| MiniMax API | - | AI对话服务 |

## 快速开始

### 环境要求

- Node.js >= 18.0.0
- Java 17
- MySQL 8.0
- Redis 7.x

### 前端启动

```bash
cd 01_Frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建生产版本
npm run build
```

### 后端启动

```bash
cd 02_Backend/healing-app

# 编译项目
mvn clean compile

# 运行应用
mvn spring-boot:run

# 打包
mvn clean package
```

### 数据库初始化

```bash
# 执行SQL脚本
cd 02_Backend/healing-common/src/main/resources/sql
mysql -u root -p healing_db < ai_module.sql
```

## API 接口

### 认证相关

| 接口 | 方法 | 路径 | 说明 |
|------|------|------|------|
| 简易登录 | POST | `/api/v1/auth/simple-login` | 昵称登录 |
| 刷新Token | POST | `/api/v1/auth/refresh` | 刷新access token |
| 退出登录 | POST | `/api/v1/auth/logout` | 清除登录状态 |

### 用户相关

| 接口 | 方法 | 路径 | 说明 |
|------|------|------|------|
| 获取用户信息 | GET | `/api/v1/users/profile` | 获取当前用户信息 |
| 更新用户信息 | PUT | `/api/v1/users/profile` | 更新用户信息 |
| 获取健康档案 | GET | `/api/v1/users/health-profile` | 获取用户健康档案 |

### AI相关

| 接口 | 方法 | 路径 | 说明 |
|------|------|------|------|
| 发送消息 | POST | `/api/v1/ai/chat` | 发送消息获取AI回复 |
| 获取会话列表 | GET | `/api/v1/ai/sessions` | 获取对话会话列表 |
| 获取历史 | GET | `/api/v1/ai/history` | 获取对话历史 |

更多接口详见 [API_DOCUMENT.md](./API_DOCUMENT.md)

## 文档索引

| 文档 | 说明 |
|------|------|
| [PRD.md](./PRD.md) | 产品需求文档，包含功能设计、用户故事 |
| [API_DOCUMENT.md](./API_DOCUMENT.md) | API接口详细文档 |
| [TECHNICAL_DESIGN.md](./TECHNICAL_DESIGN.md) | 技术方案设计，架构选型 |
| [PROJECT_STRUCTURE.md](./PROJECT_STRUCTURE.md) | 项目目录结构说明 |
| [BACKEND_STRUCTURE.md](./BACKEND_STRUCTURE.md) | 后端架构详细说明 |

## 开发规范

### Git 分支策略

```
master (生产分支)
    ↑
release/v1.0.0 (发布分支)
    ↑
develop (开发分支)
    ↑
feature/xxx (功能分支)
```

### 提交信息规范

格式：`<type>(<scope>): <subject>`

| Type | 说明 |
|------|------|
| `feat` | 新功能 |
| `fix` | 修复bug |
| `docs` | 文档更新 |
| `refactor` | 重构 |
| `test` | 测试相关 |

## 项目里程碑

| 阶段 | 时间 | 交付内容 |
|------|------|----------|
| 第一阶段 | 第1-2周 | 基础架构、数据库设计、用户系统 |
| 第二阶段 | 第2-3周 | 用户认证模块（简易登录、JWT） |
| 第三阶段 | 第3-4周 | 首页模块（轮播图、推荐、景点） |
| 第四阶段 | 第4-6周 | 音乐模块（播放器、歌单、分类） |
| 第五阶段 | 第6-7周 | AI助手模块（MiniMax对接、对话） |
| 第六阶段 | 第7-8周 | 食谱与收藏模块、我的模块 |
| 第七阶段 | 第8-9周 | 搜索模块、性能优化 |
| 第八阶段 | 第9-10周 | 测试与上线部署 |

## 目标用户

| 用户群体 | 特征描述 | 核心需求 |
|----------|----------|----------|
| 都市白领 | 25-40岁，工作压力大 | 减压放松、助眠、冥想引导 |
| 亚健康人群 | 30-55岁，身体亚健康 | 养生知识、健康食谱 |
| 养生爱好者 | 35-60岁，关注中医养生 | 专业养生内容、食疗方案 |
| 旅游爱好者 | 25-50岁，喜欢自然风光 | 疗愈景点推荐、旅行攻略 |

## 许可证

本项目仅供学习和参考使用。

## 联系方式

如有问题或建议，欢迎通过以下方式联系：

| 方式 | 联系方式 |
|------|----------|
| QQ邮箱 | 2105268075@qq.com |
| Gmail | achieve.minimax@gmail.com |

也欢迎提交 Issue 或 Pull Request。

---

**疗愈生活平台** - 让身心回归自然的怀抱 🌿