# 123

**Repository Path**: xuxiaofei1996/123

## Basic Information

- **Project Name**: 123
- **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-04-23
- **Last Updated**: 2025-04-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 学生公寓管理系统功能清单与开发进度

## 系统概述

学生公寓管理系统是一个用于管理学生宿舍、费用、通知等信息的Web应用系统。系统分为管理员和学生两个角色，各自有不同的功能模块。

## 功能清单

### 1. 用户认证模块

| 功能 | 接口 | 状态 | 备注 |
|------|------|------|------|
| 用户登录 | POST /api/auth/login | 待开发 | 支持管理员和学生两种角色登录 |
| 用户登出 | POST /api/auth/logout | 待开发 | 清除用户会话 |

### 2. 管理员模块

#### 2.1 仪表盘

| 功能 | 接口 | 状态 | 备注 |
|------|------|------|------|
| 获取用户统计 | GET /api/admin/dashboard/user-stats | 待开发 | 返回用户总数、学生数、管理员数 |
| 获取宿舍统计 | GET /api/admin/dashboard/dorm-stats | 待开发 | 返回总房间数、已入住数、空余房间数 |
| 获取费用统计 | GET /api/admin/dashboard/fee-stats | 待开发 | 返回本月水电费、住宿费、待缴费数 |

#### 2.2 用户管理

| 功能 | 接口 | 状态 | 备注 |
|------|------|------|------|
| 获取用户列表 | GET /api/admin/users | 待开发 | 支持分页、搜索、筛选 |
| 添加用户 | POST /api/admin/users | 待开发 | 创建新用户 |
| 更新用户 | PUT /api/admin/users/{id} | 待开发 | 修改用户信息 |
| 删除用户 | DELETE /api/admin/users/{id} | 待开发 | 删除指定用户 |
| 批量删除用户 | DELETE /api/admin/users/batch | 待开发 | 批量删除多个用户 |

#### 2.3 宿舍管理

| 功能 | 接口 | 状态 | 备注 |
|------|------|------|------|
| 获取宿舍列表 | GET /api/admin/dormitories | 待开发 | 支持分页、搜索、筛选 |
| 添加宿舍 | POST /api/admin/dormitories | 待开发 | 创建新宿舍 |
| 更新宿舍 | PUT /api/admin/dormitories/{id} | 待开发 | 修改宿舍信息 |
| 删除宿舍 | DELETE /api/admin/dormitories/{id} | 待开发 | 删除指定宿舍 |
| 分配床位 | POST /api/admin/dormitories/{id}/beds | 待开发 | 为学生分配床位 |
| 设置宿舍状态 | PUT /api/admin/dormitories/{id}/status | 待开发 | 设置宿舍为维护状态等 |

#### 2.4 费用管理

| 功能 | 接口 | 状态 | 备注 |
|------|------|------|------|
| 获取费用列表 | GET /api/admin/fees | 待开发 | 支持分页、搜索、筛选 |
| 添加费用 | POST /api/admin/fees | 待开发 | 创建新费用记录 |
| 更新费用 | PUT /api/admin/fees/{id} | 待开发 | 修改费用信息 |
| 删除费用 | DELETE /api/admin/fees/{id} | 待开发 | 删除指定费用 |
| 导出费用报表 | GET /api/admin/fees/export | 待开发 | 导出费用数据为Excel |

#### 2.5 信息查询

| 功能 | 接口 | 状态 | 备注 |
|------|------|------|------|
| 查询学生信息 | GET /api/admin/students | 待开发 | 支持分页、搜索、筛选 |
| 查询宿舍信息 | GET /api/admin/rooms | 待开发 | 支持分页、搜索、筛选 |
| 查询费用信息 | GET /api/admin/fee-records | 待开发 | 支持分页、搜索、筛选 |

#### 2.6 通知公告

| 功能 | 接口 | 状态 | 备注 |
|------|------|------|------|
| 获取通知列表 | GET /api/admin/announcements | 待开发 | 支持分页、搜索、筛选 |
| 添加通知 | POST /api/admin/announcements | 待开发 | 创建新通知 |
| 更新通知 | PUT /api/admin/announcements/{id} | 待开发 | 修改通知信息 |
| 删除通知 | DELETE /api/admin/announcements/{id} | 待开发 | 删除指定通知 |
| 发布通知 | PUT /api/admin/announcements/{id}/publish | 待开发 | 将草稿发布为正式通知 |
| 归档通知 | PUT /api/admin/announcements/{id}/archive | 待开发 | 将通知归档 |

### 3. 学生模块

#### 3.1 仪表盘

| 功能 | 接口 | 状态 | 备注 |
|------|------|------|------|
| 获取宿舍信息 | GET /api/student/dashboard/dorm-info | 待开发 | 返回学生所在宿舍信息 |
| 获取费用概览 | GET /api/student/dashboard/fee-info | 待开发 | 返回学生费用概览 |
| 获取最新通知 | GET /api/student/dashboard/announcements | 待开发 | 返回最新通知列表 |

