Merge pull request #3 from VisioSphereAI/feature/system_monitoring

Feature/system monitoring

Author: amish0

README.md

@@ -7,7 +7,11 @@ This repository contains an **advanced Flask application** demonstrating product
 - **🐳 Docker** containerization with Gunicorn
 - **📅 Interactive Calendar** system
 - **✓ Task Manager** with priority levels
-- **🎨 Bootstrap 5** responsive UI
+- **� Gamification** with points, badges, and leaderboards
+- **🎯 Mini-games** - Riddle solver and Math challenges
+- **💻 System Monitor** - Real-time Windows/Linux performance tracking
+- **🌙 Dark Mode** - User-preferred theme support
+- **🎨 Bootstrap 5** responsive UI with animations
 - **🧪 Comprehensive Tests** with pytest
 - **🔄 CI/CD Pipeline** with GitHub Actions
 - **📊 Multi-page Application** with Jinja2 templates
@@ -57,14 +61,24 @@ docker compose up --build
 
 ### 🏠 Web Pages
 - **Home** - Overview of features and quick links
-- **📅 Calendar** - Interactive monthly event calendar
-- **✓ Tasks** - Task management with priorities and completion tracking
+- **📅 Calendar** - Interactive monthly event calendar with task addition
+- **✓ Tasks** - Task management with priorities, due dates, and completion tracking
+- **🎮 Arcade** - Interactive games (riddles, math challenges, color matching)
+- **👤 Profile** - User profile with gamification stats
+- **🏆 Leaderboard** - Competitive ranking system
+- **💻 System Monitor** - Real-time system performance dashboard
 - **About** - Project information and technologies
 - **Contact** - Next steps and suggestions
 
 ### 🔌 API Endpoints
 - `GET /health/` - Health check endpoint
 - `POST /api/v1/echo` - Echo JSON messages
+- `GET /api/v1/system/info` - Complete system information (JSON)
+- `GET /api/v1/system/cpu` - CPU metrics and core usage
+- `GET /api/v1/system/memory` - RAM and swap memory details
+- `GET /api/v1/system/disk` - Disk partitions and usage
+- `GET /api/v1/system/battery` - Battery status and health
+- `GET /api/v1/system/network` - Network interfaces and I/O statistics
 
 ### 🛠️ Advanced Features
 - **App Factory Pattern** - Flexible application initialization
@@ -74,6 +88,12 @@ docker compose up --build
 - **Form Handling** - Task creation and management
 - **Static Assets** - CSS and JavaScript support
 - **Responsive Design** - Mobile-friendly UI with Bootstrap 5
+- **📅 Calendar Task Addition** - Click dates to add tasks with due dates
+- **🎮 Gamification System** - Points, levels, badges, achievements, leaderboards
+- **🌙 Dark Mode Toggle** - Persistent user theme preference
+- **🎭 Easter Eggs** - Interactive hidden features (Konami code, etc.)
+- **💻 System Monitoring** - CPU, memory, disk, network, battery, and process tracking
+- **📊 Performance Metrics** - Top processes by CPU and memory usage
 
 ---
 
@@ -85,29 +105,40 @@ docker compose up --build
 │   └── workflows/
 │       └── ci.yml                 # GitHub Actions CI/CD
 ├── app/
-│   ├── __init__.py               # App factory
+│   ├── __init__.py               # App factory with Jinja2 filters
 │   ├── config.py                 # Configuration classes
-│   ├── routes.py                 # Blueprint routes
+│   ├── routes.py                 # Blueprint routes (40+ endpoints)
 │   ├── errors.py                 # Error handlers
 │   ├── extensions.py             # Flask extensions
 │   ├── health.py                 # Health check blueprint
 │   ├── calendar_manager.py       # Calendar logic
 │   ├── task_manager.py           # Task management logic
+│   ├── gamification.py           # Gamification system (points/badges/leaderboard)
+│   ├── minigames.py              # Mini-games (riddles, math)
+│   ├── system_monitor.py         # System monitoring (CPU/memory/disk/network/battery)
 │   ├── static/
 │   │   ├── css/
