文档

网站开发计划与进度跟踪

社区官网的规划、开发进度和实时状态跟踪

注意⚠️:本文档暂停维护,以实际功能为准

🚀 网站开发计划与进度跟踪

社区官网的完整开发文档。包含项目愿景、功能规划、实时进度和详细任务清单,为开发团队提供清晰的方向和进度跟踪。

🎯 项目愿景

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

核心价值

  • 连接: 让全球的技术爱好者能够轻松找到彼此
  • 协作: 提供便捷的工具支持项目协作和知识分享
  • 成长: 通过贡献系统激励成员持续参与和成长
  • 开放: 保持开源精神,欢迎所有人参与贡献

📊 总体进度概览

  • 项目启动: ✅ 2025年7月
  • 当前阶段: Phase 1 - 核心功能开发
  • 预计完成: 2025年9月初
  • 整体进度: 25% (基础设施和认证系统基本完成)

🎯 里程碑检查点

  • 2025-8 第 4 周结束: MVP功能完整,可以进行内部测试

🎯 功能概要进度

Phase 1: 基础功能 (MVP) - 优先级: 🔥 高

  • 基础设施
  • 认证系统
  • 社区组织系统
  • 用户中心
  • 活动系统
  • 社区文档
  • 贡献系统
  • 成员名录
  • *项目展示
  • Landing Page
  • 用户引导流程
  • 超级管理员-社区管理界面
    • 数据统计系统(月活、用户增长等)
    • 用户管理功能增强
    • 活动数据分析
  • 企业微信接入

Phase 2: 增强功能 - 优先级: 🟡 中

  • 通知系统 (0%) - 📋 计划中,目前只有邮件通知
  • 搜索功能 (0%) - 📋 计划中
  • 社区角色标签 + 荣誉系统 (0%) - 📋 计划中
    • 创作者经验等级系统
    • 会员等级设计(根据MVP进度)
    • 角色标签展示
  • 黑客松周报系统 (0%) - 📋 计划中
    • 周报发布功能
    • 周报订阅管理
    • 周报内容管理
  • 管理后台增强 (0%) - 📋 计划中,目前暂时由超级管理员直接修改数据库

Phase 3: 高级功能 - 优先级: 🟢 低

  • 社区分部 (0%)
  • 积分商城 (0%): 可以通过贡献值兑换社区积分
  • 论坛功能 (0%): 需要实名审核和备案

📋 详细功能进度

✅ 基础设施 (100%)

  • Next.js 项目搭建
  • TypeScript 配置
  • Tailwind CSS + shadcn/ui 集成
  • Better Auth 认证系统配置
  • PostgreSQL + Prisma 数据库配置
  • Hono API 后端配置
  • 国际化 (中文/英文) 支持
  • 基础页面结构 (marketing/dashboard/auth)
  • 文档系统 (MDX 支持)

🚧 认证系统 (90%)

  • 邮箱密码登录
  • Google OAuth 登录
  • GitHub OAuth 登录
  • 用户注册流程
  • 密码重置功能
  • 邮箱验证 (已临时禁用)
  • 微信登录
  • 手机号登录

🚧 Landing Page (10%)

  • 简单的展示页面
  • 补充更多照片和说明
  • 完善的展示页面(可对外)
  • 优化展示内容

🚧 用户中心 (30%) → 详细需求文档

目标: 让用户能够注册、登录并管理个人信息

用户注册/登录 ✅ 已完成

  • 邮箱注册 (Better Auth)
  • GitHub/Google 第三方登录
  • 邮箱验证 (暂时禁用)

个人资料管理 🚧 开发中

  • 基础用户模型
  • 用户列表管理
  • 管理员权限系统
  • 用户资料扩展 (分部、技能、CP值)
  • 个人资料页面
  • 基础信息编辑 (姓名、邮箱、头像)
  • 扩展信息 (分部、技能、个人简介)
  • CP值显示和历史记录 (Contribution Point)

CP值系统 📋 计划中

  • CP值计算规则
  • 贡献记录追踪
  • 等级系统设计

📋 活动系统 (0%) → 详细需求文档

目标: 支持线下活动的发布、报名和管理

活动发布 📋 计划中

  • 活动基础信息 (标题、描述、时间、地点)
  • 分部标签和分类
  • 报名人数限制
  • 活动图片上传
  • 活动数据模型设计

活动报名 📋 计划中

  • 一键报名功能
  • 报名状态管理
  • 报名列表查看
  • 取消报名功能
  • 自定义报名问题

活动管理 📋 计划中

  • 组织者管理界面
  • 参与者名单导出
  • 活动状态更新
  • 活动数据统计
  • 签到功能
  • 活动反馈收集

✅ 社区文档 (80%)

目标: 提供完整的社区治理和开发文档

文档系统 ✅ 已完成

  • 基于 Fumadocs 的文档站点
  • Markdown 支持
  • 响应式设计

内容管理 ✅ 已完成

  • 文档导航优化
  • 全文搜索功能
  • 移动端适配改进

社区治理 📋 计划中

  • 社区规范文档
  • 贡献指南
  • 行为准则

其他内容维护

  • 联系我们
  • 博客系统
  • ChangeLog

律师审核相关隐私政策和法律条款

  • 隐私政策
  • 法律条款
  • 参考合同

📋 贡献申报系统 (0%) → 详细需求文档

目标: 让成员能够申报贡献并获得CP值奖励

贡献申报 📋 计划中

  • 贡献类型分类 (代码、文档、活动组织等)
  • 申报表单设计
  • 证据材料上传
  • 贡献数据模型设计

