HƯỚNG DẪN TRIỂN KHAI 102 POS

Cài đặt xong, lấy đúng LAN Host và gửi thông tin để mở kết nối Internet.

Tài liệu này dành cho chủ quán hoặc kỹ thuật viên cài POS Server tại quán. Làm theo từng bước, sau đó gửi mẫu thông tin ở cuối trang để được tạo hostname Cloudflare và nhận hướng dẫn chạy cloudflared.

Tải bộ cài Stable ← Về trang chủ

1. Cài đặt POS Server

Tải 102 POS Server Stable từ trang tải phần mềm.
Trên máy làm server, bấm chuột phải file cài → Run as administrator.
Giữ thư mục cài mặc định, để trình cài đặt cài PostgreSQL và dịch vụ 102POS-Server.
Khi First Run hỏi thông tin quán, nhập tên quán và chọn đúng chế độ kết nối. Không đổi port mặc định 3101.
Mở trình duyệt trên chính máy server và truy cập http://127.0.0.1:3101 để kiểm tra.

Quan trọng: Máy server phải bật trong thời gian quán sử dụng. Không tắt dịch vụ 102POS-Server hoặc PostgreSQL sau khi cài.

2. First Run sẽ hỏi những gì?

Sau khi cài xong, cửa sổ First Run sẽ lần lượt hỏi các thông tin dưới đây. Người dùng chỉ cần nhập theo bảng; không cần tự sửa file .env.

Ô cần nhập	Nhập gì?	Ví dụ
Shop name	Tên quán hiển thị trên POS.	`Billiards & Cafe 102`
Domain mode	Chọn `102POS_SUBDOMAIN` nếu đã nhận hostname từ 102 POS; chọn `LAN_ONLY` nếu chỉ dùng trong mạng nội bộ.	`102POS_SUBDOMAIN`
APP_URL	Địa chỉ giao diện quản trị. Có thể dán cả URL đầy đủ hoặc chỉ hostname.	`https://quan02-app.102pos.io.vn`
QR_URL	Địa chỉ giao diện QR công khai, phải khác APP_URL.	`https://quan02-qr.102pos.io.vn`
LAN_APP_URL	Địa chỉ dùng khi thiết bị cùng Wi-Fi/LAN; có thể bỏ trống nếu không dùng LAN dự phòng.	`http://192.168.1.25:3101`
LAN_QR_URL	Địa chỉ QR trong LAN; thường dùng cùng địa chỉ server LAN.	`http://192.168.1.25:3101`
Mật khẩu admin	Chọn `N` ở câu hỏi mật khẩu mặc định, rồi nhập mật khẩu mới tối thiểu 8 ký tự và nhập lại lần hai.	`Quan02@2026!`

Không cần nhập: PORT vẫn là 3101; WEBSITE_URL tự là https://102pos.io.vn; sau khi lưu URL, hệ thống tự sinh POS_APP_HOSTNAMES và POS_QR_HOSTNAMES. Không tự điền token Cloudflare, mật khẩu PostgreSQL hoặc private key vào các ô URL.

Nếu máy đã có PostgreSQL

Installer sẽ hỏi chọn cách dùng cơ sở dữ liệu. Khuyến nghị chọn Cài PostgreSQL riêng cho 102 POS. Nếu chọn Sử dụng PostgreSQL hiện có, cần nhập đúng:

Host: thường là 127.0.0.1.
Port: đúng port PostgreSQL đang chạy, không đoán; instance riêng 102 POS thường dùng 55432.
Tài khoản quản trị: ví dụ postgres.
Tên Windows Service: chọn đúng service PostgreSQL đang có.
Mật khẩu quản trị PostgreSQL: nhập tại ô bảo mật, không gửi qua email.

Nếu không biết các thông tin PostgreSQL hiện có, hãy chọn cài riêng cho 102 POS hoặc gửi ảnh màn hình lỗi cho kỹ thuật viên; không nhập đại.

3. Cấu hình ban đầu

Đăng nhập quản trị bằng tài khoản admin đã tạo trong First Run.
Vào phần Hệ thống / Cấu hình, kiểm tra tên quán, múi giờ, tiền tệ và thông tin liên hệ.
Tạo khu vực, loại bàn, sản phẩm và tài khoản nhân viên. Có thể dùng seed demo nếu đang thử nghiệm.
Trong phần QR, kiểm tra đường dẫn công khai của QR trước khi in mã cho từng bàn.
Nếu dùng Android trong LAN, nhập URL dạng http://LAN-HOST:3101. Khi đã có HTTPS hostname, dùng URL HTTPS được cấp.

4. Xem IP để lấy LAN Host

