Skip to content

Commit

Permalink
Merge pull request #24 from ConnorMarcus/readme-edits
Browse files Browse the repository at this point in the history
Added README to include necessary info
  • Loading branch information
ConnorMarcus authored Nov 10, 2023
2 parents b4a1747 + c651aff commit f53ce0c
Show file tree
Hide file tree
Showing 2 changed files with 76 additions and 1 deletion.
77 changes: 76 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,77 @@
# SYSC4806Project
# 4th Year Project Management System
[![Build and deploy JAR app to Azure Web App - SYSC4806Project](https://github.com/ConnorMarcus/SYSC4806Project/actions/workflows/main_sysc4806project.yml/badge.svg)](https://github.com/ConnorMarcus/SYSC4806Project/actions/workflows/main_sysc4806project.yml)

SYSC 4806 Group Project

## About
We have designed a 4th Year Project Management System for Engineering students. Our service allows students to create an account and join any available 4th year engineering project. Professors can create 4th year projects for students and can help manage them.

## Table of Contents
- [About](#about)
- [Usage](#usage)
- [Production](#production)
- [Local](#local)
- [Sprints](#sprints)
- [Agile Practices](#agile-practices)
- [Tests](#tests)
- [Diagrams](#diagrams)
- [Contributors](#contributors)

## Usage
### Production
The 4th Year Project Management System is available at [sysc4806project.azurewebsites.net](https://sysc4806project.azurewebsites.net/)

### Local
1. Clone the repo
```
git clone https://github.com/ConnorMarcus/SYSC4806Project.git
```
2. Package the app
```
mvn package
```
3. Execute the jar file
```
cd target
java -jar SYSC4806Project-1.0-SNAPSHOT.jar
```
4. Open your browser and navigate to [localhost:8080](https://localhost:8080)

## Sprints
Our project is divided into three 2-week sprints:
- Early Prototype (**available now**)
- Alpha Release (November 27, 2023)
- Final Product (December 8, 2023)

### Agile Practices
Tickets for new features, bug fixes, and more are available in the [Issues tab](https://github.com/ConnorMarcus/SYSC4806Project/issues). Our weekly scrums are also available in the [Issues tab](https://github.com/ConnorMarcus/SYSC4806Project/issues). The Kanban board is available in the [Project tab](https://github.com/users/ConnorMarcus/projects/1).

## Tests
1. Run all tests:
```
mvn clean test
```
2. Run an individual test:
```
mvn clean test -Dtest=<PATH_TO_TEST>.<TEST_CLASS>
```
E.g., [TestStudent](/src/test/java/sysc4806.project/models/TestStudent.java)
```
mvn clean test -Dtest=sysc4806.project.models.TestStudent
```

## Diagrams
### Database Schema
Place holder

### UML Class Diagram
The UML class diagram for all the Models can be found in the [diagrams](/diagrams/uml_class_diagram.jpg) folder.



## Contributors
Connor Marcus, Noah Hammoud, George Pantazopoulos, and Vahid Foroughi

<a href="https://github.com/ConnorMarcus/SYSC4806Project/graphs/contributors">
<img src="https://contrib.rocks/image?repo=va9id/monopoly" />
</a>
Binary file added diagrams/uml_class_diagram.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit f53ce0c

Please sign in to comment.