# 二手交易平台

**Repository Path**: dm_team/second-hand-trading-platform

## Basic Information

- **Project Name**: 二手交易平台
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-07
- **Last Updated**: 2026-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 校园二手交易平台

一个**功能超全、架构完善**的校园二手交易平台，采用 FastAPI + MySQL 后端，Vue 3 前端的全栈架构，包含用户系统、商品管理、订单系统、即时通讯、积分系统、优惠券、社区论坛、后台管理等完整功能模块。

## 🚀 功能特性

### 🎯 用户系统
- 邮箱/手机号注册登录
- JWT 身份认证与刷新
- 用户资料管理（头像、昵称、简介）
- 学生认证（学生证上传、审核）
- 实名认证
- 收货地址管理（多地址、默认地址）
- 用户等级与成长体系（10个等级）
- 勋章系统
- 积分系统（签到、交易、评价获取积分）
- 每日签到（连续签到奖励）
- 黑名单功能
- 用户隐私设置

### 📦 商品系统
- 商品浏览（列表、网格、大图视图）
- 商品搜索（关键词、全文搜索）
- 高级筛选（价格、成色、分类、距离、库存筛选）
- 商品库存管理（商品发布时设置库存、库存为0自动下架、下单时扣减库存）
- 商品标签系统（商品标签管理、按标签搜索）
- 智能排序（价格、发布时间、浏览量、销量）
- 商品详情（多图轮播、视频、规格、评价、库存显示）
- 商品发布与编辑
- 草稿保存
- 商品分类（多级分类、分类筛选）
- 商品图片/视频上传
- 商品规格管理
- 收藏功能（收藏夹分类）
- 浏览历史记录
- 降价提醒
- 商品置顶推广
- 商品审核（可选）
- 该用户其他商品
- 相似商品推荐

### 🛒 订单系统
- 购物车（添加、修改、删除、选中、合计）
- 创建订单（地址选择、优惠券、积分抵扣）
- 订单号生成
- 订单状态流转（待支付→已支付→待发货→已发货→已完成→已评价）
- 订单详情查看
- 订单列表（全部、待支付、待发货、待收货、待评价等）
- 取消订单
- 支付订单（模拟支付）
- 发货管理（物流公司、运单号）
- 物流信息查询（轨迹跟踪）
- 确认收货
- 延长收货
- 自动确认收货
- 订单备注（买家留言、卖家备注）
- 订单导出

### 💸 退款退货系统
- 退款申请（仅退款、退货退款）
- 退款原因选择
- 退款凭证上传
- 退款协商
- 退款审核（同意/拒绝）
- 退货地址填写
- 退货物流信息
- 退款进度查询
- 平台介入

### ⭐ 评价系统
- 发表评价（多维度评分、文字、图片、匿名）
- 商品评价列表
- 评价筛选（好评、中评、差评、有图、追评）
- 点赞评价
- 回复评价
- 评价统计（好评率、评分分布）

### 🎁 优惠券系统
- 多种优惠券类型（满减券、折扣券、免邮券、新人券、节日券）
- 优惠券领取
- 优惠券使用
- 我的优惠券（可用、已使用、已过期）
- 优惠券过期提醒
- 优惠券发放（后台管理）

### 💬 消息系统
- 即时通讯（WebSocket 实时消息）
- 会话列表
- 创建会话
- 发送文字/图片/语音/文件/商品卡片/订单卡片
- 消息已读状态
- 消息撤回（限时）
- 消息记录查询
- 系统通知（订单、商品、评价等）
- 系统公告
- 通知已读/未读管理

### 🎯 求购与拍卖系统
- 发布求购信息
- 求购列表
- 求购搜索
- 求购报价
- 联系求购者
- 我的求购
- 发布拍卖商品
- 拍卖出价
- 拍卖保证金
- 拍卖成交

### 👥 社区论坛
- 发布帖子
- 帖子列表
- 帖子详情
- 帖子点赞
- 帖子收藏
- 评论回复
- 帖子分类
- 帖子置顶

