文档
Dev guide网站开发计划与进度跟踪

网站开发计划与进度跟踪

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

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

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

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

🎯 项目愿景

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

核心价值

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

📊 总体进度概览

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

🎯 里程碑检查点

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

🎯 功能概要进度

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

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

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

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

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

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

📋 详细功能进度

✅ 基础设施 (100%)

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

🚧 认证系统 (90%)

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

🚧 Landing Page (10%)

  • [x] 简单的展示页面
  • [ ] 补充更多照片和说明
  • [ ] 完善的展示页面（可对外）
  • [ ] 优化展示内容

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

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

用户注册/登录 ✅ 已完成

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

个人资料管理 🚧 开发中

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

CP值系统 📋 计划中

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

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

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

活动发布 📋 计划中

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

活动报名 📋 计划中

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

活动管理 📋 计划中

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

✅ 社区文档 (80%)

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

文档系统 ✅ 已完成

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

内容管理 ✅ 已完成

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

社区治理 📋 计划中

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

其他内容维护

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

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

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

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

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

贡献申报 📋 计划中

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

审核流程 📋 计划中

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

贡献展示 📋 计划中

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

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

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

成员列表 📋 计划中

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

成员详情 📋 计划中

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

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

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

项目提交 📋 计划中

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

项目展示 📋 计划中

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

🔄 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 | 维护者: 开发团队

Tiptap 富文本编辑器

Previous Page

基于 Better Auth Next.js 实现微信双端登录：踩坑指南与完整实现

Next Page

On this page

No Headings