Cybertrax 2.1 Client (design)

From UG

(Difference between revisions)
Jump to: navigation, search
(Document History)
 
(4 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 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.
+
-
 
+
-
Technical Note:
+
-
--------------
+
-
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
+
-
to create separate instances (with different feature set) of this application
+
-
(and DB) serving various companies.
+
-
 
+
-
== Business Story and related Use Cases ==
+
-
 
+
-
=== Business story ===
+
-
 
+
-
''Company Jackel is a supplier for a company CEI Holmdel. According to the new business process operator Mary Doe at Jackel is responsible for creating new shipments. All new shipments with PO issued by CEI Holmdel 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.''
+
-
 
+
-
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).
+
-
 
+
-
=== Use Cases ===
+
-
 
+
-
==== 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]].
+
-
 
+
-
===== Figure 1 =====
+
-
[[File:Shipper User for EA Dom and Jackel.JPG]]
+
-
 
+
-
 
+
-
==== 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]].
+
-
 
+
-
===== Figure 3 =====
+
-
[[File:CreatedCTListWithOutCT.JPG]]
+
-
 
+
-
==== Use case. Create First Shipment ====
+
-
1) Mary clicks on “Add” button. System offers empty form. Mary fills in all required fields. See [[#Figure 4]]
+
-
 
+
-
===== Figure 4 =====
+
-
[[File:GeneralCreateAdd3Commo.JPG]]
+
-
 
+
-
2) Mary clicks “Save” button and is presented with “Preview and Disclaimer Screen”. See [[#Figure 5]]
+
-
 
+
-
===== Figure 5 =====
+
-
[[File:DisclaimerAndPreview.JPG]]
+
-
 
+
-
3) She makes sure that all info is accurate, clicks OK and presented with “Confirmation screen”. See [[#Figure 6]]
+
-
 
+
-
===== Figure 6 =====
+
-
[[File:ConfirmationWith3records.JPG]]
+
-
 
+
-
==== 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]]
+
-
 
+
-
===== Figure 7 =====
+
-
[[File:NewTabShipper.JPG]]
+
-
 
+
-
==== 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]].
+
-
 
+
-
===== Figure 12 =====
+
-
[[File:EditCTShipper.JPG]]
+
-
 
+
-
 
+
-
==== 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.
+
-
 
+
-
===== Figure 13 =====
+
-
[[File:ViewCTShipper.JPG]]
+
-
 
+
-
 
+
-
==== 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 “CEI Holmdel” . See [[#Figure 2]].
+
-
 
+
-
===== Figure 2 =====
+
-
[[File:Planner User John at Arden Stamford.JPG]]
+
-
 
+
-
==== 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]]
+
-
 
+
-
===== Figure 8 =====
+
-
[[File:NewTabEM.JPG]]
+
-
 
+
-
 
+
-
==== 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]] and Reject Tab [[#Figure 11]].
+
-
 
+
-
===== Figure 9 =====
+
-
[[File:ApproveTabEM.JPG]]
+
-
 
+
-
===== Figure 11 =====
+
-
[[File:RejectedTabEM.JPG]]
+
-
 
+
-
 
+
-
==== Use case. Planner John puts one CT on hold without a date ====
+
-
Planner John puts on hold CT#11112 See [[#Figure: CT On hold without a date]].
+
-
 
+
-
===== Figure: CT On hold without a date =====
+
-
[[File:John CT On hold without a date.JPG]]
+
-
 
+
-
==== Use case. Planner John adds Approved for date to CT that is on hold ====
+
-
John selects CT and sets Approved for date to 01-Jul-2010.
+
-
 
+
-
This CT will be moved to Approved Tab by system automatically on Jul 01, 2010 (unless John decides to change this date or CT status).
+
-
 
+
-
He could also simply set status to Approved or Rejected instead of setting Approved for date.
+
-
 
+
-
See [[#Figure 10b]]
+
-
 
+
-
===== Figure 10b =====
+
-
[[File:HoldTabEM.JPG]]
+
-
 
+
-
 
+
-
==== Use case. Entering comment ====
+
-
Every time John set status to a shipment he can enter a comment - see [[#Figure 10a]].
+
-
 
+
-
===== Figure 10a =====
+
-
[[File:CommentWindow.JPG]]
+
-
 
+
-
==== 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]]
+
-
 
+
-
===== Figure 14 =====
+
-
[[File:ViewCTEM.JPG]]
+
-
 
+
-
==== Use Case. Switch between different roles ====
+
-
Max Links has 2 roles activated in profile: Client, and Shipper. He is currently looking at CT details as Client. To switch to his Shipper view he may click on the menu item located in the Header. See [[#Figure 15]]
+
-
 
+
-
===== Figure 15 =====
+
-
[[File:Client view with Shipper and Planner roles.JPG]]
+
-
 
+
-
== Additional Design Information ==
+
-
 
+
-
=== Add_new_address_by_a_Shipper_feature ===
+
-
 
+
-
This is a detailed design for
+
-
[[Cybertrax_2.1_Client_(requirements)#Add_new_address_by_a_Shipper_feature]]
+
-
 
+
-
TBD
+
-
 
+
-
=== History panel ===
+
-
 
+
-
See example of history panel below.
+
-
 
+
-
=== Figure 14a ===
+
-
[[File:HistoryWindow.JPG]]
+
-
 
+
-
== Document History ==
+
-
 
+
-
* published ver 1.0 --[[User:Alex|Alex]] 19:27, 18 June 2010 (EDT)
+

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