# poem-system

**Repository Path**: three-circles/poem-system

## Basic Information

- **Project Name**: poem-system
- **Description**: No description available
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-03-03
- **Last Updated**: 2025-06-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 诗词心理疏导系统 (Poem Psychological Counseling System)

## 项目介绍

诗词心理疏导系统是一个集成了诗词数据库、AI心理疏导、心理咨询师在线咨询等功能的综合性心理健康平台。系统采用前后端分离架构，为用户提供多样化的心理健康服务。

### 主要功能模块

#### 普通用户端
- **诗词数据库**: 浏览和欣赏古诗词，通过诗词陶冶情操
- **AI心理疏导**: 基于讯飞星火大模型的智能心理疏导对话
- **心理咨询**: 在线查看心理咨询师信息并发送留言咨询
- **个人中心**: 查看和修改个人信息，管理留言记录
- **情感检测**: 基于文本分析的情感状态检测

#### 心理咨询师端
- **专业首页**: 查看待处理留言和系统通知
- **留言管理**: 接收、回复和管理用户咨询留言
- **AI辅助**: 获取AI心理疏导建议，辅助专业咨询
- **个人信息**: 管理个人资料和专业信息

#### 管理员端
- **系统监控**: 实时监控系统运行状态和性能指标
- **用户管理**: 管理普通用户和心理咨询师账户
- **数据统计**: 查看系统使用情况和数据分析

## 技术架构

### 前端技术栈
- **Vue.js 2.x**: 前端核心框架
- **Element UI**: UI组件库
- **Vue Router**: 前端路由管理
- **Axios**: HTTP请求库
- **Vuex**: 状态管理

### 后端技术栈
- **Spring Boot 2.x**: 后端核心框架
- **Spring Security**: 安全认证框架
- **MyBatis**: 数据持久化框架
- **MySQL**: 关系型数据库
- **JWT**: 身份认证令牌
- **Spring Boot Admin**: 系统监控管理

### 第三方服务
- **讯飞星火大模型**: AI对话和心理疏导
- **Swagger**: API文档生成

## 安装部署

### 环境要求
- **Java**: JDK 1.8+
- **Node.js**: 14.x+
- **MySQL**: 5.7+
- **Maven**: 3.6+

### 数据库配置

1. 创建MySQL数据库
```sql
CREATE DATABASE newpoemsystem CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

2. 修改数据库连接配置
编辑 `server/src/main/resources/application.yml`:
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/newpoemsystem?useSSL=false&serverTimezone=UTC&useUnicode=true&characterEncoding=utf8
    username: your_username
    password: your_password
```

### 后端启动

1. 进入server目录
```bash
cd server
```

2. 安装依赖并启动
```bash
mvn clean install
mvn spring-boot:run
```

后端服务将在 `http://localhost:28080` 启动

### 前端启动

1. 进入web目录
```bash
cd web
```

2. 安装依赖
```bash
npm install
```

3. 启动开发服务器
```bash
npm run serve
```

前端服务将在 `http://localhost:8080` 启动

4. 生产环境构建
```bash
npm run build
```

## 系统访问地址

### 用户端
- **普通用户登录**: http://localhost:8080/login
- **心理咨询师登录**: http://localhost:8080/psycho/login
- **用户注册**: http://localhost:8080/register
- **心理咨询师注册**: http://localhost:8080/psycho/register

### 管理端
- **Spring Boot Admin**: http://localhost:28080/admin
  - 用户名: `admin`
  - 密码: `admin`

### API文档
- **Swagger UI**: http://localhost:28080/swagger-ui.html
- **API Docs**: http://localhost:28080/v3/api-docs

### 系统监控
- **健康检查**: http://localhost:28080/actuator/health
- **系统信息**: http://localhost:28080/actuator/info
- **所有监控端点**: http://localhost:28080/actuator

## 功能特性

