# dorm

**Repository Path**: gitc_1_0/dorm

## Basic Information

- **Project Name**: dorm
- **Description**: 宿舍管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 宿舍管理系统 (Dormitory Management System)

基于 Spring Boot + Vue3 的宿舍管理系统。

## 项目结构

- `frontend`: Vue3 + TypeScript + Element Plus 前端项目
- `backend`: Spring Boot + MyBatis-Plus + Spring Security 后端项目

## 快速开始

### 前端 (Frontend)

1. 进入前端目录:
   ```bash
   cd frontend
   ```
2. 安装依赖:
   ```bash
   npm install
   ```
3. 启动开发服务器:
   ```bash
   npm run dev
   ```

### 后端 (Backend)

1. 进入后端目录:
   ```bash
   cd backend
   ```
2. 配置数据库:
   修改 `src/main/resources/application.yml` 中的数据库连接信息。
   ```yaml
   spring:
     datasource:
       url: jdbc:mysql://localhost:3306/dorm_db...
       username: your_username
       password: your_password
   ```
3. 创建数据库并导入初始数据 (参考 `product_document.md` 中的 SQL)。
4. 运行项目:
   使用 Maven 运行或直接运行 `DormManagementApplication.java`。

## 功能模块

- **认证授权**: 基于 JWT 的登录认证，支持学生、宿管、管理员三种角色。
- **学生端**: 个人信息查看、报修申请、费用查询、访客预约。
- **宿管端**: 宿舍管理、报修处理、访客审核、水电费录入。
- **管理员端**: 用户管理、系统监控、数据统计。

## 技术栈

- **前端**: Vue 3, TypeScript, Vite, Element Plus, Pinia, Axios, Vue Router
- **后端**: Spring Boot 2.7, MyBatis-Plus, Spring Security, JWT, MySQL, Lombok

## 注意事项

- 前端开发代理配置在 `frontend/vite.config.ts` 中，默认转发 `/api` 请求到 `http://localhost:8080`。
- 后端默认运行在 8080 端口。