Skip to Content

App đầu tiên

Khoảng 30 phút. Làm xong, bạn có app “Duyệt mua sắm” chạy thử trong bảng điều khiển: nhân viên tạo đề xuất mua, quản lý duyệt hoặc từ chối.

Bạn mô tả nghiệp vụ của app, duyệt spec do agent soạn, xem bản chạy thử rồi nhờ agent sửa. Ví dụ trong trang là một app thật, agent làm trên manh.run từ khâu viết spec đến khi deploy.

Nếu chưa kết nối agent, hãy làm theo trang Kết nối agent trước. Việc này mất khoảng 2 phút.

Các bước

Mô tả nghiệp vụ của app

Nói rõ ai dùng app, họ làm những việc gì và cần lưu thông tin gì. Bạn không cần nhắc tên thư viện hay cấu trúc file, vì agent tự đọc tài liệu framework của manh.run.

Dùng manh.run, làm app "Duyệt mua sắm". Nhân viên tạo đề xuất mua (tiêu đề, mô tả, số tiền, hạng mục, cần trước ngày) và theo dõi trạng thái. Nhân viên sửa hoặc huỷ được khi đề xuất còn chờ. Quản lý thấy hộp chờ duyệt, duyệt hoặc từ chối; khi từ chối phải ghi lý do. Mỗi bước ghi lại thành dòng thời gian. Quản lý xem tổng đã duyệt theo tháng.

Duyệt spec trước khi có code

Agent làm theo quy trình của manh.run: viết spec trước, code sau. Agent soạn PRD.md, ORCA.md (vai trò, đối tượng, quyền) và spec/01–04 (dữ liệu, vòng đời, API, màn hình) trong thư mục làm việc của bạn. Sau đó agent hỏi bạn một loạt câu về vai trò, quyền, luồng trạng thái, danh sách màn hình và những chỗ yêu cầu chưa rõ.

Bạn trả lời các câu hỏi đó. Agent viết code theo spec, nên sửa ở bước này đỡ tốn công hơn nhiều so với sửa về sau.

Agent viết code và kiểm lỗi

Agent tạo project trên manh.run rồi ghi file vào app/ theo từng phần: bảng và quy tắc nghiệp vụ trước, rồi đến API, sau cùng là các trang. Ngay khi ghi file, manh.run kiểm lỗi và báo kết quả cho agent. Xong mỗi phần, agent chạy check đầy đủ, kể cả kiểm tra kiểu TypeScript.

Cây app/ của mẫu Duyệt mua sắm:

app/ ├── auth.ts → vai trò, cách đăng ký (đăng nhập và người dùng do manh.run sinh) ├── layout.tsx → khung app: menu theo vai, đăng xuất ├── page.tsx → trang / — việc chờ và tổng quan tháng ├── login/page.tsx → trang /login ├── register/page.tsx → trang /register ├── shared/request.ts → trạng thái và vòng đời của đề xuất └── requests/ ├── requests.table.ts → bảng đề xuất ├── request-events.table.ts → dòng thời gian của từng đề xuất ├── repository.ts → vòng đời, quyền, ghi lịch sử ├── page.tsx → trang /requests — danh sách ├── get.ts · post.ts → GET · POST /api/requests ├── stats/get.ts → GET /api/requests/stats └── [id:int]/ ├── page.tsx → trang /requests/12 — chi tiết ├── get.ts · patch.ts → GET · PATCH /api/requests/12 ├── approve/post.ts → POST /api/requests/12/approve ├── reject/post.ts → POST /api/requests/12/reject └── cancel/post.ts → POST /api/requests/12/cancel

Xem bản chạy thử

Mở manh.run  và chọn project. Trang Tổng quan của project có khung preview chạy bản nháp mới nhất, tự cập nhật vài giây sau mỗi lần agent ghi file. Các phần gọi API chỉ có dữ liệu sau lần deploy đầu, nên khi viết xong API, agent sẽ deploy để bạn chạy thử.

Yêu cầu sửa

Nhắn agent điều bạn muốn đổi ngay trong cuộc chat đó, ví dụ: “Thêm cột phòng ban vào danh sách đề xuất.”

Muốn chỉ đúng chỗ trên màn hình, bấm Chọn phần tử trên preview, bấm vào phần cần sửa rồi bấm Sao chép prompt. Prompt chép ra đã có tên file và số dòng. Bạn dán vào agent rồi viết thêm điều muốn đổi.

Cần biết

  • Spec nằm trên máy bạn, trong thư mục agent đang làm việc. Project trên manh.run chỉ giữ cây app/.
  • Agent ghi file không làm thay đổi app đang chạy thật. App chỉ đổi khi deploy.
  • Agent nạp dữ liệu mẫu qua API sau khi deploy, không viết cứng vào code.

Bước tiếp theo

Cập nhật