Tài chính · VND
Tổng số0 ₫
Đã thu0 ₫
Còn thiếu0 ₫
Công việc của nhóm
Giữ công việc 3 giây để tải bản lưu hoặc xóa. Bàn phím: Shift + F10.
Bản demo · Dữ liệu lưu trên trình duyệt này
PaanChat
Chào bạn 👋
Cùng làm tốt hơn.
Mỗi công việc, một cuộc trò chuyện.
4 đang thực hiện
1 đã xong
Tìm từ danh bạ điện thoại
Lời mời kết bạn
Bạn bè 0
Trải nghiệm với tài khoản demo
Tài khoản demo riêng, tự hết hạn sau 24 giờ.Lưu mã dự phòng ở nơi an toàn
Mã chỉ hiện lần này. Ai có mã có thể đặt lại mật khẩu của bạn. Mỗi lần dùng sẽ tạo mã mới.
Mã PaanChat
Chỉnh sửa hồ sơ
Bảo mật và thiết bị
Đổi / đặt mật khẩu
Thông tin xác minh
PaanChat nhận kết quả từ đối tác định danh được phép tích hợp, không nhận ảnh căn cước hoặc ảnh mặt. Họ tên và trạng thái xác minh sẽ được gửi vào danh sách superadmin.
Đối chiếu với tổ chức (thủ công)
Đối chiếu thông tin nội bộ với đầu mối có thẩm quyền; không chứng nhận căn cước.
Quyền riêng tư và dữ liệu
Máy chủ lưu hồ sơ, quan hệ bạn bè và tin nhắn riêng để cung cấp dịch vụ. Mật khẩu được băm; phiên đăng nhập dùng cookie cần thiết. Công việc demo lưu trên trình duyệt theo tài khoản. Không dùng cookie theo dõi. Danh bạ đã chọn chỉ dùng đối chiếu trong lần yêu cầu. Hồ sơ đối chiếu được mã hóa, giới hạn truy cập và tự xóa nội dung khi hết hạn. Tin nhắn riêng hiện chưa có mã hóa đầu cuối.
Xóa tài khoản
Xóa hồ sơ, ảnh đại diện, quan hệ bạn bè và tin nhắn riêng trên máy chủ. Dữ liệu công việc demo trên trình duyệt cần xóa riêng trong mục Công việc.
Sao lưu và chuyển thiết bị
Sao lưu tài khoản
Giữ bản lưu trên Google Drive của bạn để chuyển sang thiết bị mới.
Bản lưu gần nhất:
Đọc lịch sử ngoài ứng dụng
ZIP lịch sử đã giải mã chứa dữ liệu riêng tư; chỉ giữ trên thiết bị của bạn. Giải nén toàn bộ thư mục rồi mở index.html để xem chat, công việc và file. Tin nhắn riêng trong bản lưu chỉ để đọc.
Cách dùng sao lưu Google Drive
- Bấm Tạo và tải bản sao lưu để nhận file .wcbackup đã nén và mã hóa.
- Tải file .wcbackup lên Google Drive cá nhân của bạn.
- Mở Chia sẻ, chọn Bất kỳ ai có đường liên kết với quyền Người xem và cho phép tải file. Chỉ chia sẻ file sao lưu đã mã hóa.
- Sao chép liên kết file, dán vào ô bên trên và bấm Lưu liên kết. Để trống rồi lưu nếu muốn gỡ liên kết.
- Đăng nhập đúng tài khoản PaanChat trên thiết bị mới. Khi quản trị viên bật tự khôi phục, ứng dụng tải bản lưu và hợp nhất công việc. Có thể bấm Khôi phục từ liên kết hoặc Nhập file sao lưu để làm thủ công.
Bạn tự tải file lên Drive. PaanChat không nhận mật khẩu Google và không tự tải bản sao lưu lên Drive.
Nếu Drive chặn tải tự động, tải file .wcbackup bằng Drive rồi chọn Nhập file sao lưu.
Mở Google Drive · Hướng dẫn tải file lên Drive · Hướng dẫn chia sẻ file
Dữ liệu được lưu ở đâu?
- Hồ sơ, danh bạ và tin nhắn riêng
- Máy chủ PaanChat ·
- Công việc của tài khoản
- File đính kèm
- Bản sao lưu .wcbackup
- Thiết bị của bạn, sau đó Google Drive do bạn tải lên
Tin nhắn riêng tải từ máy chủ khi đăng nhập; bản sao lưu giữ lịch sử để đọc. Công việc do bạn tạo được sao lưu và hợp nhất theo ID, không ghi đè dữ liệu mới. Công việc chung tiếp tục lấy từ đồng bộ nhóm. File chưa tải được sẽ được báo trong kết quả.
Các bản sao công việc có ID riêng được giữ độc lập. Công việc, bước và tin nhắn đã xóa không được đưa trở lại từ bản sao lưu; khi nội dung khác nhau, giữ bản hiện có.
Gói dịch vụ
Quảng cáo của tôi
Mini app và nhà phát triển
Quản trị hệ thống
Các tính năng quản trị hiển thị theo quyền được cấp.
PaanChat · ADMIN
Trung tâm quản trị
Quản lý tài khoản, thông tin nhóm và vận hành hệ thống.
Mở nhóm để xem thành viên, hồ sơ, khóa hoặc cấm thành viên. Chat công việc chỉ mở được khi có dữ liệu trong tài khoản trên thiết bị này. Xóa nhóm chuyển vào mục Đã xóa; công việc và file cục bộ được giữ lại. Nhóm bị khóa hoặc xóa không gửi thêm chat qua ứng dụng khi kết nối.
Chỉ duyệt sau khi đối chiếu với đầu mối có thẩm quyền. Quyết định này không chứng nhận căn cước hay danh tính nhà nước.
Bộ lọc từ cấm
Cảnh báo nội dung
Tự hiển thị nội dung có từ đang bật. Gõ từ để tìm ngay, không cần quét.
Trên thiết bị này
Chat và nội dung công việc của tài khoản đang đăng nhập. Không gửi nội dung lên máy chủ.
Trên máy chủ
Thử một đoạn nội dung
Danh sách từ cấm
Quét dữ liệu đang lưu
Tìm nội dung khớp trong dữ liệu cũ. Kết quả được ghi nhận để xem xét.
Thêm và bật ít nhất một từ lọc trước khi quét.
Các đợt quét gần đây
Kết quả cần xem xét
Chỉ hiển thị mã nguồn, người gửi và từ khớp; không mở toàn văn chat riêng. Kết quả tự hết hạn sau 90 ngày.
Phạm vi và cách hoạt động
Cảnh báo tự động tìm theo danh sách từ đang bật, kể cả khi chế độ chặn nội dung mới đang tắt. Gõ từ để tìm tạm thời; từ đang gõ chưa được lưu vào danh sách. Kết quả chỉ hiện đoạn có từ khớp. Chat công việc được kiểm tra trong tài khoản trên thiết bị này; máy chủ chỉ tìm tin nhắn riêng, tên hiển thị và tên nhóm đã lưu. Không đọc file, ảnh hoặc tài chính.
So khớp cụm từ không phân biệt hoa/thường hoặc dấu. Khi gõ, có thể tìm theo phần đầu của từ. Danh sách tự cập nhật mỗi 20 giây khi đang mở. Quét dữ liệu là công cụ ghi nhật ký bổ sung, xử lý 250 bản ghi/lượt; có thể tiếp tục trong 7 ngày.
Xem thiết kế nhiều máy chủ và cập nhật đồng bộ · Hướng dẫn cụm, Cloudflare và subdomain
Đăng nhập & khôi phục bằng SMS
Người dùng gửi PAANCHAT - mã xác minh đến SIM quản trị. App Android chỉ chuyển SMS đúng mẫu về máy chủ; trình duyệt tự đăng nhập hoặc mở bước nhập mật khẩu mới.
Android APKCài điện thoại nhận SMS
- Cài APK PaanChat SMS Bridge lên điện thoại Android gắn SIM nhận SMS; mở app và cấp quyền nhận SMS.
- Nhập địa chỉ https://chat.paanchat.com, số SIM nhận, mã thiết bị và khóa vừa tạo. Khóa chỉ hiển thị khi tạo; thay khóa sẽ cần cập nhật trên điện thoại.
- Điện thoại hai SIM: nhập ID subscription của đúng SIM hiển thị trong app, hoặc dùng máy chỉ gắn một SIM.
- Bật cầu nối. Giữ điện thoại có Internet, không force-stop app; kiểm tra hạn chế pin của hãng. Thử SMS thật sau mỗi lần khởi động lại.
APK quản trị nằm trong runtime/android-bridge sau khi chạy npm run android:build. Không phát app cầu nối cho người dùng thường. Chỉ nhận SMS khớp PAANCHAT - mã; không đọc lại hộp thư, không tự gửi SMS, không lưu mật khẩu người dùng. Cần HTTPS và thời gian điện thoại đúng. Nhận SMS không chứng minh danh tính pháp lý; mất SIM hoặc bị giả mạo SMS vẫn là rủi ro phải quản lý.
Sao lưu Google Drive cá nhân
Người dùng tải file .wcbackup đã nén và mã hóa về máy, tự tải lên Drive rồi lưu liên kết vào tài khoản PaanChat. Hệ thống lấy file từ liên kết khi họ đăng nhập thiết bị mới. Không cần dự án Google Cloud, OAuth hoặc mật khẩu Google.
Các bản sao công việc có ID riêng được giữ độc lập. Công việc, bước và tin nhắn đã xóa không được đưa trở lại từ bản sao lưu; khi nội dung khác nhau, giữ bản hiện có.
Thiết lập và dùng từ đầu
- Bật sao lưu và tùy chọn tự khôi phục ở biểu mẫu trên. Chọn giới hạn 1–64 MB, nhập lý do rồi lưu.
- Người dùng mở Tài khoản → Sao lưu tài khoản và tạo file .wcbackup. Kết quả cho biết số công việc, tin nhắn và file; file thiếu hoặc công việc của người khác được báo riêng.
- Người dùng tự tải file mã hóa lên Google Drive, chia sẻ Bất kỳ ai có đường liên kết với quyền Người xem, cho phép tải xuống rồi lưu liên kết file vào PaanChat.
- Trên thiết bị mới, đăng nhập cùng tài khoản. Công việc do người đó tạo được kiểm tra chữ ký và hợp nhất theo ID; nội dung mới đang có được giữ. Tin nhắn riêng tải từ máy chủ, lịch sử trong bản sao lưu dùng để đọc.
- Nếu Google Drive yêu cầu đăng nhập, xác nhận hoặc chặn tải tự động, người dùng tải file .wcbackup bằng Drive rồi chọn Nhập file sao lưu trong PaanChat.
Nơi lưu dữ liệu hiện tại và bảo vệ khóa
- Máy chủ tài khoản
- Hồ sơ, danh bạ, tin nhắn riêng, liên kết sao lưu và khóa sao lưu mã hóa theo tài khoản nằm trong cơ sở dữ liệu của PaanChat.
- Công việc và ảnh trong bước
- Dữ liệu theo tài khoản ở localStorage của trình duyệt. Khi bật đồng bộ công việc, có thêm bản trên cơ sở dữ liệu máy chủ. Công việc chung lấy theo quyền thành viên và đồng bộ nhóm.
- File gốc
- IndexedDB giữ bản cục bộ; máy chủ hoặc node lưu trữ giữ các file đã gửi theo cấu hình. File không tải được khi xuất sẽ được báo, không coi là đã sao lưu đủ.
- SQLite và cụm HA
- SQLite mặc định dùng data/workchat.sqlite; DATA_DIR có thể đổi. Cụm HA cần PostgreSQL và kho file nhân bản theo cấu hình node. Drive là bản phục hồi cá nhân.
Bản .wcbackup dùng AES-256-GCM, khóa riêng theo tài khoản do máy chủ quản lý. Máy chủ có thể giải mã sau khi người dùng đăng nhập; đây không phải mã hóa đầu cuối. Chỉ tài khoản sở hữu được phép giải mã và nhập dữ liệu.
Sao lưu hệ thống phải giữ cơ sở dữ liệu, dữ liệu file, cấu hình và kho bí mật ở nơi được bảo vệ. Các node cùng cụm cần dùng kho bí mật nhất quán. Mất toàn bộ khóa của cụm có thể khiến file .wcbackup không giải mã được; file trên Drive không thay thế bản sao lưu khóa.
Dùng HTTPS khi triển khai tên miền để bảo vệ dữ liệu giữa trình duyệt và máy chủ. Trong mạng LAN HTTP, nén và mã hóa vẫn thực hiện trên máy chủ.
Lộ trình ứng dụng máy tính và điện thoại
Đây là hướng lưu cho ứng dụng native sẽ xây dựng sau, chưa phải chức năng đã cài trong bản web.
- Máy tính: cơ sở dữ liệu và file riêng theo tài khoản trong thư mục ứng dụng; người dùng có thể chọn nơi giữ file công việc. Đường dẫn dự kiến: Windows %LOCALAPPDATA%\PaanChat, macOS ~/Library/Application Support/PaanChat, Linux ~/.local/share/PaanChat.
- Điện thoại: dữ liệu và khóa thiết bị trong bộ nhớ riêng của ứng dụng; chọn xuất bản sao lưu mã hóa sang Files hoặc Drive khi cần.
- Giữ chung định dạng sao lưu, ID công việc và quy tắc hợp nhất với bản web; tự đồng bộ khi online và khôi phục từ liên kết theo quyền tài khoản.
Đăng nhập VNeID
Chưa kết nối. Đây là cấu hình chuẩn bị, chưa phải API VNeID hoạt động. Cần đơn vị vận hành, quyền khai thác dịch vụ, tài liệu kỹ thuật và thông tin kết nối do bên cung cấp cấp. PaanChat không nhận mật khẩu VNeID, ảnh căn cước hoặc ảnh mặt.
Thông tin dịch vụ xác thực điện tử quốc gia
Hướng dẫn chuẩn bị tích hợp VNeID
Trạng thái PaanChat: đã có nơi lưu cấu hình chuẩn bị; chưa có đối tác, credential hoặc adapter chính thức. Lưu cấu hình không bật đăng nhập VNeID.
- Xác định đơn vị vận hành
Chuẩn bị thông tin tổ chức, người đại diện, đầu mối kỹ thuật và quyền riêng tư; mô tả mục đích đăng nhập, dữ liệu tối thiểu cần nhận và thời hạn lưu. Xác nhận thành phần hồ sơ hiện hành trực tiếp với bên tiếp nhận.
- Đăng ký khai thác dịch vụ
Mở Cổng xác thực điện tử quốc gia, xem quy trình đăng ký và liên hệ Trung tâm RAR qua đầu mối được công bố trên cổng. Hoàn tất thẩm định và điều kiện kết nối theo hướng dẫn của đơn vị cung cấp.
Cổng đăng ký và đầu mối chính thức - Nhận tài liệu và thông tin kết nối
Yêu cầu giao thức đăng nhập, môi trường thử/nghiệm thu, mã ứng dụng, phương thức kiểm tra kết quả, các trường được phép nhận, cơ chế thu hồi và quy trình xử lý sự cố. Không suy đoán endpoint từ các trang đăng nhập công khai.
Mục tài liệu của cổng - Lưu bản chuẩn bị trong PaanChat
Điền các thông tin đã được cấp vào biểu mẫu bên dưới và ghi tham chiếu phê duyệt. Client secret, khóa riêng và dữ liệu căn cước không đưa vào ghi chú. Cấu hình chuẩn bị được mã hóa trên máy chủ; thay đổi có nhật ký và kiểm tra phiên bản.
- Triển khai adapter theo tài liệu được cấp
Đội kỹ thuật triển khai HTTPS, URL chuyển hướng đã đăng ký, kiểm tra tính toàn vẹn và nguồn kết quả, ràng buộc phiên, hạn dùng và chống phát lại. Liên kết tài khoản bằng định danh ổn định từ đối tác; không tự ghép tài khoản chỉ vì trùng tên hoặc số điện thoại.
- Kiểm thử và bật sau nghiệm thu
Thử đăng nhập thành công, hủy, sai nguồn, hết hạn, phát lại, mất kết nối và tài khoản PaanChat bị khóa. Công bố thông báo xử lý dữ liệu, hoàn thành nghiệm thu theo bên cung cấp rồi mới bật trên môi trường thật. VNeID không mặc nhiên cấp quyền superadmin.
Danh mục trên là các bước triển khai của PaanChat; hồ sơ, giao thức và yêu cầu nghiệm thu phải theo tài liệu chính thức được cấp. Tham khảo quy định định danh và xác thực điện tử tại Nghị định 69/2024/NĐ-CP và văn bản sửa đổi Nghị định 320/2026/NĐ-CP, đồng thời kiểm tra văn bản sửa đổi còn hiệu lực với đơn vị cung cấp.
Cụm máy chủ
Cấu hình cấp 1, lưu file cấp 2 và hướng dẫn triển khai theo từng máy.
Tên miền paanchat.com · HTTPS & Cloudflare
Địa chỉ chính thức dự kiến: https://paanchat.com. Hồ sơ cấu hình đã có; chỉ chuyển từ LAN sau khi tạo tunnel và nối DNS thành công.
paanchat.com: Trang chủ giới thiệu · paanchat.com/download: Tải ứng dụng · chat.paanchat.com: Chat web. Cùng tunnel trỏ về localhost cổng 7557; ứng dụng dùng PUBLIC_URL=https://chat.paanchat.com.
- Thêm paanchat.com vào tài khoản Cloudflare và đặt nameserver tại nơi mua tên miền theo Cloudflare. Đợi trạng thái tên miền Active.
- Trong terminal tại thư mục PaanChat, đăng nhập Cloudflare và tạo tunnel. Chọn đúng tên miền; giữ chứng thư và file credential trên máy này, không gửi vào chat hoặc Superadmin.
cloudflared tunnel login cloudflared tunnel create workchat-paanchat - Lấy UUID do Cloudflare trả về, thay UUID trong hai lệnh sau. Bộ tạo dùng đường dẫn credential của tài khoản máy hiện tại; không đọc hoặc sao chép khóa vào mã nguồn.
npm run domain:configure -- UUID cloudflared tunnel route dns UUID paanchat.com cloudflared tunnel route dns UUID chat.paanchat.comNếu DNS đã có bản ghi cùng tên, kiểm tra trước khi thay; không dùng tùy chọn ghi đè tự động.
- Dừng tiến trình npm start đang chạy bằng Ctrl+C, rồi bật hồ sơ tên miền. Hồ sơ này giữ nguyên dữ liệu và khóa từ .env, dùng cookie Secure, giới hạn origin ở HTTPS và chỉ nghe trên localhost.
npm run start:domain - Mở terminal thứ hai tại PaanChat và chạy tunnel:
cloudflared tunnel --config deploy/paanchat/cloudflared.yml run UUID - Mở https://chat.paanchat.com/health/ready, yêu cầu mã 200; sau đó đăng nhập lại trên tên miền và thử chat, tải file, mic và cuộc gọi bằng hai thiết bị. Hai terminal phải tiếp tục chạy; khi đã nghiệm thu, cài ứng dụng và tunnel thành dịch vụ khởi động cùng máy.
Cloudflare: bật chuyển hướng HTTP sang HTTPS; không đặt Cache Everything cho ứng dụng và bỏ cache /api/*, /auth/*, /health/*, /superadmin trên chat.paanchat.com. SSE cần giữ kết nối. Các callback đăng nhập/thanh toán sau này phải dùng tên miền HTTPS này.
Cloudflare Tunnel phục vụ web; gọi qua mạng khác vẫn cần STUN/TURN riêng. Khi thêm node, dùng chat.paanchat.com làm PUBLIC_URL chung, node1.paanchat.com, node2.paanchat.com… làm địa chỉ node. Trong cấu hình cụm, đặt Tên miền là paanchat.com và Subdomain dùng chung là chat; nhiều tunnel cần cấu hình cân bằng tải và kiểm tra sức khỏe.
Dữ liệu công việc chỉ có ở trình duyệt LAN chưa tự chuyển sang tên miền mới. Xuất bản lưu hoặc bật đồng bộ nhóm trước khi chuyển; dữ liệu phía máy chủ và ID tài khoản vẫn được giữ.
Hướng dẫn Cloudflare Tunnel ↗Theo dõi trạng thái node
Chọn từng máy để xem dịch vụ, tài nguyên và lịch sử hoạt động.
Tự cập nhật mỗi 15 giâyCập nhật gần nhất:
Chưa tải được trạng thái mới. Đang hiển thị báo cáo cuối cùng; chưa xác nhận tình trạng hiện tại của các node.
Chưa có dữ liệu theo dõi.
Agent báo về khoảng 15 giây/lần; sau 65 giây không báo về, node được đánh dấu mất liên lạc. Lịch sử được lấy mẫu mỗi phút, ghi thêm khi trạng thái thay đổi và lưu tối đa 6 giờ. Máy đang phục vụ vẫn có thông số trực tiếp khi chưa cài agent.
Đóng gói dữ liệu
Database, file đã đồng bộ và khóa phục hồi trong một gói có mật khẩu.
Dùng khi sao lưu hoặc chuyển sang cụm mới. Node bổ sung kết nối database chung. Công việc và file chỉ lưu trên trình duyệt chưa nằm trong gói này; cần đồng bộ hoặc xuất công việc trước.
Phiên bản & cập nhật tự động
Máy phát hành chạy npm start để theo dõi mã nguồn. Các sửa đổi được gom sau 3 giây yên; kiểm tra mã rồi tạo phiên bản và gói ký số. Node đã cài bằng gói ký số cùng bên phát hành sẽ tải từ máy quản lý hoặc peer qua VPN, cập nhật từng máy và kiểm tra dịch vụ trước khi giữ bản mới.
Đang kiểm tra phiên bản…
Bộ tự cập nhật thay mã ứng dụng; giữ database, danh tính node và khóa VPN. Một node có thể ngừng ngắn khi thay bản; nhiều node cần ít nhất một peer khỏe. Cần PostgreSQL HA, nhiều origin Cloudflare và nghiệm thu khởi động/VPN trên từng hệ điều hành. Migration xóa/đổi dữ liệu cần kế hoạch riêng; không tự rollback database. Giữ khóa phát hành ngoài gói và hạn chế ai được sửa mã trên máy phát hành.
Từ một máy đến cụm nhiều node
Xem sơ đồ hoặc làm theo từng bước. Các node ứng dụng có cùng vai trò.
SuperadminTên miền chungĐiều phối · cấu hình · theo dõi
Hình sao mô tả các bước quản lý từ Superadmin. VPN giữa các máy cấp 1 nên có đường trực tiếp hoặc dự phòng để tránh phụ thuộc một máy trung tâm.
Người dùngHTTPS qua một tên miền
Node ứng dụng 1 · 2 · 3 · …Ưu tiên máy khỏe, ít kết nối
Cụm database chungPrimary ⇄ Standby ⇄ Standby
Database chung có bản sao trên nhiều máy: một primary ghi dữ liệu tại một thời điểm, standby nhận bản sao; PostgreSQL/Patroni chọn máy thay thế theo quorum. Kho file phân bố theo mã file, ưu tiên ba bản và chỉ xác nhận khi có ít nhất hai. Thêm node ứng dụng giúp tăng khả năng xử lý; database dung lượng lớn vẫn cần thiết kế phân vùng riêng.
1 · Chuẩn bị máy, tên miền và đường truyền
Chọn ít nhất ba máy độc lập cho database HA. Node ứng dụng có thể là macOS, Windows hoặc Linux x64/ARM64; hạ tầng PostgreSQL/Patroni/etcd hiện dùng bộ triển khai Linux bên dưới. Máy phải có quyền cài dịch vụ, đủ ổ đĩa, giờ chính xác và tắt chế độ ngủ.
Dùng tên miền bạn sở hữu, ví dụ chat.tenmien.vn. Cloudflare đưa HTTPS vào ứng dụng. WireGuard cần endpoint UDP trực tiếp; subdomain web qua Tunnel không thay thế UDP. Kiểm tra router, CGNAT, firewall và mạng VPN không trùng LAN. Người dùng không cần cài VPN của cụm.
2 · Đóng gói trước khi sao chép
Trên máy có mã nguồn đã duyệt, chạy lệnh bên dưới để tạo thư mục mới chứa mã, thư viện production từ lockfile và manifest ký Ed25519. Khóa ký riêng ở deploy/secrets/release-signing.pem, không nằm trong gói; sao lưu khóa này ngoài máy vận hành. Bản đầu cần lấy từ nguồn tin cậy và đối chiếu vân tay bên phát hành.
npm run node:packageNếu cần mang dữ liệu: bấm Đóng gói dữ liệu mới, đặt mật khẩu riêng, tải workchat-data.wcb vào thư mục gói vừa tạo. Gói chứa snapshot database, file đã đồng bộ và khóa phục hồi; không mang danh tính riêng/khóa WireGuard của máy nguồn. Không sao chép trực tiếp SQLite đang ghi hoặc file WAL. Dữ liệu chỉ ở trình duyệt cần đồng bộ/xuất trước.
3 · Copy thư mục sang máy mới rồi chạy một lệnh
Mở terminal tại thư mục gói. Chạy với quyền quản trị của hệ điều hành. Bộ cài kiểm tra runtime Node theo SHA-256, dùng thư viện đã đóng gói, tạo danh tính node và khóa VPN riêng, cài dịch vụ khởi động cùng máy, rồi hiện link cấu hình localhost.
# macOS / Linux
sh install-node.sh
# Windows · PowerShell mở bằng Run as Administrator
powershell -ExecutionPolicy Bypass -File .\install-node.ps1Lần đầu cần Internet để tải Node và gói hệ điều hành. Linux tự cài wireguard-tools qua trình quản lý gói hỗ trợ; Windows tải bộ cài WireGuard chính thức và kiểm tra chữ ký Authenticode. macOS tự cài công cụ khi đã có Homebrew; nếu thiếu Homebrew hoặc công cụ phát triển cần bổ sung theo hướng dẫn chính thức rồi chạy lại. Nếu chưa cài VPN được, node vẫn có trang cấu hình nhưng báo cần cài thêm. Không tự bật VPN khi chưa có peer/IP.
4 · Ghép node, cấu hình WireGuard
Mở link localhost do bộ cài in ra, đặt tên máy. Trong Superadmin qua HTTPS, tạo mã ghép 10 phút và dán vào trang localhost. Đối chiếu mã node/vân tay với máy thật. Node sẽ xuất hiện cùng RAM, ổ đĩa, IP, phiên bản và khóa VPN công khai.
Bấm VPN trên thẻ node để điền IP riêng, UDP và peer, tải workchat-vpn.json. Copy file này về đúng máy, chạy lại bộ cài với tùy chọn sau. Khóa riêng ở máy đó, không tải lên Superadmin. Các cấu hình chỉ tạo tuyến /32 giữa các IP riêng, không nhận script PostUp/PreUp.
# macOS / Linux
sh install-node.sh --vpn ./workchat-vpn.json
# Windows
powershell -ExecutionPolicy Bypass -File .\install-node.ps1 -Vpn .\workchat-vpn.jsonMỗi cặp máy cần cấu hình hai chiều; ít nhất một đầu phải có UDP tiếp cận được. Cho phép UDP của WireGuard, giới hạn cổng database/app/file trong VPN. Khởi động lại từng máy và kiểm tra wg show, handshake và kết nối IP riêng. macOS launchd bật tunnel khi boot; cần nghiệm thu mất kết nối và reboot trên máy thật.
5 · Dựng database nhiều bản sao và chuyển dữ liệu
Nếu chỉ thêm node: dùng endpoint PostgreSQL của cụm hiện có; không nhập backup vào database đang chạy. Dựng ba database Linux bằng cấu hình HA bên dưới: primary ghi, standby đồng bộ, etcd duy trì quorum và watchdog ngăn hai primary. Mỗi app dùng proxy database có đường dự phòng; đọc hướng dẫn nâng cao để cấu hình chứng thư, quyền và PITR.
Nếu chuyển từ máy SQLite ban đầu: kiểm tra gói dữ liệu trên trang localhost, dữ liệu được giải mã vào thư mục restored-data mới trong state. Dừng ghi ở máy nguồn khi chốt bản cuối, chuyển snapshot vào PostgreSQL trống bằng lệnh migration; dùng cùng PRIVATE_DATA_KEY và ARCHIVE_SIGNING_KEY trong secrets.json. Kiểm tra số bản ghi và khóa trước khi bật các node. Tệp objects là ciphertext phải nạp vào các kho file mới; không đổi khóa mã hóa giữa chừng.
npm run migrate:postgres -- /path/restored-data/workchat.sqlite --dry-run
npm run migrate:postgres -- /path/restored-data/workchat.sqlite --applyGói PostgreSQL chứa snapshot logic postgres.jsonl để phục hồi vào database trống cùng phiên bản mã nguồn; dùng lệnh bên dưới sau khi kiểm tra gói, cấu hình DATABASE_URL/CA và dừng các app của database đích. Instance của database mới được giữ riêng, node nhập lại ở trạng thái tạm dừng. Backup không tự hợp nhất vào cụm đang có. Cơ chế nhập/hợp nhất đoạn chat từng công việc vẫn là chức năng riêng.
node scripts/restore-postgres.mjs /path/restored-data --apply6 · Duyệt node và nối tên miền
Chuẩn bị ít nhất ba kho file. Trong Cấu hình node, nhập IP VPN, endpoint PostgreSQL đúng cụm và CA hoặc xác nhận database chỉ chạy trong VPN đã mã hóa. Superadmin gửi cấu hình mã hóa riêng cho node, không yêu cầu nhập lại toàn bộ khóa chung. Khi đã sẵn sàng, bật node và đợi trạng thái app/kho file/router hoạt động.
Mỗi native node có router tại 127.0.0.1:3000, app IP-VPN:3002, kho file IP-VPN:3100. Cloudflare Tunnel trên từng máy trỏ vào router localhost. Cấu hình load balancer/pool cho các subdomain của cùng tên miền; dùng một PUBLIC_URL thống nhất và cookie/session chung. Cần tài khoản/domain Cloudflare thật để triển khai phần này.
7 · Kiểm tra phân tải và thêm máy
Router kiểm tra app mỗi 5 giây, ưu tiên node khỏe có ít kết nối và chia lượt khi bằng nhau. Node mới được duyệt được đưa vào danh sách router ở lần agent nhận cấu hình tiếp theo; app/file cần chạy và truy cập được qua VPN. Mỗi router có số kết nối riêng, nên tải cân bằng theo thực tế kết nối, không cam kết mọi máy luôn có cùng số request.
File mới dùng rendezvous hashing để chọn tối đa ba kho ưu tiên, thử kho khác nếu lỗi và chỉ xác nhận khi đủ hai bản. Đọc có thể tìm ở các kho còn lại. Thêm kho làm file mới phân bố lại; file cũ cần chạy repair để có bản tại vị trí mới. Giữ các kho cũ cho đến khi kiểm tra xong; không xóa node đang giữ bản duy nhất.
npm run storage:repairKiểm thử hai người trên các node khác nhau: gửi tin, file, thay đổi công việc, tải lại và đối chiếu. Nếu mất kết nối sau khi ghi, giữ nguyên mã thao tác để thử lại; router không tự gửi lại thao tác ghi vì kết quả commit có thể đã tồn tại.
8 · Nghiệm thu mất máy, reboot và backup
Ngắt từng máy ứng dụng, database primary và một kho file; thử đăng nhập/gửi tin/file qua các máy còn lại, kiểm tra failover và dữ liệu. Mất quorum thì database cần dừng ghi an toàn. Reboot từng OS, kiểm tra dịch vụ và tunnel lên lại. Thử phục hồi backup trên môi trường cách ly trước khi chuyển domain.
Bảng Theo dõi cập nhật mỗi 15 giây, báo mất liên lạc sau 65 giây, ghi lịch sử tối đa 6 giờ. Tạm dừng/thu hồi chỉ tới máy đang liên lạc; máy offline có thể tiếp tục dùng cache. Nếu mất quyền kiểm soát máy, thu hồi VPN/database và xoay khóa dùng chung. Có backup độc lập/PITR, không chỉ dựa vào các bản sao đang chạy.
9 · Đóng gói bản mới và cập nhật lần lượt
Sau khi sửa mã nguồn và kiểm thử, chạy node:package với cùng khóa phát hành. Copy gói ký số sang từng máy và chạy bộ cài từ bản đã tin cậy; cập nhật một máy thử trước, theo dõi rồi mới đến máy tiếp theo. Bộ cài xác minh chữ ký/hash, chặn bên phát hành khác và bản cũ, giữ danh tính/dữ liệu, chờ agent hoạt động và giữ bản app trước đó. Nếu bộ cài bị ngắt đột ngột, kiểm tra tiến trình cài trước khi gỡ file install.lock tại thư mục hệ điều hành. Nếu bước cài hoặc khởi động agent lỗi, khôi phục mã cũ; migration database cần kế hoạch tương thích và backup riêng.
Để xác minh bằng mã đã cài, dùng runtime và scripts/install-node.mjs của máy đó với --source trỏ gói mới; không chạy script lấy từ nguồn chưa tin cậy bằng quyền quản trị. Bản đầu cần đối chiếu vân tay phát hành ngoài gói. Khi máy phát hành chạy npm start, thay đổi mã được gom sau 3 giây yên, kiểm tra và tạo bản ký số tự động. Node cài gói ký số cùng khóa phát hành tự tải bản mới từ máy quản lý hoặc peer VPN, chờ lượt, đổi mã và kiểm tra agent/app/kho file/router. Lỗi khởi động quay về mã cũ; dữ liệu và khóa VPN giữ riêng. Máy chỉ cài mã nguồn trực tiếp cần chạy bộ cài gói ký số một lần để có bootstrap cập nhật. Cần nghiệm thu OS/VPN/Cloudflare, kiểm thử tải và migration tương thích; không tự rollback database.
Node cài bằng một lệnh
macOS · Windows · Linux — mỗi máy chạy cùng ứng dụng và kho file.
Cài node mới & hướng dẫn cấu hình
1. Sao chép mã nguồn & chạy bộ cài
Copy thư mục PaanChat đã kiểm thử sang máy mới. Mở Terminal hoặc PowerShell tại thư mục đó. Bộ cài tải Node.js đã ghim phiên bản và kiểm tra SHA-256, cài thư viện, tạo mã node mới rồi đăng ký tự khởi động.
macOS / Linux — tài khoản thường có quyền sudo:
sh ./install-node.shWindows — mở PowerShell bằng Run as administrator:
powershell -NoProfile -ExecutionPolicy Bypass -File .\install-node.ps1Dữ liệu node được tạo riêng ở máy đích. Bộ cài giữ .env và danh tính máy cũ ngoài triển khai. Gói ký số mang thư viện production; workchat-data.wcb đi kèm được giữ mã hóa, chỉ giải mã vào thư mục mới sau khi nhập mật khẩu ở localhost. Chạy lại bộ cài trên cùng máy giữ mã node và dữ liệu.
| Hệ điều hành | Thư mục cài | Tự chạy |
|---|---|---|
| macOS | /Library/Application Support/WorkChatNode | LaunchDaemon |
| Linux | /var/lib/workchat-node | systemd |
| Windows | %ProgramData%\WorkChatNode | Task Scheduler · SYSTEM |
Linux cần systemd và curl; macOS dùng launchd/curl sẵn có. Hỗ trợ CPU x64 và ARM64. Lần đầu cần Internet để tải runtime và công cụ hệ điều hành; thư viện production đã có trong gói ký số. Tự chạy cần hệ điều hành đã khởi động và ổ đĩa đã mở khóa; tắt chế độ ngủ khi làm máy chủ.
2. Ghép node vào Superadmin
- Bộ cài in đường dẫn cấu hình tại localhost có mã bảo vệ. Mở đường dẫn đó ngay trên máy mới; trang hiển thị mã node và vân tay khóa.
- Mở Superadmin của cụm qua tên miền HTTPS. Nhập lý do, tạo mã ghép bên dưới và dán vào trang localhost trong 10 phút. Mỗi mã chỉ ghép một node.
- Node xuất hiện ở danh sách sau khi ghép. So sánh mã node và vân tay khóa với máy mới trước khi kích hoạt.
HTTP qua IP LAN hiện tại dùng phát triển giao diện. Ghép máy khác cần tên miền HTTPS để bảo vệ mã ghép. Có thể thử trên localhost; không dùng chế độ thử cho Internet.
3. Cấu hình & kích hoạt
- Kết nối máy vào VPN riêng, gán IP cố định trong mạng cụm. Xem phần VPN phía dưới.
- Chuẩn bị PostgreSQL HA dùng chung, giữ khóa dữ liệu cũ và chuyển dữ liệu theo hướng dẫn. Cấu hình ít nhất ba kho file độc lập cho máy chủ quản lý; file mới cần hai bản sao.
- Bấm Cấu hình trên node. Nhập IP VPN, URL PostgreSQL mà mọi node truy cập được và chứng thư CA nếu dùng TLS. URL phải dẫn về đúng database của cụm; không dùng localhost của máy mới.
- Chọn Kích hoạt. Node nhận cấu hình đã mã hóa, tự chạy ứng dụng cổng 3002 và kho file cổng 3100 trên IP VPN. Chỉ cho các máy trong cụm truy cập hai cổng này.
- Cloudflare Tunnel trên native node trỏ tới router 127.0.0.1:3000; router phân tải các app qua IP VPN cổng 3002. Đặt PUBLIC_URL của các node là cùng tên miền người dùng; cấu hình load balancer và kiểm tra /health/ready.
Mỗi node nên dùng một proxy PostgreSQL khác trong cụm HA, cổng 6432 theo bộ triển khai Linux, cùng trỏ tới database primary hợp lệ. Tránh để tất cả node phụ thuộc một proxy duy nhất. Tên miền HTTPS chung và cân bằng tải phải tiếp tục hoạt động khi một máy mất mạng.
Trang hiển thị hostname, OS, CPU, RAM, dung lượng trống, IP, phiên bản, vân tay khóa, chế độ tự chạy, thời điểm báo về và trạng thái thật của app/kho file. IP mạng chỉ là thông tin tham khảo; người quản trị chọn IP VPN.
4. Hoạt động khi mất kết nối & quản lý
Agent báo về khoảng 15 giây/lần. Trên 65 giây không báo được sẽ hiện Mất liên lạc. Khi khởi động lại và trang quản lý đang offline, node chạy cấu hình đã duyệt lưu mã hóa tại máy; database, VPN và các bản sao file vẫn phải truy cập được.
Tạm dừng hoặc Thu hồi dừng ứng dụng/kho file tại lần liên lạc tiếp theo, giữ dữ liệu tại máy. Máy đang mất mạng chưa nhận được lệnh. Thu hồi không xóa khóa đã cấp khỏi máy cũ; khi máy bị mất quyền kiểm soát, cần thu hồi VPN/database, xoay khóa dùng chung và kiểm tra lại toàn cụm.
Các node ứng dụng/kho file có cùng vai trò. PostgreSQL HA vẫn có primary/standby và quorum để tránh ghi dữ liệu mâu thuẫn. Bộ cài chuẩn bị WireGuard và có thể áp dụng file VPN tải từ Superadmin; PostgreSQL HA và tài khoản Cloudflare cần cấu hình hạ tầng riêng; cấu hình hạ tầng Linux ở phần nâng cao bên dưới.
Nghiệm thu trên máy thật: reboot từng OS, kiểm tra app/kho file, gửi tin và file qua các node, ngắt một máy rồi đối chiếu dữ liệu, thử khôi phục từ backup. Trên Windows, file được flush trước khi ghi nhận nhưng Node không cung cấp directory fsync; cần thử mất điện trên NTFS và có backup độc lập. Tự đồng bộ phiên bản qua Internet cần bộ phát hành ký số và cơ chế triển khai riêng; hiện cập nhật bằng chạy lại bộ cài với mã nguồn đã duyệt.
Apple · launchd · systemd · Microsoft · Boot trigger · Node.js · SHA-256
Chỉ node đã ghép mới có trong danh sách. Tối đa hiển thị 250 node gần nhất. Trạng thái dựa trên lần báo về, không chứng nhận toàn cụm đã nghiệm thu.
Hạ tầng database HA · cấu hình nâng cao trên Linux
Cấu hình dưới đây là bản dự kiến. Lưu hoặc tải cấu hình không thay đổi máy chủ đang chạy. Cần triển khai và nghiệm thu trên các máy thật trước khi chuyển dữ liệu.
Địa chỉ dự kiến theo cấu hình
Các địa chỉ này là bản xem trước, chưa xác nhận node đã kết nối.
Hướng dẫn đặt các node
Bước 1 · Chuẩn bị máy và điền cấu hình
- Chuẩn bị ba máy Linux độc lập cho cấp 1, có Docker Engine + Compose, ổ dữ liệu bền vững, giờ hệ thống đồng bộ và kết nối WireGuard riêng. Ví dụ IP: 10.60.0.11, 10.60.0.12, 10.60.0.13. Bộ cấu hình dùng network_mode=host trên Linux.
- Nếu tách kho file cấp 2, chuẩn bị thêm ba máy Linux có IP VPN riêng: 10.60.0.21, 10.60.0.22, 10.60.0.23. Ba bản sao file cần nằm trên các máy độc lập.
- Kiểm tra /dev/watchdog và quyền thiết bị trên từng máy cấp 1. Lấy GID bằng lệnh dưới rồi điền vào ô GID watchdog của máy tương ứng. Patroni đặt watchdog mode=required; cần kiểm chứng fencing trên máy/VM thực tế trước khi vận hành.
stat -c '%g' /dev/watchdogĐiền tên miền gốc thuộc Cloudflare, subdomain chung (ví dụ chat), mạng VPN và IP từng máy. Chỉ nhập UUID Tunnel, không nhập token hoặc file credential.
Bước 2 · Build image và tạo bộ triển khai
Build từ mã nguồn đã kiểm thử, đẩy lên registry của đơn vị vận hành; ghi lại digest, xác minh chữ ký phát hành rồi điền image@sha256:… trong cấu hình. Dùng cùng digest PaanChat trên mọi máy ứng dụng và kho file.
docker build -t REGISTRY/workchat:RELEASE .
docker build -t REGISTRY/workchat-patroni:RELEASE deploy/cluster/patroni
docker push REGISTRY/workchat:RELEASE
docker push REGISTRY/workchat-patroni:RELEASEThay REGISTRY và RELEASE bằng registry/phiên bản của bạn. Bấm Lưu cấu hình node, sau đó Tải cấu hình triển khai. File workchat-topology.json không chứa khóa bí mật. Tại thư mục mã nguồn, dùng Node.js 24 trở lên để sinh bộ triển khai:
# Chỉ dùng cho cụm mới chưa có dữ liệu/khóa cũ:
node deploy/cluster/prepare.mjs /duong-dan/workchat-topology.json /duong-dan/workchat-deploy
# Chuyển/cập nhật cụm có dữ liệu: truyền bộ khóa chung đã bảo quản:
node deploy/cluster/prepare.mjs /duong-dan/workchat-topology.json /duong-dan/workchat-deploy-moi /kho-bi-mat/shared-keys.jsonBộ tạo từ chối ghi đè thư mục có sẵn; sinh thư mục quyền 0700, file quyền 0600. shared-keys.json chứa các khóa dùng chung và mật khẩu database, chỉ lưu trong kho bí mật của người vận hành. Khi chuyển dữ liệu cũ, PRIVATE_DATA_KEY và ARCHIVE_SIGNING_KEY phải khớp khóa cũ; không tạo bộ khóa mới thay thế.
Copy node1/ sang máy node1, node2/ sang máy node2, node3/ sang máy node3 qua SSH/SCP bảo mật. Nếu chọn máy lưu file riêng, copy file1/, file2/, file3/ sang ba máy cấp 2 tương ứng. Chỉ chuyển file cần thiết cho từng máy, không đưa shared-keys.json hoặc file .env lên web/Git.
Bước 3 · Mạng nội bộ và khởi động dịch vụ
Firewall phải chặn các cổng nội bộ từ Internet. Chỉ cho các IP VPN của cụm kết nối đúng dịch vụ; HTTP nội bộ đi trong WireGuard đã mã hóa.
| Dịch vụ | Cổng | Phạm vi |
|---|---|---|
| etcd | 2379, 2380 | Giữa ba máy cấp 1 |
| PostgreSQL / Patroni | 5432, 8008 | Giữa ba máy cấp 1 |
| Ứng dụng PaanChat | 3002 | Proxy trên ba máy cấp 1 |
| Kho file | 3100 | Máy cấp 1 tới máy lưu file |
| Proxy web | 3000 | Chỉ localhost |
| Proxy database | 6432 | Localhost & node trong VPN |
Trong thư mục nodeN trên mỗi máy cấp 1, khởi động database và proxy. Đợi đủ ba etcd, một PostgreSQL primary và standby đồng bộ; kiểm tra bằng công cụ Patroni của người vận hành.
docker compose -f compose.json up -d etcd postgres proxyKho file cùng cấp 1: chạy lệnh đầu trên cả ba máy nodeN. Kho file riêng: chạy lệnh đầu trong thư mục fileN trên cả ba máy cấp 2. Sau khi kho file sẵn sàng, chạy lệnh thứ hai trên ba máy cấp 1:
docker compose -f compose.json up -d storage
docker compose -f compose.json up -d appKiểm tra readiness bằng IP VPN của từng app, ví dụ dưới. /health/ready trả 200 khi app kết nối database có standby đồng bộ. Endpoint này không chứng nhận kho file đủ bản sao; cần thử tải file thật và kiểm tra repair.
curl --fail http://10.60.0.11:3002/health/readyChuyển dữ liệu SQLite cần tạm dừng ghi, backup nhất quán, giữ đúng khóa cũ, chạy migration dry-run rồi apply vào PostgreSQL chưa có người dùng. Xem phần Chuyển dữ liệu cũ trong hướng dẫn đầy đủ trước khi thực hiện. Không thay .env của máy đang phục vụ chỉ để thử cấu hình mới.
Bước 4 · Cloudflare và subdomain cho từng máy
- Đưa DNS của tên miền vào cùng tài khoản Cloudflare. Tạo ba named tunnel quản lý cục bộ, mỗi máy cấp 1 có UUID riêng. Cài cloudflared thành dịch vụ trên từng máy.
- File cloudflared.yml đã sinh có hai route: subdomain chung và nodeN.domain, cùng trỏ http://127.0.0.1:3000. Đặt credential tương ứng tại /etc/cloudflared/UUID.json; chỉ tài khoản chạy dịch vụ được đọc.
- Tạo CNAME nodeN.domain tới UUID.cfargotunnel.com của máy tương ứng. Bảng Địa chỉ dự kiến ở trên cung cấp hostname và target theo bản đang nhập.
- Tạo Public Load Balancer cho subdomain chung. Thêm ba endpoint UUID.cfargotunnel.com, Host header là subdomain chung; gắn HTTPS monitor cổng 443, đường dẫn /health/ready, mã kỳ vọng 200, Host header cùng địa chỉ chung.
- Subdomain chung do Load Balancer quản lý. Đăng nhập qua địa chỉ chung để phiên hoạt động xuyên máy; không tạo ba CNAME trùng tên. Bypass cache cho /api/*, /auth/* và /health/*.
Load Balancing là dịch vụ riêng của Cloudflare; cấu hình tài khoản/gói trước khi bật. Tài liệu chính thức: DNS, tunnel và load balancing
Bước 5 · Nghiệm thu, backup và cập nhật
- Qua địa chỉ chung, thử đăng nhập, gửi chat/file, đổi avatar, sửa nhóm và quyền. Đối chiếu dữ liệu từ máy khác; đồng bộ công việc hiện áp dụng các thiết bị của cùng tài khoản.
- Dừng một app, rồi một máy lưu file: kiểm tra truy cập và file mới còn hai bản sao. Dừng thêm máy lưu file: upload phải bị từ chối; đưa node trở lại và chạy công cụ storage:repair bằng app.env của cụm.
- Diễn tập mất PostgreSQL primary, mất kết nối VPN, mất điện và đầy ổ. Chỉ phía có quorum và standby hợp lệ được ghi. Đo thời gian khôi phục, kiểm dữ liệu đã xác nhận, watchdog/fencing và quá trình rejoin.
- Backup database + WAL/PITR, etcd, file và khóa vào kho riêng ngoài cụm; thử restore. Các bản sao trong cụm không thay thế backup.
- Cập nhật cùng image digest đã duyệt lần lượt từng app, chờ /health/ready rồi mới tới máy tiếp theo. Controller CI/CD tự triển khai và benchmark tải lớn còn cần tích hợp sau.
Hướng dẫn đầy đủ: migration, giới hạn hiện tại và nghiệm thu · Patroni: replication và quorum
Nhân viên dùng tài khoản PaanChat đã đăng ký và có mật khẩu. Chỉ cấp các quyền cần dùng; quyền thao tác cần quyền xem tab. Nhân viên không được tự nâng quyền hoặc cấp quyền ngoài phạm vi của mình.
Thư viện gồm nguồn chính thức liên quan đã chọn. Quét kiểm tra kết nối và thay đổi của các nguồn này, không xác nhận đã bao quát mọi văn bản hay đủ điều kiện cấp phép. Hồ sơ tạo ra là dự thảo để bổ sung, đối chiếu mẫu hiện hành và ký trước khi nộp.
Điền nhanh từ giấy tờ
Quét giấy đăng ký kinh doanh hoặc căn cước người đại diện để lấy thông tin soạn hồ sơ.
Có thể lưu thông tin đang soạn. Các mục có * cần có trước khi tạo hồ sơ. Không nhập mật khẩu hoặc khóa tích hợp vào biểu mẫu.
Tải HTML để mở xem và in thành PDF. Mỗi bản giữ thông tin doanh nghiệp tại lúc tạo; sửa doanh nghiệp không thay đổi hồ sơ cũ.
Hiện hỗ trợ tối đa 32 MB mỗi file. Dung lượng gói có thể lớn hơn. Thay đổi hạn mức áp dụng cho tài khoản đang dùng gói; file đã lưu được giữ lại. Upload file lớn qua nhiều phần sẽ được phát triển tiếp.
Cấu hình thanh toán tự động
- Chọn đơn vị thanh toán, đăng ký tài khoản doanh nghiệp và cung cấp tài liệu tích hợp, môi trường thử nghiệm, tên miền thanh toán và chính sách hoàn tiền.
- Lưu tên đơn vị và ghi chú ở bên dưới. Đây là thông tin chuẩn bị, chưa kích hoạt thanh toán.
- Kết nối adapter phía máy chủ: tạo đơn từ giá trong hệ thống, xác minh chữ ký webhook tại
/api/billing/webhook, đối soát số tiền, mã đơn và thông báo trùng. Khóa bí mật lưu ngoài mã nguồn; dùng cùng cấu hình trên các node. - Kiểm thử thanh toán thành công, thất bại, trùng thông báo và hoàn tiền. Sau khi kiểm thử, bật cổng thực tế và mở bán từng gói.
Cấp gói ưu đãi cho tài khoản
Thao tác này cấp gói trực tiếp, không ghi nhận thanh toán. Chọn Cơ bản để đưa về gói miễn phí.
Đơn thanh toán
Sau mỗi 5 công việc có một quảng cáo; danh sách dưới 5 việc đặt quảng cáo ở cuối. Chỉ hiển thị chiến dịch được bật và trong lịch chạy. Quảng cáo có nhãn riêng, không trở thành tin nhắn và không xuất vào bản lưu chat.
Vị trí & giá bán
Giá tính theo ngày cho từng vị trí. Chọn cả hai vị trí sẽ cộng hai mức giá. Giá đơn đã tạo được giữ nguyên. Chưa thu tiền khi chưa kết nối cổng thanh toán.
Hiển thị & luân phiên
Quy trình quản lý mini app
- Nhà phát triển nộp thông tin, địa chỉ chạy thử, mã nguồn / bản phát hành và chính sách riêng tư.
- Chọn Chờ duyệt để kiểm tra chức năng, nội dung, quyền đề xuất và chủ thể phát hành. Chỉ mở các liên kết sau khi kiểm tra nguồn.
- Duyệt hoặc từ chối với lý do. App đã duyệt vẫn cần Bật để xuất hiện trong cửa hàng. Có thể Tắt riêng từng app hoặc tắt toàn bộ menu App.
- Mỗi lần nhà phát triển sửa thông tin, app tạm ẩn và chờ duyệt lại. Quyền đề xuất chưa cấp quyền dữ liệu; mini app bên ngoài mở trong iframe sandbox không cùng origin, không được đọc dữ liệu PaanChat; có liên kết mở trang riêng nếu website không cho nhúng.
- Mỗi mini app có thư mục riêng. Sàn thương mại đã có chức năng cửa hàng/giỏ hàng/đơn/affiliate; Sàn bán buôn và Bảng tin còn Sắp ra mắt. Cổng API, sandbox và xác minh gói cài đặt sẽ bổ sung trước khi cấp quyền dữ liệu cho app bên thứ ba.
Hướng dẫn vận hành sàn
- Duyệt thông tin cửa hàng và chính sách đổi trả; sau đó duyệt từng sản phẩm. Bản sửa nội dung được gửi duyệt lại.
- Giá, phí vận chuyển, tồn kho và hoa hồng được máy chủ chốt khi tạo đơn. Giữ hàng 15 phút, giải phóng đơn hết hạn/hủy; thông báo thanh toán có chữ ký mới trừ tồn kho.
- Người bán chuẩn bị hàng và nhập vận đơn. Người mua xác nhận nhận hàng hoặc gửi yêu cầu hỗ trợ. Giải quyết tranh chấp với lý do và nhật ký.
- Affiliate không tự giới thiệu chính mình/người bán. Hoa hồng chưa được rút trước khi nhận hàng và hết thời hạn đổi trả. Hoàn tiền hủy hoa hồng; nếu đã chuyển cần đối soát.
- Yêu cầu rút được duyệt riêng. Chỉ nhà cung cấp xác nhận chuyển tiền mới hiển thị Đã chuyển tiền; cấu hình tên nhà cung cấp không thay thế tích hợp thật.
- Trước khi nhận giao dịch thật, cần hoàn thiện chính sách vận hành, hồ sơ doanh nghiệp/sàn, thanh toán, giao vận, đối soát người bán, hóa đơn và kiểm thử trên hạ tầng thực. Xem tab Tài liệu và Lộ trình.
Thiết lập cuộc gọi từ đầu
- Mở PaanChat qua HTTPS trên domain Cloudflare hoặc localhost. Địa chỉ HTTP của máy trong LAN không được trình duyệt cấp camera/micro.
- Trong chat riêng, bấm biểu tượng điện thoại hoặc camera. Trong công việc, hai nút này gọi các thành viên nhóm. Người nhận tự chọn nhận/từ chối; PaanChat không tự bật micro/camera.
- Hai thiết bị trao đổi tín hiệu nhỏ qua máy chủ, media truyền WebRTC. Trình duyệt thương lượng codec tương thích; Full HD là mức ưu tiên và có thể hạ theo mạng/thiết bị.
- STUN giúp tìm đường kết nối. TURN chuyển tiếp khi NAT/tường lửa chặn đường trực tiếp. Máy chủ ứng dụng không xử lý video; TURN cần đủ băng thông và cổng UDP/TCP. Cloudflare Tunnel cho web không thay TURN.
- Với Cloudflare TURN, tạo TURN Server app riêng trong Cloudflare rồi chọn Cloudflare TURN, nhập Key ID và API Token. Máy chủ giữ khóa gốc và cấp thông tin truy cập tạm thời cho từng người dùng đã đăng nhập. Địa chỉ STUN/TURN được điền tự động.
- Có thể tự vận hành coturn. Tạo khóa ngẫu nhiên riêng từ 24 ký tự, đặt cùng khóa ở static-auth-secret của coturn và ô Khóa TURN. Bật use-auth-secret, realm là domain TURN. Mở cổng 3478, 5349 khi dùng TLS và dải UDP relay đã cấu hình. Không dùng hostname proxy web thông thường cho TURN UDP.
- coturn dùng tài khoản tạm thời một giờ theo HMAC; Cloudflare dùng thông tin tạm thời đủ cho cuộc gọi tối đa bốn giờ. Khóa gốc được mã hóa trong database và không gửi cho trình duyệt. Cấu hình dùng chung giữa node, đồng bộ thời gian các máy.
- Gọi nhóm hiện kết nối nhiều cặp, tối đa 6 người. Mỗi người gửi nhiều luồng; nhóm lớn cần SFU như LiveKit/mediasoup và simulcast, không tăng giới hạn này để thay thế SFU.
- Không ghi âm hoặc lưu video. Tín hiệu SDP/ICE mã hóa khi lưu và xóa sau 2 phút. Kết nối WebRTC dùng DTLS-SRTP; bảo vệ thiết bị và phiên đăng nhập vẫn cần thiết.
Nhật ký thay đổi và quét dữ liệu lưu tối đa 90 ngày. Không ghi mật khẩu hoặc toàn văn tin nhắn.
Bấm vào biểu tượng để mở mini app. Các app sắp ra mắt sẽ hiện thông tin phát triển.