Lee Jun Yao Francis - Project Portfolio

Delivery Date is used to indicate the delivery date that the parcel must be delivered by. The dates are only accepted if they are in the valid format DD-MM-YYYY or understandable by Ark.

Ark is able to recognise various forms of dates as shown in the table below but the dates in the Ark are formatted as DD-MM-YYYY. However, invalid inputs such as a phone number or symbols still will be rejected.

Current date as of writing is 12 November 2017.

The parcel list is maintained in sorted order by comparing their delivery dates, with the earliest on top.

Delivery Date is used to indicate the delivery date that the parcel must be delivered by. The dates are only accepted if they are in the valid format DD-MM-YYYY or understandable by Ark.

Ark is able to recognise various forms of dates as shown in the table below but the dates in the Ark are formatted as DD-MM-YYYY. However, invalid inputs such as a phone number or symbols still will be rejected.

Current date as of writing is 12 November 2017.

The parcel list is maintained in sorted order by comparing their delivery dates, with the earliest on top.

The following sequence diagram shows how the delivery date is parsed to PrettyTime's parser:

Figure 4.13.1 : Sequence diagram describing the parsing of delivery date when edit 1 d/today is executed

As seen in the sequence diagram above, a request comes in to ParserUtil to parse the delivery date. A new DeliveryDate is then created and within it we instantiate a SimpleDateFormat object with the desired date format and an instance of PrettyTimeParser. We then request for PrettyTimeParser to parse the string today and subsequently pass it’s result into our SimpleDateFormat to format our date in the way we’ve defined, dd-MM-yyyy. After the date has been formatted, we store it within the DeliveryDate object to be returned to ParserUtil and subsequently returned to whichever method which called it.

The list of parcels stored in Ark is maintained to be sorted according to the delivery date of the parcels, with the earliest delivery date at the top. This allows the more pertinent deliveries to be shown quickly.
The list is sorted whenever there is a change in the list that may potentially disrupt the order of the list so that the user does not have to manually do so.

Figure 4.15.1 : Adding Alice to Ark, maintainSorted is actually called and returns void.

The list of parcels in Ark is maintained to be always in sorted order according to delivery dates, with the earliest being on the top. This is so that the user will be able to look at the more pertinent deliveries.

The list is sorted whenever a parcel is added or edited. This is because these commands are the ones that might possibly cause the new parcel to be placed in the wrong position.

Ark has two tabs, one for uncompleted parcels, the other for completed parcels. Whenever add and edit commands are executed, the newly added or edited parcel gets selected. If the status of the newly added or edited parcel is not on the current active list, a tab switch needs to happen. This is taken care off by the selection mechanism within the Model Manager class.

ArkBot is written using TelegramBots, a Java library written by rubenlagus to create bots using Telegram Bots API.

At present the following commands have an equivalent in ArkBot: add delete list find undo redo help. ArkBot also has the added functionality of complete which is merely a wrapper around the edit command to mark parcel deliveries as complete. This is especially useful for our delivery man.

Like all Telegram Bots, each command must be prefixed with a / character. So if I were to want to trigger the help command, I would send /help to ArkBot.

At present, all messages and commands to ArkBot are sent directly to Ark where they are processed and the commands and arguments are formatted as Ark commands and subsequently executed.

If we enter the complete command into ArkBot without any parameters, we enter listen mode. In listen mode, ArkBot is waiting for a QR to be sent to be analysed. The image is then downloaded and using the zxing barcode scanning library for Java, the information is unwrapped and parsed into the edit command to change the status of the parcel to COMPLETED.