-│   │   │   └── styles.css        # Custom styles
+│   │   │   └── styles.css        # Custom styles with dark mode
 │   │   └── js/
-│   │       └── app.js            # Frontend JavaScript
+│   │       └── app.js            # Frontend JS (dark mode, easter eggs)
 │   └── templates/
-│       ├── layout.html           # Base template
+│       ├── layout.html           # Base template with navbar
 │       ├── home.html             # Home page
 │       ├── calendar.html         # Calendar page
 │       ├── tasks.html            # Tasks page
+│       ├── profile.html          # User profile page
+│       ├── leaderboard.html      # Leaderboard page
+│       ├── games.html            # Games menu page
+│       ├── riddle_game.html      # Riddle game page
+│       ├── math_game.html        # Math game page
+│       ├── system_monitor.html   # System monitor dashboard
 │       ├── about.html            # About page
 │       └── contact.html          # Contact page
 ├── tests/
-│   ├── test_api.py              # API tests
-│   └── test_pages.py            # Page tests
+│   ├── conftest.py              # Pytest configuration
+│   ├── test_api.py              # API endpoint tests
+│   ├── test_pages.py            # Page rendering tests
+│   └── test_system.py           # System monitoring tests
 ├── docs/
 │   ├── api.md                   # API documentation
 │   ├── overview.md              # Project overview

app/__init__.py

@@ -7,6 +7,15 @@
 from .routes import main_bp
 
 
+def format_bytes(bytes_value):
+    """Convert bytes to human readable format."""
+    for unit in ["B", "KB", "MB", "GB", "TB"]:
+        if bytes_value < 1024:
+            return f"{bytes_value:.2f} {unit}"
+        bytes_value /= 1024
+    return f"{bytes_value:.2f} PB"
+
+
 def create_app(config_object=None):
     app = Flask(__name__, instance_relative_config=True)
     config_object = config_object or "app.config.Config"
@@ -18,4 +27,7 @@ def create_app(config_object=None):
     app.register_blueprint(health_bp)
     register_error_handlers(app)
 
+    # Register custom Jinja2 filters
+    app.jinja_env.filters["format_bytes"] = format_bytes
+
     return app

app/calendar_manager.py

@@ -5,8 +5,9 @@
 class EventCalendar:
     """Simple event calendar management."""
 
-    def __init__(self):
+    def __init__(self, task_manager=None):
         self.events = {}
+        self.task_manager = task_manager
 
     def add_event(self, date_str, event_name):
         """Add an event to a specific date."""
@@ -18,6 +19,28 @@ def get_events(self, date_str):
         """Get events for a specific date."""
         return self.events.get(date_str, [])
 
+    def get_tasks_for_date(self, date_str):
+        """Get tasks for a specific date."""
+        if not self.task_manager:
+            return []
+
+        # Parse the date string to get year, month, day
+        try:
+            year, month, day = map(int, date_str.split('-'))
+            target_date = datetime(year, month, day).date()
+
+            # Get all tasks and filter by due date
+            all_tasks = self.task_manager.get_all_tasks()
+            date_tasks = []
+
+            for task in all_tasks:
+                if hasattr(task, 'due_date') and task.due_date == target_date:
+                    date_tasks.append(task)
+
+            return date_tasks
+        except (ValueError, AttributeError):
+            return []
+
     def get_calendar_data(self, year, month):
         """Get calendar data for a specific month."""
         cal_data = []
@@ -27,13 +50,14 @@ def get_calendar_data(self, year, month):
             week_data = []
             for day in week:
                 if day == 0:
-                    week_data.append({"day": None, "events": []})
+                    week_data.append({"day": None, "events": [], "tasks": []})
                 else:
                     date_str = f"{year}-{month:02d}-{day:02d}"
                     week_data.append({
                         "day": day,
                         "date": date_str,
                         "events": self.get_events(date_str),
+                        "tasks": self.get_tasks_for_date(date_str),
                         "is_today": self._is_today(year, month, day),
                     })
             cal_data.append(week_data)

app/routes.py

@@ -7,14 +7,16 @@
 from .task_manager import TaskManager
 from .gamification import GamificationManager
 from .minigames import MiniGame
