Kiểm Soát Phiên Bản

Mỗi thay đổi đều được commit vào một kho lưu trữ GitHub riêng tư do Proyecta quản lý. Duyệt và chuyển đổi giữa các snapshot trước đó bằng menu thả xuống phiên bản trong thanh công cụ builder.

Mỗi thay đổi mà AI thực hiện trên ứng dụng của bạn đều được commit vào một kho lưu trữ GitHub riêng tư do Proyecta quản lý. Code của bạn luôn có thể truy cập và xuất ra từ builder.

Lịch Sử Phiên Bản

Sử dụng menu thả xuống phiên bản trong thanh công cụ builder để chuyển đổi giữa các snapshot. Trên thiết bị di động, truy cập Lịch Sử Phiên Bản qua menu More. Khi đang xem một phiên bản cũ, nhấp vào Open history trong banner phiên bản để xem danh sách đầy đủ. Mỗi phiên bản hiển thị:

• Số phiên bản (ví dụ: “v12”)
• Nhãn (ví dụ: ‘v1 (pre-cloud)’ cho snapshot frontend ban đầu, hoặc để trống cho các phiên bản lặp)
• Dấu thời gian tạo theo múi giờ địa phương của bạn
• 7 ký tự đầu của git commit hash

Mở một phiên bản trước đó

Nhấp vào bất kỳ thẻ phiên bản nào để mở snapshot đó trong phần xem trước. Các phiên bản cũ mở ở chế độ chỉ đọc — bạn có thể kiểm tra code và xem trước, nhưng không thể chỉnh sửa từ bên trong chế độ xem lịch sử.

Trong khi bạn đang duyệt một phiên bản cũ, một banner phía dưới thanh công cụ sẽ hiển thị “Viewing version N in read-only mode.” Nhấp vào Return to latest trong banner để quay lại trạng thái làm việc hiện tại và tiếp tục chỉnh sửa.

Nếu bạn chưa từng chỉnh sửa bất cứ điều gì, trang tính sẽ hiển thị “No snapshots yet — versions are created automatically after builder turns that commit changes.”

Làm thế nào để thực sự hoàn nguyên?

Hoàn nguyên một cú nhấp từ trang Lịch Sử Phiên Bản đang có trong lộ trình phát triển. Hiện tại, bạn có hai lựa chọn:

1. Hỏi AI — "Revert the last change", "Go back to how the homepage looked in version 6", "Undo everything from the last three commits". AI sẽ đọc lịch sử và áp dụng reverse commit cho bạn.
2. Dùng git trong Terminal — để kiểm soát chính xác hơn:

# View recent commits
git log --oneline -20

# Revert a specific commit (creates a new commit undoing it)
git revert <commit-hash>

# Or reset to a specific point (destructive)
git reset --hard <commit-hash>

GitHub

Code dự án của bạn được lưu trữ trong một kho lưu trữ GitHub riêng tư do Proyecta quản lý. Bạn có thể truy cập code trực tiếp từ trình soạn thảo code bên trong builder, hoặc xuất ra ngoài. Nếu bạn đã kết nối tổ chức GitHub của riêng mình, kho lưu trữ sẽ được tạo ở đó thay vì ở nơi mặc định.

Câu hỏi thường gặp

Mỗi phiên bản bao gồm những gì?

Các thay đổi về code, cập nhật cấu hình và sửa đổi schema — tất cả những gì tồn tại trong git. Các tài nguyên được lưu trữ ngoài kho lưu trữ (như tệp đã tải lên và bản ghi cơ sở dữ liệu) không được tạo phiên bản.

Tôi có thể tạo branch không?

Có. Sử dụng Terminal để tạo và chuyển đổi branch: git checkout -b feature/new-homepage. AI sẽ commit vào bất kỳ branch nào đang được checkout.

Làm thế nào để cộng tác với nhóm của tôi?

Nhiều thành viên trong nhóm có thể truy cập cùng một kho lưu trữ trên GitHub. Sử dụng các quy trình git tiêu chuẩn (branch, pull request) để cộng tác.

Sắp ra mắt

• Hoàn nguyên một cú nhấp — nút “Revert to this version” trong trang Lịch Sử Phiên Bản sẽ tạo một phiên bản mới khớp với snapshot cũ hơn
• Nhãn phiên bản tùy chỉnh — đặt tên cho từng phiên bản riêng lẻ để dễ tìm kiếm hơn về sau