BB Marketplace: System Requirements Specification (SRS)
BB Marketplace: System Requirements Specification (SRS)
Version 1.0
Produced by:
PayPro
Tariq Center, Suite 302, Plot 1C
Tariq Road, Block 2 PECHS
Karachi, Pakistan
Executive Overview
The Marketplace system will be a Web-based marketplace bringing together private individuals and small
companies to buy and sell all manner of items. It will take advantage of the Internet and World Wide Web to
radically improve the way they buy and sell items.
The buyer objectives for the Marketplace are to:
Provide them with a huge selection of items (and sellers).
Enable them to easily search for, find, and buy the items they want.
Enable them to buy items that they could not ordinarily find or afford.
Enable them to help set (and thereby minimize) the price of the items they wish to buy (e.g., via
auctions and reverse auctions).
Make buying more convenient by allowing them to buy items:
ANYTIME (I.E., 24 HOURS A DAY AND 7 DAYS A WEEK).
ANYWHERE THAT THE BUYERS HAVE ACCESS TO THE INTERNET (E.G., AT HOME, AT WORK,
AND WHILE TRAVELING).
Minimize risks associated with buying over the Internet.
The seller objectives for the Marketplace are to:
Provide them with a huge customer base of potential buyers.
Enable them to easily target and personalize their marketing to appropriate potential buyers.
Enable them to sell items that they could not otherwise afford to sell (e.g., by minimizing their
overhead and transaction costs).
Enable them to determine the market price of their items and set their prices accordingly.
Make selling more convenient by allowing them to sell items:
ANYTIME (I.E., 24 HOURS A DAY AND 7 DAYS A WEEK).
ANYWHERE THE SELLERS HAVE ACCESS TO THE INTERNET (E.G., AT HOME, AT WORK,
WHILE TRAVELING).
Minimize risks associated with selling over the Internet.
The PayPro objectives for the Marketplace are to:
Minimize the costs of providing a marketplace (e.g., capital costs, labor costs) compared to a
physical marketplace (e.g., a shopping mall) by maximizing automation and thus minimizing labor and
facilities costs.
Maximize income by maximizing the number of sellers (i.e., merchants) paying marketplace fees.
Table of Contents
1 INTRODUCTION.......................................................................................................................................10
1.1 SPECIFICATION DEFINITION....................................................................................................................10
1.2 SPECIFICATION OBJECTIVES...................................................................................................................10
1.3 INTENDED AUDIENCES...........................................................................................................................10
1.4 REFERENCES...........................................................................................................................................10
1.5 SPECIFICATION OVERVIEW.....................................................................................................................11
2 MARKETPLACE SYSTEM OVERVIEW...............................................................................................12
2.1 DEFINITION.............................................................................................................................................12
2.2 BUSINESS GOAL.....................................................................................................................................12
2.3 BUSINESS OBJECTIVES...........................................................................................................................12
2.3.1 Buyer Business Benefits.................................................................................................................12
2.3.2 Sellers Business Benefits...............................................................................................................12
2.3.3 Marketplace Owner Business Benefits..........................................................................................12
2.4 CONTEXT OF THE MARKETPLACE..........................................................................................................13
2.4.1 External Hardware........................................................................................................................13
2.4.2 External Roles...............................................................................................................................14
2.4.3 External Software..........................................................................................................................14
2.4.4 External Systems............................................................................................................................14
2.5 MARKETPLACE CAPABILITIES................................................................................................................14
2.5.1 Summary of System Capabilities...................................................................................................14
2.5.1.1 Employee Capabilities..............................................................................................................................14
2.5.1.2 Users Capabilities.....................................................................................................................................14
2.5.1.3 Other Capabilities.....................................................................................................................................15
3 FUNCTIONAL REQUIREMENTS...........................................................................................................16
3.1 SUMMARY USE CASE DIAGRAMS..........................................................................................................16
3.2 EXTERNAL ROLES..................................................................................................................................18
3.2.1 Accountant.....................................................................................................................................18
3.2.1.1 Use Case: Accountant Generates Financial Reports..................................................................................19
3.2.1.1.1 Normal Path: Feedback Summary Report Generated.........................................................................19
3.2.1.1.2 Normal Path: Fees Summary Report Generated.................................................................................20
3.2.1.1.3 Normal Path: Invoice Summary Report Generated............................................................................20
3.2.1.1.4 Normal Path: Listings Summary Report Generated...........................................................................21
3.2.1.1.5 Normal Path: User Summary Report Generated.................................................................................21
3.2.1.2 Use Case: Accountant Updates Fee Schedule...........................................................................................22
3.2.1.2.1 Normal Path: Fees Successfully Updated...........................................................................................22
3.2.1.2.2 Exception Path: Accountant Times Out.............................................................................................23
3.2.1.2.3 Exception Path: Invalid Fee...............................................................................................................23
3.2.1.3 Use Case: Accountant Updates User Restrictions.....................................................................................24
3.2.1.3.1 Normal Path: User Restrictions Successfully Updated.......................................................................24
3.2.1.3.2 Exception Path: Accountant Times Out.............................................................................................25
3.2.1.3.3 Exception Path: Invalid User Restriction...........................................................................................26
3.2.2 Buyer..............................................................................................................................................26
3.2.2.1 Use Case: Buyer Reads Buyer Guidelines.................................................................................................29
3.2.2.1.1 Normal Path: Guidelines Read...........................................................................................................29
3.2.2.2 Use Case: Buyer Searches for Items..........................................................................................................30
3.2.2.2.1 Normal Path: Search by Category......................................................................................................31
3.2.2.2.2 Normal Path: Search by Keywords....................................................................................................32
3.2.2.2.3 Normal Path: Search by Sale Number................................................................................................34
3.2.2.2.4 Normal Path: Search by Seller...........................................................................................................35
3.2.2.2.5 Exception Path: Buyer Times Out......................................................................................................37
3.2.2.2.6 Exception Path: Search Unsuccessful And Search Again...................................................................37
3.2.2.2.7 Exception Path: Unsuccessful Search Prompts Request for Notification of Future Sales...................38
3.2.2.3 Use Case: Marketplace Notifies Buyer of Cancelled Sale.........................................................................39
3.2.2.3.1 Normal Path: Auction Cancelled when Buyer is Logged On.............................................................39
3.2.2.3.2 Normal Path: Auction Cancelled when Buyer is Not Logged On......................................................40
3.2.2.3.3 Normal Path: Direct Sale Cancelled when Buyer is Logged On........................................................40
3.2.2.4 Use Case: Buyer Reviews Personal History..............................................................................................41
3.2.2.4.1 Normal Path: Bid History Displayed..................................................................................................41
3.2.2.4.2 Exceptional Path: No Bid History......................................................................................................42
3.2.2.5 Use Case: Buyer Reviews Seller Feedback History..................................................................................43
3.2.2.5.1 Normal Path: Seller Feedback Reviewed...........................................................................................43
3.2.2.5.2 Exceptional Path: No Feedback Registered........................................................................................44
3.2.2.6 Use Case: Buyer Registers Feedback about Seller....................................................................................45
3.2.2.6.1 Normal Path: Feedback Registered....................................................................................................45
3.2.2.7 Use Case: Buyer Registers for Notification of Future Sales......................................................................46
3.2.2.7.1 Normal Path: Search by Item Categories...........................................................................................46
3.2.2.7.2 Normal Path: Search by Keywords....................................................................................................47
3.2.2.7.3 Normal Path: Search by Sellers..........................................................................................................48
3.2.2.8 Use Case: Marketplace Notifies Buyer of Relevant Sale...........................................................................49
3.2.2.8.1 Normal Path: Buyer Notified when Logged On.................................................................................49
3.2.2.8.2 Normal Path: Buyer Notified when Not Logged On..........................................................................50
3.2.2.8.3 Exceptional Path: Buyer Account Deleted.........................................................................................50
3.2.2.9 Use Case: Buyer Places Bid On Item........................................................................................................51
3.2.2.9.1 Normal Path: Single Bid Placed.........................................................................................................51
3.2.2.9.2 Normal Path: Automatic Proxy Bid Placed........................................................................................52
3.2.2.9.3 Normal Path: Instant Win Price Bid...................................................................................................53
3.2.2.9.4 Exceptional Path: Bid Below Minimum Bid......................................................................................53
3.2.2.9.5 Exceptional Path: Bid Below Minimum Bid Increment.....................................................................55
3.2.2.9.6 Exceptional Path: Excessive Quantity Desired...................................................................................56
3.2.2.9.7 Exceptional Path: Auction is Closed..................................................................................................57
3.2.2.10 Use Case: GPM Notifies Buyer of Being Outbid......................................................................................57
3.2.2.10.1 Normal Path: Buyer Notified...........................................................................................................57
3.2.2.10.2 Exceptional Path: Buyer Account Deleted.......................................................................................58
3.2.2.11 Use Case: Buyer Modifies Bid On Item....................................................................................................59
3.2.2.11.1 Normal Path: Automatic Proxy Bid Modified..................................................................................59
3.2.2.11.2 Normal Path: Bid Withdrawn...........................................................................................................60
3.2.2.11.3 Exceptional Path: Auction is Closed................................................................................................61
3.2.2.11.4 Exceptional Path: Bid Increment is Below Minimum......................................................................62
3.2.2.11.5 Exceptional Path: Excessive Quantity Desired.................................................................................63
3.2.2.11.6 Exceptional Path: Maximum Bid is Below Minimum Bid...............................................................64
3.2.2.12 Use Case: Marketplace Notifies Winning Buyers of Auction Results.......................................................65
3.2.2.12.1 Normal Path: Winning Buyers Notified...........................................................................................66
3.2.2.12.2 Normal Path: No Winning Buyers...................................................................................................66
3.2.2.13 Use Case: Buyer Buys Item at Direct Sale................................................................................................67
3.2.2.14 Use Case: Buyer Places Sealed Offer at Decreasing Price Sale.................................................................67
3.2.2.15 Use Case: Buyer Modifies Sealed Offer....................................................................................................67
3.2.2.16 Use Case: Marketplace Notifies Buyer of Acceptance of Sealed Offer.....................................................67
3.2.3 Security Officer..............................................................................................................................67
3.2.3.1 Use Case: Security Officer Assigns Internal Roles...................................................................................68
3.2.3.1.1 Normal Path: Person Authorized as an Accountant............................................................................68
3.2.3.1.2 Normal Path: Accountant Authorization Revoked.............................................................................69
3.2.3.1.3 Normal Path: Person Authorized as a Security Officer......................................................................69
3.2.3.1.4 Normal Path: Security Officer Authorization Revoked......................................................................69
3.2.3.1.5 Normal Path: Person Authorized as a User Support Agent................................................................69
3.2.3.1.6 Normal Path: User Support Agent Authorization Revoked................................................................69
3.2.3.2 Use Case: Marketplace Notifies Security Officer of Security Violation....................................................69
3.2.3.2.1 Normal Path: Identification Failure....................................................................................................70
3.2.3.2.2 Normal Path: Authentication Failure.................................................................................................70
3.2.3.2.3 Normal Path: Banned User Authorization Failure..............................................................................71
3.2.3.2.4 Normal Path: Suspended User Authorization Failure.........................................................................72
3.2.3.3 Use Case: Security Officer Generates Security Reports............................................................................72
3.2.3.3.1 Normal Path: Security Report Generated...........................................................................................73
3.2.4 Seller..............................................................................................................................................73
3.2.4.1 Use Case: Seller Reads Seller Guidelines.................................................................................................74
3.2.4.1.1 Normal Path: Seller Guidelines Read.................................................................................................74
3.2.4.2 Use Case: Seller Registers Sales...............................................................................................................74
3.2.4.2.1 Normal Path: Auction Registered......................................................................................................75
3.2.4.2.2 Normal Path: Direct Sale Registered..................................................................................................76
3.2.4.2.3 Exceptional Path: Mandatory Information Missing............................................................................78
3.2.4.2.4 Exceptional Path: Seller Fees Past Due..............................................................................................79
3.2.4.3 Use Case: Seller Modifies Sale.................................................................................................................80
3.2.4.4 Use Case: Seller Cancels Sale...................................................................................................................80
3.2.4.4.1 Normal Path: Sale Successfully Cancelled.........................................................................................80
3.2.4.4.2 Exceptional Path: Sale Already Closed..............................................................................................81
3.2.4.5 Use Case: Marketplace Notifies Seller of Sale Results.............................................................................82
3.2.4.5.1 Normal Path: Dutch Auction with Winning Buyers...........................................................................82
3.2.4.5.2 Normal Path: Regular Auction with High Bid Winning Buyer..........................................................82
3.2.4.5.3 Normal Path: Regular Auction with Instant Winner...........................................................................83
3.2.4.5.4 Exceptional Path: No Bid Placed.......................................................................................................84
3.2.4.5.5 Exceptional Path: Reserve Price Not Met..........................................................................................85
3.2.4.6 Use Case: Seller Reviews Personal Feedback History..............................................................................86
3.2.4.6.1 Normal Path: Histories Reviewed When Auction is Open.................................................................86
3.2.4.7 Use Case: Seller Reviews Personal Sales..................................................................................................87
3.2.4.7.1 Normal Path: Sales Reviewed............................................................................................................88
3.2.4.7.2 Exceptional Path: No Sales................................................................................................................88
3.2.5 User...............................................................................................................................................89
3.2.5.1 Use Case: User Registers User Account....................................................................................................90
3.2.5.1.1 Normal Path: New Account Created..................................................................................................91
3.2.5.1.2 Exceptional Path: Account Already Exists.........................................................................................93
3.2.5.1.3 Exceptional Path: User Identifier is Not Unique................................................................................94
3.2.5.1.4 Exceptional Path: Mandatory Information Missing............................................................................96
3.2.5.2 Use Case: User Maintains User Account...................................................................................................99
3.2.5.2.1 Normal Path: User Information Updated...........................................................................................99
3.2.5.2.2 Normal Path: User Account Deleted................................................................................................100
3.2.5.2.3 Exceptional Path: New User Identifier is Not Unique......................................................................101
3.2.5.2.4 Exceptional Path: Mandatory Information Deleted..........................................................................103
3.2.5.2.5 Exceptional Path: User Account Not Deleted..................................................................................104
3.2.5.3 Use Case: User Displays General Information........................................................................................105
3.2.5.3.1 Normal Path: Marketplace Description Displayed...........................................................................105
3.2.5.3.2 Normal Path: Marketplace Description Displayed...........................................................................106
3.2.5.3.3 Normal Path: Frequently Asked Questions Displayed.....................................................................106
3.2.5.3.4 Normal Path: Electronic Auction Glossary Displayed.....................................................................107
3.2.5.3.5 Normal Path: User Agreement Displayed........................................................................................107
3.2.5.3.6 Normal Path: Privacy Policy Displayed...........................................................................................108
3.2.5.4 Use Case: User Displays Own Feedback History....................................................................................108
3.2.5.4.1 Normal Path: History Reviewed......................................................................................................109
3.2.5.5 Use Case: User Obtains User Email Address..........................................................................................109
3.2.5.5.1 Normal Path: Email Address Obtained............................................................................................110
3.2.5.5.2 Exceptional Path: User Not Found...................................................................................................110
3.2.5.6 Use Case: User Reviews Personal Account Status..................................................................................111
3.2.5.6.1 Normal Path: Account Status Displayed..........................................................................................111
3.2.5.7 Use Case: User Inquires Regarding Personal Account............................................................................112
3.2.5.7.1 Normal Path: Inquiry Successfully Made.........................................................................................112
3.2.5.8 Use Case: GPM Emails Invoice..............................................................................................................113
3.2.5.8.1 Normal Path: Balance Charged To Credit Card...............................................................................114
3.2.5.8.2 Normal Path: Balance Due From User.............................................................................................115
3.2.5.8.3 Exceptional Path: Outstanding Balance Less than Minimum Billing Balance.................................116
3.2.5.9 Use Case: GPM Requests Credit Card Authorization..............................................................................116
3.2.5.9.1 Normal Path: Authorization Approved............................................................................................117
3.2.5.9.2 Exceptional Path: Outstanding Balance Less than Minimum Billing Balance.................................117
3.2.5.9.3 Exceptional Path: Authorization Declined.......................................................................................118
3.2.6 User Support Agent.....................................................................................................................119
3.2.6.1 Use Case: User Support Agent Handles User Inquiry.............................................................................120
3.2.6.1.1 Normal Path: Inquiry Handled.........................................................................................................120
3.2.6.2 Use Case: User Support Agent Sanctions User.......................................................................................121
3.2.6.2.1 Normal Path: User Temporarily Suspended.....................................................................................122
3.2.6.2.2 Normal Path: User Permanently Banned..........................................................................................123
3.2.6.2.3 Exceptional Path: User Account Closed...........................................................................................124
4 DATA REQUIREMENTS........................................................................................................................126
4.1 BILLING CYCLE....................................................................................................................................126
4.2 FEE SCHEDULE.....................................................................................................................................126
4.2.1 Listing Fees.................................................................................................................................126
4.2.2 Purchase Fees.............................................................................................................................126
4.2.3 Service Fees.................................................................................................................................127
4.3 MESSAGES............................................................................................................................................127
4.4 REPORTS...............................................................................................................................................127
4.4.1 Feedback Summary Report..........................................................................................................127
4.4.2 Fees Summary Report..................................................................................................................128
4.4.3 Invoice Summary Report.............................................................................................................128
4.4.4 Listings Summary Report............................................................................................................129
4.4.5 User Summary Report.................................................................................................................129
4.5 USER ACCOUNT INFORMATION............................................................................................................129
4.6 USER RESTRICTIONS............................................................................................................................129
5 SYSTEM QUALITY REQUIREMENTS...............................................................................................129
5.1 ACCESSIBILITY.....................................................................................................................................130
5.2 AUDITABILITY......................................................................................................................................130
5.3 BRANDING............................................................................................................................................130
5.4 CONFIGURABILITY................................................................................................................................130
5.4.1 Variant Capabilities....................................................................................................................130
5.4.2 Internationalization.....................................................................................................................130
5.4.3 Personalization............................................................................................................................130
5.5 CORRECTNESS......................................................................................................................................130
5.5.1 Latent Defects..............................................................................................................................131
5.5.2 Accuracy......................................................................................................................................131
5.5.3 Precision......................................................................................................................................131
5.5.4 Timeliness....................................................................................................................................131
5.6 EFFICIENCY..........................................................................................................................................131
5.7 EXTENSIBILITY.....................................................................................................................................131
5.8 INSTALLATION......................................................................................................................................132
5.9 INTEROPERABILITY...............................................................................................................................132
5.10 MAINTAINABILITY................................................................................................................................132
5.11 OPERATIONAL AVAILABILITY..............................................................................................................132
5.12 PERFORMANCE.....................................................................................................................................133
5.12.1 Capacity.......................................................................................................................................133
5.12.2 Latency........................................................................................................................................133
5.12.3 Response Time.............................................................................................................................133
5.12.4 Throughput..................................................................................................................................133
5.13 PORTABILITY........................................................................................................................................133
5.14 RELIABILITY.........................................................................................................................................133
5.15 REUSABILITY........................................................................................................................................134
5.16 ROBUSTNESS........................................................................................................................................134
5.17 SAFETY.................................................................................................................................................134
5.18 SCALABILITY........................................................................................................................................134
5.19 SECURITY REQUIREMENTS...................................................................................................................135
5.19.1 Identification Requirements.........................................................................................................135
5.19.2 Authentication Requirements.......................................................................................................136
5.19.3 Authorization Requirements........................................................................................................136
5.19.4 Immunity Requirements...............................................................................................................137
5.19.5 Integrity Requirements................................................................................................................138
5.19.6 Intrusion Detection Requirements...............................................................................................138
5.19.7 Nonrepudiation Requirements.....................................................................................................138
5.19.8 Privacy Requirements..................................................................................................................140
5.19.9 Security Auditing Requirements..................................................................................................141
5.19.10 Survivability Requirements..........................................................................................................141
5.19.11 Physical Protection Requirements..............................................................................................141
5.19.12 System Maintenance Security Requirements...............................................................................141
5.20 TESTABILITY........................................................................................................................................141
5.21 USABILITY............................................................................................................................................141
6 SYSTEM CONSTRAINTS.......................................................................................................................143
6.1 BUSINESS RULES..................................................................................................................................143
6.2 DATA AND CONTENT CONSTRAINTS....................................................................................................143
6.2.1 Databases....................................................................................................................................143
6.3 HARDWARE CONSTRAINTS...................................................................................................................143
6.4 SOFTWARE CONSTRAINTS....................................................................................................................143
6.4.1 High-Level Languages.................................................................................................................143
6.5 INDUSTRY STANDARDS........................................................................................................................143
6.6 LEGAL AND REGULATORY CONSTRAINTS............................................................................................144
APPENDICES....................................................................................................................................................145
A. ENVISIONED FUTURE ENHANCEMENTS.......................................................................................................145
B. OPEN ISSUES................................................................................................................................................145
C. MAJOR TBDS..............................................................................................................................................145
D. ASSUMPTIONS..............................................................................................................................................146
Table of Figures
Figure 1: Marketplace Context Diagram..........................................................................................13
Figure 2: Employee Summary Use Case Diagram...........................................................................16
Figure 3: User Summary Use Case Diagram...................................................................................17
Figure 4: Accountant Use Case Diagram.........................................................................................18
Figure 5: General Buyer Use Case Diagram....................................................................................27
Figure 6: Auction-Specific Buyer Use Case Diagram.....................................................................28
Figure 7: Direct Sale Buyer Use Case Diagram...............................................................................28
Figure 8: Security Officer Use Case Diagram.................................................................................68
Figure 9: Seller Use Case Diagram..................................................................................................73
Figure 10: User Use Case Diagram..................................................................................................90
Figure 11: User Support Agent Use Case Diagram.......................................................................120