Skip to content

architecture-diagram.md

Latest commit

 

History

History
99 lines (70 loc) · 4 KB

architecture-diagram.md

File metadata and controls

99 lines (70 loc) · 4 KB

Task Scheduler Bot - System Architecture

Overview

High-level architecture showing the main system components and data flow for the intelligent task scheduling bot.

System Architecture

graph TB
    %% Users and Interfaces
    User[👤 User]

    %% Core System Components
    subgraph Platform["🤖 Task Scheduler Bot Platform"]
        Interface[📱 Telegram Interface<br/>• Natural language input<br/>• Conversational UI<br/>• Command handling]

        Brain[🧠 AI Processing Engine<br/>• Task understanding<br/>• Priority assessment<br/>• Context awareness]

        Scheduler[📅 Intelligent Scheduler<br/>• Time slot optimization<br/>• Conflict resolution<br/>• Energy-based scheduling]
    end

    %% External Services
    subgraph External["🌐 External Services"]
        Calendar[📅 Google Calendar<br/>• Event storage<br/>• Time blocking<br/>• Schedule management]

        Database[📊 Google Sheets<br/>• Task metadata<br/>• Priority tracking<br/>• Status management]

        AI[🤖 OpenAI GPT-4<br/>• Language understanding<br/>• Task extraction<br/>• Smart parsing]
    end

    %% Infrastructure
    subgraph Infrastructure["☁️ Infrastructure"]
        Hosting[⚡ Vercel Serverless<br/>• Auto-scaling<br/>• Global deployment<br/>• Zero config]
    end

    %% Main Data Flow
    User -->|"Schedule meeting with John at 2pm tomorrow"| Interface
    Interface -->|Natural language| Brain
    Brain <-->|Task parsing & validation| AI
    Brain -->|Structured task data| Scheduler

    Scheduler <-->|Check availability & conflicts| Calendar
    Scheduler <-->|Save task metadata & status| Database

    Scheduler -->|Optimal time slot| Brain
    Brain -->|Formatted confirmation| Interface
    Interface -->|"✅ Meeting scheduled for 2:00 PM"| User

    %% Infrastructure connections
    Platform -.->|Hosted on| Hosting

    %% Styling
    classDef userStyle fill:#e3f2fd,stroke:#1976d2,stroke-width:3px,color:#000000
    classDef platformStyle fill:#e8f5e8,stroke:#388e3c,stroke-width:2px,color:#000000
    classDef externalStyle fill:#fff3e0,stroke:#f57c00,stroke-width:2px,color:#000000
    classDef infraStyle fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px,color:#000000

    class User userStyle
    class Interface,Brain,Scheduler platformStyle
    class Calendar,Database,AI externalStyle
    class Hosting infraStyle
Loading

Core System Components

🤖 Task Scheduler Bot Platform

The main application consisting of three key components:

  • Telegram Interface: Handles user interactions through natural language messaging
  • AI Processing Engine: Understands user intent and extracts structured task information
  • Intelligent Scheduler: Finds optimal time slots using calendar data and user preferences

🌐 External Services

  • Google Calendar: Primary calendar system for event storage and scheduling
  • Google Sheets: Task database for metadata, priorities, and status tracking
  • OpenAI GPT-4: AI service for natural language understanding and task parsing

☁️ Infrastructure

  • Vercel Serverless: Zero-config hosting platform with automatic scaling

High-Level Data Flow

  1. User Input → Natural language task requests via Telegram
  2. AI Processing → Extract structured task data (title, duration, priority, preferences)
  3. Smart Scheduling → Find optimal time slots considering calendar conflicts and user energy levels
  4. Dual Storage → Save events to Calendar and metadata to Sheets
  5. User Feedback → Confirmations and interactive management options

Key Capabilities

  • Natural Language Processing: Understands complex scheduling requests
  • Intelligent Time Management: Considers energy levels, priorities, and preferences
  • Conflict Resolution: Automatically avoids scheduling conflicts
  • Multi-Modal Storage: Events in Calendar, metadata in Sheets for comprehensive tracking
  • Conversational Interface: Chat-based interaction with inline keyboards for task management