LITReview

Description

LITReview is a Django-based application where users can create profiles, follow each other, and share posts about books and get reviews. It incorporates essential functionalities like user authentication, post creation, and follower management.

Features

• User Authentication: Sign up, log in, log out features.
• Following System: Users can follow and unfollow others and can accept or reject demands of others to be followed.
• Post Sharing: Users can create, edit, and delete their own posts and can comments posts of others who are followed by the user.

Tech Stack

• Framework: Django 3.2
• Database: sqlite 3
• Frontend: HTML, CSS (Bootstrap)

Project Structure

• followers/ - Handles the following system between users.
• posts/ - Manages post creation, updating, and deletion.
• authentication/ - Manages user authentication.
• media/ - Stores uploaded media files.
• static/ - Contains static files like CSS.
• templates/ - Contains HTML templates for the application.

Getting Started

Prerequisites

• Python 3.8 or above
• Django 3.2

Installation

1. Clone the repository to your local machine:

git clone 'https://github.com/br-imen/litreview-project9-op'

2. create a virtual environment:

python3 -m venv venv

3. activate the virtual environment:

source venv/bin/activate

4. Navigate to the project directory:

cd litreview

5. Install required packages:

pip install -r requirements.txt

6. Make migrations:

python3 manage.py makemigrations

7. Push migrations to database:

python3 manage.py migrate

8. Start the development server:

python3 manage.py runserver

9. Open a browser and go to localhost http://127.0.0.1:8000/ to start using the application.

Usage

Once the application is running, you can perform the following actions:

1. To explore features you must signup and then login.

2. in flux page, you can see posts about books of people you are following and you can also post demands for reviews or reviews or just review posts demanding to review a book.

3. in abonnements page, you can send demands to follow someone or unfollow users, you can accept or reject demands to follow you or unfollow people to see their latest uploads and reviews.

4. in posts page, you see all your posts and reviews on demands of others.

5. to logout, you click on 'se déconnecter'

Contribution

Any contributions you make are greatly appreciated.

Authors and acknowledgments

Special Thanks to my mentor and OpenClassrooms.