+from .system_monitor import SystemMonitor
 
 main_bp = Blueprint("main", __name__)
 
 # Initialize managers
-event_calendar = EventCalendar()
 task_manager = TaskManager()
+event_calendar = EventCalendar(task_manager)
 game_manager = GamificationManager()
 mini_game = MiniGame()
+system_monitor = SystemMonitor()
 
 # Pre-populate sample events and tasks
 event_calendar.add_event("2026-04-11", "Team Meeting")
@@ -99,6 +101,28 @@ def calendar():
     return render_template("calendar.html", **context)
 
 
+@main_bp.route("/calendar/add-task", methods=["POST"])
+def add_calendar_task():
+    """Add a task from the calendar modal."""
+    date_str = request.form.get("date")
+    title = request.form.get("title")
+    description = request.form.get("description", "")
+    priority = request.form.get("priority", "medium")
+
+    if not title or not date_str:
+        return redirect(url_for("main.calendar"))
+
+    # Add the task with due date
+    task_manager.add_task(title, description, priority, due_date=date_str)
+
+    # Award points for adding a task
+    user_id = _get_user_id()
+    game_manager.add_points(user_id, 5)
+    game_manager.add_badge(user_id, "task_creator")
+
+    return redirect(url_for("main.calendar"))
+
+
 @main_bp.route("/tasks", methods=["GET", "POST"])
 def tasks():
     """Display and manage tasks."""
@@ -125,10 +149,10 @@ def toggle_task(task_id):
     """Toggle task completion status."""
     user_id = _get_user_id()
     task = task_manager.get_task(task_id)
-    if task and not task["completed"]:
+    if task and not task.completed:
         game_manager.increment_task_count(user_id)
     if task:
-        task_manager.update_task(task_id, completed=not task["completed"])
+        task_manager.update_task(task_id, completed=not task.completed)
 
     return redirect(url_for("main.tasks"))
 
@@ -242,3 +266,61 @@ def math_game():
     context["math"] = mini_game.quick_math()
 
     return render_template("math_game.html", **context)
+
+
+@main_bp.route("/system", methods=["GET"])
+def system_monitor_page():
+    """Display system performance monitoring."""
+    context = _template_context()
+    context["title"] = "System Monitor"
+    
+    system_info = system_monitor.get_all_info()
+    context["system_info"] = system_info["system"]
+    context["cpu_info"] = system_info["cpu"]
+    context["memory_info"] = system_info["memory"]
+    context["disk_info"] = system_info["disk"]
+    context["network_info"] = system_info["network"]
+    context["network_io"] = system_info["network_io"]
+    context["battery_info"] = system_info["battery"]
+    context["boot_time"] = system_info["boot_time"]
+    context["processes"] = system_info["processes"]
+    context["format_bytes"] = system_monitor.format_bytes
+    
+    return render_template("system_monitor.html", **context)
+
+
+@main_bp.route("/api/v1/system/info", methods=["GET"])
+def api_system_info():
+    """API endpoint for system information."""
+    return jsonify(system_monitor.get_all_info())
+
+
+@main_bp.route("/api/v1/system/cpu", methods=["GET"])
+def api_cpu_info():
+    """API endpoint for CPU information."""
+    return jsonify(system_monitor.get_cpu_info())
+
+
+@main_bp.route("/api/v1/system/memory", methods=["GET"])
+def api_memory_info():
+    """API endpoint for memory information."""
+    return jsonify(system_monitor.get_memory_info())
+
+
+@main_bp.route("/api/v1/system/disk", methods=["GET"])
+def api_disk_info():
+    """API endpoint for disk information."""
+    return jsonify(system_monitor.get_disk_info())
+
+
+@main_bp.route("/api/v1/system/battery", methods=["GET"])
+def api_battery_info():
+    """API endpoint for battery information."""
+    return jsonify(system_monitor.get_battery_info())
+
+
+@main_bp.route("/api/v1/system/network", methods=["GET"])
+def api_network_info():
+    """API endpoint for network information."""
+    network_data = system_monitor.get_network_info()
+    return jsonify(network_data)