Software Requirements

Specification
for

Koi Shop
Version 1.0 approved

Prepared by Vũ Hoàng Anh, Hồ Tâm Khang, Nguyễn Văn Minh,

Nguyễn Minh Hiếu

Koi Koi Farm

10/10/2024

Copyright © 2013 by Karl Wiegers and Seilevel. Permission is granted to use and modify this document.
Software Requirements Specification for <Project> Page ii

Table of Contents
Table of Contents...........................................................................................................................ii
Revision History.............................................................................................................................ii
1. Introduction..............................................................................................................................2
1.1 Purpose.........................................................................................................................................2
1.2 Document Conventions................................................................................................................2
1.3 Project Scope................................................................................................................................2
1.4 References....................................................................................................................................2
2. Overall Description..................................................................................................................2
2.1 Product Perspective......................................................................................................................2
2.2 User Classes and Characteristics..................................................................................................2
2.3 Operating Environment................................................................................................................2
2.4 Design and Implementation Constraints.......................................................................................2
2.5 Assumptions and Dependencies...................................................................................................2
3. System Features.......................................................................................................................2
3.1 System Feature 1..........................................................................................................................2
3.2 System Feature 2..........................................................................................................................2
3.3 System Feature 3..........................................................................................................................2
3.4 System Feature 4..........................................................................................................................2
4. Data Requirements..................................................................................................................2
4.1 Logical Data Model......................................................................................................................2
4.2 Data Dictionary.............................................................................................................................2
4.3 Reports..........................................................................................................................................2
4.4 Data Acquisition, Integrity, Retention, and Disposal...................................................................2
5. External Interface Requirements...........................................................................................2
5.1 User Interfaces..............................................................................................................................2
5.2 Software Interfaces.......................................................................................................................2
5.3 Hardware Interfaces......................................................................................................................2
5.4 Communications Interfaces..........................................................................................................2
6. Quality Attributes....................................................................................................................2
6.1 Usability........................................................................................................................................2
6.2 Performance..................................................................................................................................2
6.3 Security.........................................................................................................................................2
6.4 Safety............................................................................................................................................2
6.5 [Others as relevant].......................................................................................................................2
7. Internationalization and Localization Requirements...........................................................2
8. Other Requirements................................................................................................................2
Appendix A: Glossary....................................................................................................................2
Appendix B: Analysis Models.......................................................................................................2

Revision History
Name Date Reason For Changes Version
Vũ Hoàng Anh 2024-10- Initial draft based on Koi farm system 1.0
12 requirements
Nguyễn Văn Minh 2024-10- Added features for customer consignment and 1.1
14 Koi comparison tools
Nguyễn Minh Hiếu 2024-10-16 Updated shopping features with certificate issuance1.2
and post-purchase care

Copyright © 2013 by Karl Wiegers and Seilevel. Permission is granted to use and modify this document.
Software Requirements Specification for <Project> Page iii

Hồ Tâm Khang 2024-10- 1.3

Finalized system features for loyalty programs, feedback, and reports
18

Copyright © 2013 by Karl Wiegers and Seilevel. Permission is granted to use and modify this document.
Software Requirements Specification for <Project> Page 1

1. Introduction
This Software Requirements Specification (SRS) outlines the Koi Fish Management System for the
farm, detailing the system's functionalities, design constraints, and requirements. It serves as a
guide for developers, testers, project managers, and other stakeholders, describing how the
system will operate to meet the farm's business objectives of selling Koi fish, providing post-sale
care, and supporting customer engagement through consignment and detailed fish information.

1.1 Purpose
The purpose of this document is to specify the requirements for the Koi Fish Management System,
version 1.0. The target audience includes developers, project managers, farm owners, testers,
marketing staff, and users who will interact with the system. This document provides a clear
description of the system’s objectives, functionalities, and constraints to ensure successful
development and implementation.

1.2 Document Conventions

 Bold text is used for section headers and important points.
 “REQ” followed by a number is used to identify specific functional requirements (e.g., REQ-
001).
 Placeholder text like “TBD” indicates where additional information is needed.
 Italic text may be used for examples or special notes.

1.3 Project Scope

The Koi Fish Management System is designed to support a Koi farm in managing the sale of Koi
fish, customer interaction, and after-sales services. The system will provide a homepage that
introduces the farm, detailed information on available Koi fish, and an option for customers to
purchase and receive certification for the Koi they buy. The system also enables post-purchase
care, consignment services, and feedback management, and offers comprehensive reports and
dashboards for administrators.

1.4 References
 Farm’s business requirements document.
 Web development guidelines.
 Payment gateway integration documentation.

2. Overall Description
The Koi Fish Management System is a web-based platform developed to streamline the process of
selling Koi fish, providing care services, and allowing customers to interact with the farm through
purchases and consignments.

Copyright © 2013 by Karl Wiegers and Seilevel. Permission is granted to use and modify this document.
Software Requirements Specification for <Project> Page 2

2.1 Product Perspective

This system is designed as a standalone product aimed at improving Koi fish sales, customer
interaction, and after-sales services for a Koi fish farm. It is not dependent on any pre-existing
systems but may require integration with third-party services such as payment gateways and
customer communication platforms.

2.2 User Classes and Characteristics

 Farm staff: Manage Koi inventory, sales, and customer queries.
 Customers: Purchase Koi, request consignment services, and interact with the farm for
post-purchase care.
 Administrators: Oversee the system, generate reports, and manage promotional activities.

