# code-hub

**Repository Path**: Easyhappy-123/code-hub

## Basic Information

- **Project Name**: code-hub
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-07
- **Last Updated**: 2026-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Code Hub - 开发者社区平台

<p align="center">
  <img src="https://img.shields.io/badge/version-1.0.0-blue.svg" alt="Version">
  <img src="https://img.shields.io/badge/Spring%20Boot-3.2.0-green.svg" alt="Spring Boot">
  <img src="https://img.shields.io/badge/Vue-3.4-orange.svg" alt="Vue">
  <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License">
</p>

> 🚀 Code Hub 是一个面向开发者的综合性社区平台，旨在帮助开发者发现优质编程资源、分享技术心得、解答开发疑惑。

## 📚 项目简介

Code Hub 提供以下核心功能：

| 模块 | 功能描述 |
|------|----------|
| ⚡ 资源导航 | 用户分享、发现、收藏编程资源（文章、开源项目、工具等） |
| 📖 技术博客 | 发布技术文章、教程、Markdown编辑器、文章分类与标签 |
| ❓ 问答社区 | 提问、回答、最佳答案采纳、悬赏机制 |
| 🤖 AI问答 | 集成大模型API，智能问答辅助功能 |
| 👥 用户社交 | 关注、点赞、收藏、评论、私信、通知系统 |
| 👑 用户权限 | 普通用户、VIP用户、管理员等多角色权限体系 |

## 🛠️ 技术栈

### 后端技术栈

- **核心框架**: Spring Boot 3.2.0
- **语言**: Java 17
- **ORM框架**: MyBatis 3.5 + MyBatis-Plus 3.5
- **数据库**: MySQL 8.0
- **安全框架**: Spring Security + JWT
- **API文档**: Knife4j 4.3.0
- **工具库**: Lombok, Hutool, FastJSON2

### 前端技术栈

- **核心框架**: Vue 3 (Composition API)
- **语言**: TypeScript 5.x
- **构建工具**: Vite 5.x
- **UI组件库**: Ant Design Vue 4.x
- **路由管理**: Vue Router 4.x
- **状态管理**: Pinia 2.x
- **HTTP客户端**: Axios

## 📂 项目结构

```
code-hub/
├── code-hub-backend/              # 后端项目
│   ├── code-hub-common/          # 公共模块（工具类、统一响应、异常处理）
│   ├── code-hub-model/           # 数据模型（实体类、DTO、VO）
│   ├── code-hub-mapper/          # 数据访问层（Mapper接口）
│   ├── code-hub-service/         # 业务逻辑层（Service）
│   ├── code-hub-controller/       # 控制层（REST API）
│   ├── code-hub-starter/          # 启动模块
│   └── docs/                      # 项目文档（SQL脚本等）
├── code-hub-frontend/             # 前端项目
│   └── src/
│       ├── api/                   # API接口封装
│       ├── assets/                # 静态资源
│       ├── components/            # 公共组件
│       ├── layouts/               # 布局组件
│       ├── router/                # 路由配置
│       ├── stores/                # Pinia状态管理
│       ├── types/                 # TypeScript类型定义
│       ├── utils/                 # 工具函数
│       └── views/                 # 页面组件
└── README.md
```

## 🚀 快速开始

### 环境要求

- JDK 17+
- Node.js 18+
- MySQL 8.0+
- Maven 3.8+

### 1. 初始化数据库

```bash
# 登录 MySQL
mysql -u root -p

# 执行数据库初始化脚本
source docs/code_hub.sql
```

### 2. 启动后端服务

```bash
cd code-hub-backend

# 安装依赖并打包
mvn clean install

# 启动应用
cd code-hub-starter
mvn spring-boot:run

# 或打包后运行
java -jar target/code-hub-starter-1.0.0.jar
```

后端启动后，访问 API 文档：http://localhost:8080/api/doc.html

### 3. 启动前端服务

```bash
cd code-hub-frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

前端启动后，访问：http://localhost:3000

## 📋 分阶段开发计划

### 第一期（MVP）✅ 已完成
- [x] 项目结构搭建
- [x] 数据库设计
- [x] 用户注册/登录
- [x] 资源分类管理
- [x] 资源 CRUD
- [x] 资源收藏/点赞
- [x] 前端基础页面

### 第二期（规划中）
- [ ] 技术博客模块
- [ ] 评论互动
- [ ] 关注与粉丝
- [ ] 通知系统

### 第三期（规划中）
- [ ] 问答社区模块
- [ ] 悬赏机制
- [ ] AI 智能问答
- [ ] 对话历史

### 第四期（规划中）
- [ ] VIP 会员体系
- [ ] 积分系统
- [ ] 付费内容
- [ ] 管理后台

## 🔐 默认账号

| 角色 | 用户名 | 密码 |
|------|--------|------|
| 管理员 | admin | 123456 |

## 📝 API 文档

启动后端服务后，访问 Knife4j API 文档：

- 地址：http://localhost:8080/api/doc.html
- 离线文档：`code-hub-backend/docs/`

## 📄 开发规范

### 命名规范
- 类名：大驼峰（UserService）
- 方法名：小驼峰（getUserById）
- 包名：全小写（com.codehub.service）

### 分支管理
- main: 主分支
- feature/*: 功能分支
- fix/*: 修复分支

### Commit 规范
```
feat: 新功能
fix: 修复bug
docs: 文档更新
style: 代码格式
refactor: 重构
test: 测试
chore: 构建/工具
```

## 📜 许可证

本项目基于 MIT 许可证开源。

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

## 📧 联系方式

- 邮箱：support@codehub.com
- 官网：https://codehub.com

---

<p align="center">Made with ❤️ by Code Hub Team</p>