Full-Stack Django + React Project

This is a full-stack web application using Django (backend) and React (frontend). The backend provides a REST API, and the frontend consumes it to offer a user-friendly interface.

---

Getting Started

1. Backend Setup (Django)

Install dependencies

pip install django
pip install djangorestframework
pip install django-cors-headers
pip install djangorestframework-simplejwt
pip install django-environ
#install according to the DB you are using
pip install psycopg2-binary   # PostgreSQL
pip install mysqlclient       # MySQL/MariaDB
pip install oracledb          # Oracle

DataBase setup (Ignore if using SQLite)

First setup an external database and a user that can change it - process depends on the DB. Depending on the DB that you want to use change .env file next to manage.py to include DATABASE_URL for your desired DB. Examples:

DATABASE_URL=postgres://USER:PASS@localhost:5432/your_db
DATABASE_URL=mysql://USER:PASS@localhost:3306/your_db
DATABASE_URL=oracle://USER:PASS@localhost:1521/your_db

If no DATABASE_URL is provided in .env file default behaviour is to use SQLite DB.

Migrating your data to a new database (Ignore if using SQLite)

1. Dump data from current DB

   python manage.py dumpdata \
    --natural-foreign --natural-primary \
    --exclude contenttypes --exclude auth.permission \
    --indent 2 > data.json

2. Update your .env DATABASE_URL to point at the new DB

   DATABASE_URL=postgres://your_user:your_pass@localhost:5432/your_db

3. Apply the schema

   python manage.py migrate

4. Load your data dump

   python manage.py loaddata data.json

Run the backend server

python manage.py migrate
python manage.py runserver

2. Frontend Setup (React)

Install dependencies

npm install
npm install react-bootstrap bootstrap

Run the frontend

npm start

---

Project Structure Overview

Backend (Django)

• models.py
  Defines the data models used in the application.

• serializers.py
  Converts Django models to JSON format and vice versa for REST API interaction.

• views.py
  Contains CRUD logic and endpoints for API routes. Also all the backend checks that needed for input getting done in here.

  TO DO: Right now checked things are below. PLS ADD ANY ELSE IF YOU FIND

  - For task --> Users must be users of WP, can connected with only 1 WP, start/end week must not exceed that of WP

• urls.py
  Connects view logic to specific URL endpoints.

Frontend (React)

• Navigator.js
  Main navigation bar or sidebar for switching between pages.

• User.js / WorkPackage.js / Task.js
  Pages for listing and interacting with each model's data.

• AddUserModal.js / EditUserModal.js (for each page similar 2 files)
  Modal components for adding and editing model entries (similar files exist for other models like WorkPackage and Task).

---

Notes

• PLS check for urls in backend part before adding smth related with it
• CORS must be properly configured in Django for frontend-backend communication.
• Customize this README as your project grows.