Documentation for Iteration3 - danask/MIS GitHub Wiki
Requirements
- User and developer documentation (Javadoc)
- Installation, execution per use-case
Iteration3
- Updated the Java developer documentation
- Updated set-up and execution per the given use-uses
Overall architecture
This application interacts with some external components; Java runtime environment, Spring framework with Tomcat as web server, and MySQL for DBMS. Hibernate is a useful development environment to satisfy the labs in class
Specification
- Java runtime environment 1.8
- Spring framework 4 (not SpringBoot): MVC2 (model-view-controller), Hibernate5
- UI framework: BootStrap 3.4
- Web server: Apache Tomcat 8.5
- MySQL5.7 with workbench
- Additional tools: JMeter, JUnit, Jenkins, BlazeMeter (instead of Selenium) and so on
How to setup the environment, see the homepage, insert movie information, login with role
There are several steps to set up the whole development environment. Here are the requirements.
- Step1. Install JDK 1.8 or higher in your pc.
- Step2. Install Apache Tomcat 8.5 or higher.
- Step3. Install IDE Eclipse or Spring STS (different version of Eclipse)
- Step4. Create the new project or pull https://github.com/danask/MIS.git and import to the project
- Step5. After file synchronization, make sure the maven build. If it shows the problem, then try to download libraries for dependency.
- Step6. Run the project with selection of tomcat. Without this, it does not work properly.
- Step7. If you do not have DBMS such as MySQL, it shows up the error. It is time to make setting for database link. Just make sure the user id/password and database name.
- Step8. Everything is properly installed, then the project shows the first page in Chrome. http://localhost:8080/
- Step9. In the first page, try to click user registration and then you can login the system properly.
- Step10. Login with your account.
- Step11. Go to the movie database and register a data
- Step12. You can see the list of the movie which you have inserted in the movie list menu.
- Step13. After register some movies data with a user who has a movie database administrator role, try to search with keywords like movie title and artists.
- Step14. The result shows the currently updated database based information.
- Step15. Log in with a user admin role.
- Step16. You can see the Admin menu and assign the right role to users.
- Step17. After assigning with the proper role such as User manager, Guest, Movie Administrator, and Administrator and log in again.
- Step18. Check whether the menu which you can access is different as the permission of the user.