Skip to content

HoshiBatista/BSTU-applicant-application-form

BSTU Applicant Application Form Bot

License Build Status GitHub Stars GitHub Forks Last Commit

πŸ“Œ Description

BSTU Applicant Application Form Bot is a Telegram bot designed to assist prospective applicants of Belgorod State Technological University named after V. G. Shukhov (BSTU) in filling out application forms. The collected data is used for statistical analysis and to improve the university's admission process.

✨ Features

  • πŸ“„ Structured data collection: gathers information about the school, class, study profile, exam subjects, etc.
  • πŸ“Š Statistical analysis: helps the university analyze applicant data.
  • πŸ€– User-friendly interface: intuitive conversation flow in Telegram.
  • πŸ”’ Data privacy and security: ensures safe data handling.
  • πŸ“‚ Database storage: all forms are stored in MongoDB.

πŸš€ Technologies Used

Python Aiogram MongoDB dotenv Docker

πŸ›  Installation and Setup

1️⃣ Clone the Repository

git clone https://github.com/your-username/BSTU-applicant-application-form.git
cd BSTU-applicant-application-form

2️⃣ Install Dependencies

pip install -r requirements.txt

3️⃣ Create .env File

Create a .env file and add the necessary environment variables:

BOT_TOKEN=your_telegram_bot_token
MONGO_URI=your_mongodb_connection_string

4️⃣ Run the Bot

python3 main.py

πŸ“Œ Usage

  1. Start the bot in Telegram using the /start command.
  2. Follow the instructions to fill out the application form.
  3. Confirm and submit your data.
  4. Your information will be securely stored in the database.

πŸ›  Deployment

The bot can be deployed using:

  • Docker: with the provided Dockerfile.
  • Heroku: using Heroku CLI.
  • VPS: managed via systemd.

πŸ’‘ Contributing

  1. Fork the repository.
  2. Create a new branch: git checkout -b feature-branch.
  3. Make changes and commit: git commit -m 'Added a new feature'.
  4. Submit a pull request πŸš€

πŸ“œ License

This project is distributed under the LICENSE.


🀝 Contact:

Telegram GitHub

About

BSTU applicant application form

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published