# workops

**Repository Path**: smewl13/workops

## Basic Information

- **Project Name**: workops
- **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-02-12
- **Last Updated**: 2026-02-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WorkOps 办公环境管理系统

WorkOps 是一个基于 Go 语言开发的现代化办公环境管理系统，采用前后端分离架构，集成了多种 DevOps 工具和服务。

## 🚀 快速开始

### 环境要求
- Go 1.25.5 或更高版本
- Linux/macOS 环境

### 安装与构建

```bash
# 克隆项目
git clone <repository-url>
cd workops

# 安装依赖
make deps

# 构建项目
make release  # 构建发布版本（推荐）
# 或
make         # 构建完整应用程序
make backend # 仅构建后端
make frontend # 仅构建前端
```

### 运行应用

```bash
# 开发模式运行
make run

# 生产模式运行（使用发布包）
cd dist/workops-*/
chmod +x start.sh stop.sh
./start.sh
```

## 🏗️ 技术架构

**后端**: Go + Gin + GORM + SQLite + Zap  
**前端**: HTML5 + CSS3 + JavaScript  
**部署**: Docker 容器化支持

## 🔧 核心功能

1. **用户管理** - 用户认证、权限控制（默认启用）
2. **Gitea 集成** - 代码仓库管理与 Webhook
3. **SonarQube 集成** - 代码质量检测
4. **数据备份** - 自动化备份调度
5. **OpenVPN 管理** - 网络安全访问
6. **Docker 镜像** - Registry 同步管理

## 📁 项目结构

```
workops/
├── cmd/workops/          # 程序入口
├── internal/             # 核心代码
│   ├── config/          # 配置管理
│   ├── services/        # 业务服务
│   ├── handlers/        # HTTP 处理器
│   └── middleware/      # 中间件
├── web/                 # 前端资源
├── config/              # 配置文件
├── bin/                 # 编译输出
└── dist/                # 发布包
```

## 🛠️ 开发命令

```bash
make help      # 查看帮助
make clean     # 清理构建产物
make test      # 运行测试
make fmt       # 格式化代码
make vet       # 代码检查
```

## 🔒 安全特性

- Session 认证机制
- 访问控制与权限管理
- 未登录自动跳转
- 完整的日志审计

## 🐳 Docker 部署

```bash
make docker-build  # 构建镜像
make docker-run    # 运行容器
make docker-stop   # 停止容器
```

## 📊 API 端点

主要 API 路径：
- `/api/v1/auth/` - 认证相关
- `/api/v1/users/` - 用户管理
- `/api/v1/gitea/` - Gitea 集成
- `/api/v1/sonarqube/` - 代码质量
- `/api/v1/backup/` - 数据备份
- `/api/v1/openvpn/` - VPN 管理
- `/api/v1/docker/` - 镜像同步

## 📄 许可证

MIT License

---
*WorkOps - 让 DevOps 管理更简单*