Bangazon-Sprint-2
About This Repo
This application is intended to manage the internal structure of the fictional Bangazon LLC. It is used for handling the database the stores details of the departments, employees, computers, and training programs available to the organization. It is built using Python, Django, and SQLite3.
Table of Contents
Installation
Tables
Usage
Contributors
Installation
Requirements
- Python3
- SQLite3
- Django
- [OPTIONAL: to seed the database using faker use This Link]
PIP dependencies for this app
- django
- django_seed (if you intend to seed the database for testing)
Steps
- download or clone the repository
- [OPTIONAL: if you would like to seed the database with dummy data from the root 'app' directory run
django_data.sh bang faker_factory
]
- to run the server cd into the root 'app' directory and run
python manage.py runserver
- Visit the application url/bang specified by the terminal
[NOTE: windows gitbash users will need to add the django_data to the root app directory and use ./django_data.sh bang faker_factory
]
Tables
Computers
- make | String
- model | String
- purchase_date | Date formated as 'yyyy-mm-dd'
Department
Employees
- first_name | String
- last_name | String
- start_date | Date formated as 'yyyy-mm-dd'
- supervisor | Boolean
- department | Foreign Key to department table
- computer | Foreign Key to computer table
Training
- name | String
- description | String
- start_date | Date formated as 'yyyy-mm-dd'
- end_date | Date formated as 'yyyy-mm-dd'
- max_attendees | Integer
- attendees | Join table wth Employees
Usage
after opening the application url/bang to reach the main page of the application, there will be various navigation buttons to reach the different components for each table. From the separate pages users are able to perform the following tasks:
Computers
- Create new computers
- View the list of all computers
- Delete computers that have never been assigned to an employee
- View the details of each individual computer
Department
- Create new departments
- View the list of all departments
- View the details of individual departments which should also list all employees in the deparment
Employees
- Create new Employees
- View the list of all employees
- View the details of individual employees which should also list the computer(s) assigned to the employee
- Edit the employees last name, assigned computer, enrolled training, and change their department
Training
- Create new training programs
- View the list of all training programs
- View the details of individual training programs which should also list the employees enrolled in it.
- Edit the details of a training program that has yet to begin
- Delete training programs that has yet to begin
Contributors