Flower Shop Service

Сервис доставки цветов на Django с интеграцией Telegram бота

Содержание

О проекте
- Используемые технологии
Начало работы
- Требования
- Установка
Использование
План развития
Вклад в проект
Лицензия
Контакты
Благодарности

О проекте

Flower Shop Service - это веб-приложение на Django для сервиса доставки цветов "Цвет 25 весны". Проект предоставляет полный функционал интернет-магазина цветов с возможностью оформления заказов, управления корзиной, просмотра каталога товаров и интеграцией с Telegram ботом для уведомлений и аналитики.

Цели и задачи проекта

Цели:

Создать полнофункциональный интернет-магазин цветов с системой заказов
Реализовать удобный пользовательский интерфейс для выбора и оформления заказов
Интегрировать Telegram бота для уведомлений и аналитики
Обеспечить эффективное управление заказами и товарами через админ-панель

Ключевые задачи:

Разработать модели данных для товаров, заказов, пользователей и отзывов
Создать систему каталога товаров с детальными страницами
Реализовать корзину покупок и систему оформления заказов
Внедрить систему аутентификации и личный кабинет пользователя
Реализовать историю заказов с возможностью повторного заказа
Добавить систему отзывов и рейтингов для товаров
Интегрировать Telegram бота для уведомлений о заказах и аналитики
Создать административную панель для управления заказами и товарами

Результаты

Реализованная функциональность:

Регистрация и авторизация пользователей с кастомной моделью пользователя
Каталог товаров с детальными страницами для каждого букета
Корзина покупок с возможностью добавления и удаления товаров
Система оформления заказов с выбором даты и времени доставки
История заказов с возможностью повторного заказа
Система отзывов и рейтингов для товаров
Личный кабинет пользователя с редактированием профиля
Административная панель для управления заказами, товарами и пользователями
Аналитика по продажам для администратора
Telegram бот с уведомлениями о новых заказах и смене статуса
Команда /analytics в Telegram боте для получения ежедневной статистики

Созданные компоненты:

Django приложение flower_shop с моделями: CustomUser, Product, Order, OrderItem, Review, Report
HTML шаблоны для всех страниц приложения
Система сигналов для автоматической отправки уведомлений в Telegram
Кастомные команды управления для создания тестовых пользователей и товаров
Интеграция с python-telegram-bot для работы Telegram бота

(В начало)

Используемые технологии

Основные технологии и библиотеки, используемые в проекте:

Дополнительные зависимости:

python-telegram-bot==21.10 - для интеграции Telegram бота
pytest==8.3.4 и pytest-django==4.10.0 - для тестирования
pillow==11.1.0 - для работы с изображениями товаров
python-dotenv==1.0.0 - для управления настройками через переменные окружения
SQLite - база данных (по умолчанию)
Bootstrap - для современного адаптивного дизайна интерфейса

(В начало)

Начало работы

Инструкции по установке и запуску проекта локально.

Требования

Для работы с проектом необходимо установить:

Python 3.x

# Проверьте версию Python
python --version

Установка

Ниже приведены инструкции по установке и настройке приложения.

Клонируйте репозиторий

git clone https://github.com/your_username/repo_name.git
cd Flower-shop-service

Создайте виртуальное окружение (рекомендуется)

python -m venv venv
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate

Установите зависимости
```
pip install -r requirements.txt
```

Создайте файл .env в корне проекта и добавьте необходимые переменные окружения:

SECRET_KEY=your-secret-key-here
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1
TELEGRAM_BOT_TOKEN=your-telegram-bot-token
TELEGRAM_ADMIN_CHAT_ID=your-telegram-chat-id

Примените миграции
```
python manage.py migrate
```
Создайте тестовых пользователей
```
python manage.py create_test_users
```
По умолчанию создаются пользователи:
- Админ: admin / admin123 (email: admin@example.com)
- Пользователь: testuser / test123 (email: testuser@example.com)
(Опционально) Создайте тестовые товары
```
python manage.py create_test_products
```
Запустите сервер разработки
```
python manage.py runserver
```
Откройте в браузере:
- Главная страница: http://127.0.0.1:8000/
- Каталог товаров: http://127.0.0.1:8000/catalog/
- Админ-панель: http://127.0.0.1:8000/admin/

(В начало)

Использование

Приложение предоставляет следующие страницы и функциональность:

Основные страницы:

