Giải pháp thăm quan


HỖ TRỢ
Đăng ký
Đăng nhập
Bắt đầu dùng thử miễn phí

Cách viết tài liệu yêu cầu hệ thống (SRS)

Cách viết tài liệu yêu cầu hệ thống (SRS)

Mục lục

Tài liệu Đặc tả Yêu cầu Phần mềm (SRS) là một tài liệu cần thiết để phát triển phần mềm cung cấp mô tả chi tiết về nhu cầu và yêu cầu của một dự án cụ thể. Nó phác thảo các mục tiêu, phạm vi, thông tin cơ bản, chi tiết thiết kế, kế hoạch thực hiện và các hoạt động liên quan khác. Tài liệu SRS đóng vai trò như một hợp đồng giữa khách hàng và nhà phát triển để đảm bảo rằng cả hai bên đều hiểu các thông số kỹ thuật và kỳ vọng của sản phẩm đang được phát triển. Ngoài ra, nó giúp giảm rủi ro bằng cách đảm bảo rằng tất cả các bên liên quan hiểu đầy đủ những gì được mong đợi từ họ trong từng giai đoạn của dự án. 

Một tài liệu SRS được soạn thảo tốt phải đầy đủ, rõ ràng và ngắn gọn để cả nhà phát triển và khách hàng đều có thể dễ dàng hiểu được. Hơn nữa, việc có sẵn một SRS đảm bảo rằng mọi thay đổi hoặc cập nhật đối với sản phẩm trong quá trình phát triển đều có thể được ghi lại và theo dõi dễ dàng. Điều này giúp giảm thiểu sự nhầm lẫn và đảm bảo rằng sản phẩm cuối cùng đáp ứng tất cả các yêu cầu được chỉ định trong tài liệu. Nhìn chung, SRS là một công cụ quan trọng cho các dự án phát triển phần mềm thành công vì nó cung cấp một khuôn khổ rõ ràng cho sự thành công. Với việc sử dụng đúng cách, nó có thể giúp các nhóm đạt được kết quả chất lượng với nỗ lực tối thiểu.

Đặc tả yêu cầu phần mềm Vs Đặc tả yêu cầu kinh doanh

Đôi khi người ta trộn lẫn các khái niệm về phần mềm và các đặc tả yêu cầu nghiệp vụ. Trên thực tế, cả hai đều khá khác nhau.

Sự khác biệt chính giữa đặc tả yêu cầu phần mềm và đặc tả yêu cầu kinh doanh là cái trước nắm bắt tất cả thông tin liên quan đến phần mềm trong khi cái sau nắm bắt tất cả thông tin liên quan đến doanh nghiệp.

Không.
Đặc điểm kỹ thuật yêu cầu phần mềm (SRS)
Đặc điểm kỹ thuật yêu cầu kinh doanh (BRS)
1.
Nó chỉ định các yêu cầu chức năng và phi chức năng có trong phần mềm.
Đây là một tài liệu chính thức mô tả các yêu cầu khác nhau do khách hàng / các bên liên quan cung cấp.
2.
Nó có nguồn gốc từ Đặc tả yêu cầu kinh doanh (BRS).
Nó bắt nguồn từ các yêu cầu và tương tác của khách hàng.
3.
Nó được tạo ra bởi một nhà phân tích hệ thống hoặc một kiến ​​trúc sư hệ thống hoặc một nhà phân tích kinh doanh.
Nó được tạo ra bởi một nhà phân tích kinh doanh.
4.
Nó mô tả cả các đặc tính kỹ thuật và chức năng của phần mềm cũng ở mức cao.
Nó mô tả các thông số kỹ thuật chức năng của phần mềm ở mức rất cao.
5.
Nó giải quyết các nguồn lực mà công ty cung cấp.
Nó giải quyết các yêu cầu kinh doanh.
6.
Nó mô tả cách thức hoạt động của doanh nghiệp khi sử dụng phần mềm hoặc ứng dụng.
Nó xác định nhu cầu của khách hàng. Tài liệu được sử dụng từ đầu đến cuối dự án.
7.
Bảng và trường hợp sử dụng được bao gồm.
Bảng và trường hợp sử dụng không được bao gồm.

Các thành phần thiết yếu của một SRS