LAN Host là địa chỉ IP nội bộ của máy đang chạy POS Server. Điện thoại, máy thu ngân và máy in phải cùng mạng với địa chỉ này.

Cách 1: Windows Command Prompt

ipconfig Tìm dòng IPv4 Address của card mạng đang kết nối, ví dụ: IPv4 Address . . . . . . . . . . : 192.168.1.25

Cách 2: PowerShell

Get-NetIPAddress -AddressFamily IPv4 | Where-Object {$_.IPAddress -notlike '127.*' -and $_.PrefixOrigin -ne 'WellKnown'} | Select-Object IPAddress,InterfaceAlias

LAN Host cần gửi là IP đang dùng để kết nối router/switch, thường bắt đầu bằng 192.168., 10. hoặc 172.16.–172.31.. Không gửi 127.0.0.1.

Ví dụ LAN URL: http://192.168.1.25:3101. Nếu đổi router hoặc đổi card mạng, IP có thể thay đổi; nên đặt DHCP reservation cho máy server.

5. Quy ước hostname APP và QR

Mỗi quán dùng một mã ngắn, ví dụ quan02. Khi tạo kết nối Internet, hostname được cấp theo cặp:

Mục đích	Hostname mẫu	Dùng cho
APP quản trị	`https://quan02-app.102pos.io.vn`	Đăng nhập quản lý POS, thu ngân, báo cáo.
QR công khai	`https://quan02-qr.102pos.io.vn`	Khách quét QR đặt món theo bàn.

Không tự đổi tên biến môi trường hoặc tự tạo hostname khác. Sau khi được cấp cặp hostname, cấu hình máy server phải nhận đúng:

POS_APP_HOSTNAMES=quan02-app.102pos.io.vn POS_QR_HOSTNAMES=quan02-qr.102pos.io.vn

Nếu có nhiều hostname, phân tách theo định dạng mà kỹ thuật viên hướng dẫn. Không đưa mật khẩu hoặc private key vào email.

6. Gửi thông tin để tạo subdomain Cloudflare

Sau khi cài xong và lấy được LAN Host, gửi email theo mẫu dưới đây. 102 POS sẽ tạo cặp subdomain, kiểm tra route và gửi lại hướng dẫn tạo service cloudflared cho máy đó.

Gửi đến	dangviethung.bvt@gmail.com
Tiêu đề	`Đăng ký hostname 102 POS - Tên quán`
Nội dung bắt buộc	Tên quán, tên người liên hệ, số điện thoại/Zalo, mã quán mong muốn (ví dụ `quan02`), LAN Host/IP, port (mặc định `3101`), phiên bản POS và hệ điều hành Windows.
File đính kèm	Ảnh hoặc file thông tin cài đặt nếu có; không gửi mật khẩu, license private key hoặc token Cloudflare.

Mở email đăng ký hostname Gọi/Zalo 0915221182

Sau khi nhận hostname

Bạn sẽ nhận lại: hostname APP, hostname QR, giá trị cấu hình cần nhập và hướng dẫn tạo Windows service cloudflared. Chỉ chạy service sau khi đã kiểm tra POS Server hoạt động tại LAN Host.

7. Gửi thông tin đăng ký bản quyền

Vào email dangviethung.bvt@gmail.com hoặc liên hệ Zalo 0915221182. Gửi các thông tin:

Tên quán và địa chỉ lắp đặt.
Người đại diện, số điện thoại/Zalo.
Gói đăng ký: theo tháng từ 79.000đ hoặc 5.000.000đ/trọn đời.
Tên máy/hostname đã cài POS và mã license hoặc file yêu cầu được hệ thống xuất ra.
Ảnh chụp màn hình mục Bản quyền nếu cần hỗ trợ kích hoạt.

License dùng cho một máy. Trong thời gian còn hiệu lực, khách hàng được yêu cầu bổ sung tính năng, báo cáo và hướng dẫn sử dụng.

Gửi email đăng ký bản quyền Gọi/Zalo

8. Kiểm tra trước khi gửi

Trên máy server, http://127.0.0.1:3101 mở được.
Từ máy khác cùng Wi-Fi/LAN, http://LAN-HOST:3101 mở được.
Windows Firewall cho phép dịch vụ POS Server qua mạng Private.
LAN Host không phải 127.0.0.1 và không phải IP của VPN không dùng.
Đã ghi lại phiên bản POS, mã quán và địa chỉ email liên hệ.

Nếu hostname APP/QR báo “không tồn tại” hoặc QR lại hiện giao diện quản trị, dừng thao tác và gửi ảnh lỗi cùng LAN Host về email hỗ trợ.