🏠 开发者主页

欢迎来到 Hackathon Weekly 社区网站 的开发者主页！这里是你开始贡献代码的起点。

🚀 快速导航

想加入社区网站开发？

我们欢迎大家参与到社区网站的开发中来！也欢迎有相同理念的小伙伴/各地的黑客松社区在我们的基础上进行二次开发。

我们将向公益组织/非盈利性活动提供技术支持 && 开放代码授权。商业授权需要沟通协商。

如您有意愿请邮件联系 contact@HackathonWeekly.com

邮件示例：

• 您/您组织的自我介绍，期望的合作模式
• 您擅长的技术栈
• 您为什么想要加入社区网站开发 / 获取授权
• 您的微信或其他联系方式

您将获得社区网站贡献者称号，并且跟一群志同道合的小伙伴享受并肩作战的快乐。

审核通过后，我们将邀请您加入社区代码仓库！感谢您的贡献！

📖 开发文档

• 快速开始指南: 如果你是新人/第一次参与开发，请务必阅读
• 网站开发计划 - 高层规划和功能优先级
• 常见开发问题 - 常见问题和解决方案
• 常见 AI 开发Prompt - 常见的 AI 开发 Prompt

可以如何贡献？

对于新人，建议你先尝试一些简单任务！例如

• 维护社区文档！文档中还有很多潜在的问题，例如过时信息，缺失内容，链接错误等等！
• 测试、寻找并修复网站中的 bug！例如 页面加载慢 功能失效 错误提示不友好 等等！
• 翻译社区文档！为文档以及一些 UI 组件添加多语种翻译！
• 提建议！网站开发还在很早期的阶段，如果有任何建议，欢迎提出来！发送邮件给 contact@HackathonWeekly.com

对于有经验的开发者，建议你尝试以下任务！

• 根据社区 roadmap 进行开发！看还有哪些重要的功能没有实现
• 添加你觉得有用的功能！例如 改进网站的用户界面 改进网站的后端功能 等等！

🛠️ 开发工具

• 开发服务器: http://localhost:3000
• API 文档: http://localhost:3000/api/openapi
• 数据库管理: http://localhost:5555 (Prisma Studio)

📋 项目概览

🎯 项目愿景

构建一个现代化的技术社区平台，连接全球的 Hackathon 爱好者，促进技术交流与合作。

🏗️ 技术栈

• 前端: Next.js 15 + React 19 + TypeScript
• 后端: Hono + Better Auth + Prisma
• 数据库: PostgreSQL (Neon)
• UI: shadcn/ui + Tailwind CSS
• 部署: Vercel

🌟 核心功能

• 用户系统: 注册登录、个人资料、CP值系统
• 活动系统: 活动发布、报名、分部筛选
• 文档系统: 开发文档、API文档
• 贡献系统: 贡献申报、审核、积分奖励
• 社区功能: 成员目录、项目展示

质量保证

• 每个功能开发完成后立即测试
• 保持代码风格一致性 (使用现有的shadcn/ui组件)
• 确保移动端适配
• 定期备份数据库

🔧 开发工具

常用命令

# 启动开发环境
bun dev              # 开发服务器
bun db:studio        # 数据库管理界面

# 数据库操作
bun db:push          # 同步数据库结构
bun db:generate      # 生成 Prisma 客户端

# 代码质量
bun lint             # 代码检查
bun format           # 代码格式化
bun type-check       # 类型检查

完整的命令列表和开发规范请参考 快速开始指南

🚀 开始开发

重要提示

• 📧 邮箱验证已临时禁用 (位置: src/lib/auth/auth.ts:122)
• 🔑 测试账号: 可直接注册新账号进行测试
• 📱 移动端优先: 所有功能都需要适配移动端

获取帮助

• 🐛 发现 Bug: 创建 Issue 详细描述问题
• 💡 功能建议: 在 Issue 中提出功能需求
• 🔧 代码贡献: Fork 项目，创建 PR
• 📖 文档改进: 直接编辑文档文件

FAQ

社区网站是否开源？

目前社区网站还在非常早期的阶段，正在快速迭代之中，我们希望未来在合适的时机开源。