Đặc tả yêu cầu phần mềm cho dự án phiên bản 1 0 đã được phê duyệt

Đặc Tả Yêu Cầu Phần Mềm cho Phiên bản 1.0 đã được phê duyệt Được biên soạn bởi Karl Wiegers, Software Requirements Specification Template PPL - Đặc tả yêu cầu phần mềm cho Trang ii Mục lục Mục lục ii Lịch sử sửa đổi iii 1 Giới thiệu 1 1.1 Mục đích của tài liệu 1 1.2 Quy ước tài liệu 1 1.3 Phạm vi dự án 1 1.4 Tài liệu tham khảo 2 2 Mô tả tổng quan .2 2.1 Bối cảnh sản phẩm 2 2.2 Lớp người dùng và đặc điểm 2 2.3 Môi trường hoạt động 3 2.4 Ràng buộc về thiết kế và thực hiện 3 2.5 Giả định và sự phụ thuộc .3 3 Tính năng hệ thống 4 3.1 Tính năng hệ thống 1 .4 3.1.1 Mô tả 4 3.1.2 Trình tự kích thích/phản ứng .4 3.1.3 Yêu cầu chức năng .4 3.2 Tính năng hệ thống 2 (và v.v.) .5 4 Yêu cầu dữ liệu .5 4.1 Mô hình dữ liệu logic .5 4.2 Từ điển dữ liệu .5 4.3 Báo cáo 6 4.4 Thu thập, toàn vẹn, lưu giữ và xử lý dữ liệu 6 5 Yêu cầu giao diện bên ngoài 6 5.1 Giao diện người dùng 6 5.2 Giao diện phần mềm 6 5.3 Giao diện phần cứng 7 5.4 Giao diện truyền thông 7 6 Thuộc tính chất lượng 8 6.1 Khả năng sử dụng 8 6.2 Hiệu suất 8 6.3 Bảo mật 8 6.4 Sự an toàn 8 6.5 [Những thuộc tính chất lượng khác có liên quan] 8 7 Yêu cầu quốc tế hóa và nội địa hóa 9 Karl Wiegers, Software Requirements Specification Template PPL - Đặc tả yêu cầu phần mềm cho Trang iii 8 Những yêu cầu khác .9 9 Bảng thuật ngữ .9 10 Mô hình phân tích 9 Karl Wiegers, Software Requirements Specification Template PPL - Đặc tả yêu cầu phần mềm cho Trang iv Lịch sử sửa đổi Phiên bản Tên Ngày Lý do thay đổi Karl Wiegers, Software Requirements Specification Template PPL - Đặc tả yêu cầu phần mềm cho Trang 1 1 Giới thiệu 1.1 Mục đích của tài liệu < - Xác định sản phẩm mà các yêu cầu phần mềm của nó được xác định trong tài liệu này, bao gồm số phát hành hoặc số của bản sửa đổi - Mô tả các nhóm người đọc khác nhau mà tài liệu hướng tới, chẳng hạn như người phát triển, người quản lý dự án, nhân viên tiếp thị, người dùng, kiểm thử viên và người viết tài liệu > 1.2 Quy ước tài liệu < - Mô tả mọi tiêu chuẩn hoặc quy ước đánh máy được sử dụng, bao gồm ý nghĩa của các kiểu văn bản cụ thể, đánh dấu điểm nổi bật hoặc ký hiệu - Nếu đang gắn nhãn các mã định danh yêu cầu duy nhất theo cách thủ công, bạn có thể mô tả định dạng ở đây cho bất cứ người nào cần thêm một yêu cầu vào tài liệu sau này > 1.3 Phạm vi dự án < - Cung cấp mô tả ngắn gọn về phần mềm được xác định và mục đích của nó - Liên hệ phần mềm với mục tiêu của người dùng hoặc công ty cũng như với các mục tiêu và chiến lược kinh doanh - Nếu có tài liệu tầm nhìn và phạm vi riêng biệt hoặc tài liệu tương tự, hãy tham khảo đến nó thay vì sao chép nội dung của nó vào đây - SRS cho một bản phát hành tiếp theo của sản phẩm đang phát triển phải chứa tuyên bố phạm vi riêng của nó như một tập hợp con của tầm nhìn sản phẩm chiến lược dài Karl Wiegers, Software Requirements Specification Template PPL - Đặc tả yêu cầu phần mềm cho Trang 2 hạn Bạn có thể cung cấp bản tóm tắt cấp cao về các tính năng chính mà bản phát hành có hoặc các chức năng quan trọng mà bản phát hành thực hiện > 1.4 Tài liệu tham khảo < - Liệt kê mọi tài liệu hoặc nguồn khác mà SRS này đề cập đến Bao gồm các đường link đến chúng nếu chúng ở một vị trí cố định Chúng có thể bao gồm hướng dẫn về kiểu giao diện người dùng, hợp đồng, tiêu chuẩn, đặc tả yêu cầu hệ thống, đặc tả giao diện hoặc SRS của sản phẩm liên quan - Cung cấp đủ thông tin để người đọc có thể truy cập từng tài liệu tham khảo, bao gồm tiêu đề, tác giả, số phiên bản, ngày tháng và nguồn, vị trí lưu trữ hoặc URL > 2 Mô tả tổng quan 2.1 Bối cảnh sản phẩm < - Mô tả bối cảnh và nguồn gốc của sản phẩm Đây có phải là thành viên tiếp theo của dòng sản phẩm đang phát triển, phiên bản tiếp theo của hệ thống trưởng thành, sản phẩm thay thế cho ứng dụng hiện có hay sản phẩm hoàn toàn mới? - Nếu SRS này xác định một thành phần của hệ thống lớn hơn, hãy nêu rõ phần mềm này liên quan như thế nào đến hệ thống tổng thể và xác định các giao diện chính giữa hai hệ thống - Hãy cân nhắc đưa vào các mô hình trực quan như sơ đồ ngữ cảnh hoặc bản đồ hệ sinh thái để thể hiện mối quan hệ của sản phẩm với các hệ thống khác > 2.2 Lớp người dùng và đặc điểm < Karl Wiegers, Software Requirements Specification Template PPL - Đặc tả yêu cầu phần mềm cho Trang 3 - Xác định các lớp (nhóm) người dùng khác nhau mà bạn dự đoán sẽ sử dụng sản phẩm này và mô tả các đặc điểm thích hợp của họ Một số yêu cầu có thể chỉ liên quan đến một số lớp người dùng nhất định - Xác định các lớp người dùng ưa thích Các lớp người dùng đại diện cho một tập hợp con của các bên liên quan được mô tả trong tài liệu tầm nhìn và phạm vi - Các mô tả lớp người dùng là tài nguyên có thể tái sử dụng Nếu chúng có sẵn, bạn nên tham chiếu đến chúng trong danh mục lớp người dùng chính thay vì sao chép thông tin ở đây > 2.3 Môi trường hoạt động < - Mô tả môi trường mà phần mềm sẽ hoạt động, bao gồm cả nền tảng phần cứng; hệ điều hành và phiên bản; vị trí địa lý của người dùng, máy chủ và cơ sở dữ liệu; và các tổ chức lưu trữ cơ sở dữ liệu, máy chủ và website liên quan - Liệt kê bất kỳ thành phần phần mềm hoặc ứng dụng nào khác mà hệ thống phải cùng tồn tại một cách hòa bình - Nếu công việc cơ sở hạ tầng kỹ thuật mở rộng cần được thực hiện cùng với việc phát triển hệ thống mới, hãy xem xét việc tạo một đặc tả yêu cầu cơ sở hạ tầng riêng biệt để trình bày chi tiết công việc đó > 2.4 Ràng buộc về thiết kế và thực hiện < - Mô tả bất kỳ yếu tố nào sẽ giới hạn các tùy chọn có sẵn cho người phát triển - Chúng có thể bao gồm: các chính sách của công ty hoặc quy định; các hạn chế về phần cứng (yêu cầu về thời gian hoặc bộ nhớ); giao diện với các ứng dụng khác; các công nghệ, công cụ và cơ sở dữ liệu cụ thể sẽ được sử dụng; yêu cầu hoặc hạn chế về ngôn ngữ lập trình > 2.5 Giả định và sự phụ thuộc < Karl Wiegers, Software Requirements Specification Template PPL - Đặc tả yêu cầu phần mềm cho Trang 4 - Liệt kê mọi yếu tố giả định (ngược lại với các sự kiện đã biết) có thể ảnh hưởng đến các yêu cầu được nêu trong SRS - Chúng có thể bao gồm các thành phần thương mại hoặc bên thứ ba mà bạn dự định sử dụng, các kỳ vọng tái sử dụng, các vấn đề xung quanh môi trường phát triển hoặc vận hành hoặc các ràng buộc Dự án có thể bị ảnh hưởng nếu những giả định này không chính xác, không được chia sẻ hoặc thay đổi Đồng thời xác định bất kỳ sự phụ thuộc nào của dự án vào các yếu tố bên ngoài nằm ngoài tầm kiểm soát của dự án > 3 Tính năng hệ thống < - Mẫu này minh họa việc sắp xếp các yêu cầu chức năng cho sản phẩm theo tính năng hệ thống, các dịch vụ chính mà sản phẩm cung cấp - Bạn có thể tổ chức phần này theo trường hợp sử dụng, phương thức hoạt động, lớp người dùng, lớp đối tượng, phân cấp chức năng, kích thích, phản hồi hoặc kết hợp những thứ này, bất cứ điều gì có ý nghĩa logic nhất đối với sản phẩm của bạn.> 3.1 Tính năng hệ thống 1 3.1.1 Mô tả 3.1.2 Trình tự kích thích/phản ứng 3.1.3 Yêu cầu chức năng < Karl Wiegers, Software Requirements Specification Template PPL - Đặc tả yêu cầu phần mềm cho Trang 5 - Hãy liệt kê các yêu cầu chức năng cụ thể liên quan đến tính năng này Đây là những khả năng của phần mềm phải được triển khai để người dùng thực hiện các dịch vụ của tính năng hoặc thực hiện một trường hợp sử dụng - Mô tả cách sản phẩm phản ứng với các điều kiện lỗi dự kiến - Sử dụng “TBD” ở những chỗ mà thông tin cần thiết vẫn chưa có sẵn > 3.2 Tính năng hệ thống 2 (và v.v.) 4 Yêu cầu dữ liệu 4.1 Mô hình dữ liệu logic < - Mô hình dữ liệu là sự thể hiện trực quan của các đối tượng và bộ sưu tập dữ liệu mà hệ thống sẽ xử lý cũng như mối quan hệ giữa chúng - Bao gồm mô hình dữ liệu cho các hoạt động nghiệp vụ đang được hệ thống xử lý hoặc biểu diễn logic cho dữ liệu mà chính hệ thống sẽ thao tác - Các mô hình dữ liệu thường được tạo dưới dạng sơ đồ thực thể - quan hệ > 4.2 Từ điển dữ liệu < - Từ điển dữ liệu xác định thành phần cấu trúc dữ liệu và ý nghĩa, kiểu dữ liệu, độ dài, định dạng và các giá trị được phép đối với các thành phần dữ liệu tạo nên các cấu trúc đó - Trong nhiều trường hợp, tốt hơn hết bạn nên lưu trữ từ điển dữ liệu dưới dạng một tạo phẩm riêng biệt thay vì nhúng nó vào SRS Điều đó cũng làm tăng khả năng tái sử dụng của nó trong các dự án khác > Karl Wiegers, Software Requirements Specification Template PPL - Đặc tả yêu cầu phần mềm cho Trang 6 4.3 Báo cáo 4.4 Thu thập, toàn vẹn, lưu giữ và xử lý dữ liệu 5 Yêu cầu giao diện bên ngoài 5.1 Giao diện người dùng < - Mô tả đặc điểm logic của từng giao diện giữa sản phẩm phần mềm và người dùng Điều này có thể bao gồm hình ảnh màn hình mẫu, bất kỳ tiêu chuẩn GUI hoặc hướng dẫn kiểu dòng sản phẩm nào phải tuân theo, các ràng buộc về bố cục màn hình, các nút và chức năng tiêu chuẩn (ví dụ: trợ giúp) sẽ xuất hiện trên mọi màn hình, phím tắt, tiêu chuẩn hiển thị thông báo lỗi và sớm - Xác định các thành phần phần mềm cần có giao diện người dùng - Chi tiết về thiết kế giao diện người dùng phải được ghi lại trong một đặc tả giao diện người dùng riêng > 5.2 Giao diện phần mềm < Karl Wiegers, Software Requirements Specification Template PPL - Đặc tả yêu cầu phần mềm cho Trang 7 - Mô tả các kết nối giữa sản phẩm này và các thành phần phần mềm khác (được xác định theo tên và phiên bản), bao gồm các ứng dụng, cơ sở dữ liệu, hệ điều hành, công cụ, thư viện, trang web và các thành phần thương mại tích hợp khác - Nêu rõ mục đích, định dạng và nội dung của các thông điệp, dữ liệu và giá trị điều khiển được trao đổi giữa các thành phần phần mềm Chỉ định ánh xạ dữ liệu đầu vào và đầu ra giữa các hệ thống và bất kỳ bản dịch nào cần được thực hiện để dữ liệu được truyền từ hệ thống này sang hệ thống khác - Mô tả các dịch vụ cần thiết bởi hoặc từ các thành phần phần mềm bên ngoài và bản chất của giao tiếp giữa các thành phần Xác định dữ liệu sẽ được trao đổi giữa hoặc chia sẻ giữa các thành phần phần mềm - Chỉ định các yêu cầu phi chức năng ảnh hưởng đến giao diện, chẳng hạn như mức độ dịch vụ về thời gian và tần suất phản hồi hoặc các biện pháp kiểm soát và hạn chế bảo mật > 5.3 Giao diện phần cứng < - Mô tả đặc điểm từng giao diện giữa các thành phần phần mềm và phần cứng (nếu có) của hệ thống Mô tả này có thể bao gồm các loại thiết bị được hỗ trợ, dữ liệu và tương tác điều khiển giữa phần mềm và phần cứng cũng như các giao thức truyền thông sẽ được sử dụng Liệt kê các đầu vào và đầu ra, định dạng, giá trị hoặc phạm vi hợp lệ của chúng và mọi vấn đề về thời gian mà người phát triển cần lưu ý - Nếu thông tin này rộng, hãy xem xét việc tạo một tài liệu đặc tả giao diện riêng > 5.4 Giao diện truyền thông < - Nêu rõ các yêu cầu đối với mọi chức năng liên lạc mà sản phẩm sẽ sử dụng, bao gồm e-mail, trình duyệt Web, giao thức mạng và biểu mẫu điện tử Xác định bất kỳ định dạng tin nhắn thích hợp - Chỉ định các vấn đề về bảo mật hoặc mã hóa truyền thông, tốc độ truyền dữ liệu, cơ chế bắt tay và đồng bộ hóa - Nêu rõ mọi ràng buộc xung quanh các giao diện này, chẳng hạn như liệu các tệp đính kèm e-mail có được chấp nhận hay không > Karl Wiegers, Software Requirements Specification Template PPL - Đặc tả yêu cầu phần mềm cho Trang 8 6 Thuộc tính chất lượng 6.1 Khả năng sử dụng 6.2 Hiệu suất 6.3 Bảo mật 6.4 Sự an toàn 6.5 [Những thuộc tính chất lượng khác có liên quan] 7 Yêu cầu quốc tế hóa và nội địa hóa 8 Những yêu cầu khác 9 Bảng thuật ngữ 10 Mô hình phân tích Karl Wiegers, Software Requirements Specification Template