2.3 Operating Environment

 Web-based application accessible via modern browsers (e.g., Chrome, Firefox).
 Hosted on cloud servers with necessary backup and security systems.
 Integration with payment gateways for online transactions.

2.4 Design and Implementation Constraints

 The system must comply with data protection regulations.
 It will interface with third-party payment gateways.
 The user interface will be optimized for both desktop and mobile use.

2.5 Assumptions and Dependencies

Customers have access to the internet to interact with the system.
The farm has personnel available to handle customer queries and Koi fish care services.

3. System Features
The Koi Fish Management System includes the following main features:

3.1 System Feature 1

Koi Fish Listing and Details.

3.1.1 Description

Customers can view detailed information about available Koi fish, including origin, species,
gender, size, age, temperament, daily feeding requirements, and certificates.

Priority: High.

3.1.2 Stimulus/Response Sequences

Copyright © 2013 by Karl Wiegers and Seilevel. Permission is granted to use and modify this document.
Software Requirements Specification for <Project> Page 3

Customer searches for a Koi fish by criteria (species, size, origin), and the system returns
matching results.

3.1.3 Functional Requirements

 REQ-001: Display detailed Koi fish information.

 REQ-002: Enable search by various criteria (e.g., imported purebred, F1 hybrids,

domestic breeds).

3.2 System Feature 3

Koi Fish Purchase and Certification.

3.2.1 Description
Customers can purchase Koi fish, either individually or in bulk, and receive certificates of
origin, health, and awards.

Priority: High.

3.2.2 Stimulus/Response Sequences

Customer selects Koi fish, completes purchase, and receives a digital certificate.

3.2.3 Functional Requirements

 REQ-003: Allow Koi purchase.

 REQ-004: Provide certificate for purchased Koi.

3.3 System Feature 3

Koi Fish Purchase and Certification.

3.3.1 Description

Customers can consign Koi fish for sale or care at the farm. Two consignment modes are
offered: offline for regular care, and online for business purposes.

Priority: Medium.

3.3.2 Stimulus/Response Sequences

Customer requests consignment; farm staff confirm price and perform fish transfer.

3.3.3 Functional Requirements

 REQ-005: Support consignment requests.

Copyright © 2013 by Karl Wiegers and Seilevel. Permission is granted to use and modify this document.
Software Requirements Specification for <Project> Page 4

 REQ-006: Manage consignment process (price confirmation, fish transfer, sale).

3.4 System Feature 4

Koi Fish Comparison Tool.

3.4.1 Description

Customers can compare multiple Koi fish side-by-side to aid in purchase decisions.

Priority: Low.

3.4.2 Stimulus/Response Sequences

Customer selects two or more Koi fish for comparison; system shows side-by-side details.

3.4.3 Functional Requirements

 REQ-007: Provide comparison view for selected Koi fish.

4. Data Requirements
4.1 Logical Data Model
The system will manage data related to Koi fish, customers, sales, and consignment. A relational
database will be used to store fish details, customer profiles, transaction histories, and
consignment data.

4.2 Data Dictionary

Each Koi fish entry will include fields like species, size, gender, age, temperament, and
certifications. Customer data will include name, contact information, and purchase history.

4.3 Reports
The system will generate reports on fish sales, customer activity, and consignment performance,
including metrics on customer satisfaction and Koi health.

4.4 Data Acquisition, Integrity, Retention, and Disposal

Data will be backed up daily, and customer data will be retained in compliance with data protection
regulations. Consigned fish data will be stored for the duration of the consignment.

Copyright © 2013 by Karl Wiegers and Seilevel. Permission is granted to use and modify this document.
Software Requirements Specification for <Project> Page 5

5. External Interface Requirements

5.1 User Interfaces
The system will feature a web-based UI for both desktop and mobile users. It will be designed to
be intuitive and accessible, with support for searching, purchasing, and managing Koi fish.

5.2 Software Interfaces

Integration with payment gateways will be essential for handling online transactions securely. The
system will also integrate with third-party tools for sending customer updates and notifications.

5.3 Hardware Interfaces

No direct hardware interface is required, though the system will need to work with any standard
devices (e.g., PCs, tablets, smartphones) capable of accessing the web.

5.4 Communications Interfaces

The system will communicate with customers via email and SMS for notifications related to
purchases, consignment updates, and Koi fish health status.

6. Quality Attributes
6.1 Usability
The system will be designed for ease of use with clear navigation, search functionality, and simple
transaction flows.

6.2 Performance
The system should handle up to 500 concurrent users without performance degradation. Page load
times should be under 2 seconds.

6.3 Security
The system must ensure the security of customer data, including payment information, through
encryption and secure communications.

6.4 Safety
The system must ensure data safety, preventing loss or unauthorized access to customer
information and transaction details.

Copyright © 2013 by Karl Wiegers and Seilevel. Permission is granted to use and modify this document.
Software Requirements Specification for <Project> Page 6

7. Internationalization and Localization Requirements

The system will support multiple languages and formats for currency, dates, and addresses,
allowing it to operate in various countries with minimal configuration changes.

8. Other Requirements
The system must comply with relevant financial and data protection regulations, including GDPR
(General Data Protection Regulation) and any local laws related to e-commerce and online
payments.

Appendix A: Glossary
 F1 Hybrids: First generation offspring of crossbred Koi fish.
 Consignment: Agreement to store and sell Koi fish on behalf of a customer.

Appendix B: Analysis Models

Data flow diagrams and entity-relationship diagrams (ERDs) will be provided separately to illustrate
the data processes within the system.

Copyright © 2013 by Karl Wiegers and Seilevel. Permission is granted to use and modify this document.