Skip to content
This repository has been archived by the owner on Feb 11, 2025. It is now read-only.

Installation guide #204

Merged
merged 3 commits into from
Mar 22, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 1 addition & 3 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,4 @@ server/*.war
# IntelliJ IDEA
.idea/

.history/

*.xlsx
.history/
30 changes: 14 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
# Sale Dock

[![build](https://github.com/hardingadonis/saledock/actions/workflows/build.yml/badge.svg)](https://github.com/hardingadonis/saledock/actions/workflows/build.yml)
[![publish](https://github.com/hardingadonis/saledock/actions/workflows/publish.yml/badge.svg)](https://github.com/hardingadonis/saledock/actions/workflows/publish.yml)
[![release](https://github.com/hardingadonis/saledock/actions/workflows/release.yml/badge.svg)](https://github.com/hardingadonis/saledock/actions/workflows/release.yml)
Expand All @@ -7,17 +8,18 @@
![GitHub top language](https://img.shields.io/github/languages/top/hardingadonis/saledock)
![GitHub repo size](https://img.shields.io/github/repo-size/hardingadonis/saledock)
![GitHub License](https://img.shields.io/github/license/hardingadonis/saledock)
> SWP391 project, ERP system, Sales module

> SWP391 project, ERP system, Sales module

## Requirements

- JDK 17
- MySQL 8.2.0
- Tomcat 10
- Maven 3+


## Database

<details>
<summary>Database</summary>

Expand All @@ -28,37 +30,33 @@
</div>
</details>


## Development

- You need to install the requirements above.

#### 1. Clone `Sale Dock`:

```bash
git clone https://github.com/hardingadonis/saledock.git
```

#### 2. Open `Sale Dock`:

- You can open `Sale Dock` with your favorite IDE:
- [IntelliJ IDEA](https://www.jetbrains.com/idea/)
- [Eclipse](https://www.eclipse.org/)
- [NetBeans](https://netbeans.apache.org/)

#### 3. Build `Sale Dock` with `Maven` (Optional):

```bash
cd saledock
mvn verify
```


## Deployment
#### 1. Download `docker-compose.yml`:
```bash
curl -O https://raw.githubusercontent.com/hardingadonis/saledock/main/docker-compose.yml
```
#### 2. Run `docker-copmose`:
```bash
docker-compose up -d
```
#### 3. Access `Sale Dock`:
- Open `http://localhost:8080/saledock` in your browser.

- Open Installation Guide: [Installation Guide](docs/INSTALLATION_GUIDE.md)

## Contributors

Expand Down Expand Up @@ -93,7 +91,7 @@ docker-compose up -d

<!-- ALL-CONTRIBUTORS-LIST:END -->


## Licenses:

- [Sale Dock](https://github.com/hardingadonis/saledock) is under the [Apache-2.0 license](https://github.com/hardingadonis/saledock/blob/main/LICENSE).
- [favicon](https://github.com/hardingadonis/saledock/blob/main/src/main/webapp/assets/images/favicon/favicon.png) is under the [flaticon](https://www.flaticon.com/free-icon/sale_791968).
- [favicon](https://github.com/hardingadonis/saledock/blob/main/src/main/webapp/assets/images/favicon/favicon.png) is under the [flaticon](https://www.flaticon.com/free-icon/sale_791968).
48 changes: 48 additions & 0 deletions docs/INSTALLATION_GUIDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
# Sale Dock - Installation Guide

## I. Install via Docker

### 1. Requirements

- OS: Linux, Windows, macOS
- Docker Desktop: [Install Docker Desktop](https://www.docker.com/products/docker-desktop)

### 2. Installation

- Step 1: Open Docker Desktop

| ![Docker Desktop](../imgs/1.png) |
| :------------------------------: |
| _Image 1: Open Docker Desktop_ |

- Step 2: Open your terminal

| ![Terminal](../imgs/2.png) |
| :---------------------------: |
| _Image 2: Open your terminal_ |

- Step 3: Download `docker-compose.yml` via `curl`

```bash
curl -O https://raw.githubusercontent.com/hardingadonis/saledock/main/docker-compose.yml
```

| ![Download docker compose file](../imgs/3.png) |
| :-------------------------------------------------: |
| _Image 3: Download `docker-compose.yml` via `curl`_ |

- Step 4: Run `docker-compose up -d` and wait for the installation to complete

```bash
docker-compose up -d
```

| ![Run docker compose](../imgs/4.png) |
| :-----------------------------------: |
| _Image 4: Run `docker-compose up -d`_ |

- Step 5: Open your browser and navigate to `http://localhost:8080/saledock`

| ![Open browser](../imgs/5.png) |
| :----------------------------: |
| _Image 5: Open your browser_ |
Binary file added docs/SWP391 - Final Release.pdf
Binary file not shown.
Binary file added docs/SWP391 - Issues Report.xlsx
Binary file not shown.
Binary file added docs/SWP391 - Project Tracking.xlsx
Binary file not shown.
Binary file added docs/SWP391 - Software Design Specification.pdf
Binary file not shown.
Binary file added docs/SWP391 - System Test.xlsx
Binary file not shown.
Binary file added docs/SaleDock_SRS_v1.0.pdf
Binary file not shown.
Binary file added imgs/1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added imgs/2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added imgs/3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added imgs/4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added imgs/5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading