FIT9131 Semester 2 2018 Assignment 1
Inventory Management System
Introduction
This assignment is due by 10:00 pm Friday of Week 7 (7th September, 2018). It is worth a total of 15% of the marks for your final assessment in this unit. Heavy penalties will apply for late submission. This is an individual assignment and must be your own work. You must attribute the source of any part of your code which you have not written yourself. Please note the section on plagiarism in this document.
This assignment is structured as a 10% + 5% assessment. The code submitted for this assignment will be assessed for 10% of the marks and a unit test during the tutorial time in Week 8 will be assessed independently for 5% of the marks allocated. Please note that the unit test is a hurdle requirement for the assignment. Failing to complete the unit test will result in no marks being allocated for the entire assignment.
The assignment must be done using the BlueJ environment.
The Java source code for this assignment must be implemented according to the Java Coding Standards for this unit.
Any points needing clarification may be discussed with your tutor in the lab classes.
Specification
For this assignment you will write a program which will simulate an inventory management systems for a products company based in Melbourne, Victoria. The system will allow a salesperson to register products which are sold by the company. The salesperson can also register a sale for a customer which allows the customer to buy products which are sold by the company. Lastly, the system will keep track of the quantity of products available and will allow the salesperson to finalize the sale for the customer. Keep in mind that the company using this system operates as a wholesaler so there is a minimum quantity which must be ordered for all listed items. From here on, the salesperson(s) are the referred to as the users of the system.
This section specifies the required functionality of the program. Only a text interface is required for this program; however, more marks will be gained for a program that is easy to follow with clear information/error messages to the user.
8 August 2018 1
FIT9131 Semester 2 2018 Assignment 1 System Operation
The following section outlines the functionality of the program.
Class Diagram:
The program is to be designed using the following class diagram specification:
The above class diagram only outlines the various classes and the required attributes within each class. The methods which should be included are open to interpretation by the programmer. However, the required attributes cannot and must not be changed, added, or removed. The method should include a default constructor, a non-default constructor, accessor and mutator methods for each attribute, and a display method to present the state of the object.
The interaction between the classes must follow the outlined class diagram above as well. No additional objects should be created. The requirements is for students to demonstrate their understanding of using the pass by reference in Java, and the use of parameters to do message passing.
8 August 2018 2
FIT9131 Semester 2 2018 Assignment 1
Program Logic:
When the Inventory Management System starts, the following options will be presented to the user:
Option 1:
Allows the user to register a new product to be sold. Every new product registered must meet the following criteria:
• Product Name – Name of the product
o Must be between 3 and 25 characters long.
o Cannot be repeated for two or more products.
o Should be case insensitive, i.e. lower and upper case letters should be treated the same way.
• Product Description – Brief description of the product being sold o Must be between 1 and 50 characters long.
• Product Price – Unit price for a single item of the product o Must be a double value > 0
• Quantity On Hand – Quantity available for purchase
o Must be an integer between 0 and 10.
o Must be randomly generated by the system when a product is created.
• Minimum Order Quantity – Minimum Quantity to be Ordered
o Must be an integer between 1 and 5
o Must be randomly generated by the system when a product is created.
8 August 2018 3
FIT9131 Semester 2 2018 Assignment 1
• The system only allows a maximum of FIVE products which can be registered. Option 2:
Allows the user to purchase a new product which has been registered. Every product bought must meet the following criteria:
- Only products added in Option 1 can be purchased. If no products have been registered, an error message must be shown to the user.
- User should be shown a submenu to select from the registered products as follows:
- When a product is selected, the quantity of hand should be greater than the minimum order quantity. If not, an error should be shown to the user. If yes, then it should be added to the array.
- A user can purchase a maximum of THREE items only.
- On purchase a product, the Total Cost of the SaleTransaction should be updated. However, the Quantity on Hand should NOT be changed until option 5 is selected. Each order purchase must be for the minimum order quantity.
8 August 2018 4
FIT9131 Semester 2 2018 Assignment 1
Option 3:
Allows the user to remove a product which has been purchased in option 2. Every product removed must meet the following criteria:
- Only products added to the array in Option 2 can be removed. If no products have been purchased, an error message must be shown to the user.
- User should be shown a submenu to select from the purchased products as follows:
- On removing a product, the Total Cost of the SaleTransaction should be updated. However, the Quantity on Hand should NOT be changed until option 5 is selected. Each order removed must update the Total Cost based on the minimum order quantity.
Option 4:
Allows the user to view all the currently registered products which are available to be purchased.
Option 5:
Allows the user to finalize a sale and checkout from the system. Every final sale must meet the following criteria:
- Only products added to the array in Option 2 can be finalized for the sale. If no products have been purchased, an error message must be shown to the user.
- For each item purchased, the system will
8 August 2018 5
FIT9131
o
o
Semester 2 2018 Assignment 1
Check the product purchased in the SaleTransaction class with the Product class objects. If a match is found, the Quantity on Hand will be reduced by the minimum order quantity for the purchase.
If the same product is ordered multiple times and IF the Quantity on Hand falls below the minimum order quantity, the sale of that specific item is cancelled and not finalized and an error message is displayed to the user. The rest of the sale will be finalized.
Option 6:
• Allows the user to view a brief but descriptive explanation on how to use the system and what the various options do within the menu.
Option 7:
• Exits the system.
8 August 2018 6
FIT9131 Semester 2 2018 Assignment 1 Program design
The objective of this assignment is for students to understand coding, as well as to get the basics of design.
Your program MUST consist of the following classes: 1. Product
2. RandomNumberGenerator 3. SaleTransaction
4. ProductList
5. Sale
You MUST follow good programming practices and use loops where required to ensure good program design.
ALL classes MUST have a default constructor, a non default constructor (if applicable), accessor methods for each field, mutator methods for each field, and a display method to provide the current state of the object.
The fields shown in the included class diagram on page 2 are the MAXIMUM fields expected. Your implementation may have fewer fields but should not exceed these.
The data type of each field has been shown in the class diagram and must adhere to the specifications provided.
The explanation for some of the fields for each of the classes has been provided under the Program Logic section above. The rest are included below.
Product class
The Product class will specify the attributes and behaviours of a product. The description of the fields are provided in the program logic section.
RandomNumberGenerator class
The RandomNumberGenerator class will specify the attributes and behaviours for generating a random number between a set minimum and a set maximum. An object of the RandomNumberGenerator class will have the following fields only:
- minimumValue – (int) stores the minimum value of the number to be generated
- maximumValue – (int) stores the maximum value of the number to be generated
8 August 2018 7
FIT9131 Semester 2 2018 Assignment 1 ProductList Class
The ProductList class will store an array of product objects which are available to be purchased. An object of the ProductList class will have the following fields only:
• listOfProducts – (Product[]) array of Product objects of maximum size 5.
This class is responsible for adding products to the array, removing products from the array, etc.
SaleTransaction Class
The SaleTransaction class will specify the attributes and behaviours of a sale transaction. An object of the SaleTransaction class will have the following fields only:
- saleCode – (int) randomly generated sale code number between 1000 and 9999.
- items – (Product[]) array of Product objects of maximum size 3.
This class is responsible for recording products purchased and removed from the shopping cart.Sale Class
The Sale class will be the main control class of the program and will specify the attributes and behaviours of the system. An object of the Sale class will have the following fields only:
- prodList – (ProductList) object of the ProductList class.
- transaction – (SaleTransaction) object of the SaleTransaction class.
This class is responsible for facilitating the main functioning of the program and for integrating thevarious classes together to be able to provide the required functionality for the program to run.
Hints and Suggestions
The following hints and suggestions may be useful in designing your program:
- To facilitate a clean layout of your program, consider looking at the tutorial notes in the homework exercises on how to clear the terminal screen in BlueJ, if required.
- Input validations for numeric inputs are NOT required at this stage. For numeric inputs, read the input from the keyboard as a String and then consider using the Integer.parseInt() method to understand how a String can be converted into an integer .
- An important aspect to understand to get this class to work correctly is how to PASS BY REFERENCE when using objects. Keep in mind Arrays are objects.
- Lastly, when working with arrays, keep in mind that arrays CAN store null objects. So while extensive validation does not have to be done for the program, your program MUST validate if an array element is null or not to prevent your program from crashing.
8 August 2018 8
FIT9131 Semester 2 2018 Assignment 1 Assessment
Assessment for this assignment will be done via an interview with your tutor and a unit test assessment.
Coding Assessment (10%)
The marks will be allocated as follows:
- 35% – Object-oriented design quality. This will be assessed on appropriate implementation of classes, fields, constructors, methods and validation of the object’s state.
- 5% – Adherence to FIT9131 Java coding standards.
- 60% – Program functionality in accordance to the requirements.
You must submit your work by the submission deadline on the due date (a late penalty of 20% per day, inclusive of weekends, of the possible marks will apply – up to a maximum of 100%). There will be no extensions – so start working on it early.
Marks will be deducted for untidy/incomplete submissions, and non-conformances to the FIT9131 Java Coding Standards.
Unit Test Assessment (5%)
This assessment will be a written assessment and will be held during the tutorial times in Week 8 after the submission. Keep in mind that students are expected to have finished ALL their code by the submission deadline, and more importantly have to have done their own work.
The unit test will be a closed book test wherein students will be required to WRITE code to answer a few questions. The questions will cover material from Weeks 1 – 6 of the lectures. Students should bear in mind that BlueJ or any other electronic device will not be permitted, so students need to know HOW to write their own code in order to finish the unit test hurdle.
Unit test for DE / Off-Campus students will be scheduled for Week 8, but due to the examination environment of the unit test, an equivalent moodle quiz or a skype assessment may be administered which may be slightly different than the on-campus format of the assessment.
Interview
You will be asked to demonstrate your program at an “interview” following the submission date, in Week 8. At the interview, you will be asked to explain your code/design, modify your code, and discuss your design decisions and alternatives. Marks will not be awarded for any section of code/design/functionality that you cannot explain satisfactorily (the marker may also delete excessive in-code comments before you are asked to explain that code).
In other words, you will be assessed on your understanding of the code, and not on the actual code itself.
For on-campus students, interview times will be arranged in the tutorial labs in Week 7. It is your responsibility to attend the lab and arrange an interview time with your tutor. Any student who does not attend an interview will receive a mark of 0 for the assignment. The actual interviews will take place in Week 8.
8 August 2018 9
FIT9131 Semester 2 2018 Assignment 1
For off-campus learning (OCL) students, the interviews will be organised during week 7 and will take place online via Skype or other video facility during Week 8. It is your responsibility to make yourself available for an interview time. Any student who does not attend an interview will receive a mark of 0 for the assignment.
Submission Requirements
The assignment must be uploaded to Moodle by 10:00 pm Friday of Week 7 (7th September, 2018).
The submission requirements for Assignment 1 are as follows:
A .zip file uploaded to Moodle containing the following components:
- the BlueJ project you created to implement your assignment.
- a completed Assignment Cover Sheet. This will be available for download from the unit’s Moodle site before the submission deadline. You simply complete the editable sections of the document, save it, and include it in your .zip file for submission.
The .zip file should be named with your Student ID Number. For example, if your id is 12345678, then the file should be named 12345678_A1.zip. Do not name your zip file with any other name.
It is your responsibility to check that your ZIP file contains all the correct files, and is not corrupted, before you submit it. If you tutor cannot open your zip file, or if it does not contain the correct files, you will NOT be assessed.
Marks will be deducted for any of these requirements that are not complied with.
Warning: there will be no extensions to the due date. Any late submission will incur the 20% per day penalty. It is strongly suggested that you submit the assignment well before the deadline, in case there are some unexpected complications on the day (e.g. interruptions to your home internet connection).
Extensions
All requests for extensions must follow the faculty guidelines and submit the required forms as soon as possible. In addition, when emailing for an extension, please remember to include all code completed until that time. This assignment cannot be completed in a few days and requires students to apply what we learn each week as we move closer to the submission date.
Plagiarism
Cheating and plagiarism are viewed as serious offences. In cases where cheating has been confirmed, students have been severely penalised, from losing all marks for an assignment, to facing disciplinary action at the Faculty level. Monash has several policies in relation to these offences and it is your responsibility to acquaint yourself with these.
Plagiarism (http://www.policy.monash.edu/policy-bank/academic/education/conduct/plagiarism- policy.html)
Lastly, your assignment will be subjected to a similarity check against all current and past assignment submissions. Should your submission be flagged as highly similar to that of another student, both submission grades will be withheld and considered as per the university’s policy on plagiarism and collusion. All work submitted MUST be your own work. Do not share or borrow anything.
8 August 2018 10