Cybertrax 2.1 Client (design)

From UG

Revision as of 21:32, 16 June 2010

Introduction

This article describes design (solution) for Cybertrax ver 2.1 Client application a.k.a. Shipper Interface.

Design is based on business requirements documented in Cybertrax 2.1 Client (requirements).

This document heavily relies on Business Story / Use Case approach to explain functionality. We took this approach believing it is better for a non technical audience.

Additional more technical definitions are included at the end of the document.

Cybertrax 2.1 Client Application

Providing required functionality to our client Arden could be achieved by adding additional features to our current CyberTrax 2.0 Client Application:

• create CT (Shipper role)
• authorize CT (Planner role)

We call this new version Cybertrax 2.1.

Please note that one of the challenges is to add extra functionality requested by various Jaguar clients to one web portal serving all companies. Emphasis here is on "one" because it does not seem feasible or even possible to create separate instances (with different feature set) of this application serving various companies.

Business Stories and related Use Cases

Business story One

Company Jackel is a supplier for a company CEI Holmdel. Accordingly to the new business process operator Mary Doe at Jackel is responsible for creating new shipments. All new shipments with PO issued by Arden Stamford have to go through authorization process by planner John at Arden in Stamford. If authorized then they are ready to enter into transportation phase and be handled by Jaguar operator Susan. It is also possible that they get rejected or put on hold. In addition supervisor Mike at Arden would like to monitor/run reports on all shipments created by Jackel.

On July 1, Mary has the following 3 products ready to ship from her NJ warehouse. The name and address of her warehouse is Gannet Warehouse and they are located at 50 Executive Drive in Edison, NJ. These products are shipping to Cosmetic Essence Inc (CEI), who are located at 2182 Route 35S in in Holmdel, NJ. First Mary has cosmetic brushes under PO # H018386, Sku 152813, that are packed onto 1 pallet, with 8 cartons, that contain 49,152 pcs inside, and weighs 108 pounds. Second, Mary has aluminum caps under PO # HEA0043, Sku 135096 that are packed onto 4 pallets, with 50 cartons, that contain 40,000 pcs inside, and weighs 560 pounds. Third Mary has empty glass bottles under PO # H016242, Sku 158841E5, that are packed onto 12 pallets, with 1545 cartons, that contain 30,900 pcs inside, and weighs 4356 pounds.

Note for CT2 Admin

In order to implement described business process in Cybertrax 2.1 we need to create users with appropriate roles:

• user mary@jackel.com with enabled “Shipper (a.k.a. Supplier) /Create Shipments Role”
• user john@arden.com with enabled “Authorization/Planner Role”
• user susan@jaguarfreight.com with enabled “Jaguar Operator Role”
• user mike@arden.com with enabled “Viewer (a.k.a. Client) Role”

Please note that current version Cybertrax 2.0 is based on another business process. Shipments are created by users with Jaguar Role (jaguar employees) only. At the same time read-only monitoring/reporting on shipments is supported (Client User role). Authorization is not part of this process.

Use case. Create User Mary with a Create CT Role

Jaguar operations manager creates user mary@jackel.com with Supplier role. E0 Client Company field is set to EA USA Domestic. Shipper field is set to Jackel. See #Figure 1.

Use case. Log In As a Supplier First time

Mary logs in. Her homepage is Shipments List, New Tab. No shipments displayed. See #Figure 3.

Use case. Create First Shipment

1) Mary clicks on “Add” button. System offers empty form. Mary fills in all required fields. See #Figure 4

2) Mary clicks “Save” button and is presented with “Preview and Disclaimer Screen”. See #Figure 5

3) She makes sure that all info is accurate, clicks OK and presented with “Confirmation screen”. See #Figure 6

Use Case. View CTs in Shipper role

• see steps 1,2,3 above

• 4) Mary clicks OK and System presents her with Shipments List. 3 new shipments appear now on New Tab. See #Figure 7

Use Case. Edit CT

Mary realizes that she has to edit some information. She selects CT and clicks on Edit. System presents the screen as defined on #Figure 12.

Use Case. View CT

After shipment went through approval process Mary will only be able to view CT and not edit - see #Figure 13 Please note that there are additional read only fields.

Use case. Create User with Authorization/Planner Role

Jaguar operations manager creates user john@arden.com with Planner role. “Authorize CT with PO issued by” field is set to “EA Stamford” . See #Figure 2.

Use case. Log In As a Planner and see shipments to authorize

Planner John logs in and see 3 new shipments that Mary created and he may authorize. See #Figure 8

Use case. Planner John approves one CT and rejects one CT

Planner John rejects one CT and approves another. To do that he selects appropriate CT on List CTs page, selects appropriate status from dropdown and clicks on "Submit" button.

Shipments now are displayed on appropriate tabs according to approval status. See Approved tab #Figure 9 Reject Tab #Figure 11.

Use case. Planner John puts one CT on hold without a date

Planner John puts on hold CT# ... See #Figure 10b.

Use case. Planner John adds date to CT that is on hold

...

Use case. Entering comment

Every time John set status on a shipment he must enter comment - see #Figure 10a.

Use Case. View CTs (as a Planner)

John may want to see detailed CT view. He selects CT and clicks on "View" button. See result on #Figure 14

Figures

Figure 1

Figure 2

Figure 3

Figure 4

Figure 5

Figure 6

Figure 7

Figure 8

Figure 9

Figure 10

Figure 10a

Figure 10b

Figure 11

Figure 12

Figure 13

Figure 14

Additional Technical Information