{"id":23064146,"url":"https://github.com/complicat9d/e-commerce-service","last_synced_at":"2026-04-26T20:31:36.503Z","repository":{"id":266217328,"uuid":"897691023","full_name":"complicat9d/e-commerce-service","owner":"complicat9d","description":"Service, comprising of telegram bot for browsing products cataloges, managing user shopping cart and processing orders, and admin panel on django framework","archived":false,"fork":false,"pushed_at":"2025-04-17T05:21:31.000Z","size":233,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-04T07:45:57.690Z","etag":null,"topics":["aiogram","django-admin","docker-compose","pydantic","pytetst","sqlalchemy"],"latest_commit_sha":null,"homepage":"","language":"Python","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/complicat9d.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,"zenodo":null}},"created_at":"2024-12-03T04:15:48.000Z","updated_at":"2025-04-17T05:21:34.000Z","dependencies_parsed_at":"2025-02-08T21:42:25.883Z","dependency_job_id":"a937870a-d01d-47ee-88d4-8f7df923204d","html_url":"https://github.com/complicat9d/e-commerce-service","commit_stats":null,"previous_names":["complicat9d/e-commerce-bot","complicat9d/e-commerce-service"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/complicat9d/e-commerce-service","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/complicat9d%2Fe-commerce-service","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/complicat9d%2Fe-commerce-service/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/complicat9d%2Fe-commerce-service/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/complicat9d%2Fe-commerce-service/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/complicat9d","download_url":"https://codeload.github.com/complicat9d/e-commerce-service/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/complicat9d%2Fe-commerce-service/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32312209,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T19:15:34.056Z","status":"ssl_error","status_checked_at":"2026-04-26T19:15:15.467Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["aiogram","django-admin","docker-compose","pydantic","pytetst","sqlalchemy"],"created_at":"2024-12-16T04:16:23.568Z","updated_at":"2026-04-26T20:31:36.479Z","avatar_url":"https://github.com/complicat9d.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Сервис с каталогом продуктов в телеграм боте и админ панелью\n\nДанный проект представляет собой бот, написанный на `aiogram`, и админ панель для редактирования сущностей, рассылок пользователям в бота и выгрузки данных в `.xlsx`, написанную на фреймворке `Django`.\n\n## Функционал\nТелеграм-бот позволяет пользователям просматривать каталог товаров с разделением на категории, выбирать нужный товар, указав необходимое количество, и добавлять его в корзину. После этого пользователь попадает в корзину, где может указать адрес доставки и произвести оплату через встроенный платёжный шлюз API Телеграма, или же удалить товар из корзины. Все данные о сделках автоматически сохраняются в отдельной Excel-таблице, выгрузка которой доступна через админ-панель. Также в боте имеется раздел с часто задаваемыми вопросами (FAQ).\n\nВ админ-панели реализованы функции регистрации администратора при запуске проекта, а также назначение ролей и прав доступа для других пользователей (пользователей, администраторов, суперпользователей). Для каждой сущности (например, пользователей, товаров, заказов) реализованы операции просмотра, добавления, редактирования и удаления данных. Для сущности \"Пользователь\" предусмотрена возможность массовых рассылок, а для сущности \"Корзина\" — выгрузка данных в формате Excel.\n\n---\n\n## Конфигурация и запуск проекта\n### Конфигурация переменных окружения\nДля корректной работы сервиса нужно создать файл `.env` в корне скопированного проекта и инициализировать следующие переменные из `.env-example`:\n```.env-example\nTOKEN=\nBOT_PAYMENT_PROVIDER_TOKEN=\n\nSECRET_KEY=\nDJANGO_SUPERUSER_EMAIL=\nDJANGO_SUPERUSER_PASSWORD=\n\nCHANNEL_SUBSCRIPTION_LINK=\nCHANNEL_SUBSCRIPTION_CHECK=\nGROUP_SUBSCRIPTION_LINK=\nGROUP_SUBSCRIPTION_CHECK=\n```\n`TOKEN` - токен бота, полученный в [@BotFather](https://t.me/BotFather)\n\n`BOT_PAYMENT_PROVIDER_TOKEN` - токен провайдера, который предоставляет доступ к платежному шлюзу (также получается в [@BotFather](https://t.me/BotFather))\n\nПри тестировании сервиса использовался тестовый терминал `Paymaster`, креды от тестовой карточки:\n```text\nНомер карты: 4100 0000 0000 0001\nMM/YY: 03/26\nCVC/CVV-код: 111\n```\n`SECRET_KEY` - SHA256 строка для шифрования пароля юзеров в базе данных\n\n_должен быть инициализирован другим значением, а не тем, что стоит по умолчанию в конфиге при разворачивании в прод_\n\n`DJANGO_SUPERUSER_EMAIL` - электронная почта суперюзера\n\n`DJANGO_SUPERUSER_PASSWORD` - пароль от админ панели для суперюзера\n\n`CHANNEL_SUBSCRIPTION_LINK` - ссылка, по которой юзер сможет перейти и подписаться на канал\n\n`CHANNEL_SUBSCRIPTION_CHECK` - ссылка на канал _(https://t.me/\u003cbot_username\u003e)_, `chat_id`, внутренний айди канала \n\n`GROUP_SUBSCRIPTION_LINK` - ссылка, по которой юзер сможет вступить в группу\n\n`GROUP_SUBSCRIPTION_CHECK` - ссылка на группу _(https://t.me/\u003cbot_username\u003e)_, `chat_id`, внутренний айди группы \n\n---\n\n#### Проверка подписки\n\nAPI Телеграма позволяет проверять подписку на каналы и группы, где бот добавлен в качестве администратора. Основное различие, которое учитывается при проверке подписки, заключается в разных форматах ссылок для вступления в публичные и приватные каналы/группы. В публичных каналах используется юзернейм, в то время как в приватных каналах и группах — хэш, который невозможно идентифицировать напрямую через API.\n\nТем не менее, если у нас есть внутренний ID канала или группы, то проверка подписки становится возможной. Именно поэтому для проверки используются два поля: ссылка на канал и проверка через `chat_id`, юзернейм или внутренний ID.\n\n_`Внутренний ID`_ канала или группы можно найти в веб-версии Телеграма в строке поиска, он будет последним аргументом в URL (например: `-1002494342292`), либо получить через API, используя личный аккаунт для доступа к данным.\n\n---\n\n### Запуск проекта\n_Пререквизит: наличие `docker compose`_\n\nВ корне проекта прорпишите следующую команду:\n```commandline\ndocker compose up --build\n```\nДля запуска без логов:\n```commandline\ndocker compose up --build -d \n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcomplicat9d%2Fe-commerce-service","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcomplicat9d%2Fe-commerce-service","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcomplicat9d%2Fe-commerce-service/lists"}