# hackplay-platform

**Repository Path**: chengxuru/hackplay-platform

## Basic Information

- **Project Name**: hackplay-platform
- **Description**: > 宇宙雷达 - 发现全宇宙最酷的竞赛，找到最强的队友

HackPlay 是一个现代化的竞赛开黑平台，专为程序员、数据科学家和技术爱好者设计。平台提供竞赛发现、团队组建、学习资源、项目展示等全方位服务，让你在技术竞赛的宇宙中找到属于自己的星辰大海。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-08-10
- **Last Updated**: 2025-09-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HackPlay - 竞赛开黑平台 🚀

> 宇宙雷达 - 发现全宇宙最酷的竞赛，找到最强的队友

HackPlay 是一个现代化的竞赛开黑平台，专为程序员、数据科学家和技术爱好者设计。平台提供竞赛发现、团队组建、学习资源、项目展示等全方位服务，让你在技术竞赛的宇宙中找到属于自己的星辰大海。

## ✨ 核心功能

### 🏆 竞赛发现
- **智能聚合**: 汇聚 Kaggle、天池、DevPost、Google 等主流平台竞赛
- **精准筛选**: 按类别、难度、平台、奖金等多维度筛选
- **实时更新**: 7x24小时监控竞赛动态，第一时间获取最新信息
- **个性推荐**: 基于技能标签和历史参赛记录的智能推荐

### 👥 开黑大厅
- **技能匹配**: 基于技能互补的智能队友推荐
- **实时聊天**: 内置聊天系统，快速沟通协作
- **团队管理**: 完整的团队创建、邀请、管理流程
- **历史记录**: 详细的组队历史和成绩追踪

### 📅 竞赛日历
- **可视化时间线**: 7日冲刺视图，直观展示竞赛时间安排
- **智能提醒**: 报名截止、比赛开始等关键节点提醒
- **跨平台同步**: 支持导出到个人日历应用
- **冲突检测**: 自动检测时间冲突的竞赛

### 📚 学习中心
- **技能路径**: 针对不同竞赛类型的学习路径规划
- **实战课程**: 由竞赛获奖者分享的实战经验课程
- **进度追踪**: 详细的学习进度和成就系统
- **社区互动**: 学习笔记分享和讨论

### 💬 讨论社区
- **技术交流**: 算法讨论、代码分享、经验交流
- **队友招募**: 发布招募信息，寻找志同道合的队友
- **竞赛复盘**: 比赛结束后的总结和反思分享
- **热门话题**: 实时热门技术话题和趋势分析

### 🗂️ 项目展示
- **作品集**: 展示参赛项目和个人作品
- **代码托管**: 集成 GitHub，直接展示代码仓库
- **成果分享**: 项目演示、技术文档、设计思路分享
- **社区评价**: 同行评价和反馈系统

### 📊 数据集市场
- **资源聚合**: 汇聚各平台优质数据集
- **智能搜索**: 按领域、格式、大小等条件搜索
- **质量评估**: 社区评分和使用反馈
- **下载统计**: 热门数据集排行和趋势分析

### 🎯 活动中心
- **线上活动**: 技术分享会、经验交流会、模拟竞赛
- **线下聚会**: 本地技术聚会和面基活动
- **官方活动**: 平台举办的特色活动和挑战赛
- **第三方活动**: 合作伙伴和社区组织的活动

## 🛠️ 技术架构

### 前端技术栈
- **框架**: Next.js 14 (App Router)
- **语言**: TypeScript
- **样式**: Tailwind CSS + CSS Modules
- **动画**: Framer Motion
- **组件库**: Radix UI + shadcn/ui
- **状态管理**: React Hooks + Context
- **国际化**: 自定义 i18n 解决方案

### 后端技术栈
- **框架**: FastAPI (Python)
- **数据库**: PostgreSQL + Redis
- **认证**: JWT + OAuth2
- **文件存储**: MinIO (S3兼容)
- **任务队列**: Celery + Redis
- **API文档**: OpenAPI/Swagger

### 基础设施
- **容器化**: Docker + Docker Compose
- **部署**: Vercel (前端) + 云服务器 (后端)
- **监控**: 自定义监控面板
- **日志**: 结构化日志系统

## 🚀 快速开始

### 环境要求
- Node.js 18+
- Python 3.11+
- PostgreSQL 15+
- Redis 7+
- Docker (可选)

### 前端启动

```bash
cd frontend
npm install
npm run dev
```

访问 http://localhost:3000

### 后端启动

