# DevOps

**Repository Path**: katasea/dev-ops

## Basic Information

- **Project Name**: DevOps
- **Description**: 研发管理devops系统-仅前端项目
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KZ DevOps 项目管理平台

一个现代化的DevOps项目管理平台，提供产品管理、项目管理、需求管理、任务跟踪、缺陷管理等功能。

## 🚀 预览
### 登录页面
![登录页面截图](./image/login.png)

### 仪表板
![仪表板截图](./image/dash.png)

### 产品管理
![产品管理截图](./image/cpgl.png)
![产品管理截图](./image/dark-cpgl.png)

### 任务管理
![任务管理截图](./image/rwjm.png)
![任务管理截图](./image/rwgl.png)

## ✨ 功能特性

### 🎯 核心功能
- **产品管理** - 完整的产品生命周期管理
- **项目管理** - 多项目并行管理
- **需求管理** - 需求收集、评审、跟踪
- **任务跟踪** - 任务分配、进度跟踪
- **缺陷管理** - Bug报告、修复、验证
- **知识库** - 文档和知识管理

### 🛠️ 系统功能
- **用户管理** - 多角色权限控制
- **角色权限** - 灵活的权限配置
- **菜单管理** - 动态菜单配置
- **消息中心** - 统一消息通知
- **系统设置** - 个性化配置

### 🎨 用户体验
- **响应式设计** - 支持桌面和移动端
- **暗黑模式** - 支持明暗主题切换
- **实时通知** - 消息实时推送
- **音频提醒** - 重要事件音频提醒

## 🛠️ 技术栈

### 前端技术
- **React 18** - 现代化前端框架
- **TypeScript** - 类型安全的JavaScript
- **Vite** - 快速构建工具
- **Tailwind CSS** - 实用优先的CSS框架
- **React Router** - 客户端路由
- **Sonner** - 轻量级Toast通知

### 开发工具
- **pnpm** - 快速、节省磁盘空间的包管理器
- **ESLint** - 代码质量检查
- **Prettier** - 代码格式化

## 🚀 快速开始

### 环境准备

- 安装 [Node.js](https://nodejs.org/en) (版本 16+)
- 安装 [pnpm](https://pnpm.io/installation)

### 安装依赖

```bash
pnpm install
```

### 启动开发服务器

```bash
pnpm run dev
```

在浏览器中访问 [http://localhost:3000](http://localhost:3000)

### 构建生产版本

```bash
pnpm run build
```

### 预览生产版本

```bash
pnpm run preview
```

## 📁 项目结构

```
src/
├── components/          # 公共组件
│   ├── Header.tsx       # 顶部导航栏
│   ├── Sidebar.tsx      # 侧边栏菜单
│   ├── Layout.tsx       # 页面布局
│   ├── Drawer.tsx       # 抽屉组件
│   └── Empty.tsx        # 空状态组件
├── contexts/            # React Context
│   ├── MessageContext.tsx   # 消息管理
│   ├── AudioContext.tsx     # 音频管理
│   ├── SystemContext.tsx   # 系统管理
│   └── authContext.ts       # 认证管理
├── hooks/               # 自定义Hooks
│   ├── useTheme.ts          # 主题切换
│   └── useAudioNotification.ts # 音频通知
├── lib/                 # 工具库
│   ├── utils.ts             # 工具函数
│   └── audio.ts             # 音频工具
├── pages/              # 页面组件
│   ├── Home.tsx             # 首页/仪表板
│   ├── Products.tsx         # 产品管理
│   ├── Projects.tsx         # 项目管理
│   ├── Requirements.tsx     # 需求管理
│   ├── Tasks.tsx            # 任务管理
│   ├── Bugs.tsx             # 缺陷管理
│   ├── Knowledge.tsx         # 知识库
│   ├── Messages.tsx          # 消息中心
│   ├── Settings.tsx          # 系统设置
│   ├── Users.tsx            # 用户管理
│   ├── Roles.tsx            # 角色管理
│   ├── Menus.tsx             # 菜单管理
│   └── Help.tsx             # 帮助中心
└── main.tsx             # 应用入口
```

## 🔧 配置说明

### 环境变量

项目支持以下环境变量：

- `VITE_API_BASE_URL` - API基础地址
- `VITE_APP_TITLE` - 应用标题

### 主题配置

项目支持明暗主题切换，主题配置位于 `src/hooks/useTheme.ts`。

## 🤝 贡献指南

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

## 📄 许可证

本项目采用 **GNU General Public License v3.0 (GPL-3.0)** 许可证。

### 许可证特点

**允许的行为：**
- ✅ 自由使用 - 可以个人使用
- ✅ 自由修改 - 可以根据需要修改源代码
- ✅ 自由分发 - 可以分享给他人
- ✅ 自由研究 - 可以学习和研究代码

**限制的行为：**
- ❌ **禁止闭源分发** - 任何基于本项目的修改版本必须开源
- ❌ **禁止商业售卖** - 不能将本项目作为商业产品售卖
- ❌ **禁止移除版权声明** - 必须保留原始许可证和版权信息

### 为什么选择GPL-3.0？

GPL-3.0是"copyleft"许可证，确保：
1. **保护开源精神** - 任何基于本项目的衍生作品必须保持开源
2. **防止商业滥用** - 防止他人将您的劳动成果包装成商业产品售卖
3. **促进社区贡献** - 鼓励改进和贡献回馈社区

查看完整的 [LICENSE](LICENSE) 文件了解详情。

## 🙏 致谢

感谢以下开源项目的支持：

- [React](https://reactjs.org/)
- [Vite](https://vitejs.dev/)
- [Tailwind CSS](https://tailwindcss.com/)
- [React Router](https://reactrouter.com/)
- [Sonner](https://sonner.emilkowal.ski/)

## 📞 联系方式

如有问题或建议，请通过以下方式联系：

- 邮箱：1126883892@qq.com
- 项目地址：https://gitee.com/katasea/dev-ops

---

⭐ 如果这个项目对您有帮助，请给个星标支持！