Bắt đầu

Tạo tài khoản

Người dùng mới đăng ký tại /register. Màn hình được chia thành phần giới thiệu sản phẩm bên trái (tiêu đề động "Chào mừng đến với Apps Kit SDK", một dòng mô tả sản phẩm và ba thẻ thống kê có hiệu ứng động — Doanh thu cao hơn, Tỷ lệ khớp, Sự cố & ANR — đây là nội dung quảng bá mang tính minh họa, không phải dữ liệu về tài khoản của bạn) và biểu mẫu đăng ký bên phải.

Biểu mẫu đăng ký thu thập các thông tin sau:

• Họ và tên — bắt buộc.
• Email — bắt buộc, phải là địa chỉ email hợp lệ.
• Mật khẩu — bắt buộc, tối thiểu 8 ký tự và phải chứa ít nhất một chữ hoa, một chữ thường và một ký tự đặc biệt (ví dụ: !@#$%^&*).

Nhấp vào Tạo tài khoản sẽ tạo tài khoản email/mật khẩu trên Firebase, gửi ngay email xác minh qua Firebase, rồi đăng ký người dùng với backend của Apps Kit SDK (POST /oauth/login với oauthProvider: "email"). Sau đó, bạn được chuyển hướng đến /login — thao tác đăng ký không tự động đăng nhập và bạn chỉ có thể đăng nhập sau khi xác minh email (xem phần Đăng nhập bên dưới).

Ngoài ra, Đăng ký bằng Google sử dụng cửa sổ bật lên đăng nhập Google của Firebase (signInWithPopup) và đăng ký tài khoản với oauthProvider: "gmail". Đăng ký bằng Google không yêu cầu xác minh email riêng và đưa bạn thẳng đến / (Ứng dụng của tôi) hoặc /users, tùy loại tài khoản.

Liên kết "Đã có tài khoản? ĐĂNG NHẬP TẠI ĐÂY" đưa bạn về /login.

Đăng nhập

Màn hình Đăng nhập (/login) sử dụng cùng bố cục hai phần như màn hình Đăng ký: phần giới thiệu sản phẩm bên trái và khung đăng nhập bên phải.

LOGIN_SCREEN_IMAGE

Biểu mẫu đăng nhập gồm:

• Email — bắt buộc, đúng định dạng email.
• Mật khẩu — bắt buộc.
• Nút bật/tắt hiển thị mật khẩu (biểu tượng con mắt) trên trường mật khẩu.
• Tiếp tục — nút gửi biểu mẫu, bị vô hiệu hóa cho đến khi biểu mẫu hợp lệ.
• Ghi nhớ tôi — hộp kiểm, khi được chọn sẽ lưu địa chỉ email (không phải mật khẩu) vào trình duyệt để tự động điền vào lần truy cập tiếp theo.
• Quên mật khẩu? — liên kết đến /forget-password.
• Nút "Đăng nhập bằng Google" — sử dụng cùng luồng cửa sổ bật lên của Firebase như khi đăng ký bằng Google, nhưng dành cho tài khoản đã tồn tại.
• "Người dùng mới? ĐĂNG KÝ TẠI ĐÂY" — liên kết đến /register.

Khi đăng nhập bằng email/mật khẩu, hệ thống còn kiểm tra xem email của tài khoản Firebase đã được xác minh hay chưa; nếu chưa, bạn sẽ thấy thông báo "Vui lòng xác minh email trước." và không được đăng nhập. Sau khi đăng nhập thành công (bằng một trong hai phương thức), bạn được chuyển đến / (Ứng dụng của tôi) nếu là tài khoản người dùng thông thường, hoặc /users nếu là tài khoản nội bộ/quản trị viên.

Quên mật khẩu

/forget-password là biểu mẫu chỉ có một trường (địa chỉ email của bạn). Gửi biểu mẫu sẽ gọi sendPasswordResetEmail của Firebase — không có luồng đặt lại mật khẩu ngay trong cổng thông tin; bạn nhận liên kết đặt lại qua email và một thông báo toast xác nhận "Đã gửi email đặt lại mật khẩu. Vui lòng kiểm tra hộp thư đến", sau đó bạn được đưa về /login. Trang này cũng có liên kết "Quay lại đăng nhập?".

Thanh điều hướng trên cùng

Sau khi đăng nhập, mọi trang (trừ các màn hình xác thực) đều hiển thị thanh điều hướng trên cùng với menu tài khoản ở bên phải và — chỉ trên trang Ứng dụng của tôi — một biểu tượng chuông thông báo bên cạnh.

Menu tài khoản. Nhấp vào ảnh đại diện/tên/email ở góc trên bên phải sẽ mở menu thả xuống gồm:

• Mục "Tài khoản của tôi" đại diện cho tài khoản của bạn (chấm màu xanh lam đánh dấu đây là ngữ cảnh đang hoạt động khi được chọn).
• Phần "Được chia sẻ với tôi" — chỉ xuất hiện nếu bạn đã chấp nhận ít nhất một lời mời chia sẻ từ nhóm khác. Phần này liệt kê tên, email và ảnh đại diện của từng người mời. Nhấp vào một người sẽ chuyển toàn bộ ngữ cảnh của cổng thông tin sang tài khoản đó (về mặt kỹ thuật: dispatch switchAccount()), vì vậy mọi nội dung bạn thấy sau đó — Ứng dụng của tôi, Thương hiệu, Chiến dịch, v.v. — đều phản ánh tài nguyên của họ, được lọc theo các quyền họ đã cấp cho bạn.
• Phần chân menu thay đổi tùy theo ngữ cảnh: nếu bạn đang xem tài khoản của mình, phần này hiển thị liên kết "Hồ sơ". Nếu bạn đang xem tài khoản đã chuyển sang/được chia sẻ, phần này sẽ hiển thị nút màu đỏ "Thoát → Được chia sẻ với tôi", đưa bạn trở lại tài khoản của mình và chuyển đến trang Được chia sẻ với tôi.

Khi bạn đang xem tài khoản đã chuyển sang, thanh điều hướng cũng hiển thị nhãn nhỏ "Được chia sẻ" bên cạnh tên hiển thị, để bạn luôn nhận biết mình đang xem dữ liệu của ai.

Chuông thông báo. Biểu tượng này chỉ xuất hiện trên các đường dẫn / và /apps (tức bảng điều khiển Ứng dụng của tôi) — không xuất hiện ở nơi nào khác trong cổng thông tin. Số trên huy hiệu là tổng số thông báo thuộc tất cả các nhóm thông báo. Nhấp vào biểu tượng sẽ mở danh sách thả xuống có tiêu đề "Thông báo", liệt kê các mục theo loại, mỗi mục kèm một thông điệp ngắn.

Thao tác nhấp vào từng thông báo có hành vi khác nhau tùy theo loại:

• Nếu loại thông báo là upatedSdkVersion (cảnh báo "Đã cập nhật phiên bản SDK"), nhấp vào thông báo sẽ đưa bạn thẳng đến trang Chi tiết ứng dụng của ứng dụng đó (/app/:id) và không đánh dấu thông báo là đã đọc.
• Với mọi loại thông báo khác, nhấp vào thông báo sẽ chuyển đến trang Tải SDK và có đánh dấu thông báo là đã đọc (gọi endpoint đánh dấu đã đọc và hiển thị thông báo toast "Đã đánh dấu thông báo là đã đọc thành công").

Chuông này chỉ cung cấp danh sách thả xuống để xem nhanh — đây là giao diện riêng, đơn giản hơn trang Thông báo của tôi chuyên dụng được mô tả ở phần sau của hướng dẫn này; cả hai đều tách biệt với danh sách lời mời Được chia sẻ với tôi. Cổng thông tin thực sự có ba khu vực lời mời/thông báo khác nhau; xem phần Tài khoản để biết sự khác biệt.