VIETTYPE INDEPENDENT — WINDOWS BETA 0.6.0
Windows 11 • Intel/AMD x64; lõi và xử lý ảnh đã chạy thử trên Windows 11 ARM64 qua lớp tương thích x64.

CÀI / CẬP NHẬT
• Thoát bản cũ qua menu Vi/En → Thoát. Giải nén toàn bộ ZIP, mở VietType.exe.
• Không cần Python/.NET, không cần chạy quyền quản trị.
• Thoát các bộ gõ khác; chọn English (US) trong Windows. Nếu chạy máy ảo, để bộ gõ trên Mac ở En.
• Dữ liệu mẫu của 0.1.x được đọc khi chưa có library.json. File cũ được giữ nguyên; bản mới lưu vào library.json.
• Không sửa cùng một thư mục dữ liệu bằng hai phiên bản. Khi cần quay về 0.1.x, mẫu mới của 0.2.0 không tự hiện trong bản cũ.

BỘ GÕ
• Click Vi/En hoặc Ctrl+Alt+0 để đổi Việt/Anh. Chuột phải biểu tượng để mở cửa sổ hoặc thoát.
• Telex/VNI, kiểu đặt dấu hoà/hòa, khôi phục từ tiếng Anh trong Cài đặt bộ gõ.
• Ứng dụng… → Khởi động cùng Windows: bật để chạy nền khi đăng nhập. Nếu di chuyển VietType.exe, bật lại để cập nhật đường dẫn.
• Nếu Windows chặn ứng dụng chưa ký: chỉ dùng More info → Run anyway khi có lựa chọn và bạn tin nguồn file. Không tắt Defender/Smart App Control để chạy. Máy quản trị có thể không cho phép mở.

MẪU TRẢ LỜI, CHỮ VÀ ẢNH
• Tìm mẫu ngay trên danh sách bằng tên, mã gõ hoặc nội dung, có thể gõ không dấu.
• Chọn mẫu, nhập tên, mã gõ và nội dung. Bấm Lưu mẫu.
• Nút QR chuyển khoản bên dưới nội dung bật/tắt QR cho mẫu đang sửa.
• + Thêm mẫu để thêm, tối đa 5.000 mẫu. Mã gõ như ;baogia, phân biệt hoa/thường.
• Nút Thêm ảnh để gắn PNG/JPG/BMP/TIFF. App lưu ảnh vào dữ liệu riêng, không phụ thuộc file gốc.
• Nút … bên cạnh Tên mẫu → Xem ảnh / Bỏ ảnh / Xóa mẫu. Mọi thay đổi cần bấm Lưu mẫu.
• Chọn Phím tắt bên dưới nội dung: Ctrl+Alt+1…9 hoặc Chưa gán. Mã trùng hoặc phím trùng sẽ được báo.
• Trong Vi, gõ mã + Space để dán. Hoặc dùng phím tắt; phím tắt mẫu dùng được cả ở En.
• Ctrl+Alt+K mở Tìm và dán mẫu: tìm tên/mã/nội dung không cần dấu, dùng mũi tên và Enter.
• Chữ được dán trước, ảnh sau. App không nhấn Enter hay tự gửi tin nhắn. Một số ứng dụng mở hộp xác nhận ảnh.
• Đợi dán xong rồi gõ tiếp; đổi ô, click chuột hoặc gõ tiếp có thể hủy lượt dán còn lại.
• Clipboard sẽ chứa chữ/ảnh vừa dán. Nếu không khôi phục được đúng ô nhập, app báo và chép nội dung vào clipboard; mẫu có ảnh sẽ ưu tiên ảnh để tự Ctrl+V.

MẪU CÓ CHỖ ĐIỀN
• Viết {ten_khach}, {ma_don}, {san_pham}… trong nội dung (tên biến dùng chữ không dấu, số và dấu gạch dưới; bắt đầu bằng chữ).
• Khi dùng mẫu, app hỏi lần lượt các giá trị, sau đó hiện nội dung xem trước. Bấm Dán để quay lại ô soạn.
• Bấm Hủy để giữ nguyên ô soạn. Cùng một biến xuất hiện nhiều lần chỉ hỏi một lần.

QR CHUYỂN KHOẢN
• Bấm QR chuyển khoản để nhập ngân hàng, số tài khoản, tên chủ tài khoản, số tiền nếu muốn.
• Hỗ trợ mã VCB, BIDV, MB, TCB, ACB, VPB, TPB, ICB, VBA, STB; ngân hàng khác dùng BIN 6 số.
• Chọn Ngẫu nhiên nội dung chuyển khoản: xáo 30 câu chúc, dùng hết rồi xáo lại trong phiên chạy. Không thêm số thứ tự.
• Bỏ chọn để dùng nội dung mặc định. Bỏ chọn và để trống: QR không chứa nội dung chuyển khoản; app ngân hàng xử lý ô đó.
• Nội dung QR chuyển thành chữ không dấu, tối đa 25 ký tự. Số tài khoản 6–19 chữ/số; số tiền nguyên dương hoặc để trống.
• Trong mẫu, bấm QR chuyển khoản để hiện “QR · Đang bật”, rồi Lưu mẫu.
• Chữ đã lưu của mẫu vẫn dán vào chat; câu chuyển khoản chỉ nằm trong QR, không tự thêm vào chữ chat.
• QR được tạo trên máy, không gọi dịch vụ mạng. Ảnh QR không có logo ngân hàng. Tên người nhận thực tế do ngân hàng tra từ tài khoản; tên chủ tài khoản nhập trong cài đặt không xác nhận chủ sở hữu.
• Quét thử trong app ngân hàng, kiểm tra đúng ngân hàng/tài khoản/số tiền/nội dung trước khi sử dụng. VietType không chuyển tiền, không xác nhận giao dịch.