Các phần chính của đặc tả yêu cầu phần mềm là:

  • Người điều hành kinh doanh - Các lý do tại sao khách hàng đang tìm cách xây dựng hệ thống được mô tả trong phần này. Phần này bao gồm thêm những vấn đề mà khách hàng đang gặp phải với hệ thống hiện tại và những cơ hội mà hệ thống mới sẽ mang lại.
  • MÔ HÌNH KINH DOANH - Mô hình kinh doanh mà hệ thống được hỗ trợ sẽ được thảo luận trong phần này. Nó còn bao gồm nhiều chi tiết khác như bối cảnh tổ chức và kinh doanh, các chức năng kinh doanh chính và sơ đồ quy trình của hệ thống.
  • Yêu cầu về chức năng và hệ thống - Phần này thường nêu chi tiết các yêu cầu được tổ chức theo cấu trúc phân cấp. Các yêu cầu chức năng ở cấp cao nhất và các yêu cầu hệ thống chi tiết được liệt kê dưới dạng các mục con.
  • Các trường hợp sử dụng hệ thống - Phần này bao gồm sơ đồ trường hợp sử dụng Ngôn ngữ mô hình thống nhất (UML) giải thích tất cả các thực thể bên ngoài quan trọng sẽ tương tác với hệ thống và các trường hợp sử dụng khác nhau mà chúng sẽ phải thực hiện.
  • Yêu cầu kỹ thuật - Phần này thảo luận về tất cả các yêu cầu phi chức năng tạo nên môi trường kỹ thuật và các giới hạn kỹ thuật mà phần mềm sẽ hoạt động.  
  • Chất lượng hệ thống - Trong phần này, nhiều phẩm chất của hệ thống được xác định như độ tin cậy, khả năng phục vụ, bảo mật, khả năng mở rộng, tính sẵn sàng và khả năng bảo trì.
  • Hạn chế và giả định - Tất cả các hạn chế đặt ra đối với thiết kế hệ thống theo quan điểm của khách hàng được mô tả trong phần này. Các giả định khác nhau của nhóm kỹ sư về những gì sẽ xảy ra trong quá trình phát triển cũng được thảo luận ở đây.
  • Tiêu chí chấp nhận - Chi tiết về tất cả các điều kiện phải đáp ứng trước khi hệ thống được bàn giao cho khách hàng cuối cùng sẽ được thảo luận trong phần này.

Cấu trúc của một SRS

1. Giới thiệu -

Phần giới thiệu giải thích ý nghĩa SRS nói chung, phạm vi của nó đối với nhóm của bạn và cấu trúc của nó.

1.1. Mục đích

Ở đây, giải thích mục tiêu và cấu trúc của tài liệu phần mềm SRS: các loại yêu cầu sẽ được giải quyết, cũng như nhân sự sẽ sử dụng nó.

Giữ cho phần này ngắn gọn: 1-2 đoạn văn là đủ.

1.2. Đối tượng dự định

Bạn có thể đi sâu và giải thích cách các bên và nhóm liên quan sẽ làm việc với SRS, cũng như tham gia vào quá trình phát triển SRS. Họ thường là chủ sở hữu sản phẩm, nhà đầu tư, nhà phân tích kinh doanh, nhà phát triển, đôi khi là người kiểm tra và nhân viên vận hành. Toàn bộ cấu trúc được xác định bởi cách tiếp cận phát triển phần mềm của bạn và thiết lập tổ chức của nhóm.

1.3. Mục đích sử dụng

Mô tả các tình huống mà nhóm của bạn sẽ sử dụng SRS. Thông thường, nó được sử dụng trong các trường hợp sau:

  • thiết kế và động não các tính năng mới
  • lập kế hoạch thời gian dự án, nước rút, ước tính chi phí
  • đánh giá rủi ro
  • giám sát và đo lường thành công của nhóm
  • các tình huống xung đột khi các bên liên quan có tầm nhìn khác nhau về một sản phẩm được thực hiện tốt.

KHAI THÁC. Phạm vi

Phần này bao gồm phạm vi của sản phẩm, vì vậy bạn sẽ cần phải trình bày tổng quan nhanh về hệ thống - mục đích chính, chức năng và vị trí của nó. Nó có thể so sánh với cách bạn giải thích một sản phẩm tại cuộc họp các bên liên quan ngoại trừ việc nó được phép nghiên cứu sâu hơn về các chi tiết kỹ thuật.