### 🔧 后台管理系统
- 数据统计（用户增长、商品发布、交易额等）
- 数据可视化图表
- 商品管理（列表、审核、上下架）
- 用户管理（列表、状态管理、权限设置）
- 用户认证审核
- 订单管理（列表、状态查看、介入处理）
- 退款审核
- 评价管理
- 消息管理（系统公告、站内信）
- 优惠券管理（创建、编辑、发放、统计）
- 分类管理
- 系统配置（站点信息、注册、发布、积分规则等）
- 举报管理
- 操作日志查询
- 财务统计（交易流水、充值、提现等）

### 🛡️ 安全防护
- 密码 bcrypt 加密
- JWT 身份认证与刷新
- 登录失败次数限制
- 接口限流保护
- CORS 跨域配置
- 输入验证（Pydantic）
- SQL 注入防护（ORM）
- XSS 防护
- CSRF 防护
- 文件上传安全（类型、大小、内容检查）
- 操作日志记录
- 敏感数据脱敏

## 🛠️ 技术栈

### 后端
- FastAPI (Python 3.10+) - 高性能异步 Web 框架
- SQLAlchemy 2.0+ - ORM 数据库操作
- MySQL 8.0+ - 关系型数据库
- JWT - 身份认证
- bcrypt - 密码加密（直接使用，不依赖 passlib）
- slowapi + Limiter - 接口限流（内存存储）
- Pydantic - 数据验证
- WebSocket - 实时通讯

### 前端
- Vue 3 - 渐进式 JavaScript 框架
- Vite - 下一代前端构建工具
- Tailwind CSS - 原子化 CSS 框架
- Pinia - 状态管理
- Vue Router 4 - 路由管理
- Axios - HTTP 客户端
- Element Plus - UI 组件库

## 📁 项目结构

```
校园二手交易平台/
├── backend/                 # 后端代码
│   ├── app/
│   │   ├── api/           # API 路由
│   │   ├── core/          # 核心配置
│   │   ├── models/        # 数据模型（40+表）
│   │   ├── schemas/       # Pydantic 模型
│   │   ├── services/      # 业务逻辑层
│   │   └── utils/         # 工具函数
│   ├── alembic/           # 数据库迁移
│   ├── uploads/           # 上传文件
│   ├── .env               # 环境配置
│   └── requirements.txt
├── frontend/              # 前端代码
│   ├── src/
│   │   ├── api/          # API 接口
│   │   ├── assets/       # 静态资源
│   │   ├── components/   # 组件
│   │   ├── router/       # 路由
│   │   ├── stores/       # 状态管理
│   │   ├── utils/        # 工具函数
│   │   └── views/        # 页面
│   └── package.json
├── docs/                  # 项目文档
│   ├── features.md       # 功能说明
│   ├── architecture.md   # 技术架构
│   └── database.md       # 数据库设计
├── sql/                   # SQL 脚本
│   └── init.sql         # 数据库初始化
├── .trae/                # 设计文档
└── README.md
```

## 🚀 快速开始

### 环境要求

- Python 3.10+
- MySQL 8.0+
- Node.js 18+

### 后端启动

1. 创建数据库并导入数据：

