# gupt-font_end

**Repository Path**: wish168/gupt-font_end

## Basic Information

- **Project Name**: gupt-font_end
- **Description**: 本项目是 邮院通（校园一站式服务平台 + AI 智能助手） 的前端部分，基于 Vue3 + TDesign + TailwindCSS 构建，旨在为校园师生提供 统一入口、便捷操作与智能服务 的数字化体验。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-09-11
- **Last Updated**: 2025-12-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# 📖 邮院通前端项目

本项目是 **邮院通（校园一站式服务平台 + AI 智能助手）** 的前端部分，基于 **Vue3 + TDesign + TailwindCSS** 构建，旨在为校园师生提供 **统一入口、便捷操作与智能服务** 的数字化体验。

## 🚀 技术栈

- **框架**：Vue3 + Vite
- **UI 组件库**：TDesign Vue Next
- **样式**：TailwindCSS
- **状态管理**：Pinia
- **路由**：Vue Router
- **数据请求**：Axios，封装统一请求拦截
- **可视化**：ECharts（用于消费统计等模块）
- **构建工具**：Vite（支持 HMR 与快速构建）

---

## 📂 项目目录结构

```

gupt-font-end
├── public/ # 静态资源
├── src/
│ ├── api/ # 封装接口请求
│ ├── assets/ # 图片、图标等静态文件
│ ├── components/ # 通用组件
│ ├── config/ # 全局配置（主题、请求基础配置等）
│ ├── exception/ # 全局异常处理页面（404、500）
│ ├── guards/ # 路由守卫
│ ├── hooks/ # 自定义 hooks（如 useUser、useRequest）
│ ├── layouts/ # 页面布局（导航栏、侧边栏、通用布局）
│ ├── mock/ # 本地 mock 数据
│ ├── pages/ # 业务页面（新闻、社团、课程、宿舍、消费、邮件等）
│ ├── router/ # 路由配置
│ ├── store/ # Pinia 状态管理
│ ├── style/ # 全局样式
│ ├── types/ # TS 类型定义
│ ├── utils/ # 工具函数（日期格式化、缓存工具等）
│ ├── App.vue # 根组件
│ └── main.ts # 入口文件
├── .env # 默认环境变量
├── .env.development # 开发环境变量
├── vite.config.ts # Vite 配置
├── package.json # 依赖配置
└── index.html # 入口 HTML

````

---

## 🛠️ 本地运行

### 1. 克隆项目
```bash
git clone https://github.com/Moonlight168/campus-ai-assistant.git
cd campus-ai-assistant/gupt-web
````

### 2. 安装依赖

```bash
npm install
```

### 3. 启动开发环境

```bash
npm run dev
```

默认访问地址：[http://localhost:5173](http://localhost:5173)

### 4. 构建生产环境

```bash
npm run build
```

---

## 📌 功能模块

* **首页门户**：统一入口，展示校园通知、新闻资讯、服务导航
* **新闻公告**：新闻列表、新闻详情页，支持全文检索
* **社团管理**：活动发布、社团介绍、我的社团
* **课程表 & 成绩**：学生课表、成绩查询
* **宿舍服务**：宿舍分配、报修、宿舍评分
* **消费中心**：校园卡余额、交易记录、充值
* **邮件通知**：邮件收发、系统消息提醒
* **AI 智能助手**：基于 Ollama + Qwen 模型，支持自然语言问答

---

## 📷 页面预览

| 页面模块     | 截图 |
|--------------|------|
| 登录页面     | ![登录页面](imges/login.png) |
| 新闻栏目     | ![新闻栏目](imges/info.png) |
| 新闻列表     | ![新闻列表](imges/info_list.png) |
| 新闻详情     | ![新闻详情](imges/info_detail.png) |
| 社团活动     | ![社团活动](imges/club_activity.png) |
| 社团介绍     | ![社团介绍](imges/club_introduce.png) |
| 我的社团     | ![我的社团](imges/myclub.png) |
| 我的成绩     | ![我的成绩](imges/class_grades.png) |
| 我的课表     | ![我的课表](imges/class_schedule.png) |
| 请假功能     | ![请假功能](imges/class_leave.png) |
| 请假详情     | ![请假详情](imges/leave_detail.png) |
| 宿舍评分     | ![宿舍评分](imges/dorm_score.png) |
| 宿舍报修     | ![宿舍报修](imges/dorm_repair.png) |
| 我的报修记录 | ![我的报修记录](imges/dorm_myrepair.png) |
| 我的宿舍     | ![我的宿舍](imges/dorm_my.png) |
| 校园消费     | ![校园消费](imges/consumption.png) |
| 我的钱包     | ![我的钱包](imges/consumption_wallet.png) |
| 消费记录     | ![消费记录](imges/consumption_wallet_transaction.png) |
| 我的邮箱     | ![我的邮箱](imges/mail.png) |
| 编辑信件     | ![编辑信件](imges/mail_write.png) |
| 个人简介     | ![个人简介](imges/user.png) |

---

## 🔗 后端项目

请参考后端服务：[Gitee - 邮院通(前端)](https://gitee.com/wish168/gupt-management-back-end)