Phần này phải mô tả:

  • Tất cả các loại người dùng dự kiến ​​​​sẽ tương tác với hệ thống
  • Tất cả các phần thiết yếu của kiến ​​trúc

1.5 Định nghĩa và từ viết tắt

Trong suốt tài liệu của bạn, nhóm thường xuyên sử dụng một số từ nhất định. Loại bỏ mọi hiểu lầm tiềm ẩn, cho phép các nhà phát triển mới tham gia và giải quyết các tình huống xung đột sẽ dễ dàng hơn nếu bạn hiểu rõ nghĩa của những từ này.

Các thành phần nêu trên tạo thành một định nghĩa. Các định nghĩa cung cấp thông tin về chức năng, công nghệ cơ bản, cá nhân mục tiêu, thực thể kinh doanh (người dùng, khách hàng, người trung gian) và các bên liên quan. Bạn có thể sử dụng một từ viết tắt để viết SRS của mình nhanh hơn nếu bạn chọn làm như vậy. Tài liệu sẽ có thể đọc được miễn là có bao gồm bảng định nghĩa.

2. Mô tả chung

Trong phần thứ hai, bạn mô tả các tính năng chính của sản phẩm, người dùng mục tiêu và phạm vi hệ thống cho người đọc. Mô tả này chỉ tập trung vào các tính năng chính và kiến ​​trúc phần mềm mà không đi sâu vào chi tiết cụ thể về các tiện ích bổ sung và kết nối.

2.1 Nhu cầu của Người dùng

Phần này là một vấn đề lựa chọn, vì vậy một số tổ chức chọn không đưa nó vào tài liệu kỹ thuật SRS của họ. Chúng tôi tin rằng tốt hơn hết bạn nên liệt kê các vấn đề bạn muốn giải quyết với chức năng của mình ngay bây giờ. Nó sẽ hữu ích sau này trong khi các chức năng động não và giám sát. Bạn có thể quay lại phần này bất kỳ lúc nào trong quá trình phát triển sản phẩm và xem liệu nhóm trải nghiệm người dùng có đi lạc khỏi con đường đã định hay không.

Nhu cầu đề cập đến các vấn đề mà người dùng sẽ có thể giải quyết với hệ thống. Bạn có thể chia những nhu cầu này thành các danh mục phụ nếu bạn đối phó với đối tượng được phân khúc cao. Cố gắng không đi vào chi tiết về nhu cầu của từng người dùng. Bạn cần để lại một khoảng trống để giải thích, đề phòng trường hợp một vấn đề trở nên quan trọng hơn bạn nghĩ ban đầu.

2.2 Giả định và Phụ thuộc

Giả định là những giả định của nhóm về sản phẩm và khả năng của sản phẩm sẽ đúng trong 99% tình huống. Chẳng hạn, thật tự nhiên khi giả định rằng một nền tảng hỗ trợ người lái xe điều hướng vào ban đêm sẽ được sử dụng chủ yếu ở chế độ ban đêm.

Ý nghĩa của các giả định là gì? Chúng cho phép bạn tập trung vào các tính năng quan trọng nhất của ứng dụng trước tiên. Giả định này giúp hiểu rằng các nhà thiết kế phải phát triển một giao diện phù hợp với tầm nhìn trong bóng tối cho một trợ lý lái xe ban đêm. Một số người dùng chắc chắn có thể mở ứng dụng trong ngày, nhưng đó là một khoảng thời gian dài, vì vậy bạn không cần phải đưa các yếu tố liên quan vào nguyên mẫu ngay lập tức.

3. Các tính năng và yêu cầu của hệ thống

Phần này trình bày chi tiết các tính năng của sản phẩm và tiêu chí thực thi. Vì hai phần trước đề cập đến toàn bộ sản phẩm, bạn sẽ tìm thấy mô tả toàn diện hơn ở đây.

3.1 Yêu cầu chức năng

được nêu trong một danh sách các chức năng sẽ được thực hiện trong một hệ thống. Những tiêu chí này liên quan đến “cái gì sẽ được tạo ra?” hơn là “làm thế nào” và “khi nào”.

