https://github.com/appleipx/news-feed

МыслиВслух
https://github.com/appleipx/news-feed

celery python3 redis rest-api unit-testing

Last synced: about 2 months ago
JSON representation

МыслиВслух

• Host: GitHub
• URL: https://github.com/appleipx/news-feed
• Owner: AppleIpx
• Created: 2024-01-30T07:44:42.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-01-30T10:06:51.000Z (over 2 years ago)
• Last Synced: 2025-01-13T08:34:55.248Z (over 1 year ago)
• Topics: celery, python3, redis, rest-api, unit-testing
• Language: Python
• Homepage:
• Size: 1.32 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Буря идей, волнение вдохновения: ваш личный поток мыслей в МыслиВслух

## Развертывание проекта

1. Сделать клон проекта "https://github.com/AppleIpx/news-feed.git"

2. Cоздать виртуальное окружение "python3  -m venv venv" и активировать его "source venv/bin/activate"

3. Установить библиотеки с requirements.txt "pip install -r requirements.txt"

4. Ввести данные вашей электронной почты и SECRET_KEY в (backend/news_feed/settings.py), образец находится в infra/.env.example

5. Выполнить миграции находясь в директории backend "python manage.py migrate"

6. Создать супер пользователя (админ) "python manage.py createsuperuser"

7. Запустить локальный сервер "python manage.py runserver"

8. Зайти в панель администратора 127.0.0.1:8000/admin, используя логин и пароль введенные при создании супер пользователя

## Техническое задание (ТЗ)

## 1. Введение

### 1.1 Описание проекта

Приложение "МыслиВслух" предназначено для создания уникальных и интересных личных блогов, где пользователи могут 

свободно выражать свои мысли, идеи и чувства. Оно предоставляет платформу, где каждый может поделиться 

своим внутренним миром, находить вдохновение в мыслях других и оставлять комментарии. "МыслиВслух" создано 

для того, чтобы стимулировать творчество, обмен опытом и построение сообщества, где каждая мысль имеет свое место и значение.

### 1.2 Контекст проекта

Возникла идея создать приложение "МыслиВслух", чтобы удовлетворить потребность в креативном самовыражении и обмене 

мыслями, предоставляя уникальное пространство для пользователей выражать свои идеи и взгляды в личных блогах.

## 2. Требования

### 2.1 Функциональные требования

#### 2.1.1 Основные функции

- Регистрация и аутентификация пользователей.

- Отправка email письма при регистрации пользователя.

- Создана форма сброса пароля пользователя, отправкой email письма.

- Создание, редактирование и удаление постов.

- Оставление комментариев под конкретным постом

- Поиск постов по названию и дате.

- Интеграция Swagger для удобной документации API и взаимодействия с ним.

- Реализована защита от множественных запросов от анонимов (50 запросов) и авторизированных пользователей (100 запросов)

для предотвращения злоупотреблений и улучшения общей производительности системы.

## 3. Архитектура

### 3.1 Архитектурные решения

- Backend: Django с использованием Django REST framework.

- Backend: Отправка писем асинхронно с использованием Celery и Redis

- База данных: SqLite3

### 3.2 База данных

- База данных будет содержать таблицы для пользователей, постов и комментариев.

## 4. Разработка

### 4.1 План разработки

- Этап 1: Проектирование базы данных и бэкенда.

- Этап 2: Тестирование и отладка.

- Этап 3: Релиз и развертывание.

### 4.2 Ресурсы и инструменты

- Python, Django, Django REST framework, Celery, Redis, Djoser, для бэкенда.

- Инструменты для тестирования - unit test.

## 5. Тестирование

### 5.1 План тестирования

- Тестирование функциональности регистрации и аутентификации пользователей.

- Тестирование создания постов и комментариев к ним.

### Результат работы:

## Авторизация и Регистрация:

- Пользователи могут создавать учетные записи и входить в систему.

![Регистрация пользователя](public/user_registration.png).

- При регистрации пользователи получают email письмо.

![Полученное email письмо после регистрации](public/receiving_an_email_after_registration.png).

- Если пользователь забыл пароль, он может его восстановить, инструкция придет по email.

![Полученное email письмо для сброса пароля](public/received_password_reset_email.png).

- Пользователи разделяются на администраторов и обычных пользователей.

![Разделение пользователей](public/separation_of_users.png).

## Посты:

- Пользователи могут создавать, редактировать и удалять свои посты.

![Создание поста](public/create_blog_post.png).

- Пользователи могут оставлять комментарии под постами.

![Оставление комментария](public/leave_a_comment.png).

- Просмотр оставленного комментария.

![Просмотр оставленного комментария](public/view_comment.png).

- Пользователи могут фильтровать посты по их названию. Введем "по"

![Фильтрация поста по названию](public/filtering_a_post_by_title.png).

- Фильтрация по дате. Введем 30.01.2024.

![Фильтрация поста по дате](public/filtering_a_post_by_data.png).

## Документация

- Документация доступна по адресу "127.0.0.1:8000/swagger/".

![Документация](public/swagger.png).