# NetworkRent

**Repository Path**: Qia-A/network-rent

## Basic Information

- **Project Name**: NetworkRent
- **Description**: 校园网易租
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 0
- **Created**: 2025-11-19
- **Last Updated**: 2025-12-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Network Rent 项目

## 项目概述

Network Rent 是一个名为"校园网易租"的校园网络资源共享平台项目，专为高校学生打造。该项目包含后端服务和微信小程序前端两部分，旨在连接拥有闲置校园网络资源的"出租方"与存在临时网络需求的"租用方"。平台提供订单管理、支付保障、实名审核和双向评价系统，构建高效、可信、互助的校园网络共享生态。

## 项目结构

```
C:\Users\QIA27\Desktop\Network Rent\
├── docs/                    # 项目文档
├── network-rent-backend/    # 后端服务 (Spring Boot)
├── network-rent-wx/         # 微信小程序前端
├── sql/                     # 数据库脚本
├── README.md
└── LICENSE
```

## 技术栈

### 后端 (network-rent-backend)

- **核心框架**: Spring Boot 3.4.11
- **语言**: Java 17
- **ORM 框架**: MyBatis-Plus/MyBatis-Flex
- **数据库**: MySQL 8.0
- **缓存**: Redis
- **认证授权**: JWT
- **构建工具**: Gradle
- **开发工具**: IntelliJ IDEA

### 前端 (network-rent-wx)

- **平台**: 微信小程序
- **UI 框架**: TDesign MiniProgram
- **构建工具**: 微信开发者工具+trae
- **包管理**: npm

## 功能模块

### 用户功能

- 注册登录 (学号/手机号)
- 学生身份认证 (学信网数据接口或上传学生证)
- 密码管理

### 租用功能

- 查看租用信息 (时间、租金、押金)
- 订单状态管理
- 到期提醒 (短信/电话)

### 出租功能

- 设置出租信息 (时间、价格、联系方式)
- 订单与收益管理

### 后台管理

- 用户管理
- 商品审核
- 订单管理

## 开发规范

### 后端规范

- **项目结构**: 遵循标准 Spring Boot 结构，包含 controller、service、dao、model、util、exception 等包
- **接口规范**:
  - REST API: `/业务/api/v版本/资源` (如 `/rent/api/v1/house`)
  - 返回格式: 统一 JSON 结构 `{code, msg, data}`
- **方法命名**:
  - Controller: `queryXxx`, `createXxx`, `updateXxx`, `deleteXxx`
  - Service: `queryXxx`/`findXxx`, `saveXxx`, `updateXxx`, `removeXxx`
  - DAO: `getXxxById`, `listXxxByCondition`, `insertXxx`, `updateXxx`, `deleteXxxById`
- **数据库规范**:
  - 表名: 小写字母 + 下划线 (如 `house_info`)
  - 字段名: 驼峰命名法 (如 `userId`)
  - 主键: `id` (bigint, 自增)
  - 通用字段: `createTime`, `updateTime`

### 前端规范

- **项目结构**: 包含 router、store、views、components、api、utils、styles 等目录
- **组件命名**: PascalCase (如 `HouseDetail.vue`)
- **API 规范**: 按业务模块拆分，请求方法与后端对应

### 通用规范

- **命名**: 变量/函数 camelCase, 常量 UPPER_SNAKE_CASE, 类名 PascalCase
- **版本控制**: Git 分支策略 (main, dev, feature/xxx, fix/xxx)
- **安全**: BCrypt 密码加密, JWT 权限验证, 防 SQL 注入和 XSS

## 数据库结构

目前包含 `users` 表，存储用户信息，包括学号、用户名、密码、手机号、真实姓名、学校名称、角色类型等字段。

## 构建与运行

### 后端

- 使用 Gradle 构建: `./gradlew build`
- 运行: `./gradlew bootRun`
- 依赖管理: 通过 `build.gradle` 文件

### 前端

- 使用微信开发者工具打开 `network-rent-wx` 目录
- 依赖安装: `npm install`
- 代码检查: `npm run lint