
Tài liệu yêu cầu ứng dụng, hay bản đặc tả ứng dụng, là một kế hoạch ngắn bằng văn bản được lập trước khi bất kỳ ai xây dựng ứng dụng. Tài liệu này nêu rõ ai sẽ sử dụng ứng dụng, mỗi người sẽ thấy những màn hình nào, ứng dụng lưu giữ thông tin gì, kết nối với những dịch vụ nào, những gì tạm thời chưa được đưa vào và chi phí xây dựng tối đa. Bạn đọc, đặt câu hỏi và chỉnh sửa bản đặc tả; chỉ phê duyệt khi tài liệu mô tả đúng ứng dụng mà bạn thực sự muốn.
Bạn cần phê duyệt trước vì bản đặc tả là nơi ít tốn kém nhất để phát hiện sai sót. Thay đổi một dòng trên trang không tốn gì. Nếu chỉ sau khi xây dựng mới phát hiện giáo viên dạy kèm có thể xem số điện thoại của mọi phụ huynh, hoặc các khoản phí không thể được trả góp, ứng dụng sẽ phải xây dựng lại.
Nói đơn giản, bản đặc tả phần mềm là gì?
Trong phần mềm, bản đặc tả — ở các dự án lớn thường được gọi là tài liệu yêu cầu hoặc SRS, viết tắt của đặc tả yêu cầu phần mềm — là thỏa thuận giữa người cần ứng dụng và đơn vị xây dựng ứng dụng. Tài liệu nêu ứng dụng phải làm gì, không phải mã nguồn thực hiện điều đó như thế nào. Với một cửa hàng, câu lạc bộ hoặc trường học, một trang thường là đủ, miễn là nội dung cụ thể và được viết bằng ngôn ngữ dễ hiểu.
Cách kiểm tra một bản đặc tả rất đơn giản: hai bên phát triển khác nhau có thể đọc và tạo ra những ứng dụng gần giống nhau không? Nếu tài liệu chỉ ghi học viên có thể xem kết quả, đó mới là mong muốn. Nếu ghi học viên đăng nhập bằng số điện thoại và xem điểm các bài kiểm tra của mình theo từng môn, bên cạnh điểm trung bình của lớp, đó là một yêu cầu có thể xây dựng và kiểm tra được.
Một tài liệu yêu cầu ứng dụng dài một trang gồm những gì?
Hãy lấy ví dụ một trung tâm gia sư muốn có ứng dụng quản lý lớp học, điểm danh và học phí. Một bản đặc tả một trang hữu ích sẽ gồm các phần sau:
| Phần trong bản đặc tả | Nội dung nêu gì | Ví dụ cho trung tâm gia sư |
|---|---|---|
| Ai sử dụng ứng dụng | Từng nhóm người đăng nhập và những việc họ được phép làm | Chủ trung tâm, gia sư, học viên và phụ huynh; chỉ chủ trung tâm được xem tổng học phí |
| Màn hình theo vai trò | Các trang mà từng vai trò nhìn thấy và những việc họ làm trên đó | Gia sư: xem các lớp hôm nay, điểm danh, nhập điểm kiểm tra. Phụ huynh: xem tình hình chuyên cần, điểm số và học phí còn phải đóng |
| Dữ liệu được lưu | Các bản ghi mà ứng dụng lưu và thông tin có trong từng bản ghi | Học viên, lớp học, điểm danh theo từng buổi, bài kiểm tra và điểm số, các đợt đóng học phí và biên lai |
| Tích hợp | Các dịch vụ bên ngoài mà ứng dụng kết nối và cách kết nối | Thanh toán học phí trực tuyến qua cổng thanh toán, có biên lai cho từng đợt đóng |
| Tạm thời chưa làm | Những việc phiên bản này sẽ không làm | Không kiểm tra trùng lịch; không nhập dữ liệu từ hồ sơ năm trước |
| Mức chi phí tối đa | Chi phí cao nhất của bản dựng | Mức tối đa được hiển thị trước khi phê duyệt, không phải khoản ước tính sau khi hoàn thành công việc |
Màn hình theo vai trò là phần mọi người thường đọc lướt nhưng lại quan trọng nhất. Một ứng dụng thực chất là nhiều ứng dụng dùng chung một bộ dữ liệu: giao diện của chủ trung tâm, gia sư và phụ huynh. Đọc từng màn hình theo vai trò sẽ giúp bạn nhận ra rằng gia sư có thể điểm danh nhưng không ai có thể sửa khi điểm danh nhầm.
Dòng tạm thời chưa có cũng quan trọng không kém. Dòng này cho bạn biết mình sẽ không nhận được những gì, vốn là nguyên nhân thường gây thất vọng sau khi xây dựng. Một danh sách ngắn gọn, trung thực về các nội dung bị loại trừ là dấu hiệu của bản đặc tả tốt, không phải bản đặc tả yếu.
Khi bạn mô tả ứng dụng cho Deployflix, bản đặc tả được viết theo cấu trúc này: ai sử dụng ứng dụng, các màn hình, dữ liệu được lưu, những gì tạm thời chưa có và chi phí xây dựng tối đa, bằng chính ngôn ngữ bạn dùng để mô tả. Nếu có điểm nào chưa rõ, Deployflix sẽ hỏi trước khi lập kế hoạch. Trang Cách hoạt động cho biết bản đặc tả nằm ở đâu trong quy trình.
Bạn nên đọc và chất vấn bản đặc tả ứng dụng như thế nào?
Đừng đọc bản đặc tả như đọc hợp đồng từ đầu đến cuối. Hãy đọc nó như một ngày làm việc tại doanh nghiệp của bạn.
- Đi qua một ngày thực tế với từng vai trò. Họ nhấn vào đâu, nhìn thấy gì và nhập những gì? Sau đó làm tương tự với mọi vai trò còn lại.
- Theo dõi một bản ghi từ đầu đến cuối. Chọn một học viên, đơn hàng hoặc lượt đặt chỗ. Ai tạo, ai thay đổi, ai có thể xóa và cuối cùng bản ghi được lưu ở đâu?
- Tìm các tình huống không suôn sẻ. Một lượt đặt chỗ bị hủy, một khoản hoàn tiền, một mục nhập sai, một khoản thanh toán thất bại hoặc một thành viên rời đi. Nếu bản đặc tả chỉ mô tả những trường hợp thuận lợi, hãy hỏi điều gì sẽ xảy ra khi có sự cố.
- Kiểm tra mọi con số và câu chữ bạn sẽ in ra. Định dạng hóa đơn, các đợt đóng học phí, dòng thuế và số biên lai phải phù hợp với cách bạn đang làm hiện nay. Nếu hóa đơn phải thể hiện một loại thuế như GST, VAT hoặc thuế bán hàng, hãy xác nhận chi tiết với kế toán của bạn.
- Hỏi về mọi điểm còn mơ hồ. Những từ như quản lý, theo dõi, dễ dàng và báo cáo có thể che giấu những quyết định chưa được đưa ra. Hãy hỏi: báo cáo nào, hiển thị thông tin gì và dành cho ai?
Bạn nên tìm những thiếu sót nào trước khi phê duyệt?
Phần lớn bản đặc tả gặp vấn đề không phải vì sai mà vì chưa đầy đủ. Sau đây là những thiếu sót thường gặp nhất.
Ai có thể xem những gì
Vai trò rất dễ đặt tên nhưng cũng dễ được mô tả mơ hồ. Hãy kiểm tra từng vai trò có thể xem gì, không chỉ những việc họ có thể làm. Gia sư có thể xem học phí không? Một phụ huynh có thể xem điểm của con người khác không? Nhân viên có thể tải danh sách khách hàng xuống không? Nếu ứng dụng lưu thông tin cá nhân, hãy quyết định ngay ai được phép xem.
Chỉnh sửa, hủy và hoàn tác
Sớm muộn gì mọi bản ghi cũng cần được sửa. Hãy kiểm tra xem bản đặc tả có nêu rõ ai được chỉnh sửa hoặc hủy một mục nhập và giá trị cũ có được giữ lại hay không.
Tiền bạc
Nếu ứng dụng nhận thanh toán, bản đặc tả cần thể hiện các bước thanh toán: khách có thể trả bằng những phương thức nào (thẻ và các phương thức thanh toán địa phương), thanh toán cho khoản gì, có được trả một phần không, khách nhận được gì sau đó và cách xử lý khi chưa thanh toán hoặc thanh toán thất bại. Quy định hoàn tiền do doanh nghiệp quyết định, vì vậy hãy ghi rõ quy định của bạn. Các cổng thường thu phí theo tỷ lệ phần trăm mỗi giao dịch và cộng thêm phí cố định tại nhiều quốc gia, vì vậy hãy xem trang bảng giá của cổng bạn dùng. Ứng dụng Deployflix nhận thanh toán qua cổng như Razorpay hoặc Cashfree; các cổng quốc tế sẽ sớm được hỗ trợ. Trang tích hợp của chúng tôi cho biết những dịch vụ hiện có thể kết nối.
Tin nhắn và lời nhắc
Nếu bạn cần gửi lời nhắc, hãy nêu rõ cách gửi đến mọi người: qua email, bên trong ứng dụng hoặc bằng cách khác. Nếu bản đặc tả không đề cập đến một kênh nào đó, hãy coi như kênh ấy không có.
Dữ liệu hiện có của bạn
Dữ liệu trong bảng tính và sổ sách cũ thường cần được chuyển sang ứng dụng mới. Hãy hỏi xem việc nhập dữ liệu này có nằm trong bản đặc tả hay thuộc danh sách tạm thời chưa có.
Thiết bị và ngôn ngữ
Mọi người sẽ dùng ứng dụng trên điện thoại, máy tính tại quầy hay cả hai? Ngoài tiếng Anh, ứng dụng có cần hỗ trợ tiếng Tây Ban Nha, tiếng Ả Rập, tiếng Pháp hoặc ngôn ngữ khác không? Những yếu tố này ảnh hưởng đến thiết kế màn hình, vì vậy hãy quyết định trước khi xây dựng. Deployflix viết nội dung trong ứng dụng bằng ngôn ngữ bạn yêu cầu và bản thân Deployflix hỗ trợ 41 ngôn ngữ.
Tại sao phải phê duyệt bản đặc tả trước khi xây dựng?
Vì sửa một câu ít tốn kém hơn sửa một ứng dụng. Trước khi xây dựng, thêm vai trò phụ huynh hoặc một đợt đóng học phí chỉ là chỉnh sửa trên một trang. Sau khi xây dựng, thay đổi tương tự có thể ảnh hưởng đến các màn hình, dữ liệu và quyền đã hoàn thiện.
Việc phê duyệt còn cho bạn một căn cứ để kiểm tra ứng dụng đã hoàn thành. Khi bản dựng xong, hãy mở bản đặc tả và kiểm tra lần lượt: từng vai trò, từng màn hình và từng loại dữ liệu. Nếu có nội dung nào bị thiếu, bạn hoàn toàn có lý do để yêu cầu bổ sung.
Bản đặc tả cũng làm rõ chi phí trước khi bạn cam kết. Khi chi phí xây dựng tối đa được ghi trong bản đặc tả, bạn có con số cụ thể để quyết định. Trên Deployflix, mức trần đó được hiển thị trước khi bạn phê duyệt và bạn chỉ trả cho lượng điểm thực tế đã dùng để xây dựng, như được giải thích trên trang bảng giá.
Các thay đổi được lên kế hoạch như thế nào sau khi xây dựng ứng dụng?
Một ứng dụng hiếm khi thực sự hoàn tất. Một khóa học mới, địa điểm thứ hai hay cách thu học phí mới đều cần được cân nhắc kỹ như bản dựng đầu tiên.
Hãy lập một bản đặc tả nhỏ riêng cho mỗi thay đổi: thay đổi những gì, ảnh hưởng đến vai trò và màn hình nào, dữ liệu nào được thêm hoặc sửa, những gì giữ nguyên và chi phí có thể là bao nhiêu. Đọc bản đặc tả đó với cùng những câu hỏi và phê duyệt trước khi công việc bắt đầu. Hãy giữ phiên bản trước để có thể quay lại phiên bản đang hoạt động tốt nếu thay đổi gặp vấn đề.
Deployflix xử lý thay đổi theo cách này: bạn cho biết cần thay đổi gì, Deployflix lập kế hoạch cho thay đổi đó dưới dạng phiên bản tiếp theo và chỉ bắt đầu xây dựng sau khi được phê duyệt. Mọi phiên bản trước đều được giữ lại. Trong một tổ chức, chỉ những người có vai trò được cấp quyền mới có thể phê duyệt, như mô tả trên trang bảo mật.
Mẫu bản đặc tả ứng dụng bạn có thể dùng
Nếu tự viết bản đặc tả, hãy sao chép các tiêu đề sau và điền vào từng mục bằng những câu đơn giản:
- Ứng dụng trong một câu: ứng dụng dành cho ai và thực hiện công việc gì.
- Vai trò: từng nhóm người dùng và những gì họ được phép xem và làm.
- Màn hình theo vai trò: với từng vai trò, liệt kê các màn hình và những gì diễn ra trên mỗi màn hình.
- Dữ liệu được lưu: từng loại bản ghi và các thông tin có trong đó.
- Tích hợp: thanh toán, tên miền của bạn, các kho ứng dụng, nơi lưu mã nguồn và mọi dịch vụ khác mà ứng dụng kết nối.
- Quy định: phí, giới hạn, thời hạn, việc hủy và hoàn tiền.
- Tạm thời chưa có: những việc phiên bản này sẽ không làm.
- Chi phí tối đa và phê duyệt: mức chi phí cao nhất và người phê duyệt.
Để xem các ví dụ đầy đủ về vai trò, màn hình và dữ liệu, hãy tham khảo hệ thống quản lý lớp học thêmEN hoặc ứng dụng đặt lịch khám tại phòng khámEN. Người sáng lập đang thử nghiệm một ý tưởng có thể viết bản đặc tả ngắn hơn nữa, chỉ với một vai trò, vài màn hình và danh sách rõ ràng những gì tạm thời chưa có, như trong ứng dụng web MVP cho công ty khởi nghiệpEN.
Câu hỏi
Bản đặc tả ứng dụng khác tài liệu yêu cầu ở điểm nào?
Khác biệt chủ yếu nằm ở độ dài và mức độ trang trọng. Tài liệu yêu cầu của một dự án lớn có thể dài nhiều trang với các yêu cầu được đánh số. Bản đặc tả ứng dụng cho doanh nghiệp nhỏ vẫn đề cập đến những nội dung tương tự (ai sử dụng, ứng dụng làm gì và lưu những gì) nhưng chỉ trong một trang, bằng lời lẽ dễ hiểu.
Ai nên viết bản đặc tả ứng dụng?
Người hiểu doanh nghiệp sẽ cung cấp nội dung: các vai trò, công việc hằng ngày và quy định. Một đơn vị phát triển có thể sắp xếp những nội dung đó thành bản đặc tả có cấu trúc, nhưng chỉ bạn mới có thể xác định nó có đúng hay không.
Tôi có thể thay đổi bản đặc tả sau khi phê duyệt không?
Có. Hãy coi đó là một thay đổi: mô tả điểm khác biệt, đọc kế hoạch đã cập nhật rồi phê duyệt lại. Giữ phiên bản trước để bạn có thể so sánh hoặc quay lại.
Bản đặc tả ứng dụng nên dài bao nhiêu?
Đủ dài để không còn điều quan trọng nào phải phỏng đoán, nhưng đủ ngắn để bạn đọc hết. Với hầu hết ứng dụng dành cho doanh nghiệp nhỏ, một trang là phù hợp; nếu dài hơn nhiều, hãy cân nhắc xây dựng theo từng giai đoạn.
Mô tả ứng dụng của bạn
Hãy mô tả nhu cầu bằng lời của bạn. Deployflix sẽ viết một bản đặc tả một trang kèm chi phí và chỉ xây dựng sau khi bạn phê duyệt.
Đã sao chép. Hãy dán nội dung này vào Deployflix sau khi bạn đăng nhập.