# gozero-demo

**Repository Path**: rxbook/gozero-demo

## Basic Information

- **Project Name**: gozero-demo
- **Description**: gozero框架的基本用法和常用功能封装
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-04
- **Last Updated**: 2025-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# gozero-demo

基于 go-zero 框架的示例项目，展示了一个典型的 Web 应用程序结构，包含用户管理、商品管理、订单管理等功能模块。

## 项目特点

- 使用 go-zero 框架构建
- 包含完整的 CRUD 操作示例
- 支持 MySQL 和 Elasticsearch 两种数据存储
- 提供定时任务功能
- 包含详细的 API 文档
- 支持配置管理

## 目录结构

```
.
├── api/                  # API 接口定义
├── etc/                  # 配置文件
├── internal/             # 核心代码
│   ├── config/           # 配置管理
│   ├── constants/        # 常量定义
│   ├── crontab/          # 定时任务
│   ├── handler/          # HTTP 请求处理器
│   ├── logic/            # 业务逻辑
│   ├── middleware/       # 中间件
│   ├── model/            # 数据模型
│   ├── repo/             # 数据访问层
│   ├── svc/              # 服务上下文
│   ├── types/            # 类型定义
│   └── utils/            # 工具函数
├── script/               # 脚本文件
└── sql/                  # 数据库脚本
```


## 安装指南

1. 克隆仓库并设置环境:
   ```bash
   git clone https://gitee.com/rxbook/gozero-demo.git
   cp .env.example .env
   ```

2. 安装依赖:
   ```bash
   go mod tidy
   ```

3. 配置数据库:
   - 创建数据库并导入 `sql/go-demo-2025.sql`
   - 将 `etc/gozero-api.yaml` 复制为 `etc/gozero-api-dev.yaml`, 并修改数据库连接信息
   

4. 运行项目:
   ```bash
   go run gozero.go
   ```

## API 文档

- **文档文件**: `gozero_doc.json`
- 可以导入到 `apifox` 中查看和调试运行
![apixfox_import_swagger.png](files/image/apixfox_import_swagger.png)