# go-admin官网

**Repository Path**: cg33/go-admin-official

## Basic Information

- **Project Name**: go-admin官网
- **Description**: go-admin官网
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2019-09-19
- **Last Updated**: 2025-11-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GoAdmin Official Website

> 现代化、科技感的 GoAdmin 框架官方网站 - 重构版

## 🚀 项目简介

这是 GoAdmin 框架的官方网站后端系统，提供插件市场、主题市场、用户中心、支付系统等完整功能。

### ✨ 特性

- 🎨 **现代化设计**: 使用 Tailwind CSS 打造简洁、科技感的界面
- ⚡ **高性能**: 基于 Gin 框架，优化的数据库查询
- 🔐 **安全认证**: JWT 身份验证，RBAC 权限控制
- 💰 **支付集成**: 支持支付宝、微信支付
- 🔍 **SEO 友好**: 服务端渲染，优化搜索引擎收录
- 📱 **响应式设计**: 完美适配各种设备
- 🎭 **Vue.js 增强**: 使用 Vue.js 管理交互组件
- 📦 **插件生态**: 完整的插件市场系统
- 🎨 **主题系统**: 多主题支持和主题市场

## 📁 项目结构

```
go-admin-official/
├── cmd/                    # 应用程序入口
│   └── server/            
│       └── main.go        # 主入口文件
├── internal/              # 私有应用代码
│   ├── config/           # 配置管理
│   ├── database/         # 数据库操作
│   ├── middleware/       # 中间件
│   ├── models/           # 数据模型
│   ├── handlers/         # HTTP 处理器
│   ├── services/         # 业务逻辑
│   ├── repositories/     # 数据访问层
│   └── auth/             # 认证授权
├── pkg/                   # 可复用的公共库
│   ├── logger/           # 日志系统
│   ├── response/         # 统一响应
│   ├── validator/        # 验证器
│   └── utils/            # 工具函数
├── web/                   # 前端资源
│   ├── templates/        # HTML 模板
│   ├── static/           # 静态资源
│   │   ├── css/         # 样式文件
│   │   ├── js/          # JavaScript 文件
│   │   └── images/      # 图片资源
│   ├── assets/          # 源文件（需编译）
│   │   ├── css/         
│   │   └── js/          
│   ├── package.json     # 前端依赖
│   └── tailwind.config.js # Tailwind 配置
├── migrations/           # 数据库迁移文件
├── scripts/              # 部署和工具脚本
├── logs/                 # 日志文件
├── uploads/              # 上传文件
├── config.yaml           # 配置文件
├── go.mod                # Go 模块定义
├── Makefile              # 构建脚本
└── README.md             # 项目文档
```

## 🛠️ 技术栈

### 后端
- **语言**: Go 1.21+
- **框架**: Gin Web Framework
- **数据库**: MySQL 8.0+
- **认证**: JWT (golang-jwt/jwt)
- **日志**: Zap
- **配置**: YAML
- **支付**: 支付宝 SDK、微信支付 SDK

### 前端
- **样式**: Tailwind CSS 3.x
- **交互**: Vue.js 3.x
- **构建**: Vite
- **图标**: Heroicons
- **字体**: Inter, JetBrains Mono

## 🚀 快速开始

### 环境要求

- Go 1.21+
- MySQL 8.0+
- Node.js 18+ (用于前端构建)
- Make (可选)

### 安装步骤

1. **克隆项目**
```bash
git clone <repository-url>
cd go-admin-official
```

2. **安装 Go 依赖**
```bash
make deps
# 或
go mod download
```

3. **配置数据库**
```bash
# 创建数据库
mysql -u root -p -e "CREATE DATABASE go_admin_official CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

# 导入初始数据
mysql -u root -p go_admin_official < migrations/init.sql
```

4. **配置应用**
```bash
# 复制配置文件并修改
cp config.yaml config.local.yaml
# 编辑 config.local.yaml，配置数据库连接等信息
```

5. **构建前端资源**
```bash
cd web
npm install
npm run build
cd ..
```

6. **运行应用**
```bash
make run
# 或
go run cmd/server/main.go -c config.yaml
```

7. **访问应用**
```
http://localhost:8080
```

## 📝 开发指南

### 开发模式运行

```bash
# 后端热重载（需要安装 air）
make dev

# 前端开发模式
cd web
npm run dev
```

### 构建生产版本

```bash
# 构建应用
make build

# 构建所有平台
make build-all

# 运行生产版本
./build/go-admin-official -c config.yaml
```

### 数据库迁移

```bash
# 创建新迁移
make migrate-create name=add_users_table

# 执行迁移
make migrate-up

# 回滚迁移
make migrate-down
```

### 代码规范

```bash
# 格式化代码
make fmt

# 运行 linter
make lint

# 运行测试
make test

# 查看测试覆盖率
make test-coverage
```

## 🎨 前端开发

### Tailwind CSS

项目使用 Tailwind CSS 实现现代化、科技感的设计风格。主要特点：

- 原子化 CSS 类
- 响应式设计
- 深色模式支持
- 自定义配置

### Vue.js 组件

使用 Vue.js 3 管理页面交互组件：

- 插件列表组件
- 主题展示组件
- 用户中心组件
- 支付组件

## 📚 API 文档

API 端点遵循 RESTful 规范：

- `GET /api/plugins` - 获取插件列表
- `GET /api/plugins/:id` - 获取插件详情
- `POST /api/auth/login` - 用户登录
- `POST /api/auth/register` - 用户注册
- `GET /api/user/profile` - 获取用户信息
- `POST /api/orders` - 创建订单

详细 API 文档请查看 `/docs/api.md`

## 🔧 配置说明

主要配置项：

- `app`: 应用基础配置
- `database`: 数据库连接配置
- `jwt`: JWT 认证配置
- `logger`: 日志配置
- `alipay/wechat`: 支付配置

## 🚢 部署

### Docker 部署

```bash
# 构建镜像
make docker-build

# 运行容器
make docker-run
```

### 传统部署

```bash
# 构建
make build

# 复制文件到服务器
scp -r build/go-admin-official config.yaml user@server:/app/

# 在服务器上运行
./go-admin-official -c config.yaml
```

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 👥 作者

- GoAdmin Team
- Email: admin@go-admin.com

## 🙏 致谢

- [Gin](https://github.com/gin-gonic/gin) - Web 框架
- [Tailwind CSS](https://tailwindcss.com/) - CSS 框架
- [Vue.js](https://vuejs.org/) - JavaScript 框架
- [AdminLTE](https://adminlte.io/) - 灵感来源

---

Made with ❤️ by GoAdmin Team