SAO LƯU / NHẬP
• Bấm Sao lưu / nhập → Có để xuất JSON gồm mẫu, ảnh, phím tắt mẫu và cấu hình QR.
• Chọn Không để nhập bản sao lưu từ Mac hoặc Windows. App xem trước số mẫu rồi hỏi Nhập thêm hoặc Thay thế.
• Nhập thêm: giữ QR hiện tại, bỏ qua ID đã có, đổi hậu tố mã gõ trùng và bỏ gán phím bị trùng.
• Thay thế: thay tất cả mẫu và QR. Trước khi nhập luôn có file truoc-khi-nhap-….json để phục hồi.
• PNG/JPG/TIFF nhập từ Mac được chuyển thành PNG. Nếu có HEIC không đọc được, app báo lỗi và không nhập một phần; hãy đổi HEIC sang PNG trên Mac rồi xuất lại.
• Dữ liệu: %LOCALAPPDATA%\VietTypeIndependentBeta. Sao lưu JSON không bao gồm quyền hệ thống và tùy chọn bộ gõ riêng của từng máy.
• File sao lưu có thể chứa nội dung cá nhân/tài khoản: giữ riêng tư. Không kèm dữ liệu thật trong gói cài.

CÔNG CỤ VĂN BẢN
• Bấm Công cụ văn bản, dán chữ, chọn 1 (hoa), 2 (thường), 3 (bỏ dấu).
• Xem kết quả rồi Sao chép. Giữ xuống dòng, không giữ font và màu chữ.

PHẠM VI KIỂM THỬ
• 0.1.1/0.1.2: người dùng xác nhận đã hết lỗi order và cửa sổ gọn.
• 0.2.0: kiểm thử lõi, schema sao lưu, biến, mã trùng, QR CRC; tạo PNG và roundtrip dữ liệu ngay trong Windows ARM64; đọc lại QR bằng bộ giải mã độc lập trên Mac.
• Chức năng mới cần thử dán thật trong ứng dụng đích. Chưa bảo đảm mọi ứng dụng lấy được cả chữ và ảnh. Google Docs/Notion, cửa sổ quản trị, game chưa được xác nhận.
• Lõi độc lập; backend Windows dùng keyboard hook + SendInput, chưa phải TSF. Ô không xác định được hoặc ô mật khẩu báo bảo mật sẽ được nhường phím.
• Bản này chưa có tự chuyển chế độ theo từng app, bộ gợi ý sửa lỗi, chuyển bảng mã cũ hoặc cập nhật tự động. Đây chưa phải bản phát hành rộng có đủ mọi tùy chọn của Mac.
• Công cụ tests/core-tests.exe và tests/feature-tests.exe dành cho QA; không ghi nhật ký gõ. Feature test tạo dữ liệu mẫu trong thư mục Temp\VietType-Feature-QA, không dùng tài khoản thật.

Nguồn và thư viện:
Lõi VietInputEngine được port từ bản độc lập, không dùng TelexCore.
JSON: nlohmann/json; tạo ma trận QR: Nayuki QR Code Generator (MIT). Giấy phép trong licenses/.

GIAO DIỆN SÁNG / TỐI
• Nút Chế độ tối / Chế độ sáng ở góc trên bên phải đổi giao diện ngay. App nhớ lựa chọn khi mở lại.
• Mẫu trả lời: danh sách bên trái, ô soạn bên phải. Tìm mẫu… để tìm mẫu cần sửa; Ctrl+Alt+K để tìm và dán trong ứng dụng khác.
• QR chuyển khoản: nhập tài khoản, tạo ảnh xem trước, rồi Lưu tài khoản.
• Các hộp chọn file và thông báo hệ thống dùng giao diện của Windows.

GIAO DIỆN 0.6.0
• Chỉ mẫu có nội dung, ảnh hoặc QR mới hiện trong danh sách. Thêm mẫu mở ô soạn trống; nhập tên và nội dung rồi Lưu mẫu để đưa vào danh sách.
• QR: chọn Ngẫu nhiên, Cố định hoặc Để trống. Cố định mở ô nhập nội dung.
• Ô ngân hàng có danh sách gợi ý; có thể nhập mã ngân hàng hoặc BIN 6 số.

ĐIỀU HƯỚNG 0.6.0
• Tất cả mục thanh bên mở ngay trong cửa sổ chính. Cài đặt bộ gõ tự lưu khi chọn.
• Công cụ văn bản giữ nội dung khi chuyển trang; kết quả cập nhật khi nhập.
• Sao lưu có nút Xuất và Nhập riêng. Hộp chọn file và xác nhận thay thế dữ liệu vẫn là hộp thoại hệ thống.
