# My hometown - Huaiyang

**Repository Path**: Sqh-12/my-hometown---huaiyang

## Basic Information

- **Project Name**: My hometown - Huaiyang
- **Description**: 一个专注于淮阳地区文化与技术交流的开源项目，旨在通过编程和创新活动促进社区发展，分享淮阳的风土人情和技术成果。本仓库由sqh拥有并管理，本仓库代码由sqh制作，本项目为个人学习项目，如需使用请获得作者授权允许，并添加项目来源。（作者邮箱2914893651@qq.com）
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-15
- **Last Updated**: 2026-03-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 我的家乡——淮阳 (My Hometown - Huaiyang)

[![Gitee](https://img.shields.io/badge/Gitee-淮阳-orange)](https://gitee.com/Sqh-12/my-hometown---huaiyang)

## 项目简介

这是一个展示河南省周口市淮阳区文化、旅游和特色的综合性Web应用项目。项目采用前后端分离架构，包含一个Vue.js前端展示网站和两个Spring Boot后端服务。

## 项目架构

```
my-hometown---huaiyang/
├── huaiyang/                      # 前端项目 (Vue 3 + TypeScript)
│   ├── src/
│   │   ├── components/            # Vue 组件
│   │   │   ├── HyHome.vue         # 首页
│   │   │   ├── HyHistory.vue      # 历史文化
│   │   │   ├── HyCustoms.vue      # 民俗文化
│   │   │   ├── HySpecialty.vue    # 特色美食
│   │   │   ├── HyTravel.vue       # 旅游景点
│   │   │   ├── HyDeclaration.vue  # 淮阳宣言
│   │   │   ├── Hy-AiAssistant.vue # AI助手
│   │   │   ├── HyBulletChat.vue   # 弹幕组件
│   │   │   └── ...
│   │   ├── assets/                # 静态资源 (图片、视频)
│   │   ├── router/                # 路由配置
│   │   └── main.ts                # 前端入口文件
│   └── src/main/java/             # 内嵌后端服务
│       └── com/example/huaiyang/
│           └── HuaiyangApplication.java
│
└── xf-chat-backend/               # AI聊天后端 (Spring Boot)
    └── src/main/java/com/example/demo/
        ├── controller/
        │   └── ChatController.java    # 聊天控制器
        ├── service/
        │   └── SparkWebSocketService  # 讯飞星火服务
        └── util/
            └── SignatureUtil.java     # 签名工具
```

## 功能特点

### 前端功能 (huaiyang)

- **首页展示** - 淮阳概览与特色介绍
- **历史文化** - 淮阳历史文化背景
- **民俗文化** - 当地民俗风情
- **特色美食** - 淮阳压缩馍、方布袋鸡、荷叶茶等
- **旅游景点** - 太昊陵、龙湖、弦歌台等景点推荐
- **淮阳宣言** - 城市宣言内容展示
- **AI助手** - 基于讯飞星火大模型的智能问答
- **弹幕互动** - 实时弹幕展示功能

### 后端功能 (xf-chat-backend)

- **智能问答** - 基于讯飞星火大模型的AI对话服务
- **RESTful API** - 提供聊天接口 `/api/chat`
- **弹幕数据** - 获取弹幕文本接口 `/api/danmaku-texts`
- **WebSocket支持** - 实时通信能力

## 技术栈

### 前端
- **框架**: Vue 3
- **语言**: TypeScript
- **UI框架**: Element Plus
- **构建工具**: Vite
- **路由**: Vue Router

### 后端
- **框架**: Spring Boot
- **语言**: Java
- **AI服务**: 讯飞星火大模型 (Spark API)

## 环境要求

### 前端
- Node.js 16+
- npm 或 yarn

### 后端
- Java 17+
- Maven 3.8+

## 快速开始

### 1. 克隆项目

```bash
git clone https://gitee.com/Sqh-12/my-hometown---huaiyang.git
cd my-hometown---huaiyang
```

### 2. 启动前端

```bash
cd huaiyang
npm install
npm run dev
```

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

### 3. 启动AI聊天后端

```bash
cd xf-chat-backend
mvn clean install
mvn spring-boot:run
```

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

## 配置说明

### 后端配置 (xf-chat-backend/src/main/resources/application.yaml)

需要在配置文件中添加讯飞API配置：

```yaml
xf:
  app:
    id: your_app_id
  api:
    key: your_api_key
    secret: your_api_secret
    url: wss://spark-api.xf-yun.com/v3.5/chat
    domain: generalv3.5
  system:
    prompt: your_system_prompt
```

## 项目预览

项目中包含丰富的静态资源：

- **图片资源**: 涵盖淮阳主要景点如太昊陵、龙湖、弦歌台、平粮台等
- **视频资源**: 包含景区介绍、文化宣传等视频内容
- **特色展示**: 压缩馍、方布袋鸡、方布袋烧鸡、荷叶茶、槐山羊等当地特色

## 主要景点

| 景点名称 | 介绍 |
|---------|------|
| 太昊陵 | 中华人文始祖伏羲陵庙 |
| 龙湖 | 国家湿地公园 |
| 弦歌台 | 孔子陈蔡绝粮处 |
| 平粮台 | 古代城址 |
| 淮阳古城 | 历史文化名城 |

## 特色美食

- 压缩馍
- 方布袋鸡
- 方布袋烧鸡
- 荷叶茶
- 槐山羊

## 许可证

本项目仅供学习交流使用。

## 贡献指南

欢迎提交 Issue 和 Pull Request！

---

*让更多人了解淮阳，爱上淮阳！* 🇨🇳