🌿 VITA - 校园可持续生活平台

让可持续成为每一个校园人的生活方式

VITA 是一个面向大学校园的资源循环平台，通过二手交易市场、社区论坛和绿色积分体系，将可持续理念融入日常校园生活。

---

✨ 功能概览

🛍️ 二手交易市场

商品发布与浏览 · 智能搜索与多维筛选 · 图片上传自动压缩 · 完整订单流程

💬 社区论坛

校园论坛 / 世界论坛双频道 · 环保话题讨论 · 跨校交流 · 帖子置顶/锁定

🌱 绿色积分体系

参与环保活动获取积分 · 积分商城兑换周边 · 积分充值与退款管理

🎨 四套主题皮肤

主题	风格
🌞 Bright	清新明亮
🌙 Night	深邃暗色
🌲 Forest	森林绿意
🍯 Cream	暖黄奶油

🔐 安全与权限

JWT 认证 · 校园邮箱(.edu)注册验证 · 三级权限体系（学生/教师/管理员）

---

📷 界面预览

首页

二手市场

商品详情

全球论坛

积分商城

个人中心

管理后台

登录页面

---

🏗️ 技术架构

前端  React 18 + TypeScript + Vite
      ├─ Tailwind CSS          样式框架
      ├─ Ant Design            UI 组件库
      ├─ Zustand               状态管理
      ├─ React Query           数据请求
      ├─ Framer Motion         交互动效
      ├─ i18next               国际化
      └─ Axios                 HTTP 客户端

后端  Flask 3.0 + SQLAlchemy
      ├─ Flask-JWT-Extended    JWT 认证
      ├─ Flask-CORS            跨域支持
      ├─ Flask-Migrate         数据库迁移
      ├─ Pillow                图片处理
      └─ Werkzeug              安全工具

数据库  MySQL（双节点架构）
        ├─ Root Node            全局用户认证、帖子索引
        └─ University Node      各校区独立数据库

---

🚀 快速启动

环境要求

• Node.js ≥ 18.0.0
• Python ≥ 3.10
• MySQL ≥ 8.0

后端启动

cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
flask db upgrade
python run.py

后端运行于 http://localhost:8065

前端启动

cd frontend
npm install
cp .env.example .env
npm run dev

前端运行于 http://localhost:5173

---

📁 项目结构

VITA/
├── backend/
│   ├── app/
│   │   ├── models.py           # 数据模型
│   │   ├── routes/             # API 路由
│   │   │   ├── auth.py         # 认证模块
│   │   │   ├── items.py        # 商品模块
│   │   │   ├── forum.py        # 论坛模块
│   │   │   ├── admin.py        # 管理后台
│   │   │   └── upload.py       # 文件上传
│   │   ├── config.py
│   │   └── extensions.py
│   └── run.py
├── frontend/
│   ├── src/
│   │   ├── components/         # 公共组件
│   │   ├── pages/              # 页面
│   │   ├── services/           # API 服务
│   │   ├── stores/             # 状态管理
│   │   ├── hooks/              # 自定义 Hooks
│   │   ├── locales/            # 国际化语言包
│   │   └── types/              # TypeScript 类型
│   └── package.json
├── config/
│   └── universities.yaml        # 校区节点配置
├── screenshots/                 # 界面截图
└── README.md

---

✅ 已完成功能

模块	功能
用户系统	注册（校园邮箱验证）、登录、JWT 认证、权限控制
交易市场	商品发布、图片上传、搜索筛选、购买流程、订单管理
社区论坛	发帖/回复、点赞评论、置顶/锁定、跨校论坛
个人中心	积分管理、数据统计、我的商品、我的订单、通知中心
管理后台	用户管理、商品审核、帖子管理、订单管理、积分配置、数据统计
主题系统	四套主题切换（中英双语）

---

🔐 安全措施

密码强度验证 · 哈希加密存储 · JWT Token 认证 · CORS 跨域保护 · SQL 注入防护 · XSS 攻击防护

---

👥 团队成员

成员	职责	主要工作
黄天	系统架构师	数据库设计、系统架构
崔洪涵	后端开发	Flask API、安全策略
杨浩泽	前端开发	React UI、用户体验

---

📝 开发计划

• 基础设施搭建
• 用户认证系统
• 二手交易功能
• 社区论坛功能
• 管理后台
• 主题系统
• 移动端优化
• 实时消息推送
• 数据可视化
• 性能优化
• 单元测试

---

📄 License

MIT License · © 2024 VITA Team