# dev-hub

**Repository Path**: jinguangyang/dev-hub

## Basic Information

- **Project Name**: dev-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-05-07
- **Last Updated**: 2026-05-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DevHub 开发者服务与外包平台

DevHub 是一个全栈开发者服务与外包平台，提供包管理、程序员兼职、商家外包三大核心功能，支持 Web 端和小程序端访问。

---

## 功能模块

### 1. 包管理模块
- 包列表检索（关键词、分类、语言）
- 包详情、版本管理
- 一键安装命令
- 包评论与评分
- 收藏与下载

### 2. 程序员兼职模块
- 兼职信息发布（全职/兼职/外包）
- 列表检索（技能、薪资、经验）
- 评论与评分
- 收藏与联系

### 3. 商家外包模块
- 外包项目发布（网站/小程序/APP/其他）
- 企业认证
- 项目评论与评分
- 收藏与联系

### 4. 用户增强
- 个人作品集管理
- 关注/粉丝系统
- 信用评分
- 多维评价（质量/态度/速度）
- 消息通知

---

## 技术栈

| 端 | 技术 | 说明 |
|----|------|------|
| 后端 | Spring Boot 3.2 + MyBatis-Plus | RESTful API |
| 数据库 | MySQL 8.0 + Redis | 主存储 + 缓存 |
| 认证 | JWT (jjwt 0.12.3) | Access + Refresh Token |
| Web前端 | React 18 + Vite + Ant Design 5 | Zustand 状态管理 |
| 小程序 | Taro 3.6 + React | 微信小程序 |

---

## 项目结构

```
devhub/
├── devhub-backend/          # Spring Boot 后端
│   ├── src/main/java/com/devhub/
│   │   ├── config/           # 配置类（CORS、JWT拦截器、Redis、MyBatis-Plus）
│   │   ├── controller/       # REST 控制器
│   │   ├── service/          # 业务逻辑
│   │   ├── mapper/           # MyBatis-Plus Mapper
│   │   ├── entity/           # 实体类
│   │   ├── dto/              # 数据传输对象
│   │   ├── utils/            # 工具类（JWT）
│   │   └── common/           # 全局异常、统一响应
│   └── src/main/resources/
│       ├── application.yml   # 应用配置
│       ├── schema.sql       # 初始数据库表
│       └── migrations/       # 增量迁移脚本
├── devhub-ui/               # React Web 前端
│   └── src/
│       ├── api/              # API 请求封装
│       ├── components/       # 公共组件（Layout、CommentSection、ReviewSection）
│       ├── pages/            # 页面组件
│       └── store/            # Zustand 状态管理
├── devhub-miniapp/           # Taro 微信小程序
│   └── src/
│       ├── pages/            # 页面
│       ├── services/         # API 服务
│       └── utils/            # 请求工具
├── docker-compose.yml        # Docker 编排配置
├── start.bat / start.sh      # 一键启动脚本
└── CLAUDE.md                # 开发备忘
```

---

## 快速启动

### 方式一：一键启动（推荐）

**Windows:**
```bash
start.bat
```

**Linux / macOS:**
```bash
chmod +x start.sh && ./start.sh
```

按提示选择：
- `1` — Docker Compose（全自动，推荐）
- `2` — 本地开发模式

### 方式二：纯 Docker

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

### 方式三：本地开发

```bash
# 1. 初始化数据库
mysql -u root -p < devhub-backend/src/main/resources/schema.sql
mysql -u root -p devhub < devhub-backend/src/main/resources/migrations/V2__enhance_features.sql

# 2. 启动后端
cd devhub-backend && mvn spring-boot:run

# 3. 启动 Web 前端
cd devhub-ui && npm install && npm run dev
```

### 方式四：小程序

```bash
cd devhub-miniapp-ui && npm install
npm run dev:weapp
# 用微信开发者工具导入 dist 目录
```

---

## 服务地址

| 服务 | 地址 |
|------|------|
| Web 前端 | http://localhost:3000 |
| 后端 API | http://localhost:8080 |
| MySQL | localhost:3306 |
| Redis | localhost:6379 |

---

## 测试账号

| 账号 | 密码 | 类型 | 说明 |
|------|------|------|------|
| programmer1 | 123456 | 程序员 | 可发布包、兼职 |
| programmer2 | 123456 | 程序员 | 可发布包、兼职 |
| merchant1 | 123456 | 商家 | 可发布外包项目 |

> 密码 MD5：`e10adc3949ba59abbe56e057f20f883e`（123456）

---

## API 概览

详细文档见 [API.md](API.md)

| 模块 | 前缀 | 说明 |
|------|------|------|
| 认证 | `/api/auth` | 登录/注册/登出/刷新Token |
| 包管理 | `/api/packages` | CRUD、版本管理 |
| 兼职 | `/api/jobs` | CRUD |
| 外包 | `/api/projects` | CRUD、企业认证 |
| 用户 | `/api/users` | 资料、消息、收藏、关注、作品集 |
| 评论 | `/api/comments` | 评论、回复、点赞 |
| 评价 | `/api/reviews` | 评分、多维评价 |
| 文件 | `/api/files` | 上传 |

---

## 数据库

详见 [DATABASE.md](DATABASE.md)

**主表：**
- `users` — 用户
- `packages` — 包信息
- `package_versions` — 包版本
- `programmer_jobs` — 程序员兼职
- `merchant_projects` — 商家外包
- `favorites` — 收藏
- `messages` — 消息

**增强表（V2 迁移）：**
- `reviews` — 评价
- `comments` — 评论（含嵌套回复）
- `user_portfolios` — 用户作品集
- `user_follows` — 关注关系
- `package_download_logs` — 下载记录
- `comment_likes` — 评论点赞

---

## 部署文档

详见 [DEPLOY.md](DEPLOY.md)