# dev-forge

**Repository Path**: shuiabi/dev-forge

## Basic Information

- **Project Name**: dev-forge
- **Description**: 代码提升
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-11
- **Last Updated**: 2026-05-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DevForge 多模块项目

## 项目结构

```
dev-forge/                          # 父工程
├── pom.xml                         # 父POM，统一管理依赖版本
├── dev-forge-common/               # 公共模块（工具类、统一响应等）
│   ├── pom.xml
│   └── src/main/java/com/example/common/
│       ├── result/                 # 统一响应封装
│       ├── exception/              # 自定义异常
│       ├── handler/                # 全局异常处理
│       └── util/                   # 工具类
└── dev-forge-shorturl/             # 短链服务模块
    ├── pom.xml
    └── src/main/
        ├── java/com/example/shorturl/
        │   ├── ShortUrlApplication.java  # 启动类
        │   ├── controller/         # 控制器层
        │   ├── service/            # 服务层
        │   ├── mapper/             # 数据访问层
        │   └── entity/             # 实体类
        └── resources/
            ├── application.yml     # 配置文件
            ├── mapper/             # MyBatis XML映射文件
            └── sql/                # 数据库初始化脚本
```

## 技术栈

- **Spring Boot 3.2.0** - 核心框架
- **MyBatis Plus 3.5.5** - ORM框架
- **MySQL 8.0** - 数据库
- **Redis** - 缓存（预留）
- **Lombok** - 简化代码
- **Hutool** - Java工具库

## 模块说明

### dev-forge-common（公共模块）
- 统一响应封装 `Result<T>`
- 全局异常处理 `GlobalExceptionHandler`
- 业务异常 `BusinessException`
- ID生成器 `IdGenerator`（雪花算法）

### dev-forge-shorturl（短链服务）
- 端口：8081
- 功能：
  - 生成短链接：`POST /api/shorturl/generate`
  - 获取原始链接：`GET /api/shorturl/{shortCode}`

## 快速开始

### 1. 数据库初始化

执行 `dev-forge-shorturl/src/main/resources/sql/init.sql` 创建数据库和表。

### 2. 修改配置

编辑 `dev-forge-shorturl/src/main/resources/application.yml`，修改数据库连接信息：
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/shorturl_db
    username: your_username
    password: your_password
```

### 3. 编译项目

在项目根目录执行：
```bash
mvn clean install
```

### 4. 启动服务

```bash
cd dev-forge-shorturl
mvn spring-boot:run
```

或直接运行 `ShortUrlApplication` 主类。

### 5. 测试接口

**生成短链接：**
```bash
curl -X POST http://localhost:8081/api/shorturl/generate \
  -H "Content-Type: application/json" \
  -d '{"originalUrl": "https://www.example.com"}'
```

**获取原始链接：**
```bash
curl http://localhost:8081/api/shorturl/{shortCode}
```

## 扩展新模块

如需添加新模块（如秒杀系统），步骤如下：

1. 在根目录创建新模块文件夹 `dev-forge-seckill`
2. 创建 `pom.xml`，继承父工程
3. 在父工程 `pom.xml` 的 `<modules>` 中添加新模块
4. 根据需要引入 `dev-forge-common` 依赖

每个模块独立端口、独立启动，互不干扰。

## 注意事项

- 确保已安装 JDK 17+
- 确保 MySQL 和 Redis 已启动
- 各模块端口不要冲突
- 公共代码放在 `dev-forge-common` 中复用