diff --git a/README.md b/README.md index acddcd43..7f577850 100644 --- a/README.md +++ b/README.md @@ -1,18 +1,109 @@ [![Open in Visual Studio Code](https://classroom.github.com/assets/open-in-vscode-718a45dd9cf7e7f842a935f5ebbe5719a5e09af4491e668f4dbf3b35d5cca122.svg)](https://classroom.github.com/online_ide?assignment_repo_id=12113659&assignment_repo_type=AssignmentRepo) # Project-Starter +## Step 1: Download the required software +- python +- libreoffice +- mySQL (Workbench) +- Memcashed + +## Step 2: Clone the repository + +```commandline +git clone https://github.com/COSC-499-W2023/year-long-project-team-17.git +``` +or +```commandline +git clone git@github.com:COSC-499-W2023/year-long-project-team-17.git +``` + +## Step 3: setup environment variables +```commandline +cp .env.example .env +``` + +Fill in the values of the variables in .env file + + +## Step 4: Create a Virtual Environment +```commandline +python -m venv virt +``` + +For Windows +```commandline +source virt/Scripts/activate +``` + +For Linux or MacOS +```commandline +source virt/bin/activate +``` + +## Step 5: Install the required dependencies +```commandline +pip install -r app/requirements.txt +``` + +## Step 6: Create the database +```commandline +python mydb.py +``` + +## Step 7: Make the necessary migrations to the database + +```commandline +python app/manage.py make migrations +``` + +```commandline +python app/manage.py migrate +``` + +## Step 8: Start the system + +```commandline +python app/manage.py runserver +``` + +## Run automated tests +```commandline +python app/manage.py test +``` + Please use the provided folder structure for your docs (project plan, design documentation, communications log, weekly logs, and final documentation), source code, testing, etc. You are free to organize any additional internal folder structure as required by the project. Please use a branching workflow and once an item is ready, do remember to issue a PR, code review, and merge it into the develop branch and then the master branch. ``` . -├── docs # Documentation files (alternatively `doc`) -│ ├── project plan # Project plan document -│ ├── design # Getting started guide -│ ├── final # Getting started guide -│ ├── logs # Team Logs -│ └── ... -├── app # Source files -├── tests # Automated tests -├── utils # Tools and utilities +├── year-long-project-team-17 # Documentation files (alternatively `doc`) +│ ├── app + ├──dcrm + ├──media + ├──presentation_templates + ├──presentations + ├──profile_pictures + ├──staticfiles + ├──admin + ├──django_extensions + ├──icon_cache + ├──util + ├──website + ├──migrations + ├──templates + ├──images + ├──partials + ├──static + ├──images + ├──tests + ├──.env.example + ├──gitignore + ├──__init__.py + ├──manage.py + ├──mydb.py + ├──requirements.txt +│ ├── docs +│ ├── weekly logs +├── app +├── tests +├── utils └── README.md ``` -Also, update your README.md file with the team and client/project information. You can find details on writing GitHub Markdown [here](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) as well as a [handy cheatsheet](https://enterprise.github.com/downloads/en/markdown-cheatsheet.pdf). diff --git a/app/README.md b/app/README.md deleted file mode 100644 index a9b4605e..00000000 --- a/app/README.md +++ /dev/null @@ -1 +0,0 @@ -This is the home for the source code of your application. diff --git a/docs/communication/README.md b/docs/communication/README.md deleted file mode 100644 index 8ea91359..00000000 --- a/docs/communication/README.md +++ /dev/null @@ -1 +0,0 @@ -The home for your communications logs where you keep meeting minutes and design decisions. diff --git a/docs/design/README.md b/docs/design/README.md deleted file mode 100644 index 2d957884..00000000 --- a/docs/design/README.md +++ /dev/null @@ -1 +0,0 @@ -The home for your design documentation. diff --git a/docs/final/README.md b/docs/final/README.md deleted file mode 100644 index e6b78d2d..00000000 --- a/docs/final/README.md +++ /dev/null @@ -1 +0,0 @@ -The home for your final documentation. diff --git a/docs/plan/Readme.md b/docs/plan/Readme.md deleted file mode 100644 index 718a5860..00000000 --- a/docs/plan/Readme.md +++ /dev/null @@ -1 +0,0 @@ -This is the home for your project plan. diff --git a/tests/README.md b/tests/README.md deleted file mode 100644 index 1c70c10c..00000000 --- a/tests/README.md +++ /dev/null @@ -1 +0,0 @@ -This is the home for all your tests.