🚀 Hướng Dẫn Setup Môi Trường Làm Việc

Dành cho ai? — Người chưa từng làm việc với code bao giờ. Không cần kinh nghiệm, chỉ cần làm đúng từng bước.

[1] Cài GitHub Desktop  →  [2] Tạo tài khoản GitHub  →  [3] Cài Antigravity
                                                                    ↓
                              [5] Clone source code  ←  [4] Đăng nhập Gmail

Làm tuần tự từ trên xuống, đừng bỏ bước nào.

💡 GitHub Desktop là gì? — Phần mềm giúp bạn tải code về máy và đồng bộ với team, không cần gõ lệnh phức tạp.

Các bước:

1. Truy cập 👉 https://desktop.github.com/download/
2. Nhấn nút Download (tự nhận diện hệ điều hành Windows/Mac)
3. Mở file vừa tải → Cài đặt như phần mềm bình thường (Next → Next → Install)
4. Mở GitHub Desktop lên — màn hình sẽ hỏi bạn đăng nhập, chưa cần làm gì cả, qua bước 2 trước

✅ Xong khi: Mở được app GitHub Desktop, thấy màn hình chào

💡 GitHub là gì? — Kho lưu trữ code trên internet. Giống như Google Drive nhưng dành riêng cho code.

Các bước:

1. Truy cập 👉 https://github.com

2. Nhấn Sign up (góc trên bên phải)

3. Điền thông tin:

   Trường	Gợi ý
   Email	Dùng email chính, bạn sẽ cần xác nhận
   Password	Tối thiểu 8 ký tự, có chữ hoa + số
   Username	Tên hiển thị, ví dụ: nguyen-van-a

4. Hoàn thành bài puzzle xác minh (kéo ô ghép hình)

5. Vào hộp thư email → Tìm mail từ GitHub → Nhấn Verify email address

✅ Xong khi: Đăng nhập được vào github.com, thấy trang dashboard cá nhân

💡 Antigravity là gì? — Tool nội bộ của team, hỗ trợ bạn trong quá trình làm việc với source code.

Các bước:

1. Lấy link tải từ team leader hoặc nhóm chat nội bộ
2. Tải file về máy
3. Nếu file là .zip → Chuột phải → Extract All (Windows) hoặc double-click (Mac)
4. Mở file cài đặt bên trong → Làm theo hướng dẫn cài đặt

⚠️ Lưu ý: Nếu Windows hiện cảnh báo "Windows protected your PC" → Nhấn More info → Run anyway. Đây là bình thường với phần mềm nội bộ.

✅ Xong khi: Mở được app Antigravity, thấy màn hình đăng nhập

💡 Tại sao cần Gmail? — Antigravity xác thực danh tính qua tài khoản Google để biết bạn là thành viên của team.

Các bước:

1. Mở Antigravity
2. Nhấn nút Sign in with Google (biểu tượng chữ G)
3. Chọn tài khoản Gmail của bạn
4. Nếu xuất hiện màn hình "Antigravity muốn truy cập..." → Nhấn Allow / Cho phép
5. Chờ vài giây → App sẽ tự chuyển vào giao diện chính

⚠️ Nếu không thấy tài khoản Gmail? → Nhấn "Use another account" và đăng nhập thủ công

✅ Xong khi: Thấy tên/email của bạn hiển thị trong app Antigravity

💡 Clone là gì? — Tải toàn bộ code từ GitHub về máy tính của bạn để có thể làm việc offline.

1. Mở GitHub Desktop

2. Vào menu File → Chọn Clone repository...

   File
   ├── New repository...
   ├── Clone repository...   ← Nhấn vào đây
   └── ...
   

3. Chọn tab URL (tab thứ 3)

4. Dán link repository vào ô trống:

   https://github.com/username/project-name.git
   

   (Link này do team cung cấp)

5. Ở ô Local Path → Nhấn Choose... → Chọn thư mục bạn muốn lưu (ví dụ: Documents/Projects)

6. Nhấn Clone → Chờ thanh tiến trình chạy xong

✅ Xong khi: GitHub Desktop hiện tên project, không báo lỗi đỏ

Chỉ dùng nếu bạn đã cài Git. Mở Terminal (Mac) hoặc Command Prompt (Windows), gõ:

git clone https://github.com/username/project-name.git

Trước khi bắt đầu làm việc, hãy tự kiểm tra:

• Đã cài và mở được GitHub Desktop
• Đã có tài khoản GitHub và xác nhận email
• Đã cài và mở được Antigravity
• Đã đăng nhập Gmail vào Antigravity thành công
• Đã clone source code về máy, thấy thư mục code xuất hiện

Tick đủ 5 ô = Bạn đã sẵn sàng! 🎉

💬 Vẫn không tự xử lý được? Chụp màn hình lỗi và gửi vào nhóm chat để team hỗ trợ.

Tài liệu nội bộ — Cập nhật bởi team