-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #176 from COSC-499-W2023/updated_readme
updated readme
- Loading branch information
Showing
7 changed files
with
101 additions
and
16 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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). |
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.