Khi bước chân vào thế giới Vibe Coding, hầu hết mọi người đều mắc phải một sai lầm chết người giống hệt nhau.
Họ vừa mở phần mềm lập trình lên là đã vội vàng gõ ngay một câu lệnh dài ngoằng: Hãy viết cho tôi một phần mềm quản lý kho hàng có đăng nhập, có quản lý khách hàng và có báo cáo doanh thu. Kết quả là chỉ sau 10 phút, AI bắt đầu tạo ra một đống mã nguồn hỗn độn, tính năng nọ đá vỡ tính năng kia, và màn hình bắt đầu đỏ rực những thông báo lỗi.
Tại sao lại như vậy? Bởi vì bạn đang bắt chú thợ xây đặt những viên gạch đầu tiên khi trong tay chưa hề có một bản vẽ kiến trúc nào cả.
Nếu ở Bài 0: Vibe Coding Là Gì? Hướng Dẫn Tự Làm Web App Cho Người Không Chuyên chúng ta đã hiểu AI là chú thợ xây tí hon cực kỳ khỏe mạnh nhưng không biết tự nghĩ, thì tài liệu PRD (Product Requirement Document) chính là chiếc la bàn dẫn đường tối thượng trong Vibe Coding. Nếu không có chiếc la bàn này, bạn và AI chắc chắn sẽ bị lạc lối giữa khu rừng kỹ thuật phức tạp.
1. Bản PRD là gì dưới góc nhìn của người làm kinh doanh?
Bản PRD trong Vibe Coding là gì? PRD (Product Requirement Document) là tài liệu mô tả chi tiết yêu cầu sản phẩm bằng ngôn ngữ tự nhiên tiếng Việt, đóng vai trò bản vẽ kiến trúc dẫn đường cho AI lập trình. Tài liệu này quy định rõ chân dung người dùng, danh sách màn hình, quy tắc nghiệp vụ của từng nút bấm và cấu trúc dữ liệu lưu trữ, giúp AI hiểu trọn vẹn bài toán kinh doanh và tạo ra mã nguồn chính xác 100% ngay từ lần đầu tiên.
Nhiều người nghe thấy cụm từ PRD thì tưởng rằng đây là thứ tài liệu hàn lâm chỉ dành cho các tập đoàn công nghệ lớn. Nhưng hiểu một cách bình dân nhất: PRD là một bản mô tả chi tiết bài toán kinh doanh và quy trình làm việc thực tế của bạn bằng văn bản.
Hãy hình dung bản PRD giống như bản thiết kế kiến trúc hoàn chỉnh của một ngôi nhà:
- Bản vẽ phải chỉ rõ: Ngôi nhà có bao nhiêu tầng, mỗi tầng có mấy phòng.
- Phòng khách đặt ở đâu, diện tích bao nhiêu mét vuông.
- Cửa chính làm bằng gỗ hay nhôm kính, mở ra phía trước hay phía sau.
- Đường ống nước và dây điện âm tường đi như thế nào để không bị chập cháy.
Khi chú thợ xây AI nhìn vào một bản thiết kế rõ ràng đến từng milimet như vậy, chú sẽ biết chính xác hôm nay cần trộn bao nhiêu bao xi măng, đặt viên gạch ở vị trí nào và không bao giờ tự ý xây một bức tường chắn ngang lối đi.
2. Bốn thành phần cốt lõi bắt buộc phải có trong một bản PRD chuẩn
Vibe Code Thực Chiến: Tự Tạo Mini Tool & Tiện Ích Tự Động Hóa Công Việc Bằng AI (Không cần biết lập trình)
Học cách xây dựng hệ thống tự động, ứng dụng web và làm chủ quy trình công nghệ từng bước bài bản cùng chuyên gia.
Một bản PRD thực chiến để nạp cho AI không cần dùng thuật ngữ đao to búa lớn. Bạn chỉ cần trả lời dứt khoát 4 câu hỏi lớn sau đây:
| Thành phần PRD | Câu hỏi định hướng | Ví dụ thực tế đời thường |
|---|---|---|
| 1. Chân dung người dùng (User Roles) | Ai là người dùng phần mềm và họ có quyền hạn gì? | Chủ xưởng xem hết doanh thu và giá vốn, nhân viên chỉ xem đơn của mình. |
| 2. Bản đồ màn hình (Screen Map) | Phần mềm gồm những trang nào để nhân viên thao tác? | Màn hình Đăng nhập, Bảng tổng quan Dashboard, Danh sách đơn hàng, Tạo đơn mới. |
| 3. Quy tắc nghiệp vụ (Business Logic) | Khi bấm vào từng nút thì dữ liệu chạy ra sao? | Bấm nút Xuất kho thì tự trừ tồn kho 1 cái và ghi lại tên nhân viên xuất. |
| 4. Cấu trúc dữ liệu (Data Fields) | Cuốn sổ tay cần ghi chép những thông tin chi tiết nào? | Họ tên, số điện thoại, ngày hẹn, tiền cọc, số tiền còn thiếu. |
Thành phần 1: Chân dung người dùng và phân quyền chi tiết (User Roles)
Bạn phải phân định rõ ràng ai là người sử dụng phần mềm và họ được phép làm những gì:
- Người quản trị tối cao (Admin): Là người chủ doanh nghiệp, nhìn thấy toàn bộ báo cáo tài chính, có quyền xem doanh thu, xem giá vốn và chỉnh sửa thông tin của mọi nhân viên.
- Người quản lý chi nhánh (Manager): Chỉ được xem dữ liệu kho hàng và doanh số của riêng chi nhánh mình quản lý.
- Nhân viên bán hàng (Staff): Chỉ có quyền tạo đơn hàng mới, tra cứu tồn kho và xem danh sách khách hàng do mình phụ trách, tuyệt đối không được xem giá nhập hàng hay lợi nhuận ròng.
Thành phần 2: Danh sách các màn hình làm việc (Screen Map)
Phần mềm của bạn gồm những trang nào? Hãy liệt kê rành mạch từng trang một:
- Trang 1: Màn hình Đăng nhập và Khôi phục mật khẩu.
- Trang 2: Màn hình Bảng điều khiển tổng quan (Dashboard) hiển thị 4 chỉ số: Doanh thu hôm nay, số đơn hàng mới, số khách cần chăm sóc và cảnh báo hàng sắp hết.
- Trang 3: Màn hình Danh sách sản phẩm kèm bộ lọc theo danh mục.
- Trang 4: Màn hình Tạo đơn hàng mới và in phiếu thu.
Thành phần 3: Quy tắc nghiệp vụ cho từng nút bấm (Business Logic)
Đây là phần quan trọng nhất để AI không làm sai lệch số liệu. Với mỗi hành động, bạn phải mô tả nguyên nhân và kết quả:
- Khi nhân viên bấm nút Xác nhận xuất kho: Hệ thống phải tự động trừ số lượng sản phẩm trong kho đi tương ứng, đồng thời ghi lại một dòng nhật ký gồm ngày giờ và tên người bấm.
- Nếu số lượng hàng trong kho nhỏ hơn 5 cái: Hệ thống phải hiển thị dòng chữ cảnh báo màu cam thông báo hàng sắp hết.
- Nếu khách hàng nợ quá 30 ngày: Nút tạo đơn hàng mới cho khách đó phải tự động bị khóa lại.
Thành phần 4: Cấu trúc các trường dữ liệu cần lưu trữ (Data Fields)
Hãy liệt kê rõ từng ô thông tin bạn muốn ghi lại vào cuốn sổ dữ liệu:
- Với khách hàng: Họ và tên, số điện thoại, địa chỉ nhận hàng, nguồn đến từ đâu (Facebook, Zalo hay người quen giới thiệu), tổng tiền đã mua.
- Với sản phẩm: Mã hàng, tên sản phẩm, đơn vị tính (cái, thùng, hộp), giá vốn nhập vào, giá bán lẻ và số lượng tồn kho tối thiểu.
3. Kỹ thuật dùng AI để cùng viết PRD: Biến ý tưởng thô thành tài liệu chuẩn
Bạn không cần phải tự mình ngồi gõ từng chữ của bản PRD từ con số 0. Hãy dùng chính AI như một người thư ký mẫn cán để cùng bạn lên kế hoạch theo 3 bước sau:
Bộ câu lệnh mẫu (Prompt) 3 bước tạo PRD cùng AI
Bước 1 – Gợi ý phỏng vấn nghiệp vụ:
Tôi đang mở một xưởng may đồng phục có 15 thợ may và 3 nhân viên bán hàng. Hiện tại tôi đang đau đầu vì không nhớ được đơn hàng nào đã cắt vải, đơn nào đang may và đơn nào đã giao cho khách. Tôi muốn làm một Web App quản lý tiến độ đơn hàng. Hãy đóng vai một chuyên gia phân tích nghiệp vụ phần mềm hàng đầu và đặt cho tôi 5 câu hỏi cụ thể nhất để làm rõ yêu cầu này.
Bước 2 – Trả lời câu hỏi đời thực:
Bạn trả lời thẳng thắn từng câu hỏi theo đúng cách bạn vận hành công việc hàng ngày, không cần dùng từ ngữ kỹ thuật.
Bước 3 – Lệnh đóng gói tài liệu:
Dựa trên toàn bộ câu trả lời trên, hãy tổng hợp lại thành một bản tài liệu PRD hoàn chỉnh bằng tiếng Việt, phân chia rõ ràng các mục: Mục tiêu sản phẩm, Chân dung người dùng và quyền hạn, Danh sách màn hình, Quy tắc nghiệp vụ chi tiết cho từng nút bấm, và Bảng cấu trúc dữ liệu cần lưu trữ.
4. Ví dụ thực tế: Bản mẫu PRD thu nhỏ cho một xưởng sản xuất dịch vụ
Dưới đây là một ví dụ trực quan về một tệp tài liệu PRD chuẩn (đặt tên là PRD.md) mà bạn có thể lưu trữ trong thư mục dự án của mình:
1. MỤC TIÊU DỰ ÁN:
– Giúp chủ xưởng theo dõi chính xác tiến độ 100% đơn hàng theo thời gian thực.
– Triệt tiêu hoàn toàn tình trạng trễ hẹn giao hàng cho khách.
2. PHÂN QUYỀN NGƯỜI DÙNG:
– Admin (Chủ xưởng): Xem toàn bộ doanh thu, tiến độ và phân công công việc.
– Thợ may: Chỉ bấm chuyển trạng thái: Đã cắt vải -> Đang may -> Đã hoàn thiện.
3. DANH SÁCH MÀN HÌNH:
– Màn hình 1: Bảng Kanban 4 cột theo dõi tiến độ đơn hàng dạng thẻ kéo thả.
– Màn hình 2: Form tạo đơn hàng mới kèm thông tin khách và ngày hẹn giao.
4. QUY TẮC NGHIỆP VỤ BẮT BUỘC:
– Ngày hẹn giao phải lớn hơn ngày tạo đơn ít nhất 3 ngày.
– Khi đơn hàng chuyển sang trạng thái Đã hoàn thiện: Tự động gửi 1 tin nhắn thông báo cho khách qua Zalo.
5. CẤU TRÚC DỮ LIỆU:
– Bảng DonHang: MaDon, TenKhach, SoDienThoai, SoLuongAo, TienCoc, TrangThai, NgayGiao.
5. Ba lỗi sai kinh điển cần tránh khi lập PRD
Để bản PRD phát huy 100% sức mạnh, bạn hãy tránh xa 3 cái bẫy dưới đây:
- Lỗi 1: Dùng từ ngữ mơ hồ, chung chung. Đừng viết câu: Hệ thống có báo cáo trực quan và hiện đại. AI không biết thế nào là hiện đại. Hãy viết rõ ràng: Hệ thống có 1 biểu đồ cột thể hiện doanh thu 7 ngày gần nhất và 1 bảng danh sách 5 mặt hàng bán chạy nhất.
- Lỗi 2: Quá tham lam ôm đồm ngay từ phiên bản đầu tiên. Hãy áp dụng nguyên tắc sản phẩm tối thiểu (MVP): Chỉ chọn ra 3 tính năng sống còn nhất giải quyết được 80% công việc hàng ngày để làm trước. Đừng cố thêm tính năng chấm công hay quét mã vạch khi quy trình quản lý đơn hàng còn chưa chạy thông suốt.
- Lỗi 3: Không lưu trữ tài liệu PRD thành một tệp cố định. Bản PRD phải được lưu vào một tệp văn bản riêng biệt trong thư mục dự án (ví dụ đặt tên là PRD.md). Mỗi khi bắt đầu một phiên làm việc mới với AI, bạn chỉ cần nạp lại tệp này để AI nhớ lại toàn bộ quy định của ngôi nhà.
6. Bước tiếp theo trên hành trình Vibe Coding
Khi bạn đã cầm chắc trong tay bản kế hoạch PRD chi tiết, ngôi nhà phần mềm của bạn đã có một bộ móng vững chãi. Bạn không còn phải lo lắng việc AI làm việc lan man hay bị lạc hướng nữa.
Nhưng để chú thợ xây AI có thể dựng lên giao diện mà không bị méo mó, chúng ta cần bước sang chặng tiếp theo: Chuyển hóa bản PRD thành bộ khung xương giao diện trắng đen Wireframe.
Xem tiếp toàn bộ hướng dẫn chặng tiếp theo tại: Bài 2: Vẽ Khung Giao Diện Wireframe: Cách Cho AI Nhìn Thấy Bản Vẽ Trước Khi Đặt Gạch Xây Tường.
Bạn cũng có thể xem lại tổng quan toàn bộ lộ trình 6 bước tại: Bài 0: Vibe Coding Là Gì? Hướng Dẫn Tự Làm Web App Cho Người Không Chuyên.
Để rút ngắn thời gian và được hướng dẫn thực hành xây dựng bản PRD cho chính mô hình kinh doanh của bạn, hãy tham khảo ngay: Khóa học Vibe Code Thực Chiến: Tự Tạo Mini Tool & Tiện Ích Tự Động Hóa Bằng AI.