先创建数据库，然后导入SQL文件：
```sql
CREATE DATABASE campus_market CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

使用MySQL客户端导入完整的数据库初始化脚本：
```bash
mysql -u root -p campus_market < sql/init.sql
```
或者在MySQL中：
```sql
source c:/Users/Administrator/Desktop/校园二手交易平台/sql/init.sql;
```

2. 进入后端目录：
```bash
cd backend
```

3. 创建虚拟环境并激活：
```bash
python -m venv venv
# Windows:
venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate
```

4. 安装依赖：
```bash
pip install -r requirements.txt
```

5. 修改环境配置：

编辑 `.env` 文件，修改数据库连接信息（如果没有密码，去掉 `:your_password`）：
```env
DATABASE_URL=mysql+pymysql://root@localhost:3306/campus_market
SECRET_KEY=your_strong_secret_key_here_change_this
```

6. 启动后端服务：
```bash
python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
```

后端服务将在 http://localhost:8000 启动，API 文档可在 http://localhost:8000/docs 查看。

### 前端启动

1. 进入前端目录：
```bash
cd frontend
```

2. 安装依赖：
```bash
npm install
```

3. 启动开发服务器：
```bash
npm run dev
```

前端服务将在 http://localhost:5173 启动。

## 👤 默认账号

### 管理员账号
- **管理员邮箱**：admin@campus.com
- **管理员密码**：admin123
- **角色**：系统管理员，可访问后台管理功能

### 测试用户账号
系统启动时会自动创建以下测试账号（可自行在数据库中添加更多）：

| 用户名 | 邮箱 | 密码 | 说明 |
|--------|------|------|------|
| 管理员 | admin@campus.com | admin123 | 系统管理员 |
| 测试用户1 | test1@campus.com | test123456 | 普通用户 |
| 测试用户2 | test2@campus.com | test123456 | 普通用户 |

> ⚠️ 注意：测试用户账号需要手动在数据库中添加，或通过注册功能创建新账号。

### 登录说明
1. 访问前端页面：http://localhost:5173
2. 点击"登录"按钮
3. 输入邮箱和密码进行登录
4. 管理员账号可访问后台管理系统（路径：/admin）

## 📊 数据库设计

项目包含 **40+ 数据表**，涵盖所有业务模块：

- **用户系统** (9张表) - users, student_verifications, addresses, user_levels, badges, user_badges, point_records, check_ins, blacklists
- **商品系统** (9张表) - categories, products, product_images, product_videos, product_specs, favorites, favorite_folders, view_history, price_alerts
- **订单系统** (6张表) - carts, orders, order_items, logistics, logistics_tracks, refunds, refund_images
- **评价系统** (4张表) - reviews, review_images, review_replies, review_likes
- **优惠券系统** (2张表) - coupons, user_coupons
- **消息系统** (4张表) - conversations, messages, notifications, announcements
- **求购拍卖** (4张表) - purchase_requests, offers, auctions, bids
- **社区论坛** (3张表) - posts, post_comments, post_likes
- **系统管理** (3张表) - reports, settings, operation_logs

详细的数据库设计文档请查看 [docs/database.md](docs/database.md)。

## ✅ 已完成功能

### 后端核心功能
- [x] 后端基础架构（FastAPI + SQLAlchemy）
- [x] 完整的数据库设计（40+表，sql/init.sql）
- [x] 用户认证系统（JWT + bcrypt）
- [x] 用户管理（注册、登录、信息修改、学生认证、地址管理、签到、积分记录）
- [x] 商品管理（商品发布、分类、浏览、搜索、收藏、浏览历史、降价提醒、热门/推荐商品）
- [x] 商品库存管理：
  - 商品发布/编辑时可设置库存数量
  - 商品列表和详情页显示库存信息
  - 库存为0时自动下架，按钮禁用购买
  - 下单时自动扣减库存
  - 取消订单时自动恢复库存
  - 购物车修改数量时检查库存
- [x] 商品标签系统：
  - 商品标签功能（SQL初始化时已包含标签数据）
  - 商品列表显示分类标签和商品标签
- [x] 分类筛选功能：
  - 商品列表页支持分类筛选
  - 分类数据自动初始化（6个一级分类，14个二级分类）
- [x] 分类接口修复（解决 ORM 对象无法序列化为 JSON 的问题）
- [x] 签到功能完善：
  - 修复日期处理问题（解决 AttributeError: 'datetime.date' 没有 'date' 属性）
  - 完善连续签到奖励机制
  - 签到奖励说明和积分用途说明
  - 优化签到成功提示信息
- [x] 完善的商品多媒体管理：
  - 商品图片上传、删除、设置主图、重新排序
  - 商品视频上传、删除
  - 商品规格添加、修改、删除、查询
- [x] 完整的订单系统：
  - 订单创建（购物车、地址、优惠券、积分抵扣）
  - 订单支付（模拟支付）
  - 卖家发货（物流信息）
  - 物流跟踪（物流轨迹查询）
  - 确认收货
  - 延长收货时间
  - 自动确认收货
  - 取消订单（自动恢复库存）
  - 订单统计（买/卖家订单数据）
  - 订单提醒（待付款/待发货/待收货/待评价）
  - 订单项评价状态检查
- [x] 购物车系统（添加、删除、修改数量、全选、计算金额）
- [x] 优惠券系统（优惠券列表、领取、我的优惠券、折扣计算）
- [x] 评价系统（发表评价、查看评价、点赞、回复、待评价列表）
- [x] 完整的退款系统：
  - 退款申请（仅退款/退货退款）
  - 退款详情查询
  - 退款取消（自动恢复订单状态）
  - 退货物流提交
- [x] 社区论坛系统：
  - 帖子分类（校园生活、学习方法、二手交易等）
  - 帖子发布、编辑、删除
  - 帖子列表、搜索、排序（最新/热门/精华）
  - 帖子详情浏览
  - 帖子点赞/取消点赞
  - 帖子评论、回复
  - 我的帖子列表
  - 我收藏的帖子
- [x] 后台管理系统：
  - 数据统计（用户、商品、订单、财务概览）
  - 用户增长趋势、订单趋势分析
  - 分类商品统计
  - 用户管理（列表、状态更新、角色管理）
  - 商品管理（列表、状态更新、审核）
  - 订单管理（列表、详情查看）
  - 帖子管理（列表、状态、置顶、精华设置）
- [x] 通知系统：
  - 通知列表查询（支持已读/未读筛选）
  - 未读通知数量
  - 标记已读（单条/全部）
  - 删除通知
  - 清空通知
- [x] 求购系统：
  - 求购信息发布、编辑、关闭
  - 求购信息列表、搜索、筛选
  - 求购信息详情浏览
  - 报价（提供商品链接和价格）
  - 接受/拒绝报价
  - 我的求购列表、我的报价列表
- [x] 拍卖系统：
  - 拍卖创建、编辑、取消
  - 拍卖列表、搜索、排序（即将结束、最新、热门、价格）
  - 拍卖详情浏览
  - 出价（支持自动出价）
  - 取消出价（仅最高出价）
  - 拍卖结算（自动确定中标者）
  - 我的拍卖、我的出价
- [x] 即时通讯系统（WebSocket）：
  - WebSocket实时聊天连接
  - 实时消息发送和接收
  - 消息已读状态
  - 正在输入状态
  - 消息撤回（5分钟内）
  - 会话列表管理
  - 消息历史查询
  - 未读消息统计
  - 在线用户状态
- [x] 智能推荐系统：
  - 热门推荐（基于浏览量、收藏量、销量）
  - 个性化推荐（基于用户行为：浏览、收藏、购买历史）
  - 协同过滤推荐（基于用户相似度、商品相似度）
  - 相似商品推荐（基于类目、价格区间）
  - 新品推荐（最新上架商品）
  - 上升趋势推荐（近期热度上升商品）
  - 混合推荐（多种算法组合）
  - 首页智能推荐（组合多种推荐策略）
  - 价格区间推荐（按价格筛选）
- [x] 文件上传（图片上传，含大小限制和类型检查）
- [x] 数据库初始化（含默认分类、用户等级、管理员账号、测试用户、测试商品、测试优惠券）
- [x] 安全修复（认证绕过漏洞修复）
- [x] 密码加密优化（移除 passlib 依赖，直接使用 bcrypt 库）
- [x] 完整 API 文档（docs/api.md，90+ 接口）
- [x] 数据库密码哈希修复（修复 init.sql 中用户密码，直接使用正确 bcrypt 生成的哈希值）

### 前端基础架构
- [x] 前端项目基础框架（Vue 3 + Vite + TypeScript）
- [x] API请求封装（Axios拦截器）
- [x] 用户状态管理（Pinia Store）
- [x] API路径统一（与后端匹配）

### 文档与配置
- [x] 完整的功能文档
- [x] 完整的技术架构文档
- [x] 数据库初始化脚本（SQL）
- [x] README完善

## 🚧 功能实现状态

### ✅ 已完全实现的功能

#### 后端API
- [x] 完整的数据库设计（40+表，sql/init.sql）
- [x] 用户认证系统（JWT + bcrypt）
- [x] 用户管理（注册、登录、信息修改、学生认证、地址管理、签到、积分记录）
- [x] 商品管理（商品发布、分类、浏览、搜索、收藏、库存管理、标签系统）
- [x] 购物车系统（添加、删除、修改数量、全选、计算金额）
- [x] 订单系统（创建、支付、发货、物流跟踪、确认收货、取消订单、退款系统）
- [x] 优惠券系统（优惠券列表、领取、我的优惠券、折扣计算）
- [x] 评价系统（发表评价、查看评价、点赞、回复）
- [x] 社区论坛系统（帖子发布、列表、详情、点赞、评论）
- [x] 通知系统（通知列表、未读数、标记已读）
- [x] 求购与拍卖系统
- [x] 即时通讯系统（WebSocket）
- [x] 智能推荐系统
- [x] 后台管理系统

#### 前端页面
- [x] 首页与商品列表页（含分类筛选）
- [x] 商品详情页
- [x] 商品发布/编辑页
- [x] 用户中心（个人信息、签到、地址管理）
- [x] 购物车与订单页
- [x] 登录/注册页
- [x] 收藏与我的商品页
- [x] 基础聊天页
- [x] **优惠券中心页面**（可领取优惠券、我的优惠券）
- [x] **订单结算页面**（地址选择、优惠券选择、积分抵扣）
- [x] **订单详情页面**（订单状态、商品信息、物流信息）
- [x] **我的订单页面**（全部订单、待支付、待发货、待收货、待评价）

---

### ❌ 后端已实现但前端缺失的功能

#### 1. 社区论坛系统
- [ ] 社区首页（帖子列表）
- [ ] 帖子详情页
- [ ] 发布帖子页面
- [ ] 帖子评论功能UI
- [ ] 我的帖子页面
- [ ] API调用文件：`frontend/src/api/community.ts`
- **后端API**：[backend/app/api/community.py](file:///c:/Users/Administrator/Desktop/校园二手交易平台/backend/app/api/community.py)

#### 2. 通知系统
- [ ] 通知中心页面
- [ ] 未读通知数徽章展示
- [ ] 通知已读标记功能
- [ ] 通知分类筛选
- [ ] API调用文件：`frontend/src/api/notification.ts`
- **后端API**：[backend/app/api/notifications.py](file:///c:/Users/Administrator/Desktop/校园二手交易平台/backend/app/api/notifications.py)

#### 3. 评价系统
- [ ] 商品评价详情页面
- [ ] 发表评价页面
- [ ] 我的评价页面
- [ ] 待评价订单列表入口
- [ ] API调用文件：`frontend/src/api/review.ts`

#### 4. 勋章系统
- [ ] 我的勋章页面
- [ ] 勋章墙展示
- [ ] 获得勋章的动画效果
- [ ] API调用文件：`frontend/src/api/badge.ts`

#### 5. 拍卖系统
- [ ] 拍卖商品列表页
- [ ] 拍卖详情页
- [ ] 出价功能UI
- [ ] 我的拍卖页面
- [ ] API调用文件：`frontend/src/api/auction.ts`

#### 6. 求购系统
- [ ] 求购信息列表页
- [ ] 发布求购页面
- [ ] 求购报价功能
- [ ] API调用文件：`frontend/src/api/purchase.ts`

#### 7. 价格提醒功能
- [ ] 价格提醒设置弹窗
- [ ] 我的价格提醒页面
- [ ] 价格变化通知
- [ ] API调用文件：`frontend/src/api/price-alert.ts`

#### 8. 积分记录
- [ ] 积分记录详情页面
- [ ] 积分收支明细
- [ ] 积分规则说明
- [ ] 前端已有点API但缺少页面

#### 9. 学生认证
- [ ] 学生认证流程页面
- [ ] 认证状态展示
- [ ] 认证审核结果通知
- [ ] 前端已有API但缺少页面

#### 10. 浏览历史
- [ ] 浏览历史页面
- [ ] 历史记录管理（删除、清空）

#### 11. 推荐系统
- [ ] 首页猜你喜欢模块
- [ ] 相似商品推荐展示
- [ ] API调用文件：`frontend/src/api/recommendation.ts`

#### 12. 管理后台子页面
- [ ] 管理后台用户管理页（当前指向AdminDashboard）
- [ ] 管理后台商品管理页（当前指向AdminDashboard）
- [ ] 管理后台订单管理页（当前指向AdminDashboard）
- [ ] 管理后台退款管理页（当前指向AdminDashboard）

---

### 📊 功能完成度统计

| 系统模块 | 后端API | 前端页面 | 完成度 |
|---------|---------|---------|--------|
| 用户认证系统 | ✅ | ✅ | 100% |
| 商品系统 | ✅ | ✅ | 95% |
| 购物车 | ✅ | ✅ | 100% |
| **订单系统** | ✅ | ✅ | 100% |
| **地址管理** | ✅ | ✅ | 100% |
| 收藏功能 | ✅ | ✅ | 100% |
| 签到功能 | ✅ | ✅ | 100% |
| **优惠券系统** | ✅ | ✅ | 100% |
| 聊天系统 | ✅ | ⚠️ | 70% |
| **社区论坛** | ✅ | ❌ | 30% |
| **通知系统** | ✅ | ❌ | 30% |
| **评价系统** | ✅ | ❌ | 40% |
| **勋章系统** | ✅ | ❌ | 20% |
| **拍卖系统** | ✅ | ❌ | 10% |
| **价格提醒** | ✅ | ❌ | 10% |
| **推荐系统** | ✅ | ❌ | 10% |
| **管理后台** | ✅ | ⚠️ | 50% |

**总体完成度**：约 **75%**（后端95%，前端55%）

---

## 🚧 待完成优化

### 前端优先开发任务
1. **高优先级**：通知中心、优惠券系统、评价系统
2. **中优先级**：社区论坛、积分记录、浏览历史
3. **低优先级**：拍卖系统、求购系统、推荐系统展示

### 其他优化
- [ ] 单元测试与集成测试
- [ ] 性能优化与缓存
- [ ] 生产环境部署配置
- [ ] Docker容器化部署

## 🔒 安全建议

### 生产环境部署
- 修改 JWT Secret Key 为强密码
- 启用 HTTPS
- 配置生产环境数据库密码
- 配置文件上传限制
- 配置日志系统
- 定期数据库备份
- 配置防火墙规则
- 启用访问日志审计

### 数据安全
- 敏感数据加密存储
- 定期安全漏洞扫描
- 数据库主从备份
- 文件异地备份

## 📚 文档说明

- [docs/features.md](docs/features.md) - 详细功能说明
- [docs/architecture.md](docs/architecture.md) - 技术架构设计
- [docs/database.md](docs/database.md) - 数据库设计文档
- [docs/api.md](docs/api.md) - 完整的 API 接口文档（90+ 接口）
- [.trae/documents/prd.md](.trae/documents/prd.md) - 产品需求文档
- [.trae/documents/arch.md](.trae/documents/arch.md) - 技术设计文档

## 💡 项目特色

1. **功能超全** - 涵盖电商平台所有核心功能模块
2. **架构完善** - 前后端分离，分层架构，易于扩展
3. **数据库设计** - 40+数据表，关系设计合理
4. **文档齐全** - 功能、架构、数据库文档完整
5. **权限控制** - 完整的 RBAC 权限控制系统
6. **安全防护** - 多重安全防护措施
7. **代码规范** - 遵循最佳实践，代码结构清晰

## 📄 许可证

MIT License

## 📝 更新日志

### 2026-06-08
- 🛒 **完善购物车系统**：
  - 修复购物车选中状态保存问题
  - 添加购物车全选/取消全选功能
  - 修复结算页商品数量显示问题（不再重新拉取覆盖选中状态）
  - 添加调试日志，优化购物车状态管理
- 🎁 **完善优惠券系统**：
  - 修复优惠券折扣计算（支持固定金额、百分比、免邮券）
  - 优惠券详情弹窗，显示完整信息（有效期、使用规则、领取时间）
  - 修复优惠券已领取状态判断（加载所有状态的用户优惠券）
  - 优惠券状态标签区分（未使用/已使用/已过期）
- 📋 **完善订单系统**：
  - 订单结算页地址管理（添加新地址、选择地址）
  - 订单结算页优惠券选择（可选择不使用优惠券）
  - 订单创建时正确应用优惠券折扣
  - 订单详情页显示完整优惠券信息
  - 修复地址API，支持JSON请求体（不再使用FormData）
- 🎨 **UI优化**：
  - 购物车商品选中状态蓝色背景高亮
  - 优惠券卡片样式优化
  - 订单页地址列表优化
- 📄 **文档更新**：
  - 更新README，标记已完成功能
  - 更新功能完成度统计（总体75%）
  - 列出待实现功能清单

### 2026-06-07
- 📦 完善商品库存管理系统：
  - 更新商品发布/编辑API，支持库存字段输入
  - 商品列表和详情页显示库存信息
  - 库存为0时自动禁用购买按钮
  - 购物车数量修改时检查库存限制
  - 下单时自动扣减库存，取消订单时自动恢复库存
- 🏷️ 新增商品标签功能：
  - SQL初始化脚本更新，为所有测试商品添加标签
  - 商品列表显示商品分类标签
- 🔍 实现商品分类筛选功能：
  - 前端商品列表页添加分类筛选组件
  - 支持按分类筛选商品（包括"全部"选项）
  - 选中分类高亮显示
- ✅ 修复签到功能问题：
  - 解决日期处理错误（AttributeError: 'datetime.date' 没有 'date' 属性）
  - 优化日期类型检查逻辑，同时兼容 datetime 和 date 两种类型
  - 完善签到奖励机制，增加里程碑奖励
  - 优化签到成功提示，显示详细奖励信息
  - 添加签到奖励说明和积分用途说明卡片
- 📋 更新SQL初始化脚本：
  - 商品初始化数据添加 stock 和 tags 字段
  - 为每个测试商品设置合理的库存数量（2-12件）
  - 为每个测试商品添加相关标签（JSON格式）
  - 添加商品所在城市信息

### 2026-06-06
- 🔧 修复密码加密问题：移除 passlib 依赖，直接使用 bcrypt 库（解决兼容性和 $2b$ 哈希问题）
- ✅ 修复数据库密码哈希：更新 init.sql，所有测试用户和管理员使用正确生成的 bcrypt 哈希
- 📄 创建完整 API 文档：新增 docs/api.md，包含 90+ 接口详细说明
- 🐛 修复分类接口：解决 ORM 对象无法序列化为 JSON 的问题（改用手动转换为字典）
- 🔌 添加消息模块的 get_user_from_token 函数：用于 WebSocket 认证
- 📁 配置文件路径修复：调整 core/config.py 的 env_file 读取路径
- 📋 文档更新：完善 README，添加 API 文档链接和功能更新记录

### **技术交流**

QQ 群：924011041（欢迎加入交流）