Cài đặt & bắt đầu

CreditMate hiện là bản phát triển nội bộ (0.x): chưa có trên App Store, chưa có trên TestFlight, và mã nguồn nằm trong kho riêng tư. Trang này mô tả cách dựng ứng dụng từ mã nguồn và những gì xảy ra ở lần mở đầu tiên.

Yêu cầu

Máy Mac có Xcode 27.
iPhone hoặc iPad chạy iOS/iPadOS 18 trở lên (hoặc trình giả lập tương ứng).
XcodeGen, cài bằng brew install xcodegen.

Build từ mã nguồn

Tệp dự án Xcode không được sửa tay. Nó được sinh ra từ project.yml, nên mọi thay đổi cấu hình đều làm trong tệp này rồi sinh lại.

xcodegen generate          # sinh CreditMate.xcodeproj từ project.yml
./scripts/test-kit.sh      # chạy kiểm thử của package CreditMateKit
xcodebuild test -scheme CreditMate \
  -destination 'platform=iOS Simulator,name=iPhone 17 Pro Max'

Sau khi sinh dự án, mở CreditMate.xcodeproj trong Xcode, chọn scheme CreditMate và chạy. Nguồn AI được cấu hình ngay trong ứng dụng; khoá API lưu trong Keychain, không nằm trong mã nguồn.

Lần mở đầu tiên

Giới thiệu. Màn mở đầu nói trước bạn cần chuẩn bị gì: ngân hàng, hạn mức, ngày chốt sao kê.
Thêm ngân hàng đầu tiên. Chọn ngân hàng trong danh mục khoảng 60 ngân hàng và công ty tài chính Việt Nam, rồi thêm thẻ. Bạn chỉ cần nhập tên gợi nhớ và 4 số cuối.
Dùng thử với dữ liệu mẫu. Nếu muốn xem ứng dụng trước khi nhập số liệu của mình, chọn dữ liệu mẫu. Đây là số liệu giả, có thể xoá bất cứ lúc nào.
Face ID. Ứng dụng mời bật khoá bằng Face ID. Bạn có thể bỏ qua và bật sau trong Cài đặt.
Mã PIN CreditMate. Mã PIN 6 số riêng của ứng dụng dùng cho khoá ứng dụng và két thông tin thanh toán. Mã này độc lập với mật mã iPhone. Quên mã PIN thì không khôi phục được, chỉ có thể đặt lại két. Xem Bảo mật và quyền riêng tư.

Ngôn ngữ

CreditMate có hai ngôn ngữ: tiếng Việt và tiếng Anh. Ứng dụng đi theo danh sách ngôn ngữ ưu tiên của iPhone: gặp tiếng Anh trước tiếng Việt thì dùng tiếng Anh, còn lại dùng tiếng Việt. Trợ lý AI cũng trả lời theo ngôn ngữ đó. Đổi ngôn ngữ trong Cài đặt iOS, mục Ứng dụng.

Xử lý sự cố thường gặp

Build báo lỗi ký mã "detritus not allowed". Thư mục dự án nằm trong vùng đồng bộ iCloud (ví dụ Desktop). Đặt thư mục build ra ngoài bằng -derivedDataPath và --scratch-path.
Không tìm thấy CreditMate.xcodeproj. Chạy lại xcodegen generate.
Đường dẫn dự án có dấu cách. Đặt đường dẫn trong dấu nháy khi gọi lệnh trên dòng lệnh.
Kiểm thử giao diện treo. Dùng bản Xcode chính thức thay cho bản beta; bản beta có thể lệch phiên bản CoreSimulator và làm trình chạy kiểm thử không phản hồi.
Quên mã PIN. Không có cách khôi phục. Chọn "Quên mã PIN?" trên màn khoá để đặt lại két; thông tin thanh toán đã lưu trong két sẽ mất, các dữ liệu khác giữ nguyên.
Khoá API bị từ chối. Kiểm tra khoá trong Cài đặt trợ lý bằng nút "Kiểm tra kết nối".