Главная страница (/)
- Приветственная страница с описанием сервиса
- Доступна всем пользователям
Каталог товаров (/catalog/)
- Отображает все доступные букеты цветов
- Доступна всем пользователям без авторизации
- Показывает название, цену и изображение каждого товара
Детальная страница товара (/catalog/<product_id>/)
- Подробная информация о букете
- Отображение всех отзывов и рейтингов
- Возможность оставить отзыв (требуется авторизация)
- Кнопка добавления товара в корзину
Корзина (/cart/)
- Просмотр товаров в корзине
- Изменение количества товаров
- Очистка корзины
- Переход к оформлению заказа
Оформление заказа (/create_order/)
- Форма для оформления доставки
- Выбор даты и времени доставки
- Указание адреса доставки
- Добавление комментария к заказу
- Требуется авторизация
История заказов (/order_history/)
- Просмотр всех заказов пользователя
- Детальная информация о каждом заказе
- Возможность повторить заказ
- Требуется авторизация
Личный кабинет (/profile/)
- Просмотр и редактирование профиля
- Управление личными данными
- Требуется авторизация
Регистрация и вход (/register/, /login/)
- Регистрация новых пользователей
- Авторизация существующих пользователей
- Восстановление пароля
Аналитика (/analytics/)
- Статистика по продажам
- Отчёты о заказах и выручке
- Доступна только суперпользователям
Админ-панель (/admin/)
- Стандартная Django админ-панель
- Управление товарами, заказами, пользователями и отзывами
- Изменение статусов заказов
- Доступна только администраторам

Telegram бот:

Уведомления о заказах: автоматическая отправка уведомлений в Telegram при создании нового заказа
Уведомления о смене статуса: отправка сообщений при изменении статуса заказа
Команда /analytics: получение ежедневной статистики по заказам и выручке
Бот запускается автоматически при старте Django приложения

(В начало)

План развития

Показать пройденные этапы разработки

Выполненные этапы:

Планируемые улучшения:

(В начало)

Вклад в проект

Вклады делают сообщество открытого исходного кода таким удивительным местом для обучения, вдохновения и творчества. Любые ваши вклады будут высоко оценены.

Если у вас есть предложения по улучшению, пожалуйста, создайте fork репозитория и отправьте pull request. Вы также можете просто открыть задачу с тегом «enhancement». Не забудьте поставить проекту звездочку! Еще раз спасибо!

Создать fork проекта
Создайте ветку для вашей функции (git checkout -b feature/AmazingFeature)
Зафиксируйте изменения (git commit -m 'Add some AmazingFeature')
Отправьте изменения в ветку (git push origin feature/AmazingFeature)
Создайте Pull Request

(В начало)

Лицензия

Распространяется по лицензии MIT. Дополнительную информацию см. в файле LICENSE.

(В начало)

Контакты

(В начало)

Благодарности

Выражаю искреннюю благодарность университету Zerocoder и всей его команде за создание вдохновляющей и профессиональной образовательной среды. За подготовку "IT-астронавтов" на "космодроме" Зерокодер.

Особая благодарность:

Кириллу Пшиннику, директору университета, за вдохновение на подвиг;

Преподавателям Нине Стефанцовой, Максиму Вершинину и Дарье Бобровской — за глубокие знания, терпение и готовность всегда помочь;

Никите Муркину, куратору курса, за чёткую организацию и наставничество;

Елизавете, менеджеру, за заботу, оперативность и неизменную доброжелательность.

Благодаря вам этот проект стал возможен!

(В начало)

Name		Name	Last commit message	Last commit date
Latest commit History 6 Commits
assets		assets
flower_shop		flower_shop
media		media
static		static
templates		templates
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
README.en.md		README.en.md
README.md		README.md
manage.py		manage.py
pytest.ini		pytest.ini
requirements.txt		requirements.txt

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

Flower Shop Service

О проекте

Используемые технологии

Требования

Установка

Основные страницы:

Telegram бот:

План развития

Выполненные этапы:

Планируемые улучшения:

Вклад в проект

Лицензия

Контакты

Благодарности

About

Uh oh!

Releases

Packages

Uh oh!

Languages

License

Z01coder/Flower-shop-service

Folders and files

Latest commit

History

Repository files navigation

Flower Shop Service

О проекте

Используемые технологии

Требования

Установка

Основные страницы:

Telegram бот:

План развития

Выполненные этапы:

Планируемые улучшения:

Вклад в проект

Лицензия

Контакты

Благодарности

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

Packages