Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/denver-code/passport-status-bot
Бот для моніторингу змін статусу вашої заявки на passport.mfa.gov.ua.
https://github.com/denver-code/passport-status-bot
bot gov-ua mfa passport telegram
Last synced: 3 days ago
JSON representation
Бот для моніторингу змін статусу вашої заявки на passport.mfa.gov.ua.
- Host: GitHub
- URL: https://github.com/denver-code/passport-status-bot
- Owner: denver-code
- License: mit
- Created: 2023-12-12T22:46:18.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-01-28T19:21:36.000Z (about 1 year ago)
- Last Synced: 2024-01-28T20:31:59.338Z (about 1 year ago)
- Topics: bot, gov-ua, mfa, passport, telegram
- Language: Python
- Homepage: https://t.me/passport_mfa_gov_ua_bot
- Size: 9.35 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# MFA Passport Dashboard bot
Telegram bot with useful tools for the community | Click to visit in real time.
# Важливе повідомлення
Станом на 28 Січ 2024 я помітив деяку активність репозиторія та боту, проте отримав свій паспорт досить давно, це робить підтримку бота не необхідною для мене і здебільшого марна трата ресурсів, отож підтримки рантайму самого бота в тг не буде, але ви завжди можете selfhostʼити чи забрати АПІ та використовувати у своїх проектах.
PR завжди відкриті :)
## Actual Demo (NOT!)
> [Note] Click on image.
Цей бот повідомляє про зміни статусу вашої заявки на _passport.mfa.gov.ua_ та надає можливість відстежувати її статус, оскільки МЗС не забезпечує такої можливості, чим створює незручності.
А саме те що потрібно вручну перевіряти кожного часу коли є можливість, щоб знати що хоч щось змінилося.
На даний момент бот надає можливості:
- Перевіряти статус заявки за простим надсиланням номера заявки, наприклад "1005562"
- Створення власного кабінету:
- Прив'язка заявки до кабінету
- Швидкий доступ до статусу заявки через кабінет
- Відстеження змін статусу через підписку (макс 5 підписок.)
- Пуш-повідомлення про зміну статусу заявки (працює тільки для підписок через NFTY.sh)
- Повний перелік команд бота:
## ToDo
- [x] Перевірка статусу заявки
- [x] Перевірка статусу заявки через кабінет
- [x] Підписка на зміни статусу заявки
- [x] Підписка на зміни статусу заявки через кабінет
- [x] Push-повідомлення про зміну статусу заявки
- [x] Refactoring
- [x] Docker-compose
- [x] Readme.md
- [x] QR-code scanner
- [ ] Analytics
- [x] Rate limit
- [ ] Inline buttons
- [ ] Improved structure
- [ ] Middlewares
## Changelog
[CHANGELOG.md](CHANGELOG.md)
## Installation
### Clone Repo
```bash
git clone https://github.com/denver-code/passport-status-bot
cd passport-status-bot
```
### Environment variables
Rename `example.env` to `.env` and fill it with your data.
```bash
cp example.env .env
vi .env
```
### Docker-compose
```bash
docker-compose up -d
```
### Manual
```bash
poetry install
poetry shell
python main.py
```
### Edit in VSCode
```bash
poetry install
poetry shell
code .
```
Then select interpreter in VSCode: `Ctrl+Shift+P` -> `Python: Select Interpreter` -> `Poetry Environment` or something like that.
## License
[MIT](LICENSE.md)