# mhys-backend

**Repository Path**: zed058/mhys-backend

## Basic Information

- **Project Name**: mhys-backend
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-26
- **Last Updated**: 2025-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 梅花易数后端服务

## 项目简介

这是一个基于Spring Boot的梅花易数后端服务，提供时间起卦和数字起卦两种方式的占卜功能。服务实现了基本的卦象生成、解卦和行动建议功能。

## 技术栈

- Spring Boot 3.2.0
- Java 17
- Maven
- Lombok
- MySQL (可选)
- Redis (可选)

## 功能特性

1. 时间起卦：根据时间戳生成卦象
2. 数字起卦：根据用户输入的两个数字生成卦象
3. 卦象生成：生成本卦和变卦
4. 梅花易数算法：完整的梅花易数算法实现，包括体卦、用卦、互卦、变卦计算
5. 五行分析：分析卦象之间的五行生克关系
6. 解卦引擎：提供卦象直解和AI解读
7. 行动建议：根据卦象提供实用的行动建议

## API接口

### 1. 时间起卦接口

```
POST /api/divination/time
```

**请求参数：**
```json
{
  "timestamp": 1640995200000
}
```

**响应示例：**
```json
{
  "code": 200,
  "message": "success",
  "data": {
    "original": [1, 0, 1, 0, 1, 1],
    "changed": [0, 0, 1, 0, 1, 1],
    "changingLines": [1, 3],
    "originalName": "乾卦",
    "changedName": "姤卦",
    "yaoCi": ["第一爻：爻辞内容示例"],
    "directInterpretation": "《乾卦》之《姤卦》：卦象直解内容示例",
    "aiInterpretation": "AI解读内容示例：结合问题场景的现代语言解读。",
    "suggestions": [
      "行动建议1：根据乾卦卦象给出的具体建议",
      "行动建议2：结合姤卦变卦的指导性建议",
      "行动建议3：实用的可操作建议"
    ]
  }
}
```

### 2. 数字起卦接口

```
POST /api/divination/number
```

**请求参数：**
```json
{
  "number1": 123,
  "number2": 456
}
```

**响应格式与时间起卦接口相同**

## 项目结构

```
src/
├── main/
│   ├── java/com/meihuayishu/backend/
│   │   ├── config/           # 配置类
│   │   ├── controller/       # 控制器
│   │   ├── dto/              # 数据传输对象
│   │   ├── service/          # 服务接口
│   │   │   └── impl/         # 服务实现
│   │   ├── common/           # 通用类
│   │   └── MeihuaYishuBackendApplication.java  # 主应用类
│   └── resources/
│       └── application.yml   # 配置文件
└── test/                     # 测试代码
```

## 如何运行

1. 确保已安装Java 17和Maven
2. 克隆项目到本地
3. 在项目根目录下运行以下命令：

```bash
mvn clean install
mvn spring-boot:run
```

4. 服务将在 `http://localhost:8080` 启动

## 如何测试

### 单元测试

运行单元测试：
```bash
mvn test
```

### API测试

使用curl命令测试时间起卦接口：
```bash
curl -X POST http://localhost:8080/api/divination/time \
  -H "Content-Type: application/json" \
  -d '{"timestamp": 1640995200000}'
```

使用curl命令测试数字起卦接口：
```bash
curl -X POST http://localhost:8080/api/divination/number \
  -H "Content-Type: application/json" \
  -d '{"number1": 123, "number2": 456}'
```

也可以使用Postman等API测试工具进行测试。

## 后续开发计划

1. 集成真实的AI模型（智谱GLM、阿里Qwen等）
2. 完善卦象数据库，包含64卦的详细信息
3. 实现更准确的梅花易数算法
4. 添加用户系统和历史记录功能
5. 集成MySQL和Redis数据库