# go-fishadmin

**Repository Path**: happykj/go-fishadmin

## Basic Information

- **Project Name**: go-fishadmin
- **Description**: No description available
- **Primary Language**: Go
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-27
- **Last Updated**: 2026-02-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FishAdmin - 鱼类管理平台

## 项目简介

FishAdmin 是一个现代化的鱼类管理平台，采用 Go + Vue.js 技术栈构建，提供用户认证、游戏管理、用户管理、仪表盘统计等功能。

## 技术栈

- **后端**: Go 1.21 + Gin 框架
- **前端**: Vue 3 + TypeScript + Vite + Element Plus + Pinia + Vue Router 4 + Axios
- **数据库**: (根据实际配置)
- **部署**: 前后端一体化，Go 托管 Vue 构建产物

## 快速开始

### 环境要求

- Go 1.21+
- Node.js 16+
- npm 或 yarn

### 安装依赖

```bash
# 后端依赖
go mod tidy

# 前端依赖
cd web && npm install
```

### 开发环境启动

#### Windows 环境

```cmd
# 方法1: 使用批处理脚本
scripts\dev.bat

# 方法2: 使用PowerShell脚本
.\scripts\dev.ps1

# 方法3: 分别启动
go run cmd/server/main.go  # 后端 (端口3000)
cd web && npm run dev      # 前端 (端口3001)
```

#### Ubuntu/Linux 环境

```bash
# 方法1: 使用开发脚本 (推荐)
chmod +x scripts/dev-ubuntu.sh
./scripts/dev-ubuntu.sh

# 方法2: 分别启动
go run cmd/server/main.go     # 后端 (端口3000)
cd web && npm run dev         # 前端 (端口3001)

# 停止服务
chmod +x scripts/stop-dev.sh
./scripts/stop-dev.sh
```

### 构建部署

#### Windows 环境

```cmd
# 全量构建
make build

# 或分别构建
cd web && npm run build
go build -o fishadmin-frontend ./cmd/server
```

#### Ubuntu/Linux 环境

```bash
# 使用构建脚本 (推荐)
chmod +x scripts/build-ubuntu.sh
./scripts/build-ubuntu.sh

# 或手动构建
cd web && npm run build
CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o fishadmin-frontend ./cmd/server
```

## 环境配置

复制环境配置文件：

```bash
# Windows
copy .env.example .env

# Linux/Unix
cp .env.example .env
```

## 项目结构

```
go-fishadmin/
├── cmd/
│   └── server/          # 服务端入口
├── config/              # 配置文件
├── internal/            # 内部包
│   ├── handlers/        # 请求处理器
│   └── middleware/      # 中间件
├── pkg/                 # 公共包
│   └── logger/          # 日志包
├── web/                 # 前端项目
│   ├── src/             # 源码
│   └── dist/            # 构建输出
├── scripts/             # 脚本文件
└── Makefile             # 构建配置
```

## 脚本说明

### Windows 脚本

- `scripts/dev.bat` - Windows开发环境启动脚本
- `scripts/dev.ps1` - PowerShell开发环境启动脚本
- `scripts/fix-deps.bat` - 依赖修复脚本
- `scripts/check-env.bat` - 环境检查脚本

### Ubuntu/Linux 脚本

- `scripts/dev-ubuntu.sh` - Ubuntu开发环境启动脚本
- `scripts/stop-dev.sh` - 停止开发服务脚本
- `scripts/build-ubuntu.sh` - Ubuntu完整构建脚本
- `scripts/fix-node-deps.sh` - Node.js依赖修复脚本
- `scripts/check-env-ubuntu.sh` - Ubuntu环境检查脚本

## 访问地址

- 前端界面: http://localhost:3001
- API接口: http://localhost:3000/api
- 管理后台: http://localhost:3001/admin

## 故障排除

详细故障排除指南请参考 [TROUBLESHOOTING.md](TROUBLESHOOTING.md)

常见问题快速解决：

```bash
# Ubuntu环境检查
chmod +x scripts/check-env-ubuntu.sh
./scripts/check-env-ubuntu.sh

# 依赖修复
chmod +x scripts/fix-node-deps.sh  
./scripts/fix-node-deps.sh
```

## 开发规范

- 前端组件命名使用 PascalCase
- 文件名使用 kebab-case
- 使用 TypeScript 和 Composition API
- API 返回格式统一

## 许可证

MIT License