A volunteer project as a part of the subject IDATT2105
To get this project up and running there are 2 methods we show incase 1 does not work:
For this Git is goind to be required if you don't have Git you can download it here.To clone with git you can use either the SSH link or HTTPS link you will find these under the code dropdown of the repository:
Then open a terminal and navigate to the location you want to clone the project(1) or go to that location and type cmd into the navigation in File Explorer(2)
1:
Remember if you are confused about where you currently are you can type "dir" to get your directory and everything in it. Navigate with "cd" as you see above
2:
As you can see here you navigate like normal in File Explorer then type cmd at the desired locaion.
After this use the command git clone (repo-URL)
If you get a printout like that you have successfully cloned the project
To download the zip file you can click the little download icon next to the clone icon and click on zip:
Note that there are other formats but we recoment zip
Find the downloaded file and extract the file
To setup the backend of the project, navigate into the project folder(full-stack-project) -> Backend -> ECOMBack. This is the Spring boot Java project that communicates with the database. Open this folder in an IDE, we recoment using IntelliJ IDEA.
The IDE shoul automatically import all necessary Maven dependencies, based on the pom.xml file. Alternatively, you can use the Maven command line to download and install the dependencies:
mvn clean install
In the application-central.properties class, you can specify which database to use with the project (url, username and password). To get access to the centralized IDI MySQL database, please reach me at [email protected]
To start the backend application, navigate to src/main/java/no/ntnu/ecomback/EcomBackApplication.java and run the main method in the IDE:
You can alternatively run the command
mvn spring-boot:run
in the root of the backend project.
To setup frontend navigate into project folder(full-stack-project) -> Frontend -> ecom. That is the frontend vue project. Open that folder in whatever IDE you want to open it in. We recoment VS Code for this.
After opening the project you need to install the node modules. There is no need to install them one by one ad they are listed in package.json. To install them you need to run:
npm install
in the terminal at location. You can open a terminal in the ecom folder as you did in previous steps or you can open it in the IDE you are working in. In VS Code you can open a terminal bu clicking terminal then new terminal:
If all goes well you will have installed all the dependencies you need. After this you are ready to run frontend with the command:
npm run dev
If you do i correctly it looks like this:
Opening the Local: link gives you the website. In this case typing http://localhost:5173 into your browser gives you this:
Remember that to get the Items Backend needs to be running