zhibo/archive/Zhibo/zhibo-1201/小张/待开发功能/用户签到列表.md

84 lines
2.4 KiB
Markdown
Raw Normal View History

2025-12-21 16:08:52 +08:00
# 用户签到列表
## 功能概述
任务管理模块中的用户签到列表功能,用于查看所有用户的签到记录,包括用户信息、获得的积分/经验、签到时间等。
## 数据库表
- **表名**`eb_user_sign`
- **实体类**`UserSign.java`
### 关键字段
| 字段名 | 类型 | 说明 |
|--------|------|------|
| id | Integer | 记录ID |
| uid | Integer | 用户ID |
| title | String | 签到说明 |
| number | Integer | 获得积分 |
| balance | Integer | 剩余积分 |
| type | Integer | 类型1=积分2=经验 |
| createDay | Date | 签到日期 |
| createTime | Date | 添加时间 |
## 界面需求
### 1. 列表页面
- **路由路径**: `/task/sign/list`
- **菜单名称**: 用户签到列表
- **页面位置**: 任务管理 > 用户签到列表
#### 搜索功能
- **搜索框**:搜索用户昵称(支持模糊搜索)
- **搜索按钮**:绿色按钮
#### 表格列
| 列名 | 字段 | 说明 |
|------|------|------|
| id | id | 签到记录ID |
| 用户昵称 | 用户昵称 | 关联用户表获取 |
| 用户头像 | 用户头像 | 关联用户表,显示为头像图片 |
| 获得的经验或积分 | number | 根据type显示类型 |
| 时间时间 | createTime | 签到时间格式YYYY-MM-DD HH:mm:ss |
#### 功能点
- 表格分页显示
- 支持按用户昵称搜索
- 头像图片展示(圆形或方形)
- 时间格式化显示
## 数据关联
需要关联用户表(`eb_user`)获取:
- 用户昵称
- 用户头像
## 待实现功能
### 前端界面(优先)
- [ ] 创建列表页面组件
- [ ] 搜索框:用户昵称搜索
- [ ] 表格展示id、用户昵称、用户头像、获得积分/经验、签到时间
- [ ] 分页组件
- [ ] 头像图片展示组件
- [ ] 配置路由:`/task/sign/list`
- [ ] 添加到任务管理菜单
### 后端接口(后续)
- [ ] 签到记录列表查询接口(带用户信息关联)
- [ ] 用户昵称搜索接口
- [ ] 分页查询接口
### 数据库连接
- [ ] 连接到 `eb_user_sign`
- [ ] 关联 `eb_user` 表获取用户信息
- [ ] 实现分页查询
## 技术要点
- 前端框架Vue + Element UI
- 表格组件el-table
- 搜索组件el-input
- 头像组件el-avatar 或 el-image
- 分页组件el-pagination
- 数据格式化:时间格式化过滤器
## 参考截图
位置:`小张/图片/任务管理-用户签到列表.png`