### 安全特性
- **密码加密**: 使用MD5加密存储用户密码
- **JWT认证**: 基于令牌的身份验证
- **权限控制**: 不同角色具有不同的访问权限
- **CORS支持**: 跨域资源共享配置

### 用户体验
- **响应式设计**: 适配不同设备和屏幕尺寸
- **实时通信**: 支持实时消息推送和通知
- **友好界面**: 采用统一的设计风格和交互体验

### 系统监控
- **性能监控**: 实时监控系统性能指标
- **日志管理**: 完整的日志记录和管理
- **健康检查**: 自动健康状态检测

## 主要API接口

### 用户管理
- `POST /users/register` - 用户注册
- `POST /users/login` - 用户登录
- `GET /users/me` - 获取当前用户信息
- `PUT /users/{id}` - 更新用户信息

### 心理咨询师管理
- `POST /psychologist/register` - 心理咨询师注册
- `POST /psychologist/login` - 心理咨询师登录
- `GET /psychologist/me` - 获取当前心理咨询师信息
- `GET /psychologist/list` - 获取心理咨询师列表

### 留言系统
- `POST /messages/send` - 发送留言
- `GET /messages/received/{userId}` - 获取接收的留言
- `GET /messages/sent/{userId}` - 获取发送的留言
- `PUT /messages/{id}/status` - 更新留言状态

### AI对话
- `POST /chat/sendQuestion` - 发送AI对话请求
- `GET /sentiments/analyze` - 文本情感分析

## 配置说明

### 讯飞星火大模型配置
编辑 `server/src/main/resources/application.yml` 中的 `xfxh` 配置节：
```yaml
xfxh:
  appId: your_app_id
  apiKey: your_api_key
  apiSecret: your_api_secret
```

### JWT配置
系统使用JWT进行身份认证，令牌会自动在登录时生成并在请求头中传递。

## 开发指南

### 代码结构
```
poem-system/
├── web/                    # 前端Vue.js项目
│   ├── src/
│   │   ├── api/           # API接口封装
│   │   ├── components/    # 公共组件
│   │   ├── views/         # 页面视图
│   │   ├── layout/        # 布局组件
│   │   └── utils/         # 工具函数
├── server/                 # 后端Spring Boot项目
│   ├── src/main/java/
│   │   └── com/example/server/
│   │       ├── controller/  # 控制器层
│   │       ├── service/     # 服务层
│   │       ├── mapper/      # 数据访问层
│   │       ├── entity/      # 实体类
│   │       ├── util/        # 工具类
│   │       └── config/      # 配置类
│   └── src/main/resources/
│       ├── mapper/          # MyBatis映射文件
│       └── application.yml  # 应用配置
```

### 添加新功能
1. 后端: 创建对应的Entity、Mapper、Service、Controller
2. 前端: 创建API接口封装和Vue组件
3. 配置路由和权限控制

## 常见问题

### Q: 启动时出现数据库连接失败
A: 检查MySQL服务是否启动，数据库连接配置是否正确

### Q: 前端无法访问后端API
A: 检查后端服务是否启动，确认端口配置是否正确

### Q: AI对话功能不可用
A: 检查讯飞星火大模型的配置是否正确，API密钥是否有效

### Q: 无法登录管理后台
A: 确认使用正确的用户名密码 (admin/admin)，检查服务是否正常启动

## 更新日志

### 最新版本特性
- ✅ 用户和心理咨询师个人信息管理
- ✅ 留言系统完整实现
- ✅ MD5密码加密
- ✅ JWT身份认证
- ✅ Spring Boot Admin系统监控
- ✅ 响应式UI设计

## 技术支持

如有技术问题，请通过以下方式获取支持：
- 查看API文档: http://localhost:28080/swagger-ui.html
- 查看系统监控: http://localhost:28080/admin
- 检查系统健康状态: http://localhost:28080/actuator/health

## 许可证

本项目采用开源许可证，具体许可信息请查看LICENSE文件。