# test

**Repository Path**: sunset-and-rain-moon/test

## Basic Information

- **Project Name**: test
- **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-12-30
- **Last Updated**: 2025-12-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 三峡旅游民宿运营管理平台

#### 项目介绍
本项目为**三峡旅游民宿运营管理平台**，是面向三峡地区民宿业主、前台及管理人员的综合性数字化管理平台。系统聚焦解决传统民宿运营中的**信息孤岛、流程低效、数据价值未释放**等核心痛点，通过集成用户管理、房源管理、预订管理、客户管理及数据分析等核心功能，实现民宿业务全流程线上化、智能化管理，助力区域民宿产业数字化升级。

> **说明**：毕业实习项目，仅用于学习参考，不涉及商业用途。

#### 软件架构
项目采用**前后端分离**架构设计，具备高内聚、低耦合、易维护的特性，技术栈明细如下：

| 技术维度       | 技术选型及版本                                                                 |
|----------------|------------------------------------------------------------------------------|
| 前端技术栈     | 框架：Vue.js 3 + Composition API<br>UI组件库：Element Plus<br>构建工具：Vite<br>包管理：npm / yarn |
| 后端技术栈     | 核心框架：Spring Boot 3<br>数据持久层：MyBatis Plus<br>数据库：MariaDB 11.8.5<br>接口调试：Swagger 2.3.0<br>接口规范：RESTful API（JSON交互） |
| 部署与运维     | 服务器：华为云（Debian 13）<br>反向代理：Nginx 1.20<br>数据库管理：Navicat Premium 17<br>开发工具：IntelliJ IDEA、VS Code |

#### 安装部署教程
##### 一、环境准备（Debian 13 Linux 环境）
> 以下操作均基于 Debian 13 系统，默认使用 root 用户执行，普通用户需添加 `sudo` 前缀。

###### 1. 系统基础配置与换源
```bash
# 更新系统包索引
apt update && apt upgrade -y

# 备份原软件源（Debian 13）
cp /etc/apt/sources.list /etc/apt/sources.list.bak

# 替换为阿里云 Debian 13 源
cat > /etc/apt/sources.list << EOF
# 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ trixie main contrib non-free non-free-firmware
# deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ trixie main contrib non-free non-free-firmware

deb https://mirrors.tuna.tsinghua.edu.cn/debian/ trixie-updates main contrib non-free non-free-firmware
# deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ trixie-updates main contrib non-free non-free-firmware

deb https://mirrors.tuna.tsinghua.edu.cn/debian/ trixie-backports main contrib non-free non-free-firmware
# deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ trixie-backports main contrib non-free non-free-firmware

# 以下安全更新软件源包含了官方源与镜像站配置，如有需要可自行修改注释切换
#deb https://security.debian.org/debian-security trixie-security main contrib non-free non-free-firmware
# deb-src https://security.debian.org/debian-security trixie-security main contrib non-free non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian-multimedia/ trixie main non-free
# deb-src https://mirrors.tuna.tsinghua.edu.cn/debian-multimedia/ trixie main non-free
EOF

# 重新更新包索引
apt update
```

#### 1.安装教程

1. **Java 17 安装与环境配置**
    - 安装 JDK 17 及以上版本
    - 安装 Node.js 20.19.2
    - 安装 MariaDB 11.8.5 并启动服务

    ```
    # 安装 OpenJDK 17
    apt install openjdk-17-jdk -y

    #验证安装
    java -version
    javac -version

    配置 JAVA_HOME 环境变量（全局生效）
    echo "export JAVA_HOME=$(dirname $(dirname $(readlink -f $(which java))))" >> /etc/profile
    echo "export PATH=\$PATH:\$JAVA_HOME/bin" >> /etc/profile

    加载环境变量
    source /etc/profile

    验证环境变量
    echo $JAVA_HOME

    ```

2. **Node.js  npm安装与换源**
    ```
    # 安装 Node.js 20.19.2（使用 nvm 管理，更灵活）
    # 安装 nvm
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

    # 加载 nvm
    source ~/.bashrc

    # 安装指定版本 Node.js
    nvm install 20.19.2
    nvm use 20.19.2

    # 验证安装
    node -v  # 应输出 v20.19.2
    npm -v   # 应输出对应版本

    # npm 换源（阿里云）
    npm config set registry https://registry.npmmirror.com

    # 验证源是否生效
    npm config get registry

    # 可选：安装 yarn 并换源
    npm install -g yarn
    yarn config set registry https://registry.npmmirror.com

    ```

2. **Nginx 1.20 安装与配置**
    ```
    # 安装 Nginx 1.20
    apt install nginx=1.20.* -y

    # 启动并设置开机自启
    systemctl start nginx
    systemctl enable nginx

    # 验证服务
    systemctl status nginx

    # 配置防火墙（允许 80/443 端口）
    apt install ufw -y
    ufw allow 80/tcp
    ufw allow 443/tcp
    ufw reload

    ```

