The Project

• Use the Django framework.
• Using server-side rendering in Django.
• Developing a web application using Django with MVT structure (Model-View-Template).
• The app is an MVP (Produit Viable Minimum).

Context

• it is a social network for sharing around literature.
• Each user can follow other users of their choice and be followed by any user.
• The application allows to request or publish literature reviews.

The app has two main use cases:

• People requesting reviews on a particular book or article.
• People looking for interesting articles and books to read, based on the reviews of others.

Database

• This repository comes with a pre-populated SQLite database of some user accounts.
• we have used SQLite for this project.

Project download

Tested on Windows 10, Python 3.10.6. and Django 4.1.7

Technical Specifications ( english )

Technical Specifications ( french )

Database schema

Wireframes

1. project recovery

$ git clone https://github.com/alexandre-75/Develop_a_web_application_using_Django.git

2. Creating a virtual environment

python<version> -m venv nom_env_virtuel

Activate the environment  `mon_env_virtuel\Scripts\activate` (Windows)

3. Installing packages

pip<version> install -r requirements.txt

4. Start the program

• From the project root folder, go with the terminal to the source folder :

   cd source/

• Run the server by executing the command :

  python manage.py runserver

• Open your favorite browser and navigate to the local development server at :

  http://127.0.0.1:8000/

5. Create an account directly with the application or use the account below

Username: username
Password: a

Use of the program

1. Website home page

• If you have a user account enter your username and password.

2. Account creation page

• enter a username and password.
• In the future you will log in with this information.

3. Dashboard

• you have access to all the options of the site.
• you can disconnect from Dashboard.

4. Administrator login page

• you can login by indicating the admin information. [partie sur les super admin]

5. Username and Password of all accounts.

Generate a flake8 report

flake8 can identify syntax errors and non-compliance with the PEP.

1. To view a flake8-html report :

• From the project root folder, go with the terminal to the *** report_flake8*** folder :

     cd report_flake8/

• next open file .HTML to view the report

2. Screenshot of a report-HTML Flake 8 :

3. A new report can be generated by running the following command in the terminal :

 $ flake8 --format=html --htmldir=flake8_rapport project_link/

Web Resources

La Formation Complète Django - Thibault Houdon