Các yêu cầu chức năng bắt đầu bằng cách mô tả chức năng được yêu cầu dựa trên mức độ cần thiết của nó đối với ứng dụng. Nếu bạn muốn làm việc trên nó trước tiên, bạn có thể bắt đầu với thiết kế, nhưng sau đó bạn nên bắt đầu phát triển. Các yêu cầu chức năng không đi sâu vào chi tiết về các ngăn xếp công nghệ vì chúng có thể thay đổi khi dự án tiến triển. Thay vì tập trung vào logic bên trong, các yêu cầu chức năng tập trung vào chức năng của người dùng cuối.

3.2 Yêu cầu giao diện bên ngoài

Yêu cầu chức năng là một phần quan trọng của đặc tả yêu cầu hệ thống. Để bao gồm tất cả các tính năng cần thiết của hệ thống, bạn sẽ cần 4-5 trang thông tin. Một số nhóm chia nhỏ chúng theo chủ đề để làm cho tài liệu dễ đọc hơn.

Thông thường, các thành phần thiết kế SRS được coi là tách biệt với phần phụ trợ và logic nghiệp vụ. Điều này có ý nghĩa vì các nhà thiết kế thay vì các nhà phát triển xử lý phần lớn lĩnh vực này, mà còn bởi vì nó là nơi bắt đầu quá trình phát triển sản phẩm.

Tùy thuộc vào dự án, các yêu cầu về giao diện bên ngoài có thể bao gồm bốn loại:

  • Giao diện người dùng
  • Giao diện phần mềm
  • Giao diện phần cứng
  • Giao diện truyền thông

Các yêu cầu về giao diện bên ngoài mô tả các phần tử trang sẽ hiển thị cho khách hàng cuối. Chúng có thể bao gồm danh sách các trang, yếu tố thiết kế, chủ đề phong cách chính, thậm chí cả yếu tố nghệ thuật, v.v. nếu chúng cần thiết cho sản phẩm.

3.3 Yêu cầu hệ thống

Yêu cầu hệ thống của sản phẩm nêu rõ các điều kiện mà sản phẩm có thể được sử dụng. Chúng thường liên quan đến các thông số kỹ thuật và tính năng phần cứng. Yêu cầu phần cứng SRS thường được xác định theo phạm vi tối thiểu và tối đa, cũng như ngưỡng hiệu suất sản phẩm tối ưu.

Việc tạo ra các yêu cầu hệ thống trước khi bắt đầu tạo ra một sản phẩm có vẻ khó khăn, nhưng nó là điều cần thiết. Các nhà phát triển phải tuân thủ các yêu cầu phần cứng để họ không phải khởi động lại dự án sau này. Các ứng dụng dành cho thiết bị di động (có nhiều biến số cần xem xét) và các ứng dụng cần khả năng phản hồi cao (trò chơi, bất kỳ sản phẩm nào có VR / AR hoặc IoT) đặc biệt dễ bị tấn công.

3.4 Yêu cầu phi chức năng 

Đối với nhiều tổ chức, phần này của SRS là phần khó nhất. Nếu các yêu cầu chức năng giải quyết câu hỏi tạo ra cái gì, thì các tiêu chuẩn phi chức năng xác định cách thức. Họ thiết lập các tiêu chí theo mức độ hiệu quả của hệ thống phải hoạt động. Tất cả các ngưỡng về hiệu suất, bảo mật và khả năng sử dụng đều được bao gồm trong lĩnh vực này.

Giá trị thực là điều khiến khó xác định các yêu cầu phi chức năng. Khó xác định các cụm từ như “đồng thời” hoặc “tính di động” vì chúng có thể có nhiều cách hiểu khác nhau cho tất cả các bên liên quan. Do đó, chúng tôi chủ trương cho điểm mỗi yêu cầu phi chức năng. Bạn có thể truy cập lại các yêu cầu dự án của mình bất kỳ lúc nào để xem liệu hệ thống hiện tại có đáp ứng các kỳ vọng ban đầu hay không.

Những lỗi nào nên tránh khi xây dựng đặc tả yêu cầu hệ thống?

