LinkedMind AI - System Architecture Document

Product Name: LinkedMind AI

Owner: Itisha Dubey

Version: 1.0

Last Updated: April 10, 2026

Status: LIVE

1. System Architecture Overview

High-Level Component Diagram

┌─────────────────────────────────────────────────────────────────┐
│                     LINKEDMIND AI - HIGH LEVEL                   │
├─────────────────────────────────────────────────────────────────┤
│                                                                   │
│   ┌──────────────┐      ┌────────────────┐    ┌─────────────┐   │
│   │   Telegram   │      │  Trending      │    │   Claude    │   │
│   │   Bot API    │      │  Topics        │    │   API       │   │
│   │              │      │  (NewsAPI)     │    │   (Content  │   │
│   │  • Messages  │      │                │    │   Gen)      │   │
│   │  • Buttons   │      │  • Cache layer │    │             │   │
│   │  • Commands  │      │                │    │   • Vision  │   │
│   └──────────────┘      └────────────────┘    └─────────────┘   │
│         ▲                                              │           │
│         │                                              │           │
│         └──────────────────────────────────────────────┘           │
│                                                                   │
│                   ┌──────────────────────┐                        │
│                   │   BOT ENGINE CORE    │                        │
│                   │  (Python + APScheduler)                       │
│                   │                      │                        │
│                   │  1. Scheduler        │                        │
│                   │  2. State Manager    │                        │
│                   │  3. Prompt Engineer  │                        │
│                   │  4. API Integrator   │                        │
│                   └──────────────────────┘                        │
│                                                                   │
│   ┌──────────────┐      ┌────────────────┐    ┌─────────────┐   │
│   │  Database    │      │  Manual Post   │    │   Logging & │   │
│   │  (Posts +    │      │   Workflow     │    │   Tracking  │   │
│   │   Metadata)  │      │                │    │             │   │
│   │              │      │  • Copy-paste  │    │   • Posts   │   │
│   │  • JSON/     │      │  • Share link  │    │   • Events  │   │
│   │    SQLite    │      │                │    │   • Errors  │   │
│   │              │      │                │    │             │   │
│   └──────────────┘      └────────────────┘    └─────────────┘   │
│                                                                   │
└─────────────────────────────────────────────────────────────────┘

2. Component Architecture & Responsibilities

Component 1: Telegram Bot Engine

Technology: python-telegram-bot (or aiogram)

Responsibility: User interface for all interactions

Key Methods:

- send_daily_prompt()           # 7-8 PM: Q1 + Q2
- send_trending_topics()        # Include 3-4 options
- send_generated_post()         # Post preview + buttons
- send_11pm_reminder()          # Final reminder before auto-post
- handle_approval_button()      # Approve workflow
- handle_edit_button()          # Edit workflow
- handle_chat_command()         # "post", "send it", "edit", "skip"
- send_confirmation()           # Post success message + instructions

Data Flow:

User Input (Telegram) 
  → Message/Button Handler 
  → State Update (JSON/DB) 
  → Bot Engine Logic 
  → Telegram Response