# bug-manager

**Repository Path**: city-space/bug-manager

## Basic Information

- **Project Name**: bug-manager
- **Description**: Bug管理系统是一个基于Flask开发的Web应用，用于团队协作跟踪和管理软件Bug。系统提供用户认证、Bug创建与分配、状态更新、评论交流等功能，帮助开发团队高效管理项目中的Bug和问题。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-11-10
- **Last Updated**: 2025-12-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Bug管理系统

## 项目概述

Bug管理系统是一个基于Flask开发的Web应用，用于团队协作跟踪和管理软件Bug。系统提供用户认证、Bug创建与分配、状态更新、评论交流等功能，帮助开发团队高效管理项目中的Bug和问题。

## 技术栈

- **后端框架**：Flask 2.3.2
- **ORM**：Flask-SQLAlchemy
- **用户认证**：Flask-Login
- **表单处理**：Flask-WTF
- **数据库**：SQLite
- **前端**：HTML5, CSS3, JavaScript

## 功能特点

### 用户管理
- 用户注册和登录
- 基于角色的权限控制（管理员/普通用户）
- 个人资料查看

### Bug管理
- Bug的创建、编辑、删除
- 支持Bug分类（功能、界面、性能、安全）
- 优先级设置（低、中、高、紧急）
- 状态跟踪（未解决、进行中、已解决、已关闭）
- Bug分配给团队成员
- Bug详情查看和评论

### 系统功能
- 仪表盘统计展示
- Bug列表筛选和分页
- 响应式设计，适配不同设备

## 安装说明

### 前置要求
- Python 3.7 或更高版本
- pip 包管理器

### 安装步骤

1. **克隆项目**
   ```bash
   git clone <repository-url>
   cd bug-manager
   ```

2. **创建虚拟环境（可选但推荐）**
   ```bash
   python -m venv venv
   # Windows
   venv\Scripts\activate
   # Linux/Mac
   source venv/bin/activate
   ```

3. **安装依赖**
   ```bash
   pip install -r requirements.txt
   ```

4. **配置环境变量**
   创建 `.env` 文件，包含以下内容：
   ```
   SECRET_KEY=your_secret_key_here
   DATABASE_URL=sqlite:///bug_manager.db
   ```

5. **初始化数据库**
   ```bash
   python init_db.py
   ```
   这将创建数据库表结构并生成默认管理员账号：
   - 用户名：admin
   - 密码：admin123

## 运行项目

### 传统方式运行

```bash
python app.py
```

访问 http://127.0.0.1:80 即可使用系统

### Docker 部署

#### 前提条件
- Docker 19.03+ 已安装
- Docker Compose 3.0+ 已安装

#### 使用 Docker Compose 运行

1. 确保 `.env` 文件已正确配置（参考安装说明部分）

2. 构建并启动容器：
   ```bash
   docker-compose up -d --build
   ```

3. 访问系统：
   - 地址：http://127.0.0.1:80

#### Docker 命令行运行（可选）

```bash
# 构建镜像
docker build -t bug-manager .

# 运行容器
docker run -d \
  --name bug-manager \
  -p 80:80 \
  -e SECRET_KEY=your_secret_key \
  -e DATABASE_URL=sqlite:////app/instance/bug_manager.db \
  -v $(pwd)/instance:/app/instance \
  bug-manager
```

#### Docker 相关命令

```bash
# 查看容器状态
docker-compose ps

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down

# 重启服务
docker-compose restart
```

## 使用说明

### 管理员功能
- 可以管理所有用户创建的Bug
- 可以查看系统全局统计信息
- 可以分配Bug给任意团队成员

### 普通用户功能
- 可以创建和管理自己报告的Bug
- 可以查看分配给自己的Bug
- 可以对Bug进行评论和状态更新

## 项目结构

```
bug-manager/
├── app/
│   ├── __init__.py       # 应用初始化
│   ├── auth.py           # 认证相关路由
│   ├── bugs.py           # Bug管理相关路由
│   ├── main.py           # 主页面相关路由
│   └── models.py         # 数据模型定义
├── templates/            # HTML模板
│   ├── auth/             # 认证相关模板
│   ├── bugs/             # Bug管理相关模板
│   ├── main/             # 主页面相关模板
│   └── base.html         # 基础模板
├── app.py                # 应用入口
├── init_db.py            # 数据库初始化脚本
├── requirements.txt      # 项目依赖
└── .env                  # 环境变量配置
```

## 注意事项

1. 本系统为开发环境配置，生产环境部署时请修改以下配置：
   - 将 `app.run(debug=True)` 中的 `debug` 设置为 `False`
   - 使用更安全的 `SECRET_KEY`
   - 考虑使用其他数据库如MySQL或PostgreSQL

2. 默认管理员账号请在首次登录后立即修改密码

## 许可证

本项目采用MIT许可证 - 详情请查看LICENSE文件