审核流程 📋 计划中

  • 管理员审核界面
  • 审核状态通知
  • CP值自动发放
  • 审核工作流设计

贡献展示 📋 计划中

  • 个人贡献历史
  • 社区贡献排行榜
  • 贡献统计图表

📋 成员名录 (0%) → 详细需求文档

目标: 展示社区成员信息,促进相互了解

成员列表 📋 计划中

  • 成员基础信息展示
  • 按分部筛选
  • 按技能筛选
  • 搜索功能
  • 发现推荐系统

成员详情 📋 计划中

  • 个人主页设计
  • 贡献记录展示
  • 参与活动历史
  • 联系方式 (可选)
  • 社交互动功能

📋 项目展示 (0%) → 详细需求文档

目标: 展示社区成员的优秀项目

项目提交 📋 计划中

  • 项目基础信息
  • 技术栈标签
  • 项目链接和截图
  • 项目数据模型设计
  • 项目协作者管理

项目展示 📋 计划中

  • 项目列表页面
  • 项目详情页面
  • 按技术栈筛选
  • 项目评分系统
  • 项目推荐算法

🔄 Phase 2 & 3 功能规划

Phase 2: 增强功能 - 优先级: 🟡 中

📋 通知系统 (0%)

  • 站内通知
  • 邮件通知
  • 活动提醒
  • 审核结果通知

📋 搜索功能 (0%)

  • 全站搜索
  • 用户搜索
  • 活动搜索
  • 项目搜索

📋 管理后台增强 (0%)

  • 用户管理
  • 活动管理
  • 内容管理
  • 数据统计

Phase 3: 高级功能 - 优先级: 🟢 低

📋 社区分部 (0%) → 详细需求文档

  • 分部页面
  • 分部负责人
  • 本地化活动

📋 积分商城 (0%)

  • CP值兑换
  • 虚拟商品
  • 实物奖励

📋 社交功能 (0%)

  • 用户关注
  • 活动评论
  • 项目点赞

小程序适配

  • 通过嵌入 webview 的方式发布一个小程序
  • 支持微信登录
  • 支持微信支付
  • 支持微信分享
  • 支持企业微信客服

🐛 已知问题

  1. 邮箱验证临时禁用

    • 状态: 已临时禁用
    • 计划: 开发完成后重新启用
    • 位置: src/lib/auth/auth.ts:122
  2. 组织系统集成

    • 状态: 已有组织系统,需要与社区分部功能整合
    • 进度: 80% (组织创建、成员邀请、角色权限已完成)
    • 待办: 社区分部功能适配

🎯 成功指标

技术指标

  • 性能: 页面加载时间 < 2秒
  • 可用性: 99.9% 正常运行时间
  • 安全性: 通过基础安全审计
  • 兼容性: 支持主流浏览器和移动设备

业务指标

  • 用户注册: 100+ 活跃用户
  • 活动发布: 10+ 活动成功举办
  • 贡献申报: 50+ 贡献记录
  • 项目展示: 20+ 项目提交

🚀 后续规划

长期愿景 (6个月+)

  • 国际化: 支持多语言
  • 移动应用: 开发原生移动应用
  • API开放: 提供开放API供第三方集成
  • 数据分析: 深度数据分析和洞察
  • AI功能: 智能推荐和匹配

📞 参与开发

如何开始

  1. 阅读文档: 快速开始指南
  2. 开始贡献: 选择感兴趣的功能开始开发

贡献方式

  • 🐛 Bug修复: 发现并修复问题
  • 功能开发: 实现新功能
  • 📖 文档改进: 完善开发文档
  • 🎨 UI/UX优化: 改进用户体验
  • 🧪 测试: 编写和执行测试用例

最后更新: 2025-09-01 | 维护者: 开发团队

On this page

🚀 网站开发计划与进度跟踪🎯 项目愿景核心价值📊 总体进度概览🎯 里程碑检查点🎯 功能概要进度Phase 1: 基础功能 (MVP) - 优先级: 🔥 高Phase 2: 增强功能 - 优先级: 🟡 中Phase 3: 高级功能 - 优先级: 🟢 低📋 详细功能进度✅ 基础设施 (100%)🚧 认证系统 (90%)🚧 Landing Page (10%)🚧 用户中心 (30%) → 详细需求文档用户注册/登录 ✅ 已完成个人资料管理 🚧 开发中CP值系统 📋 计划中📋 活动系统 (0%) → 详细需求文档活动发布 📋 计划中活动报名 📋 计划中活动管理 📋 计划中✅ 社区文档 (80%)文档系统 ✅ 已完成内容管理 ✅ 已完成社区治理 📋 计划中其他内容维护律师审核相关隐私政策和法律条款📋 贡献申报系统 (0%) → 详细需求文档贡献申报 📋 计划中审核流程 📋 计划中贡献展示 📋 计划中📋 成员名录 (0%) → 详细需求文档成员列表 📋 计划中成员详情 📋 计划中📋 项目展示 (0%) → 详细需求文档项目提交 📋 计划中项目展示 📋 计划中🔄 Phase 2 & 3 功能规划Phase 2: 增强功能 - 优先级: 🟡 中📋 通知系统 (0%)📋 搜索功能 (0%)📋 管理后台增强 (0%)Phase 3: 高级功能 - 优先级: 🟢 低📋 社区分部 (0%) → 详细需求文档📋 积分商城 (0%)📋 社交功能 (0%)小程序适配🐛 已知问题🎯 成功指标技术指标业务指标🚀 后续规划长期愿景 (6个月+)📞 参与开发如何开始贡献方式