Cách viết yêu cầu phần mềm cho hệ thống doanh nghiệp
Chiến lược & triển khai phần mềm
Yêu cầu phần mềm tốt mô tả nhu cầu nghiệp vụ, quy trình theo vai trò, dữ liệu sử dụng và các trường hợp ngoại lệ bằng ngôn ngữ mà cả bộ phận kinh doanh lẫn đội kỹ thuật đều kiểm tra được. Mỗi yêu cầu nên đi kèm tiêu chí nghiệm thu, còn các yêu cầu phi chức năng như hiệu năng, bảo mật và sao lưu cần được ghi rõ.
Yêu cầu phần mềm cần mô tả những gì?
Bắt đầu bằng mục tiêu kinh doanh và phạm vi: hệ thống phục vụ bộ phận nào, giải quyết vấn đề gì và điều gì nằm ngoài phạm vi. Mục tiêu nên viết bằng kết quả mong đợi, ví dụ rút ngắn thời gian duyệt đơn hoặc giảm nhập liệu trùng lặp, kèm cách đo đi kèm.
Tránh mô tả giải pháp kỹ thuật như “dùng bảng X” khi chưa rõ nhu cầu. Yêu cầu nên nói hệ thống phải làm gì, không nói phải làm bằng công nghệ nào, trừ khi có ràng buộc thật sự từ doanh nghiệp.
Quy trình và vai trò nên được mô tả thế nào?
Vẽ quy trình theo từng bước, mỗi bước ghi rõ vai trò thực hiện, đầu vào, đầu ra và hệ thống liên quan. Sơ đồ phân làn theo vai trò giúp thấy các bước bị bỏ quên, đặc biệt là những điểm chuyển giao giữa hai bộ phận.
Định nghĩa vai trò theo chức năng thực tế, không theo chức danh chung chung. Với mỗi vai trò, ghi quyền được xem, tạo, sửa, duyệt và phạm vi dữ liệu được truy cập, ví dụ theo phòng ban hoặc theo chi nhánh.
Dữ liệu nào cần được xác định trong yêu cầu?
Liệt kê từng nhóm dữ liệu: trường thông tin, ý nghĩa, định dạng, bắt buộc hay không, nguồn gốc và người chịu trách nhiệm cập nhật. Nếu cùng một khái niệm được gọi khác nhau giữa các bộ phận, cần thống nhất thuật ngữ trước khi thiết kế.
Xác định vòng đời của dữ liệu: khi nào được tạo, ai được sửa, khi nào bị khóa và có cần lưu lịch sử thay đổi hay không. Với dữ liệu nhạy cảm, ghi rõ quy định về truy cập và thời hạn lưu giữ.
Ngoại lệ và trường hợp đặc biệt được xử lý ra sao?
Phần lớn sự cố sau khi triển khai xuất phát từ các trường hợp không được mô tả: hủy đơn đã duyệt, sửa dữ liệu sau khi đã chốt kỳ, thiếu thông tin, trùng bản ghi hoặc quá thời hạn. Liệt kê các ngoại lệ thường gặp và quyết định xử lý cho từng trường hợp.
Với mỗi ngoại lệ, ghi người được phép xử lý, cách ghi nhận lý do và người cần được thông báo. Nếu chưa có quyết định, đánh dấu là câu hỏi còn mở để theo dõi, thay vì để đội phát triển tự suy đoán.
Yêu cầu tích hợp và tiêu chí nghiệm thu được viết thế nào?
Với mỗi hệ thống cần kết nối, ghi rõ dữ liệu đi theo chiều nào, tần suất đồng bộ, cách xử lý khi lỗi và ai chịu trách nhiệm khi hệ thống kia không phản hồi. Nêu rõ hệ thống nào là nguồn dữ liệu chính khi hai bên mâu thuẫn.
Tiêu chí nghiệm thu nên viết theo dạng kiểm tra được, ví dụ: khi người duyệt phê duyệt một đơn vượt mức quy định, hệ thống phải chuyển đơn sang cấp quản lý và ghi nhật ký. Tránh các câu như “hệ thống phải dễ sử dụng” vì không thể kiểm tra.
Yêu cầu phi chức năng gồm những gì?
Yêu cầu phi chức năng ảnh hưởng đến trải nghiệm và rủi ro vận hành, và thường bị bỏ sót nếu không được viết ra. Mỗi mục cần có cách đo hoặc cách kiểm tra cụ thể.
- Hiệu năng: thời gian phản hồi cho các thao tác chính trong điều kiện số người dùng đã xác định.
- Bảo mật: đăng nhập, phân quyền, mã hóa dữ liệu nhạy cảm và ghi nhật ký truy cập.
- Sao lưu và khôi phục: tần suất sao lưu, thời gian khôi phục mục tiêu và người có quyền thực hiện.
- Khả năng sử dụng: ngôn ngữ giao diện, hỗ trợ tiếng Việt hoặc tiếng Nhật nếu cần, và tài liệu hướng dẫn.
- Khả năng mở rộng: số địa điểm, số người dùng và khối lượng dữ liệu dự kiến trong vài năm tới.
Câu hỏi thường gặp
Bản yêu cầu nên dài bao nhiêu?
Không có độ dài chuẩn. Yêu cầu đủ tốt khi nhóm phát triển và người duyệt có thể đọc, hỏi lại và kiểm tra từng mục mà không phải đoán ý.
Có cần viết yêu cầu trước khi chọn phần mềm đóng gói không?
Nên có. Danh sách yêu cầu giúp đánh giá xem sản phẩm đóng gói có đáp ứng quy trình thực tế hay cần tùy biến, và tránh chọn theo tính năng quảng cáo.
Ai nên tham gia viết yêu cầu?
Người hiểu nghiệp vụ, người quản lý dữ liệu, đại diện đội vận hành và người phụ trách kỹ thuật hoặc đối tác phát triển. Mỗi người kiểm tra phần thuộc phạm vi của mình.
