Messaging Bots1 ACTIVE MODULES

PaYesh Karname

An automated watcher daemon monitoring national exam results with instant multi-messenger alerts.

PaYesh Karname is a high-reliability Node.js automation daemon that actively monitors national final exam evaluation portals. The instant scores are revised, papers are assigned to evaluators, or daily objection windows open, it dispatches push notifications to Bale and Telegram.

Messenger NetworkMessaging BotsAutomation Pipeline

Project Status: Production Utility

The Engineering Problem Architectural Goals Core Capabilities & Mechanics Technology Stack by Component System Architecture Deep-Dive Repository Source Matrix (1)

The Engineering Problem

During critical national examination objection windows, portal servers experience severe overload and random schedule shifts. Students must spend hours refreshing slow web pages to catch grade updates or register objection requests.

Target Users & Stakeholders

Students, academic counselors, and parents needing instant, hands-free notifications regarding national exam grade adjustments.

Architectural Goals

Zero-delay notifications the moment a paper status changes or review scores update.

Automatic detection of evaluation locks signaling a paper has been assigned to a human grader.

Assisting in prompt objection registrations during narrow daily SMS authorization windows.

Periodic digest reports delivered straight into preferred messaging channels.

Core Capabilities & Mechanics

SPEC 01

Real-time Score Delta Tracking

Detects even fractional score changes and alerts the user with an exact delta breakdown.

SPEC 02

Grader Assignment Detection

Monitors interface lock states to confirm exactly when an exam paper moves to the grading queue.

SPEC 03

Objection Window Assistant

Alerts when the daily submission threshold unlocks, collecting necessary two-factor codes via chat.

SPEC 04

Multi-Platform Dispatcher

Simultaneously alerts both Telegram and Bale messaging channels to ensure delivery resilience.

Technology Stack by Component

Core Service

Node.js 20+Bale Bot APITelegram Bot APISession PersistenceHTML Parser

System Architecture Deep-Dive

Built on modern Node.js using resilient HTTP session polling, cryptographic payload hashing to identify DOM changes without false positives, and dual-webhook dispatchers to Bale and Telegram Bot APIs.

Technical Decisions & Trade-offs

Chat-Centric Operational Model

Turned the messenger conversation into the complete control console, removing the need for an external web dashboard.

Idempotent Polling Architecture

Engineered change-detection to prevent redundant alerts even during portal server resets or intermittent network drops.

Repository Source Matrix

1 CONNECTED REPOS

Automated Academic Monitor Daemon

PaYesh-Karname

GitHub