Kết nối Server (Connect Server)

Đồng bộ dữ liệu đo bóc giữa các máy team — chia sẻ bảng giá, danh mục công tác, định mức qua server trung tâm.

Ứng dụng: team 5-10 người làm chung dự án, mỗi người 1 phần đo bóc, cần dùng chung bảng đơn giá / danh mục công tác.

4 lệnh trong nhóm

DVD Cons → nhóm Hệ thống kết nối có:

Lệnh	Mục đích	License
Kết nối Server	Login + đồng bộ dữ liệu từ server	Premium
Ngắt kết nối	Disconnect, dùng offline	Free
Gửi Định dạng	Push format/style của file hiện tại lên server làm template	Premium
Quản trị viên	Admin panel (chỉ user role admin)	Premium

Kết nối Server

DVD Cons → nhóm Hệ thống kết nối → click Kết nối Server.

Bước 1 — Lần đầu setup

Dialog hỏi thông tin server:

• Server URL — vd: https://server.dvdpm.net/api (do admin team cung cấp).
• Email + Password — tài khoản của bạn trên server.
• Workspace — chọn workspace của team (vd: "Dự án A", "BCH Hà Nội").

Click Đăng nhập → server xác thực → trả JWT token (lưu trong registry).

Bước 2 — Đồng bộ data

Sau khi login, dialog hiện các data set có sẵn trên server:

Tên data	Loại	Cập nhật cuối	Action
BangGia_2026	Sheet (Excel)	2026-05-10	[Download]
DanhMucCongTac	Sheet (Excel)	2026-04-22	[Download]
DinhMucNhanCong	Sheet (Excel)	2026-03-15	[Download]
Format_Macro_QS	Style template	2026-05-12	[Apply]

Click Download → addin tải sheet từ server, chèn vào workbook hiện tại. Click Apply → apply style template (font, color, border) vào sheet đang chọn.

Bước 3 — Upload thay đổi

Nếu bạn đã update bảng giá local → click Push trên hàng tương ứng → addin upload sheet lên server làm bản mới.

Conflict

Nếu sheet trên server đã có version mới hơn (do người khác push trước bạn) → addin hiện dialog conflict:

• Force overwrite — ghi đè (mất thay đổi của người khác).
• Pull theirs first — tải về của họ → merge thủ công → push lại.
• Cancel — không làm gì.

Ngắt kết nối

DVD Cons → nhóm Hệ thống kết nối → click Ngắt kết nối.

Disconnect khỏi server:

• Xóa JWT token local.
• Stop heartbeat (4 tiếng/lần).
• Các sheet đã download vẫn còn trong workbook (chỉ ngắt sync, không xóa data).

Sau khi disconnect, các lệnh Kết nối Server / Push / Pull đều fail cho đến khi reconnect.

Gửi Định dạng

DVD Cons → nhóm Hệ thống kết nối → click Gửi Định dạng.

Push format/style của workbook hiện tại lên server làm template chung cho team:

• Font, font size, color theme.
• Number format (mặc định cho cell tiền VND, m³, m², ...).
• Border style.
• Header row style (bold + background).

Server lưu thành template "Style_Date_UserName" → các thành viên khác Pull về sẽ thấy có file format mới.

Premium + Admin role

Lệnh "Gửi Định dạng" yêu cầu license active + role "Editor"/"Admin" trên workspace.

Quản trị viên

DVD Cons → nhóm Hệ thống kết nối → click Quản trị viên.

Admin panel (chỉ user role Admin mới mở được):

Tab Users

• List user trong workspace.
• Add user (email + role).
• Remove user.
• Change role (Viewer / Editor / Admin).

Tab Data sets

• CRUD bảng giá / danh mục / định mức.
• View version history.
• Rollback version cũ.

Tab Audit log

• Lịch sử thay đổi (ai sửa cái gì, khi nào).
• Filter theo user / date / action.

Tab Workspace settings

• Tên workspace.
• Logo upload.
• Default style template.

Backend infrastructure

DVDAddin Connect Server backend:

• Cloudflare Workers + D1 SQLite (cùng infra với license server).
• JWT auth (RS256).
• Per-workspace data isolation.
• Real-time conflict detection via ETag.

Self-hosting

Doanh nghiệp lớn có thể tự host backend (open source planned for 2027). Hiện tại dùng SaaS của dvdpm.net.

Quản lý API key + tài khoản

Trong Preferences → Server:

• Server URL (mặc định https://server.dvdpm.net/api).
• Lưu credentials (tick để không phải login mỗi lần).
• Auto-sync interval (5/15/30/60 phút).
• Conflict resolution default (Manual / Take theirs / Take mine).

License gating

Lệnh	Free	Activated/Trial
Kết nối Server	✗	✓
Ngắt kết nối	✓	✓
Gửi Định dạng	✗	✓
Quản trị viên	✗	✓ (admin role)

Khắc phục sự cố

"Cannot connect to server"

• Network → firewall / proxy chặn server.dvdpm.net.
• Server URL sai (kiểm tra trong Preferences).

"Invalid credentials"

• Email/password sai.
• Account bị admin lock → liên hệ admin.

"Sync conflict — both modified"

• Người khác sửa cùng sheet → chọn resolve strategy (Force overwrite / Pull first / Cancel).

Sync chậm

• Bảng giá > 10,000 dòng → upload/download chậm 30s-2 phút.
• Mạng chậm → chia sheet nhỏ, sync từng phần.

Liên quan

• Bản quyền — license cho phép sync.
• Preferences → Server — config server URL + auto-sync.
• QS Tools — Xem công thức, Truy vết Lookup (data analysis sau sync).