Module DMap (Mobile) — Tổng quan
DMap — "digital map" — là nơi chứa bản vẽ của dự án trên điện thoại của bạn. Đây là module bạn mở ra để tra DMap ngay tại công trường, mang DMap theo dùng offline, xem mọi lỗi dưới dạng điểm ghim đúng vị trí, và ghi nhận lỗi mới bằng cách bấm vào đúng chỗ đó trên DMap.
Mỗi mục trong menu DMap là một DMap (layout), với kích thước và góc xoay riêng.

DMap và Issue là hai nửa của cùng một công việc
Mỗi điểm ghim trên DMap chính là một Issue. Bấm vào chỗ trống trên DMap đúng là cách tạo issue trên mobile — xem Tạo Issue.
Hai module chia việc như sau:
| Bạn muốn… | Vào |
|---|---|
| Xem vấn đề nằm ở đâu | DMap — DMap kèm các điểm ghim |
| Xem vấn đề là gì, dạng danh sách lọc và thao tác được | Issue |
| Ghi nhận một lỗi mới | DMap — bấm vào vị trí trên DMap |
Khái niệm chính
| Thuật ngữ | Ý nghĩa |
|---|---|
| DMap | Bản vẽ / mặt bằng của dự án hiển thị trong app. Mỗi mục trong menu DMap là một DMap |
| Layout | Một DMap đơn lẻ với kích thước và góc xoay riêng, có thể chứa nhiều điểm ghim |
| Điểm ghim (Pin) | Điểm được đánh dấu trên DMap, đại diện cho một đối tượng — hiện luôn là Issue / lỗi — tô màu theo trạng thái |
| Điểm ghim nháp (Draft pin) | Điểm ghim bạn vừa tạo lúc offline hoặc chưa gửi đi: hiện ngay lập tức kèm biểu tượng bút chì hoặc vòng xoay trong lúc chờ đồng bộ (chỉ có trên mobile) |
| Đối tượng liên kết | Thứ mà điểm ghim trỏ tới. Hiện chỉ hỗ trợ Issue |
| DMap Label | Nhãn ngắn trên điểm ghim — tối đa 3 ký tự chữ và số, viết hoa |
| Legend (Chú giải) | Bảng nổi ở đáy màn hình DMap: màu trạng thái và số điểm ghim của từng trạng thái |
| Chế độ tải | Create (gói nhẹ để ghi nhận lỗi offline) hoặc Review (gói đầy đủ để xem xét và thao tác offline) |
| Quyền đọc / ghi | Hệ thống cấp theo từng DMap: quyền đọc cho phép xem và tải gói Review; quyền ghi cho phép tải gói Create và ghi nhận lỗi |
Bạn làm được gì
- Duyệt và tìm kiếm DMap của dự án, nhóm theo bộ môn, Drawing Set hoặc Drawing Type.
- Tải DMap về máy để mở được khi không có sóng — có hai chế độ, xem Tải DMap offline.
- Xem DMap toàn màn hình với thao tác kéo và phóng to, đúng tỉ lệ và góc xoay.
- Xem các điểm ghim — mỗi lỗi ở đúng vị trí, tô màu theo trạng thái, kèm chú giải và số đếm.
- Lọc điểm ghim theo trạng thái, tình trạng đồng bộ, người được giao và người tạo.
- Ghi nhận lỗi — bấm vào DMap, chụp ảnh, issue được tạo ngay tại vị trí đó.
- Làm tất cả những việc trên khi offline, mọi thứ tự đồng bộ khi có mạng trở lại.
Màu của điểm ghim
Màu điểm ghim đến hoàn toàn từ trạng thái của issue — không phải từ màu đặt riêng cho đối tượng:
| Trạng thái | Màu |
|---|---|
| Opened / Reopened | 🔵 Xanh dương |
| Done | 🟠 Hổ phách |
| Closed | 🟢 Xanh lá |
| Cancelled | ⬛ Xám đậm |
| Overdue | 🔴 Đỏ |
Overdue được tính tự động: issue đang Opened hoặc Reopened mà đã qua due date sẽ chuyển sang màu đỏ.
:::note Overdue có trên DMap, nhưng không có ở danh sách issue Chú giải DMap có hiển thị số lượng overdue, vì điểm ghim biết due date của issue. Còn danh sách issue trên mobile chủ ý không mang due date nên không có cờ overdue — xem Tổng quan Issue. :::
Điểm ghim nằm ở đâu
Vị trí điểm ghim được lưu trong không gian trang của chính DMap, chuẩn hóa về khoảng 0–1 để hiển thị, và xử lý đúng cho cả bốn góc xoay (0° / 90° / 180° / 270°). Nhờ vậy điểm ghim vẫn nằm đúng vết nứt đó ở mọi mức zoom, trên mọi màn hình.
Không bao giờ dùng GPS của thiết bị — "ở đâu" luôn có nghĩa là ở chỗ nào trên DMap.