Khi kỹ năng phát triển SRS của bạn tăng lên, quy trình sẽ trở nên nhanh chóng. Tuy nhiên, khi bạn mới bắt đầu, bạn nên có sẵn một danh sách các sai lầm ngớ ngẩn điển hình để tham khảo. Cuối cùng, hãy nghiền ngẫm những điều này:  

  • Bỏ qua việc kết hợp một thuật ngữ toàn diện: SRS của bạn có chứa biệt ngữ mà chỉ những người trong ngành mới quen thuộc không? Nếu vậy, hãy tạo một phần từ điển dễ hiểu và bao gồm các định nghĩa của bất kỳ từ hoặc cách diễn đạt nào không được biết đến rộng rãi. Điều này sẽ giúp đảm bảo tất cả người dùng có thể hiểu cả mục đích và thuật ngữ của tài liệu.
  • Tạo ra sự xáo trộn bằng cách kết hợp các ý tưởng: Cấu trúc tài liệu của bạn một cách có trật tự và đảm bảo cung cấp thông tin cho người đọc theo một tiến trình hợp lý. Để tránh mọi hiểu lầm hoặc nhầm lẫn, đừng lẫn lộn các khái niệm với nhau trong toàn bộ văn bản.
  • Không biết nhu cầu và mong muốn của đối tượng mục tiêu: Để hiểu được đầu ra dự kiến ​​từ phần mềm, điều quan trọng là phải phân biệt ai sẽ sử dụng nó cũng như kết quả mong đợi. Chẳng hạn, giả sử một ứng dụng được tạo để tạo báo cáo. Một số yêu cầu của nó phải liên quan đến cách người dùng có thể nhấn các nút nhất định để lấy các tài liệu khác nhau. Để thực sự hiểu chương trình báo cáo này yêu cầu những gì và cũng nhận ra ai sẽ sử dụng nó, bạn nên có cái nhìn sâu sắc về cả người dùng và kỳ vọng của họ về chức năng.  
  • Mơ hồ: Hãy chắc chắn rằng nhu cầu của bạn là rõ ràng. SRS được xây dựng để tránh hiểu lầm và do đó, điều quan trọng là phải đảm bảo tài liệu không gây nhầm lẫn. Đối với mỗi mô tả tính năng hoặc điều kiện, đảm bảo bạn không bao gồm các chức năng chưa được chỉ định.

Các phương pháp hay nhất để viết tài liệu SRS

