Cybertrax 2.1 Client (design)

From UG

(Difference between revisions)
Jump to: navigation, search
(Use case. Planner John approves one CT and rejects one CT)
 
(43 intermediate revisions not shown)
Line 1: Line 1:
-
[[Category: ClientEtc]]
+
[[Category:Cybertrax 2.1 Client]]
== Introduction ==
== Introduction ==
Line 7: Line 7:
Design is based on business requirements documented in [[Cybertrax 2.1 Client (requirements)]].
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.
+
=== Shipper Functionality ===
 +
Fully defined in:
 +
* [[Cybertrax 2.1 Client (requirements)]]
 +
* [[Cybertrax 2.1 Client (data dictionary)]]
 +
* see also [[Cybertrax 2.1 Client (use cases)]]
-
Additional more technical definitions are included at the end of the document.
+
=== Planner Functionality ===
 +
Fully defined in:
 +
* [[Cybertrax 2.1 Client (requirements)]]
 +
* [[Cybertrax 2.1 Client (data dictionary)]]
 +
* see also [[Cybertrax 2.1 Client (use cases)]]
-
=== Cybertrax 2.1 Client Application ===
+
=== Jaguar User Functionality ===
 +
Fully defined in:
 +
* [[Cybertrax 2.1 Client (requirements)]]
 +
* [[Cybertrax 2.1 Client (data dictionary)]]
 +
* see also [[Cybertrax 2.1 Client (use cases)]]
-
Providing required functionality to our client Arden could be achieved by adding additional features to our current CyberTrax 2.0 Client Application:
+
=== Miscellaneous Functionality ===
-
 
+
Fully defined in:
-
* create CT (Shipper role)
+
* [[Cybertrax 2.1 Client (requirements)]]
-
* authorize CT (Planner role)
+
* [[Cybertrax 2.1 Client (data dictionary)]]
-
 
+
* see also [[Cybertrax 2.1 Client (use cases)]]
-
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 "Apply" 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 ===
+
-
[[File:Shipper User for EA Dom and Jackel.JPG]]
+
-
 
+
-
=== Figure 2 ===
+
-
[[File:Planner User John at Arden Stamford.JPG]]
+
-
 
+
-
=== Figure 3 ===
+
-
[[File:CreatedCTListWithOutCT.JPG]]
+
-
 
+
-
=== Figure 4 ===
+
-
[[File:GeneralCreateAdd3Commo.JPG]]
+
-
 
+
-
=== Figure 5 ===
+
-
[[File:DisclaimerAndPreview.JPG]]
+
-
 
+
-
=== Figure 6 ===
+
-
[[File:ConfirmationWith3records.JPG]]
+
-
 
+
-
=== Figure 7 ===
+
-
[[File:NewTabShipper.JPG]]
+
-
 
+
-
=== Figure 8 ===
+
-
[[File:NewTabEM.JPG]]
+
-
 
+
-
=== Figure 9 ===
+
-
[[File:ApproveTabEM.JPG]]
+
-
 
+
-
=== Figure 10 ===
+
-
[[File:NewToHoldEM.JPG]]
+
-
 
+
-
=== Figure 10a ===
+
-
[[File:CommentWindow.JPG]]
+
-
 
+
-
=== Figure 10b ===
+
-
[[File:HoldTabEM.JPG]]
+
-
 
+
-
=== Figure 11 ===
+
-
[[File:RejectedTabEM.JPG]]
+
-
 
+
-
=== Figure 12 ===
+
-
[[File:EditCTShipper.JPG]]
+
-
 
+
-
=== Figure 13 ===
+
-
[[File:ViewCTShipper.JPG]]
+
-
 
+
-
=== Figure 14 ===
+
-
[[File:ViewCTEM.JPG]]
+
-
 
+
-
== Additional Technical Information ==
+

Current revision as of 20:17, 22 June 2010


Contents

[edit] 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).

[edit] Shipper Functionality

Fully defined in:

[edit] Planner Functionality

Fully defined in:

[edit] Jaguar User Functionality

Fully defined in:

[edit] Miscellaneous Functionality

Fully defined in:

Personal tools