```bash
cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn app.main:app --reload
```

访问 http://localhost:8000

### Docker 一键启动

```bash
docker-compose up -d
```

## 📱 功能特色

### 🎨 现代化UI设计
- **毛玻璃效果**: 现代化的视觉设计语言
- **深色主题**: 护眼的深色界面设计
- **响应式布局**: 完美适配桌面端和移动端
- **流畅动画**: 基于 Framer Motion 的丝滑动画效果

### 🌍 国际化支持
- **多语言**: 支持中文和英文界面
- **本地化**: 时间、数字、货币格式本地化
- **动态切换**: 实时语言切换，无需刷新页面

### ⚡ 性能优化
- **SSR/SSG**: Next.js 服务端渲染和静态生成
- **代码分割**: 自动代码分割和懒加载
- **图片优化**: Next.js Image 组件优化
- **缓存策略**: 多层缓存提升响应速度

### 🔒 安全保障
- **JWT认证**: 安全的用户认证机制
- **权限控制**: 细粒度的权限管理
- **数据加密**: 敏感数据加密存储
- **安全头**: 完整的安全响应头配置

## 📊 项目结构

```
hackplay-platform/
├── frontend/                 # 前端应用
│   ├── app/                 # Next.js App Router
│   │   ├── page.tsx         # 首页
│   │   ├── calendar/        # 竞赛日历
│   │   ├── lobby/           # 开黑大厅
│   │   ├── learn/           # 学习中心
│   │   ├── discuss/         # 讨论社区
│   │   ├── projects/        # 项目展示
│   │   ├── datasets/        # 数据集市场
│   │   ├── events/          # 活动中心
│   │   ├── profile/         # 个人资料
│   │   └── create/          # 发布竞赛
│   ├── components/          # 可复用组件
│   │   ├── ui/              # 基础UI组件
│   │   ├── navigation.tsx   # 导航组件
│   │   ├── hack-card.tsx    # 竞赛卡片
│   │   └── ...
│   ├── lib/                 # 工具库
│   │   ├── i18n.ts          # 国际化配置
│   │   └── utils.ts         # 工具函数
│   └── styles/              # 样式文件
├── backend/                 # 后端API
│   ├── app/                 # FastAPI应用
│   │   ├── api/             # API路由
│   │   ├── core/            # 核心配置
│   │   ├── models/          # 数据模型
│   │   ├── schemas/         # Pydantic模式
│   │   └── services/        # 业务逻辑
│   ├── tests/               # 测试文件
│   └── requirements.txt     # Python依赖
├── docker-compose.yml       # Docker编排
└── README.md               # 项目文档
```

## 🎯 路线图

### 🚧 开发中
- [ ] 实时聊天系统
- [ ] 移动端App
- [ ] AI智能推荐
- [ ] 区块链积分系统

### 📋 计划中
- [ ] 企业版功能
- [ ] 开放API平台
- [ ] 插件生态系统
- [ ] 多平台数据同步

## 🤝 贡献指南

我们欢迎所有形式的贡献！

### 贡献方式
1. **Bug报告**: 发现问题请提交 Issue
2. **功能建议**: 有好想法请提交 Feature Request
3. **代码贡献**: Fork 项目并提交 Pull Request
4. **文档改进**: 帮助完善项目文档
5. **设计优化**: UI/UX 设计建议和改进

### 开发流程
1. Fork 本仓库
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 📄 开源协议

本项目采用 MIT 协议开源 - 查看 [LICENSE](LICENSE) 文件了解详情

## 🙏 致谢

感谢所有为这个项目做出贡献的开发者和设计师！

特别感谢：
- [Next.js](https://nextjs.org/) - 强大的React框架
- [FastAPI](https://fastapi.tiangolo.com/) - 现代化的Python Web框架
- [Tailwind CSS](https://tailwindcss.com/) - 实用优先的CSS框架
- [Framer Motion](https://www.framer.com/motion/) - 强大的动画库
- [Radix UI](https://www.radix-ui.com/) - 无障碍的组件库

## 📞 联系我们

- **项目主页**: [HackPlay Platform](https://github.com/your-username/hackplay-platform)
- **问题反馈**: [GitHub Issues](https://github.com/your-username/hackplay-platform/issues)
- **功能建议**: [GitHub Discussions](https://github.com/your-username/hackplay-platform/discussions)

---

⭐ 如果这个项目对你有帮助，请给我们一个星标！

**让我们一起在技术竞赛的宇宙中探索无限可能！** 🌟