← Về thư mục
📄 / / projects / tech / travel-exchange-rate / BRIEF.md

🚀 PROJECT BRIEF: PERSONAL CAPITAL PROFILE (Travel Finance Optimization 2.1)

1. Product Vision (Tầm nhìn Sản phẩm)

Một ứng dụng Web/Mobile gọn nhẹ (Micro-App) dành riêng cho khách du lịch tại Đông Nam Á. App giúp người dùng đưa ra quyết định thanh toán thời gian thực (Real-time) và rẻ nhất (Global Minima) giữa 3 lựa chọn: Tiền mặt địa phương (Cash), Giao dịch Online (Online Transaction), và Quẹt thẻ POS vật lý.

2. Core Value Proposition (Giá trị Cốt lõi)

3. System Architecture & UI Layout (Cấu trúc Hệ thống)

Ứng dụng chia làm 2 màn hình (Tabs) chính, sử dụng Global State Management.

Tab 1: Hồ sơ Vốn (Configuration Profile - Data Input)

Nơi người dùng thiết lập các tham số vĩ mô trước chuyến đi. 1. Tỷ giá nền tảng: * Giá vốn USD: Tỷ giá lúc mua USD tại Việt Nam. * Giá thu USD: Tỷ giá ngân hàng nước sở tại mua USD (VD: BCA Beli). * Tiền mặt hiện có: Tổng ngân sách USD vật lý đang cầm theo. 2. Danh mục thẻ (Card Portfolio): * Khả năng Thêm/Sửa/Xóa cấu hình thẻ (Tên thẻ, Phí FX %, Tỉ giá Ngân hàng bán). 3. Hệ thống Lưu trữ (Persistence): * Sử dụng Cloud Database (VD: Firebase) hoặc LocalStorage để lưu trạng thái. Cấu hình không bị mất khi reload app.

Tab 2: Quầy POS (Calculator Dashboard - Action/Output)

Màn hình thao tác nhanh khi đứng tại quầy thanh toán. 1. HUD Header (Heads-up Display): * Hiển thị "Thanh khoản mặt" (USD Available). * Có một Dropdown hoặc Selector cho phép người dùng chọn "Thẻ Đang Dùng" (Active Card) từ danh mục đã cấu hình ở Tab 1. (Note: Logic chọn thẻ thủ công giúp kiểm soát rủi ro thẻ hết hạn mức/không mang theo). 2. Vendor Cards (Khu vực nhập liệu): Có thể có nhiều thẻ Vendor (A, B) để so sánh song song. * Input Price (Số nguyên). * Toggle Currency (USD hoặc IDR). 3. Calculation Matrix (Ma trận kết quả 3 luồng): Tự động tính ra 3 luồng chi phí dựa trên Price và thông số của Active Card. * Cash (Tiền mặt): Cảnh báo Đỏ/Gạch bỏ nếu số USD cần dùng > "Tiền mặt hiện có". * Online Transaction (Giao dịch Online): Tính qua cổng thanh toán mạng (Không bị charge 3% POS). * Quẹt POS (Vật lý): Kèm checkbox "+3% Phụ phí". * Global Highlight (Xanh lá): Hệ thống quét toàn bộ các phương án (của cả Vendor A và B) -> Tìm ra con số VND nhỏ nhất -> Highlight phương án đó.

4. Mathematical Engine (Công thức Cốt lõi)

Hệ thống tính toán dựa trên việc quy chiếu chéo tiền tệ (Double Conversion). Giả định Vendor báo giá bằng Ngoại tệ địa phương (IDR).

5. Development Stack (Đề xuất Frontend)