{"id":28003265,"url":"https://github.com/mrconsoleka/network-city-helper","last_synced_at":"2025-05-09T02:00:11.769Z","repository":{"id":262669523,"uuid":"886609638","full_name":"MrConsoleka/Network-City-Helper","owner":"MrConsoleka","description":"🤖 Telegram bot to help students study","archived":false,"fork":false,"pushed_at":"2024-12-01T10:09:21.000Z","size":966,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-09T02:00:06.788Z","etag":null,"topics":["aiogram3","netschool","python3","sgo-edu","telegram","telegram-bot"],"latest_commit_sha":null,"homepage":"https://t.me/sgo_edu_helper_bot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MrConsoleka.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-11T09:34:22.000Z","updated_at":"2025-04-02T15:18:49.000Z","dependencies_parsed_at":"2024-12-02T09:43:02.748Z","dependency_job_id":"d13bcecf-bfd2-492b-a765-9c6d286f1cc7","html_url":"https://github.com/MrConsoleka/Network-City-Helper","commit_stats":null,"previous_names":["mrenderman-yt/network-city-helper","consoleka/network-city-helper","mrconsoleka/network-city-helper"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrConsoleka%2FNetwork-City-Helper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrConsoleka%2FNetwork-City-Helper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrConsoleka%2FNetwork-City-Helper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrConsoleka%2FNetwork-City-Helper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MrConsoleka","download_url":"https://codeload.github.com/MrConsoleka/Network-City-Helper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253176434,"owners_count":21866142,"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":["aiogram3","netschool","python3","sgo-edu","telegram","telegram-bot"],"created_at":"2025-05-09T02:00:10.720Z","updated_at":"2025-05-09T02:00:11.568Z","avatar_url":"https://github.com/MrConsoleka.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"source/data/images/banner standart github.png\"\u003e\n\n\u003ch1\u003eNetwork City Helper\u003c/h1\u003e\n\n\u003cimg alt=\"Static Badge\" src=\"https://img.shields.io/badge/tag-v1.0.0-blue?logo=codenewbie\u0026logoColor=007EC6\"\u003e\n\n\u003cimg alt=\"Static Badge\" src=\"https://img.shields.io/badge/python-v3.11.9-yellow?logo=python\u0026logoColor=FBDE02\u0026labelColor=gray\u0026color=FFE100\"\u003e\n\u003cimg alt=\"Static Badge\" src=\"https://img.shields.io/badge/bot-Network%20City%20Helper-12C427?logo=dependabot\u0026logoColor=12C427\"\u003e\n\u003cimg alt=\"Static Badge\" src=\"https://img.shields.io/badge/license-MIT-12C4C4?style=flat\u0026logo=gitbook\u0026logoColor=12C4C4\"\u003e\n\n\u003c/div\u003e\n⠀\n\n\u003e [!CAUTION]\n\u003e Бот не имеет отношения к «ИрТеху»\n⠀\n## 📌 Description\n⠀\n\n**Network City Helper** — это ваш персональный телеграм-бот, созданный для оказания помощи ученикам в учебном процессе. Он взаимодействует с платформой \"Сетевой город\", предлагает широкий спектр функций, направленных на упрощение организации учебного времени и управления задачами. Бот может отправлять итоговые оценки и уведомления о просроченных заданиях, а также делиться актуальным расписанием и домашним заданием на завтрашний день.\n\n_Тем не менее, стоит отметить, что предоставленный код нуждается в доработке. В текущем виде он может содержать избыточные участки кода, которые могут быть оптимизированы для повышения производительности и улучшения читаемости._\n\n⠀\n## 🔨 Functions\n⠀\n\n### 📗 Пользователские:\n* `/start` - запуск бота\n* `/help` - помощь\n* `/menu` - меню бота\n\n### 📕 Администраторские:\n* `/bells_load` - загрузить расписания звонков\n* `/holidays_load` - загрузить расписания каникул\n* `/timetable_load` - загрузить расписания уроков\n\n⠀\n## 🔓 Bot .env\n⠀\n\n| Имя переменной среды      | Описание                                                     |\n|---------------------------|--------------------------------------------------------------|\n| BOT_TOKEN                 | Токен от вашего Telegram-бота, вы можете получить его в Telegram в боте с логином @botfather.|\n| LOGGER                    | Уровень лоигрования (BASE, FULL)|\n| SECRET_KEY                | Секретный ключ шифрования данных для бд|\n| PARSE_MODE                | Мод парсинга (HTML, MARKDOWNV2) |\n| ADMINS_ID                 | Айди администраторов|\n| DB_SQL                    | Название используемой sql (по умолчанию PostgreSQL)|\n| DB_LIB                    | Библиотека для взаимодейсвтия с бд|\n| DB_LOGIN                  | Логин пользователя бд|\n| DB_PASSWORD               | Пароль пользователя бд|\n| DB_HOST                   | Хост бд|\n| DB_PORT                   | Порт бд|\n| DB_NAME                   | Имя бд|\n\n\n⠀\n## 💻 Bot setup\n⠀\n\n1. Клонируйте репозиторий и перейдите в каталог проекта:\n\n```shell\ngit clone https://github.com/MrEnderman-YT/Network-City-Helper.git\ncd Network-City-Helper\n```\n⠀\n\n2. Создайте виртуальное окружение\n\n```shell\npython -m venv venv\n```\n⠀\n\n3. Активируйте виртуальное окружение\n\n```shell\n# For Linux or macOS:\nsource venv/bin/activate\n\n# For Windows:\nvenv\\Scripts\\activate\n```\n⠀\n\n4. Установите нужные библиотеки из файла `requirements.txt`:\n\n```shell\npip install -r requirements.txt\n```\n⠀\n\n5. Для запуска бота используйте команду:\n\n```\npython bot.py\n```\n⠀\n\n\u003e [!IMPORTANT]\n\u003e Используйте версию python 3.11 и ниже!\n\u003e \n⠀\n## 📋 Todo List\n⠀\n\n- [x] Создать данный Todo list\n- [x] Доделать readme гитхаба.\n- [ ] Сделать функцию просмотра оценок\n- [ ] Сделать калькулятор оценок\n- [ ] Сделать возможность входа через гос-услуги\n\n⠀\n## 🗃️ Library stack\n⠀\n\n* [Aiogram-3](https://github.com/aiogram/aiogram) - полностью асинхронный фреймворк для Telegram Bot API\n* [AsyncPG](https://github.com/MagicStack/asyncpg) - библиотека Python для работы с базами данных PostgreSQL.\n* [Schedule](https://pypi.org/project/schedule/) - Планировщик заданий.\n* [Cryptography](https://pypi.org/project/cryptography/) - Библиотека для обеспечения безопасности и конфиденциальности данных (шифровка данных).\n* [NetSchoolAPI-fork](https://github.com/MrEnderman-YT/netschoolapi) - мой форк асинхронный клиент для «Сетевого города»\n\n⠀\n## 💼 Credits\n⠀\n\n* [NetSchoolAPI](https://github.com/nm17/netschoolapi) - асинхронный клиент для «Сетевого города»\n\n⠀\n## 👤 Author of Network City Helper\n**© Алексеев Роман**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrconsoleka%2Fnetwork-city-helper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrconsoleka%2Fnetwork-city-helper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrconsoleka%2Fnetwork-city-helper/lists"}