# Soft

**Repository Path**: elfbobo_admin_admin/soft

## Basic Information

- **Project Name**: Soft
- **Description**: 景区导览AI数字人
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-07
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 景区导览服务AI数字人系统 MVP

这是一个可运行的基础版本，包含：

- **backend**：Spring Boot 3 + MyBatis-Plus + MySQL
- **frontend-admin**：Vue 3 + Vite + Element Plus 管理端
- **sql**：数据库初始化脚本

## 已实现模块

### 管理端
- 管理员登录
- 仪表盘统计
- 景区管理
- 景点管理
- 知识库管理
- 问答记录查看

### 游客端后端接口
- 景区列表
- 景点列表 / 景点详情
- 创建会话
- 普通问答（当前为演示逻辑，可替换真实 AI）
- 查看聊天历史
- 清空会话
- 路线推荐（当前为演示逻辑）
- 提交反馈
- 文件上传

## 目录结构

```text
scenic-ai-fullstack
├── backend
├── frontend-admin
├── sql
└── README.md
```

---

## 一、数据库准备

1. 本地安装 MySQL 8
2. 打开 `sql/init_scenic_ai_db.sql`
3. 执行整段 SQL

默认数据库名：

```sql
scenic_ai_db
```

默认管理员账号：

- 用户名：`admin`
- 密码：`123456`

---

## 二、后端启动

### 1. 用 IDEA 打开 `backend`
### 2. 修改 `src/main/resources/application.yml`

把下面这部分改成你自己的数据库配置：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/scenic_ai_db?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
    username: root
    password: 123456
```

### 3. 启动主类

`com.scenic.ai.ScenicAiApplication`

启动成功后默认地址：

- 后端接口：`http://localhost:8080`
- Swagger：`http://localhost:8080/swagger-ui.html`

---

## 三、前端启动

### 1. 进入目录

```bash
cd frontend-admin
```

### 2. 安装依赖

```bash
npm install
```

### 3. 启动

```bash
npm run dev
```

默认地址：

- 管理端前端：`http://localhost:5173`

---

## 四、当前技术说明

### 后端
- Spring Boot 3
- MyBatis-Plus
- MySQL
- Lombok
- Springdoc OpenAPI

### 前端
- Vue 3
- Vite
- Element Plus
- Axios
- Vue Router

---

## 五、注意事项

1. 当前问答与路线推荐先使用演示逻辑，后续你可以把 `ChatBizServiceImpl` 和 `RouteController` 中的 mock 逻辑替换成真实 AI 接口调用。
2. 当前登录 token 为简化版，仅用于前端演示，不是正式安全方案。
3. 当前是 MVP 骨架，适合比赛开发继续扩展。

---

## 六、建议你接下来继续做的事

1. 接入你 AI 队友的真实 `/ai/chat`、`/ai/knowledge/sync`、`/ai/recommend/route`
2. 增加管理员按景区/景点的数据权限过滤
3. 完善 Word / Excel 批量导入
4. 增加数字人配置管理
5. 增加数据大屏和满意度统计图表