---
trigger: manual
---

# Workspace Rules: Raw PHP & React Telegram Bot

## 1. Technical Stack
- **Backend:** Pure/Raw PHP (No heavy frameworks). Code must be clean, secure, and object-oriented.
- **Frontend/Webview:** React and JavaScript for the bot's Web Apps (Mini Apps).

## 2. Bot Modular Architecture
- Handlers must be strictly separated (e.g., `StartHandler.php`, `CallbackHandler.php`). Do NOT bloat the main entry point file.
- All API interactions must strictly target Telegram Bot API 10.1+ standards. Do not use outdated webhooks or long-polling methods.
- For UI/Buttons, reuse the existing custom emoji schemes.

## 3. Development Constraints
- Do NOT run automated Webpack/Vite builds or npm scripts.
- Multi-language must be handled via a custom `lang/` directory containing JSON/Array files for `en` and `fa`.
- Summaries of work must be in Persian.