#### 3.2 个人信息

| 功能 | 接口 | 状态 | 备注 |
|------|------|------|------|
| 获取个人信息 | GET /api/student/profile | 待开发 | 返回学生个人信息 |
| 更新个人信息 | PUT /api/student/profile | 待开发 | 修改学生个人信息 |

#### 3.3 费用缴纳

| 功能 | 接口 | 状态 | 备注 |
|------|------|------|------|
| 获取费用列表 | GET /api/student/fees | 待开发 | 返回学生费用列表 |
| 获取费用详情 | GET /api/student/fees/{id} | 待开发 | 返回费用详情 |
| 缴纳费用 | POST /api/student/fees/{id}/pay | 待开发 | 学生缴纳指定费用 |

#### 3.4 缴费记录

| 功能 | 接口 | 状态 | 备注 |
|------|------|------|------|
| 获取缴费记录 | GET /api/student/fee-records | 待开发 | 返回学生缴费记录列表 |

#### 3.5 通知公告

| 功能 | 接口 | 状态 | 备注 |
|------|------|------|------|
| 获取通知列表 | GET /api/student/announcements | 待开发 | 返回通知列表 |
| 获取通知详情 | GET /api/student/announcements/{id} | 待开发 | 返回通知详情 |

## 开发进度

### 已完成工作

1. 数据库设计
   - 创建了宿舍楼、房间、学生、维修记录等表
   - 添加了必要的外键约束和索引

2. 后端代码
   - 创建了实体类（Entity）
   - 创建了Mapper接口和XML
   - 创建了Service接口和实现类
   - 创建了Controller
   - 实现了基本的CRUD操作

3. 前端代码
   - 创建了登录页面
   - 创建了管理员和学生仪表盘
   - 创建了用户管理、宿舍管理、费用管理、信息查询、通知公告等页面

### 待完成工作

1. 后端开发
   - 实现用户认证模块
   - 实现管理员模块的所有接口
   - 实现学生模块的所有接口
   - 添加权限控制
   - 添加数据验证
   - 添加异常处理

2. 前端开发
   - 实现登录功能
   - 实现管理员仪表盘数据展示
   - 实现学生仪表盘数据展示
   - 实现用户管理功能
   - 实现宿舍管理功能
   - 实现费用管理功能
   - 实现信息查询功能
   - 实现通知公告功能
   - 添加表单验证
   - 添加错误处理
   - 优化用户体验

3. 测试
   - 编写单元测试
   - 编写接口测试
   - 进行功能测试
   - 进行性能测试

4. 部署
   - 配置生产环境
   - 部署后端服务
   - 部署前端服务
   - 配置数据库
   - 配置域名和SSL

## 下一步开发计划

1. 实现用户认证模块
   - 创建AuthController
   - 实现登录接口
   - 实现登出接口
   - 添加JWT认证

2. 实现管理员仪表盘
   - 实现用户统计接口
   - 实现宿舍统计接口
   - 实现费用统计接口
   - 完善前端数据展示

3. 实现学生仪表盘
   - 实现宿舍信息接口
   - 实现费用概览接口
   - 实现最新通知接口
   - 完善前端数据展示

4. 实现用户管理功能
   - 实现用户列表接口
   - 实现添加用户接口
   - 实现更新用户接口
   - 实现删除用户接口
   - 完善前端交互

5. 实现宿舍管理功能
   - 实现宿舍列表接口
   - 实现添加宿舍接口
   - 实现更新宿舍接口
   - 实现删除宿舍接口
   - 实现分配床位接口
   - 完善前端交互

6. 实现费用管理功能
   - 实现费用列表接口
   - 实现添加费用接口
   - 实现更新费用接口
   - 实现删除费用接口
   - 实现导出报表接口
   - 完善前端交互

7. 实现通知公告功能
   - 实现通知列表接口
   - 实现添加通知接口
   - 实现更新通知接口
   - 实现删除通知接口
   - 实现发布通知接口
   - 实现归档通知接口
   - 完善前端交互

8. 实现学生个人信息功能
   - 实现获取个人信息接口
   - 实现更新个人信息接口
   - 完善前端交互

9. 实现学生费用缴纳功能
   - 实现费用列表接口
   - 实现费用详情接口
   - 实现缴纳费用接口
   - 完善前端交互

10. 实现学生缴费记录功能
    - 实现缴费记录列表接口
    - 完善前端交互

11. 实现学生通知公告功能
    - 实现通知列表接口
    - 实现通知详情接口
    - 完善前端交互

12. 系统优化
    - 添加权限控制
    - 添加数据验证
    - 添加异常处理
    - 优化前端用户体验
    - 进行性能优化

13. 测试与部署
    - 编写测试用例
    - 进行功能测试
    - 进行性能测试
    - 部署到生产环境