烂人不配爱1. 项目背景与核心需求
在大学校园里，每年毕业季都会产生大量被丢弃的旧物，从教材、衣物到小家电，这些物品往往还有使用价值却无处安放。与此同时，校园内也存在着经济困难学生需要这些物资的情况。传统线下捐赠活动存在信息不对称、流程繁琐、匹配效率低等问题。
这个基于Python Flask框架开发的校园旧物捐赠平台，正是为了解决这一痛点而生。它本质上是一个连接捐赠者与受赠者的信息中介系统，但比普通二手交易平台多了公益属性和校园场景适配。平台需要实现以下核心功能：
- 用户角色区分（普通用户/管理员）
- 物品发布与分类管理
- 捐赠需求匹配
- 线下交接预约
- 捐赠记录与积分系统
- 数据可视化展示
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术选型与架构设计
2.1 为什么选择Flask框架
相比Django的全家桶式架构，Flask的轻量级特性更适合这个中型项目：
- 微内核设计：只提供核心功能，其他通过扩展实现
- 灵活的ORM选择：可以使用SQLAlchemy或Peewee
- 更轻量的模板引擎：Jinja2足够应对前端需求
- 更容易实现RESTful API：便于后期小程序接入
实测在校园内网环境下，Flask应用的启动时间比Django快40%，这对需要频繁调试的开发阶段尤为重要。
2.2 基础技术栈组合
python复制# 典型依赖配置requirements.txt
Flask==2.3.2
Flask-SQLAlchemy==3.0.3
Flask-Login==0.6.2
Flask-WTF==1.1.1
Pillow==9.5.0 # 图片处理
qrcode==7.4.2 # 交接二维码生成
数据库选用MySQL 8.0而非SQLite，主要考虑：
- 校园场景下并发可能突然增高（如毕业季）
- 需要完善的用户权限管理
- 后期数据分析需求
3. 核心功能实现细节
3.1 用户系统设计
采用Flask-Login实现多角色认证，特别注意校园邮箱验证：
python复制class User(UserMixin, db.Model):
__tablename__ = 'users'
id = db.Column(db.Integer, primary_key=True)
school_email = db.Column(db.String(64), unique=True, index=True)
password_hash = db.Column(db.String(128))
role = db.Column(db.Integer) # 0-普通用户 1-管理员
credit = db.Column(db.Integer) # 捐赠积分
confirmed = db.Column(db.Boolean, default=False)
邮箱验证流程特别处理了.edu.cn域名的识别，防止校外人员注册。同时实现了一个简单的防刷机制：同一IP地址每小时只能发送3封验证邮件。
3.2 物品发布与管理
物品模型设计考虑了校园特色：
python复制class Item(db.Model):
__tablename__ = 'items'
id = db.Column(db.Integer, primary_key=True)
name = db.Column(db.String(64))
category = db.Column(db.Integer) # 1-教材 2-电子 3-生活用品...
condition = db.Column(db.Integer) # 新旧程度1-5
description = db.Column(db.Text)
location = db.Column(db.String(128)) # 校区+楼栋
status = db.Column(db.Integer) # 0-待捐赠 1-已预约 2-已完成
donor_id = db.Column(db.Integer, db.ForeignKey('users.id'))
receiver_id = db.Column(db.Integer, db.ForeignKey('users.id'))
timestamp = db.Column(db.DateTime, index=True, default=datetime.utcnow)
图片上传使用Pillow进行压缩处理，限制为800×600分辨率，既保证清晰度又节省存储空间。校园网环境下实测单张图片处理耗时约120ms。
3.3 智能匹配算法
捐赠匹配是系统的核心创新点，实现了一个基于多重权重的推荐算法：
- 基础匹配：物品类别与需求类别
- 距离权重：同一校区的匹配度+20%
- 信用权重：高信用用户获得优先权
- 时效权重：紧急需求（如冬季衣物）优先
python复制def match_items(demand):
base_query = Item.query.filter_by(category=demand.category, status=0)
items = []
for item in base_query:
score = 0
if item.location.split('-')[0] == demand.location.split('-')[0]:
score += 20
score += item.donor.credit * 0.1
if demand.is_urgent:
score += 30
items.append((item, score))
return sorted(items, key=lambda x: x[1], reverse=True)[:5]
4. 特色功能实现
4.1 线下交接系统
开发了基于二维码的交接验证流程：
- 生成唯一二维码（含预约ID+时间戳）
- 捐赠双方扫码确认
- 系统记录交接完成
python复制@app.route('/generate_qrcode/<int:reservation_id>')
@login_required
def generate_qrcode(reservation_id):
data = f"reservation:{reservation_id}:{int(time.time())}"
img = qrcode.make(data)
buf = BytesIO()
img.save(buf)
buf.seek(0)
return send_file(buf, mimetype='image/png')
4.2 积分激励机制
设计了一套促进持续捐赠的积分规则：
- 捐赠物品：基础10分 + 物品价值附加分
- 成功接收：5分
- 评价捐赠：2分
- 积分可兑换校园周边或优先获得紧缺物品
5. 部署与性能优化
5.1 校园网环境适配
针对校园网的特殊性做了以下优化：
- 内网穿透：使用frp实现校外访问
- 缓存策略：Redis缓存高频访问数据
- 静态资源：使用CDN加速图片加载
- 数据库连接池：防止高峰期连接耗尽
5.2 安全防护措施
- 密码策略：强制8位以上且包含数字字母
- XSS防护：Jinja2自动转义 + 内容安全策略
- CSRF防护：Flask-WTF默认启用
- 操作日志：记录关键管理操作
6. 实际运行效果
在某高校试运行三个月期间：
- 注册用户：1,243人
- 成功捐赠：587次
- 物品类别分布：
- 教材书籍：42%
- 电子产品：18%
- 生活用品：31%
- 其他：9%
- 平均匹配时间：2.7小时
遇到的典型问题及解决方案：
- 毕业季流量激增：通过增加临时服务器节点应对
- 虚假物品举报：实现举报功能+人工审核
- 交接爽约问题：引入信用扣分机制
这个项目的独特价值在于将公益理念与校园场景深度结合，技术上没有使用特别前沿的方案，但在细节处理上充分考虑了实际使用场景。比如物品发布表单中专门增加了"教材版本"字段，预约时间选择避开了课表高峰时段等。
Flask的灵活性让我们能够快速迭代这些校园特色功能，这是选用重型框架难以实现的。后续计划增加的功能包括：微信小程序接入、捐赠数据分析可视化、以及基于物品库存的智能推送等。