docs: add comments to requirements.txt grouping packages by purpose

Organize requirements.txt with section comments explaining which
packages are used by which part of the project.

Fixes #172

Author: itniuma2026

requirements.txt

@@ -1,55 +1,138 @@
-attrs==23.2.0
-certifi==2024.2.2
-charset-normalizer==3.3.2
-colorama==0.4.6
-coloredlogs==15.0.1
-EasyProcess==1.1
-entrypoint2==1.1
-flatbuffers==24.3.25
-humanfriendly==10.0
-idna==3.6
-imageio==2.34.0
-jsonschema==4.21.1
-jsonschema-specifications==2023.12.1
-keyboard==0.13.5
-lazy_loader==0.3
-llvmlite==0.42.0
-MouseInfo==0.1.3
-mpmath==1.3.0
-mss==9.0.1
-networkx==3.2.1
-numba==0.59.1
-numpy==1.26.4
-onnxruntime==1.17.1
-opencv-python-headless==4.9.0.80
-packaging==24.0
-pandas==2.1.1
-Pillow==10.0.1
-platformdirs==4.2.0
-pooch==1.8.1
-protobuf==5.26.1
-PyAutoGUI==0.9.54
-pygame==2.6.1
-PyGetWindow==0.0.9
-PyMatting==1.1.12
-PyMsgBox==1.0.9
-pyperclip==1.8.2
-pyreadline3==3.4.1
-PyRect==0.2.0
-pyscreenshot==3.1
-PyScreeze==0.1.29
-python-dateutil==2.8.2
-pytweening==1.0.7
-pytz==2023.3.post1
-referencing==0.34.0
-rembg==2.0.56
-requests==2.31.0
-rpds-py==0.18.0
-scikit-image==0.22.0
-scipy==1.12.0
-six==1.16.0
-sympy==1.12
-tifffile==2024.2.12
-tqdm==4.66.2
-tzdata==2023.3
-urllib3==2.2.1
+Based on the analysis, here's the updated requirements.txt with comments grouped by purpose/category:
+
+```txt
+# ============================================
+# CORE TERMINAL/CASINO FRAMEWORK DEPENDENCIES
+# ============================================
+
+# Terminal output styling and colors
+colorama==0.4.6          # Used by casino/utils.py for colored terminal output
+
+# Enhanced logging with colors
+coloredlogs==15.0.1      # Formatted logging output
+humanfriendly==10.0      # Human-readable logging (coloredlogs dependency)
+
+# Input handling for enhanced user interaction
+keyboard==0.13.5         # Keyboard input detection and handling
+
+# Windows terminal enhancement
+pyreadline3==3.4.1       # Readline functionality for Windows terminals
+
+
+# ============================================
+# AUDIO/VISUAL & GAME PRESENTATION
+# ============================================
+
+# Game audio and visual effects
+pygame==2.6.1            # Sound effects and audio playback for casino games
+
+# Screen automation and GUI interaction
+PyAutoGUI==0.9.54        # Screen automation and GUI control
+PyGetWindow==0.0.9       # Window management (PyAutoGUI dependency)
+PyMsgBox==1.0.9          # Message boxes (PyAutoGUI dependency)
+PyRect==0.2.0            # Rectangle operations (PyAutoGUI dependency)
+PyScreeze==0.1.29        # Screenshot functionality (PyAutoGUI dependency)
+pytweening==1.0.7        # Tweening animations (PyAutoGUI dependency)
+pyperclip==1.8.2         # Clipboard operations (PyAutoGUI dependency)
+pyscreenshot==3.1        # Screenshot capture (PyAutoGUI dependency)
+mss==9.0.1               # Fast screenshot capture (PyAutoGUI dependency)
+MouseInfo==0.1.3         # Mouse position info (PyAutoGUI dependency)
+EasyProcess==1.1         # Process management (PyAutoGUI dependency)
+entrypoint2==1.1         # Entry point utilities (PyAutoGUI dependency)
+
+
+# ============================================
+# CARD IMAGE PROCESSING (rembg dependencies)
+# ============================================
+
+# Background removal for card images
+rembg==2.0.56            # Remove backgrounds from card images
+
+# Image processing libraries
+Pillow==10.0.1           # Image manipulation (rembg dependency)
+opencv-python-headless==4.9.0.80  # Computer vision (rembg dependency)
+scikit-image==0.22.0     # Image processing algorithms (rembg dependency)
+imageio==2.34.0          # Image I/O operations (rembg dependency)
+tifffile==2024.2.12      # TIFF image support (rembg dependency)
+
+# Machine learning/AI for image processing
+onnxruntime==1.17.1      # ONNX model runtime (rembg dependency)
+numpy==1.26.4            # Numerical computing (rembg dependency)
+scipy==1.12.0            # Scientific computing (rembg dependency)
+
+# Performance optimization
+numba==0.59.1            # JIT compilation for performance (rembg dependency)
+llvmlite==0.42.0         # LLVM compiler infrastructure (numba dependency)
+
+# Data fetching and management
+pooch==1.8.1             # Data file fetcher (rembg dependency)
+
+# Advanced image matting
+PyMatting==1.1.12        # Alpha matting for image composition (rembg dependency)
+
+# Protocol and serialization
+protobuf==5.26.1         # Protocol buffers (rembg dependency)
+flatbuffers==24.3.25     # FlatBuffers serialization (rembg dependency)
+
+# Mathematical computations
+sympy==1.12              # Symbolic mathematics (rembg dependency)
+mpmath==1.3.0            # Arbitrary-precision arithmetic (sympy dependency)
+
+
+# ============================================
+# DATA HANDLING & ANALYTICS
+# ============================================
+
+# Data analysis and statistics
+pandas==2.1.1            # Data manipulation and analysis for game statistics
+
+# Timezone and date handling
+python-dateutil==2.8.2   # Date parsing (pandas dependency)
+pytz==2023.3.post1       # Timezone support (pandas dependency)
+tzdata==2023.3           # Timezone database (pandas dependency)
+six==1.16.0              # Python 2/3 compatibility (pandas dependency)
+
+
+# ============================================
+# NETWORK & EXTERNAL COMMUNICATION
+# ============================================
+
+# HTTP requests for external services
+requests==2.31.0         # HTTP requests for API calls or data fetching
+certifi==2024.2.2        # SSL certificates (requests dependency)
+charset-normalizer==3.3.2 # Character encoding (requests dependency)
+idna==3.6                # Internationalized Domain Names (requests dependency)
+urllib3==2.2.1           # HTTP client (requests dependency)
+
+
+# ============================================
+# CONFIGURATION & VALIDATION
+# ============================================
+
+# Configuration schema validation
+jsonschema==4.21.1       # JSON schema validation for config files
+attrs==23.2.0            # Classes without boilerplate (jsonschema dependency)
+referencing==0.34.0      # JSON reference resolution (jsonschema dependency)
+rpds-py==0.18.0          # Persistent data structures (jsonschema dependency)
+jsonschema-specifications==2023.12.1  # JSON schema specs (jsonschema dependency)
+
+
+# ============================================
+# UTILITIES & MISC TOOLS
+# ============================================
+
+# Graph algorithms and data structures
+networkx==3.2.1          # Graph theory algorithms (potential for game logic)
+
+# Package version handling
+packaging==24.0          # Version parsing and comparison
+
+# Platform-specific directory handling
+platformdirs==4.2.0      # Platform-appropriate directories
+
+# Progress bars and loading indicators
+tqdm==4.66.2             # Progress bars for long operations
+
+# Lazy loading optimization
+lazy_loader==0.3         # Lazy loading of modules/resources
+```