Project Dashboard
Real-time overview of all 15 development phases and 11 products — March 2026
Products
Platform Architecture
🎨 Legend
User Action
Auth / Platform
Cloud / Registry
Product / Feature
Scheduler
Error / Blocked
Decision
STEP 1 — User Onboarding & Registration
👤 New Subscriber
Joins Telegram Channel
💳 Payment Processed
⤵ Triggers automatic extraction (or admin manually clicks “Refresh Users”)
☁ Cloud Extractor Job
Auto: 08:00 | 14:00 | 22:00 IST
Manual: Admin → Refresh Users
Manual: Admin → Refresh Users
→
Telethon reads TG Channel
Fetches all channel members
→
User in registry?
→ NO
INSERT user
sub_end = now + 30d
sub_end = now + 30d
YES ↓ UPDATE sub_end (extend if payment found)
💾 cloud_users DB
id • phone • username • channel_id
status • subscription_start • subscription_end
status • subscription_start • subscription_end
→
Ready for Login
STEP 2 — Authentication & Session Creation
User opens login.html
Enters phone number
e.g. +91 98765 43210 Registry Lookup
e.g. +91 98765 43210 Registry Lookup
↓ Three checks performed in sequence:
① Phone found?
NOT FOUND
Attempt counter++ 2 failures? 🔒 LOCKED
Helpdesk ticket
Attempt counter++ 2 failures? 🔒 LOCKED
Helpdesk ticket
② sub_end valid?
EXPIRED
Deny → Renew
Deny → Renew
User must re-subscribe
③ Channel active?
DISABLED
Channel suspended
Channel suspended
Admin re-enables channel
✓ All 3 checks pass ↓
Create 48h Session
localStorage • expires_at = now + 48h
→
Load allowed_products[]
From channel.products[] in DB
→
Dashboard
Session warning banner shown when <4h remaining • Auto-logout on expiry • Re-login required every 48h
STEP 3 — Product Access Control
User clicks product in Dashboard
auth.js: guardProduct(product-id)
Session valid?
NO →
Redirect → login.html
YES ↓
product-id in
session.allowed_products[]?
session.allowed_products[]?
NO →
🔒 Locked Overlay
"Upgrade your plan" Helpdesk Ticket
"Upgrade your plan" Helpdesk Ticket
YES ↓
✓ Full Product UI Loads
STEP 4 — Products & Feature Containers (All 11 Products)
Each product has 3 core functional categories. Features inside each box = what developers build. Gold border = product node. Click a product in the sidebar to see full detail.
🎬 Video Operations Month 1
⬇️ Downloaders
MP3 Extractor
YouTube to Audio (MP3)
🛠 Utility / Processing
GPU Detect & Toggle
Video Trim (GPU/CPU)
Merge Videos
Watermark Adder
Embed Subtitles
Subtitle Generator
File Analyzer
Platform Eligibility Checker
Progress Bar
Bandwidth Monitor
⏰ Automation
Local Scheduler
Cloud Scheduler
⬇️ Downloader Month 1
⬇️ Downloaders
URL Input (auto-detect)
Extraction Engine (yt-dlp)
Download Strategy
🛠 Utility
Speed Controller
Progress Bar
Bandwidth Monitor
Integrity Check (aria2c)
Media Storage
CSV Export
Proxy Usage
⏰ Automation
Parallel Downloads (1-5)
Local Scheduler
Cloud Scheduler
▶️ YouTube (Playwright) Month 2
⬇️ Downloaders
Comments Extractor
Comments+Replies Extractor
Followers Extract
Statistics Extract
📤 Posting
Video Posting
AI Metadata Enricher
⏰ Automation
Multi-Channel Support
Account Isolation
Proxy Usage
Local / Cloud Scheduler
𝕏 Twitter / X (TwitterAPI.io) Month 1
⬇️ Downloaders
Comments Extractor
Followers Extractor
Media Downloader
📤 Posting
Post / Thread
Like / Repost
Reply Chains
AI Thread Generator
⏰ Automation
Follow / Unfollow
Proxy + Multi-Account
Local / Cloud Scheduler
📸 Instagram (Instagrapi) Month 1
⬇️ Downloaders
Media Downloader
Comments Extractor
Followers Extract
📤 Posting
Post / Story / Reel
Tag Generator
AI Tag Generator
⏰ Automation
Follow / Unfollow
Proxy + Multi-Account
Local / Cloud Scheduler
✈️ Telegram (Telethon) Month 1
⬇️ Downloaders
Message Extractor
Media Downloader
Member Extractor
📤 Posting
Channel Posting
Broadcast Messaging
AI Content
⏰ Automation
Multi-Channel Publish
Local / Cloud Scheduler
🤖 Reddit (PRAW) Month 2
⬇️ Downloaders
Post Extractor
Comments Extractor
Media Downloader
📤 Posting
Submit Post
Comment / Reply
⏰ Automation
Subreddit Monitor
Proxy + Multi-Account
📝 Medium (Playwright) Month 2
📤 Posting
Publish Article
Pre-Publish Preview
AI Content Generation
Content Derivation
⏰ Automation
Multi-Publication
Proxy + Local / Cloud Scheduler
🔌 Chrome Plugin Month 2
⬇️ Downloaders
Page Content Scraper
Social Media Quick Downloader
📤 Posting
Quick-Post from Browser
Caption AI Generator
⏰ Automation
Background Sync
Native Host Bridge
📢 Advertisement Month 3
📤 Posting
Campaign Builder
Cross-Platform Publisher
Audience Targeting
⏰ Automation
Budget Controller
A/B Test Runner
Performance Analytics
🏷️ Metadata Enricher Month 3
⬇️ Downloaders
Metadata Fetch (EXIF / ID3)
Image Fetch
🛠 Utility
Schema Normalization
CSV Export
⏰ Automation
Nightly Batch Enrichment
Cloud Enrichment Pipeline
STEP 5 — Cloud Infrastructure & Data Flow
💻 Client (Desktop App)
auth.js reads session (localStorage)
Calls FastAPI via Cloudflare Tunnel
Local scheduler runs on device
yt-dlp / FFmpeg run locally
⇆
HTTPS via
CF Tunnel
HTTPS via
CF Tunnel
🛡️ Cloudflare Edge
WAF • DDoS Protection
Zero Trust Access
Tunnel → Private API Server
Real server IP hidden
→
📡 FastAPI Server
POST /auth/login → registry check
GET /products → entitlements
POST /extract → trigger extractor
POST /jobs → cloud job dispatch
GET /diagnostics → log upload
→
💾 PostgreSQL / SQLite
cloud_users table
channels table
scheduler_jobs table
audit_log (1yr TTL)
🗂️ S3 Storage
Cloud-downloaded media (7d TTL)
Diagnostic logs: <user>_<dt>_<EID>.log
CSV exports (30d TTL)
→
💻 Cloud Workers
Pull jobs from Redis queue
Stateless Python workers
Whisper STT inference
Bulk media processing
Results → S3 + DB
⏰ Cloud Extractor Job Flow (runs 3× daily)
Cron: 08:00 / 14:00 / 22:00 IST
existing get sub_end extended
→
Telethon: fetch all TG channel members
→
Compare with cloud_users
→
UPSERT: new users inserted,existing get sub_end extended
→
Extraction log written
→
✓ Registry updated
STEP 6 — Scheduler Architecture (Local & Cloud)
💻 Local Scheduler (On-Device)
SQLite job queue (local DB)
Cron expression per job
Max 2 concurrent workers
30s poll interval
Retry: 5min → 15min → 60min (max 3)
All runs logged (result + duration)
Job triggered (cron or manual)
Slots < 2?
NO →
Queue → wait
YES ↓
Execute Job
Log result to SQLite
☁️ Cloud Scheduler (Enterprise)
Redis AOF job queue (cloud)
Job ownership tracked per user
Stateless workers scale horizontally
Runs 24/7 — no client required online
Results pushed to S3 + DB
Entitlement check before execution
User schedules cloud job
Entitlement = Enterprise?
NO →
🔒 Blocked
YES ↓
Enqueue to Redis
Worker executes
Result → S3 + notify
STEP 7 — Error Logging & Diagnostic Framework
⚠️ Exception Thrown
TRY/CATCH wraps all operations
Unique Error ID tagged
e.g. ERR-VIDEOOPS-042
→
📄 Capture Context
Last executed statement
Full command output
Stack trace
Timestamp + user + product
→
☁️ Upload Diagnostic
Filename: <user>_<datetime>_<ErrorID>.log
Stored in S3 (30d TTL)
Admin retrieves via Admin Panel
→
📊 UI Notification
Error shown in UI bar
ZERO browser alert() dialogs
Debug mode ON/OFF flag
One log statement per code block