Smart Bug Tracker ^v1.1.3

• Dual-Mode Operation — Developer and Tester roles with tailored workflows
• Single Instance Protection — Prevents multiple application instances with smart focus switching
• Comprehensive Help System — F1 hotkey access with categorized keyboard shortcuts
• GitHub Integration — URL validation, template support, and one-click copy
• Sound System — Toggle sound effects (Ctrl+M) with audio feedback
• Natural Version Sorting — dev → test → alpha → beta → rc → v1.0.0
• Dark Theme — Modern dark UI designed for long working sessions
• Export Capabilities — Statistics and reports in multiple formats

✨ Major New Features

• Enhanced Single Instance Protection — Intelligent launch control with automatic focus
• Comprehensive Help System — Extended keyboard shortcuts, organized help dialog
• Advanced Keyboard Navigation — Task management shortcuts (Ctrl+D, Ctrl+P)
• F1 Hotkey — Instant access to help from any window

🔧 Technical Improvements

• Single Application Pattern — Robust singleton implementation
• Cross-Platform Compatibility — Linux and macOS support
• Improved Error Handling — Better recovery from edge cases
• Enhanced Memory Management — Reduced resource consumption

Global Shortcuts

• F1 — Open Help Dialog
• Ctrl+Q — Exit Application
• Ctrl+M — Toggle Sound
• Ctrl+O — Open Project
• Ctrl+S — Save Project
• Ctrl+F — Focus Search

Tab Navigation

• Ctrl+1 — Tasks Tab
• Ctrl+2 — Bugs Tab
• Ctrl+3 — Statistics Tab

Task Management

• Ctrl+N — New Task
• Ctrl+E — Edit Task
• Ctrl+D — Mark Task Done
• Ctrl+P — Mark Task In Progress

Bug Management

• Ctrl+Shift+N — New Bug
• Ctrl+Shift+E — Edit Bug
• Ctrl+Shift+D — Mark Bug Done
• Ctrl+Shift+P — Mark Bug In Progress

Requirements

• Python 3.8+
• PyQt5

Installation

git clone https://github.com/aixandrolab/smart-bug-tracker.git
cd smart-bug-tracker
pip install -r requirements.txt
python main.py

First Run

• Choose Developer or Tester mode
• Create a new project or open existing .bugtracker.json
• Start managing tasks and bugs

Developer Mode

• Create and manage tasks
• View and update bug reports
• Track development progress
• Assign tasks to team members
• Version management and GitHub integration

Tester Mode

• Report bugs with detailed reproduction steps
• Upload screenshots and attachments
• Track bug status and resolution
• View task progress and test instructions
• Comment on bugs and tasks

Projects are saved as .bugtracker.json files

{
  "meta": {
    "name": "Project Name",
    "description": "Project description",
    "author": "Your Name",
    "created_at": "2025-01-01T12:00:00",
    "github_url": "https://github.com/username/repo",
    "versions": ["v1.0.0", "v1.1.0"],
    "developers": ["dev1", "dev2"],
    "testers": ["tester1", "tester2"]
  },
  "versions": {
    "v1.0.0": {
      "tasks": {
        "TASK-ABC123": {
          "id": "TASK-ABC123",
          "title": "Task Title",
          "description": "Task description",
          "priority": "high",
          "status": "todo",
          "created_at": "2025-11-01T12:00:00",
          "version": "v1.0.0",
          "test_instructions": "Instructions...",
          "assigned_to": "Developer Name",
          "bug_ids": ["BUG-DEF456"]
        }
      },
      "bugs": {
        "BUG-DEF456": {
          "id": "BUG-DEF456",
          "title": "Bug Title",
          "description": "Bug description",
          "priority": "critical",
          "status": "open",
          "created_at": "2025-11-01T12:00:00",
          "task_id": "TASK-ABC123",
          "steps_to_reproduce": "1. Step one...",
          "expected_result": "Should happen...",
          "actual_result": "Actually happens...",
          "screenshot_path": "/path/to/screenshot.png",
          "author": "Tester Name",
          "assigned_to": "Developer Name",
          "comments": []
        }
      }
    }
  }
}

• Language: Python 3.8+
• GUI Framework: PyQt5
• Platform: Linux / macOS / Windows
• License: MIT
• Dependencies: PyQt5, Python Standard Library

General Questions

• Q: Can I run multiple instances?
  A: No. The application prevents multiple instances and focuses existing windows.
• Q: Can I turn off sounds?
  A: Yes! Press Ctrl+M at any time or click the sound button in the header.
• Q: What Python version do I need?
  A: Python 3.8 or higher is required.
• Q: Can I run this on a server?
  A: This is a desktop application designed for local use. For team collaboration, share the project file.

Usage Questions

• Q: How do I assign tasks to team members?
  A: Use the "Assigned To" field when creating or editing tasks.
• Q: Can I change bug priorities after creation?
  A: Yes! Edit any bug to change its priority.
• Q: What's the difference between "Won't Fix" and "Invalid"?
  A: "Won't Fix" means it's a bug but won't be addressed. "Invalid" means it's not actually a bug.
• Q: How do I track which bugs belong to which tasks?
  A: When reporting bugs, you can associate them with tasks. Use the task filter to see all related bugs.