2.  **后端部署**
    ```bash
    # 克隆项目
    g it clone git@gitee.com:red-bean-lovesickness/shixi.git
    cd shixi

    # 配置数据库
    # 创建数据库 `hotel_system`，导入项目根目录下的 `hotel_system.sql` 文件

    # 修改配置文件
    # 在 `application.yml` 中配置数据库连接信息

    # 打包并运行
    mvn clean package
    java -jar target/hotel-system-1.0.0.jar 
    ```

    ```bash
    Swagger UI 界面：http://localhost:8080/swagger-ui.html
    OpenAPI 文档：http://localhost:8080/v3/api-docs

    ```



3.  **前端部署**
    ```bash
    cd frontend

    # 安装依赖
    npm install

    # 修改配置文件
    # 在 `.env.development` 或 `.env.production` 中配置后端API地址

    # 启动开发服务器
    npm run dev

    # 构建生产版本
    npm run build
    ```
3.  **AI模块文档**

##### 模块概述
AI模块集成通义千问（Qwen）大模型，为系统提供智能对话能力，支持流式响应，适用于智能客服、业务咨询等场景。
版本迭代记录
V1.0 - 基础流式聊天
发布日期：2024年12月
核心功能

基于查询参数的简单对话接口
实时流式响应输出

基础错误处理机制

接口详情

```
@Operation(summary = "流式聊天 V1")
@RequestMapping(value = "/v1/stream", produces = "text/stream;charset=UTF-8")
public Flux<String> streamV1(@RequestParam(defaultValue = "你是谁") String message)
```
技术实现

使用Spring WebFlux的Flux实现流式传输
集成LangChain4j调用Qwen大模型

支持实时分块输出响应内容

主要更新内容

版本分离：添加了 /v1/stream路径，明确版本标识
方法提取：将流式响应逻辑提取为私有方法，便于后续版本复用
向后兼容：保留了原有接口，确保现有调用不受影响

文档更新：为V1版本添加了清晰的API文档说明

后续迭代计划
V2.0（计划中）
预计发布日期：2025年1月
规划功能

引入请求体参数替代查询参数，支持复杂对话上下文
添加对话会话管理，支持多轮对话

增加对话历史记录功能

#### 技术改进

// 计划中的V2接口
@PostMapping("/v2/chat")
public Flux<ChatResponse> chatV2(@RequestBody ChatRequest request)

#### V3.0（规划中）
预计发布日期：2026年2月
规划功能

统一的响应格式封装
支持多种AI模型切换
添加速率限制和权限控制

对话质量评估和反馈机制

技术架构
核心依赖
```
<dependency>
    <groupId>dev.langchain4j</groupId>
    <artifactId>langchain4j</artifactId>
    <version>0.25.0</version>
</dependency>
```
配置说明

# 应用配置示例
```
ai:
  qwen:
    api-key: ${QWEN_API_KEY}
    model-name: qwen-turbo
    timeout: 30000
```
使用示例
基础调用

# V1版本调用
```
GET /api/chat/v1/stream?message=介绍一下三峡旅游的特色
```
响应格式

流式文本响应，实时输出AI回复内容

注意事项

当前版本仅支持文本对话，后续将扩展多模态能力
流式响应需要客户端支持SSE（Server-Sent Events）

建议在生产环境配置合理的超时时间和重试机制

版本维护策略

V1版本将保持至少6个月的维护期
新功能优先在V2版本开发，确保V1稳定性

逐步废弃旧版本接口，提供充足的迁移周期

最后更新：2025年12月31日
维护团队：技术开发部
维护团队：技术开发部

4.  **访问系统**
    - 开发环境：`http://localhost:8080`
    - 生产环境：部署至Nginx后访问对应域名或IP

#### 使用说明

1.  **用户角色与登录**
    - 系统支持管理员、民宿主、前台、客户等多种角色。
    - 首次使用请使用管理员账号登录，初始账号信息请联系项目组。

2.  **核心功能模块**
    - **用户管理**：角色分配、权限配置、操作审计。
    - **房间管理**：房型定义、价格策略设置（时段价/活动价）、实时房态可视化。
    - **预订管理**：在线查询、预订、修改、取消、支付对接、入住/退房登记全流程。
    - **客户管理**：客户档案建立、消费历史记录、会员积分管理。
    - **数据统计**：多维度经营数据看板（出租率、收入、客户来源等），支持报表导出。

3.  **快速开始**
    - 登录后，根据左侧导航菜单进入相应模块。
    - 首次使用时，建议先配置“系统管理”中的基础参数与权限。
    - 在“民宿业务模块”中录入房源信息与价格策略，即可开始接收预订。


#### 项目文档
- [项目立项文档](./docs/名酥(29组)_三峡旅游民宿运营管理平台_项目立项文档.docx)
- [需求规格说明书](./docs/三峡旅游民宿运营管理平台_需求规格说明书.docx)
- [系统设计文档](./docs/三峡旅游民宿运营管理平台_系统设计文档.docx)
- [项目进度管理文档](./docs/三峡旅游民宿运营管理平台_项目管理计划文档.docx)

#### 联系方式
- **项目负责人**：李淳 
- **产品经理**：杜楷辉
- **技术经理**：胡国昌

**（本项目为毕业实习成果，代码与文档仅供参考学习，不直接用于商业用途。）**