{"id":24960304,"url":"https://github.com/useraar/demo-bot","last_synced_at":"2025-03-28T21:24:29.129Z","repository":{"id":275198399,"uuid":"925381271","full_name":"UserAAR/demo-bot","owner":"UserAAR","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-09T23:40:10.000Z","size":31447,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-10T00:24:03.290Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UserAAR.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-31T19:13:08.000Z","updated_at":"2025-02-09T23:40:14.000Z","dependencies_parsed_at":"2025-01-31T20:34:28.973Z","dependency_job_id":null,"html_url":"https://github.com/UserAAR/demo-bot","commit_stats":null,"previous_names":["useraar/demo-bot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UserAAR%2Fdemo-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UserAAR%2Fdemo-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UserAAR%2Fdemo-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UserAAR%2Fdemo-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UserAAR","download_url":"https://codeload.github.com/UserAAR/demo-bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246101880,"owners_count":20723716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-03T08:07:44.000Z","updated_at":"2025-03-28T21:24:29.103Z","avatar_url":"https://github.com/UserAAR.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DevAAR Telegram Bot 🤖\n\nDevAAR is a multi-functional Telegram bot built with Java and Spring Boot. It is designed to provide interactive services ranging from personal information and education details to fun commands and utility tools. This project aims to offer a flexible solution for both individual users and developers who want to explore or contribute to its functionality.\n\n**Demo Bot:** [@LMSdemobot](https://t.me/LMSdemobot)  \n*Try out our demo bot to explore its features. If you notice any missing functionality or have suggestions, future updates will address these improvements.*\n\n---\n\n## Table of Contents 📜\n- [Features](#features-)\n- [Technology Stack](#technology-stack-)\n- [Installation](#installation-)\n- [Configuration](#configuration-)\n- [Usage](#usage-)\n- [Project Structure](#project-structure-)\n- [Development](#development-)\n- [License](#license-)\n\n---\n\n## Features 🚀\n\n### Core Features\n- **Personal Info:** `/personal`, `/skills`, `/coding`  \n  *Share and display your personal details, skills, and coding experiences.*\n\n- **Education History:** `/education`  \n  *Showcase your educational background.*\n\n- **Contact Info:** `/contact`  \n  *Provide easy access to your contact details.*\n\n- **Hobbies:** `/hobbies`  \n  *Track and share your hobbies.*\n\n### Entertainment Commands\n- Random jokes: `/joke`\n- Motivational quotes: `/quote`\n- Interesting facts: `/fact`\n- Magic 8-Ball: `/magic8`\n- Roll a dice: `/dice`\n- Flip a coin: `/coinflip`\n\n### Utility Tools\n- Math calculations: `/calculate 5+3*2`\n- Secure password generator: `/password 12`\n- ASCII art generator: `/ascii Hello`\n- Todo List management: `/todo add ...`\n\n---\n\n## Technology Stack 💻\n\n- **Core Framework:** Java 21, Spring Boot 3.2\n- **Telegram API:** TelegramBots 6.9.7\n- **Data Parsing:** Jackson XML 2.15\n- **Logging:** SLF4J + Logback\n- **Build Tool:** Gradle\n\n---\n\n## Installation ⚙️\n\n1. **Clone the repository:**\n   ```bash\n   git clone https://github.com/UserAAR/demo-bot.git\n   ```\n\n2. **Install dependencies:**\n   ```bash\n   mvn clean install\n   ```\n\n3. **Create the configuration file:**  \n   Create a file at `src/main/resources/application.properties` and add the following:\n   ```properties\n   # src/main/resources/application.properties\n   telegram.bot.username=YOUR_BOT_USERNAME\n   telegram.bot.token=YOUR_BOT_TOKEN\n   ```\n\n---\n\n## Configuration 🔧\n\n**Required Parameters**\n```properties\ntelegram.bot.username=  # Your bot username from BotFather\ntelegram.bot.token=     # Your bot token from BotFather\n```\n\n**Optional Parameters**\n```properties\n# File paths and limits\nuser.info.filepath=userdata.txt\ncv.filepath=classpath:cv.pdf\n```\n\n---\n\n## Usage 📋\n\n**Command List:**\n\n| Command   | Description                        | Example   |\n|-----------|------------------------------------|-----------|\n| `/start`  | Starts the bot                     | `/start`  |\n| `/help`   | Displays the help menu             | `/help`   |\n| `/cv`     | Sends a PDF version of the CV      | `/cv`     |\n| `/weather`| Shows the weather for Baku         | `/weather`|\n\nFor detailed examples of each command, please refer to our demo bot.\n\n---\n\n## Project Structure 🏗️\n\nThe project is organized as follows:\n\n```\nsrc/\n├── main/\n│   ├── java/\n│   │   └── com/devaar/\n│   │       ├── bot/          # Bot logic and command handlers\n│   │       ├── config/       # Spring configuration files\n│   │       ├── model/        # Data Transfer Objects (DTOs)\n│   │       └── util/         # Utility classes and helpers\n│   └── resources/\n│       ├── static/           # Static files (e.g., CV)\n│       └── application.properties\n```\n\nThis structure ensures the code is modular, easy to read, and maintainable.\n\n---\n\n## Development 🛠️\n\n**Planned Improvements:**\n\n- Integration with a PostgreSQL database\n- A web-based admin panel\n- A user statistics dashboard\n\n*Note:* While the current implementation provides core functionality, additional features and improvements are planned for future updates. If you see any areas for enhancement, your contributions are welcome!\n\n**Contribution Guidelines:**\n\n1. **Run Tests:**  \n   Before creating a pull request, make sure all tests pass.\n   ```bash\n   mvn test\n   ```\n\n2. **Follow Code Standards:**  \n   Write clean and readable code. For example:\n   ```java\n   // Example of good coding practice\n   public class Example {\n       public void doSomething(String input) {\n           if (input == null) {\n               throw new IllegalArgumentException(\"Input cannot be null\");\n           }\n           // Business logic here\n       }\n   }\n   ```\n\nYour contributions and suggestions will help shape the future of this project.\n\n---\n\n## License 📄\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n---\n\n**Credits:**\n\n- [TelegramBots library](https://github.com/rubenlagus/TelegramBots)\n- Spring Boot Team\n\n---\n\n**Overview:**\n- 🚀 A wide range of features and a modular structure\n- 📋 Easy setup and configuration instructions\n- 🛠️ Planned improvements for future updates\n- 💻 A guide for developers to contribute effectively\n\nSimply copy this into your `README.md` file and replace placeholder values (like `YOUR_BOT_TOKEN`). Enjoy exploring and enhancing the DevAAR Telegram Bot!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fuseraar%2Fdemo-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fuseraar%2Fdemo-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fuseraar%2Fdemo-bot/lists"}