Viết tài liệu Đặc tả yêu cầu hệ thống (SRS) là một khía cạnh quan trọng của quá trình phát triển phần mềm và việc tuân thủ các phương pháp hay nhất có thể nâng cao đáng kể chất lượng và hiệu quả của tài liệu. Dưới đây là một số phương pháp hay nhất để viết tài liệu SRS:

  • Sử dụng ngôn ngữ rõ ràng và ngắn gọn:
    • Tránh các thuật ngữ kỹ thuật và từ viết tắt có thể không được hiểu phổ biến. Sử dụng ngôn ngữ rõ ràng và dễ hiểu, đảm bảo rằng tất cả các bên liên quan có thể dễ dàng hiểu được nội dung.
  • Bao gồm hỗ trợ trực quan:
    • Nâng cao sự hiểu biết bằng cách kết hợp các sơ đồ, sơ đồ và mô hình mô phỏng cùng với các mô tả bằng văn bản về các yêu cầu. Các phương tiện trực quan có thể cung cấp sự trình bày trực quan hơn về các khái niệm phức tạp và hành vi của hệ thống.
  • Yêu cầu ưu tiên:
    • Xác định rõ ràng mức độ ưu tiên của từng yêu cầu. Sử dụng các nhãn như “phải có”, “nên có” và “có thì tốt” để chỉ ra tầm quan trọng tương đối của các tính năng khác nhau. Ưu tiên giúp nhóm phát triển tập trung vào chức năng quan trọng trước tiên.
  • Giữ nó được cập nhật:
    • Duy trì kiểm soát phiên bản cho tài liệu SRS. Thường xuyên cập nhật tài liệu để phản ánh mọi thay đổi về yêu cầu, phạm vi dự án hoặc phản hồi của các bên liên quan. Giữ nhật ký thay đổi rõ ràng để theo dõi các sửa đổi theo thời gian.
  • Thu hút các bên liên quan:
    • Phối hợp chặt chẽ với tất cả các bên liên quan trong suốt quá trình phát triển SRS. Tham gia vào các cuộc thảo luận, thu thập phản hồi và đảm bảo rằng nhu cầu và mong đợi của họ được ghi lại chính xác trong tài liệu. Sự tham gia này thúc đẩy sự hiểu biết chung về các mục tiêu của dự án.
  • Hãy toàn diện:
    • Không chừa chỗ cho sự giải thích hoặc giả định. Cung cấp mô tả chi tiết và toàn diện về từng yêu cầu, bao gồm các khía cạnh chức năng và phi chức năng. Sự mơ hồ trong các yêu cầu có thể dẫn đến hiểu lầm và làm chậm trễ dự án.
  • Sử dụng định dạng có cấu trúc:
    • Sắp xếp tài liệu SRS thành các phần được xác định rõ ràng, chẳng hạn như Giới thiệu, Yêu cầu của các bên liên quan, Kiến trúc hệ thống, Yêu cầu chức năng, Yêu cầu phi chức năng, Ràng buộc, Giả định, Phụ thuộc và Ma trận truy xuất nguồn gốc. Định dạng có cấu trúc giúp người đọc dễ dàng tìm thấy thông tin cụ thể hơn.
  • Đảm bảo khả năng kiểm thử:
    • Viết các yêu cầu theo cách tạo điều kiện thuận lợi cho việc kiểm tra và xác nhận. Mỗi yêu cầu phải có thể kiểm chứng được, cho phép người thử nghiệm tạo các trường hợp thử nghiệm để xác thực xem hệ thống có đáp ứng các tiêu chí đã chỉ định hay không. Tiêu chí chấp nhận rõ ràng cho từng yêu cầu là rất cần thiết.
  • Tránh sự mơ hồ:
    • Hãy thận trọng trong việc loại bỏ sự mơ hồ trong các yêu cầu. Sử dụng ngôn ngữ chính xác, tránh các thuật ngữ mơ hồ và đảm bảo rằng không có chỗ cho nhiều cách giải thích về một yêu cầu. Sự mơ hồ có thể dẫn đến hiểu lầm và phải làm lại dự án.
  • Xem xét khả năng mở rộng trong tương lai:
    • Hãy suy nghĩ về khả năng mở rộng lâu dài của hệ thống phần mềm. Dự đoán các nhu cầu tiềm năng trong tương lai và đảm bảo rằng tài liệu SRS phù hợp với chúng. Cách tiếp cận chủ động này có thể tiết kiệm thời gian và nguồn lực trong tương lai.
  • Xem xét và xác nhận:
    • Tiến hành đánh giá kỹ lưỡng tài liệu SRS với các bên liên quan, bao gồm khách hàng, nhóm phát triển và các chuyên gia về chủ đề. Giải quyết mọi khác biệt, mâu thuẫn hoặc mơ hồ phát sinh trong quá trình xem xét. Việc xác nhận đảm bảo rằng tài liệu thể hiện chính xác các mục tiêu của dự án.
  • Có được sự chấp thuận chính thức:
    • Sau khi hoàn thiện tài liệu SRS, hãy nhận được sự chấp thuận và phê duyệt chính thức từ khách hàng hoặc nhà tài trợ dự án. Điều này chính thức hóa thỏa thuận về phạm vi và yêu cầu của dự án, cung cấp cơ sở rõ ràng cho sự phát triển.

Việc kết hợp những phương pháp hay nhất này vào quá trình viết tài liệu SRS có thể góp phần vào sự thành công của các dự án phát triển phần mềm. Tài liệu SRS được soạn thảo kỹ lưỡng đóng vai trò là hướng dẫn đáng tin cậy cho cả nhóm phát triển và các bên liên quan, giúp đảm bảo rằng hệ thống phần mềm cuối cùng phù hợp với mong đợi và yêu cầu.

Kết luận

Viết tài liệu Đặc tả yêu cầu hệ thống (SRS) hiệu quả là một bước quan trọng trong quy trình phát triển phần mềm. Nó đóng vai trò là nền tảng để lập kế hoạch, phát triển, thử nghiệm và xác nhận dự án thành công. Bằng cách làm theo các bước được nêu trong bài viết này và tuân thủ các phương pháp hay nhất, bạn có thể tạo tài liệu SRS đóng vai trò là hướng dẫn đáng tin cậy để xây dựng hệ thống phần mềm đáp ứng nhu cầu và mong đợi của các bên liên quan.

Đừng quên chia sẻ bài viết này!

Áo sơ mi