Appearance
Quản lý Mã Vùng Trồng Lớn (Master Growing Areas)
Mã Vùng Trồng Lớn (Master Growing Area - MGA) là cấp quản lý cao nhất trong hệ thống phân cấp vùng trồng. Mỗi MGA chứa nhiều lô thửa (thửa canh tác) bên trong.
Mã Vùng Trồng Lớn (MGA)
└── Lô thửa 1 (Location)
│ └── Vụ mùa → Nhật ký canh tác
└── Lô thửa 2
└── ...Truy cập
- Menu: QUẢN LÝ VÙNG TRỒNG → Mã vùng lớn
- Đường dẫn:
/farm/master-areas - Vai trò: ADMIN, TENANT_ADMIN
1. Danh sách Mã Vùng Trồng
Bảng danh sách
| Cột | Mô tả |
|---|---|
| STT | Số thứ tự |
| Mã vùng | Mã định danh (VD: MVT-01, MVT-LNG-01) |
| Tên Vùng trồng | Tên gọi (nhấn vào để xem chi tiết) |
| Thông tin chung | Đơn vị sở hữu, Người quản lý, Loại cây trồng, Địa chỉ |
| Đội trưởng phụ trách | Danh sách đội trưởng được gán (hiển thị dạng tag) |
| Giới hạn diện tích | Diện tích tối đa cho phép (ha) |
| Thao tác | Nút Sửa và Chi tiết |
Thao tác nhanh
- Nhấn tên vùng trồng → Mở trang Chi tiết
- Nhấn nút Sửa → Mở popup chỉnh sửa
- Nhấn nút Chi tiết → Mở trang Chi tiết
2. Thêm Mã Vùng Trồng mới
Nhấn nút "+ Thêm mã vùng" (góc phải phía trên)
Thông tin cần nhập
| Trường | Bắt buộc | Mô tả |
|---|---|---|
| Mã vùng trồng | ✅ | Mã định danh duy nhất (VD: MVT-01). Không thể sửa sau khi tạo |
| Tên vùng trồng | ✅ | Tên gọi (VD: "Vùng Trồng Vải Lục Ngạn") |
| Tỉnh/Thành phố | Chọn từ danh sách hoặc nhập tùy chỉnh | |
| Phường/Xã | Tự động lọc theo Tỉnh đã chọn | |
| Địa chỉ chi tiết | Thôn, Xóm, Số nhà... | |
| Đơn vị sở hữu | Tên doanh nghiệp, HTX sở hữu | |
| Người quản lý | Tên người chịu trách nhiệm chung | |
| Loại cây trồng | Loại cây (VD: Lúa, Vải, Cà phê, Sầu riêng) | |
| Giới hạn diện tích (m²) | Mặc định: 100,000 m² (10 ha). Tổng diện tích lô thửa không được vượt quá giá trị này | |
| Danh sách Đội trưởng | Chọn một hoặc nhiều Đội trưởng phụ trách. Hỗ trợ tìm kiếm theo tên | |
| Danh sách Nhân viên KCS | Chọn Nhân viên KCS phụ trách kiểm tra chất lượng (tùy chọn) |
Thêm Đội trưởng nhanh
Nếu Đội trưởng chưa có tài khoản:
- Nhấn nút "+ Thêm Nhanh" bên cạnh dropdown Đội trưởng
- Popup tạo tài khoản Đội trưởng mới mở ra
- Nhập thông tin → Tạo xong → Đội trưởng tự động xuất hiện trong danh sách chọn
Lưu
Nhấn "Tạo mới" → Hệ thống tạo MGA và tự động gán Đội trưởng đã chọn.
💡 Lưu ý: Mã vùng trồng (
code) không thể thay đổi sau khi tạo. Hãy đặt mã theo quy ước nhất quán (VD:MVT-[Tỉnh]-[Số]).
3. Sửa Mã Vùng Trồng
Từ danh sách → Nhấn nút "Sửa" ở cột Thao tác
Thông tin có thể sửa
| Trường | Sửa được? | Ghi chú |
|---|---|---|
| Mã vùng trồng | ❌ | Không thể thay đổi |
| Tên vùng trồng | ✅ | |
| Tỉnh/Xã/Địa chỉ | ✅ | |
| Đơn vị sở hữu | ✅ | |
| Người quản lý | ✅ | |
| Loại cây trồng | ✅ | |
| Giới hạn diện tích | ✅ | Lưu ý: nếu giảm nhỏ hơn tổng diện tích lô thửa hiện có, hệ thống sẽ cảnh báo |
| Đội trưởng | ✅ | Thêm/Bớt đội trưởng. Ảnh hưởng đến quyền truy cập lô thửa |
| Nhân viên KCS | ✅ | Thêm/Bớt nhân viên KCS |
Nhấn "Cập nhật" để lưu thay đổi.
⚠️ Lưu ý quan trọng: Khi xóa một Đội trưởng khỏi MGA, đội trưởng đó sẽ mất quyền truy cập các lô thửa thuộc vùng này trên cả Web và Mobile.
4. Chi tiết Mã Vùng Trồng
Từ danh sách → Nhấn vào tên vùng trồng hoặc nút "Chi tiết"
Đường dẫn: /farm/master-areas/:id
4.1. Thông tin chung
Bảng hiển thị:
| Mục | Mô tả |
|---|---|
| Tên Vùng trồng | Tên gọi đầy đủ |
| Trạng thái | ACTIVE / INACTIVE |
| Vị trí | Xã, Tỉnh |
| Tổng diện tích hiện có | Tổng diện tích các lô thửa con (ha) — tính tự động |
| Giới hạn tối đa | Giới hạn diện tích đã cấu hình (ha) |
4.2. Bản đồ các Thửa canh tác
- Bản đồ vệ tinh (Mapbox) hiển thị toàn bộ lô thửa thuộc vùng
- Mỗi lô thửa hiện dạng Polygon (viền xanh, tô mờ)
- Nhấn vào Polygon → Popup hiển thị:
- Tên thửa
- Nông hộ phụ trách
- Đội trưởng
- Diện tích (m²)
- Nút "Xem 3D toàn vùng" → Mở chế độ xem 3D (MapLibre) với địa hình nổi
4.3. Danh sách Thửa canh tác
Bảng danh sách tất cả lô thửa thuộc vùng:
| Cột | Mô tả |
|---|---|
| STT | Số thứ tự |
| Tên thửa | Nhấn để xem chi tiết lô thửa |
| Nông hộ | Nông dân phụ trách |
| Đội trưởng | Đội trưởng quản lý |
| Diện tích | Diện tích (m²) |
5. Xóa Mã Vùng Trồng
⚠️ Hiện tại hệ thống không hỗ trợ xóa trực tiếp MGA từ giao diện nếu bên trong còn lô thửa. Để xóa:
- Chuyển hoặc xóa tất cả lô thửa con bên trong MGA trước
- Liên hệ Admin hệ thống để xóa MGA rỗng
- Hoặc chuyển trạng thái MGA sang INACTIVE bằng cách liên hệ quản trị
💡 Khuyến nghị: Thay vì xóa, hãy chuyển trạng thái sang INACTIVE để giữ lại lịch sử dữ liệu phục vụ truy xuất nguồn gốc và tuân thủ EUDR.
6. Mối quan hệ với các module khác
| Module | Liên kết |
|---|---|
| Lô thửa (Location) | Mỗi lô thửa bắt buộc thuộc 1 MGA |
| Đội trưởng | Gán vào MGA → Quản lý các lô thửa bên trong |
| Nông dân | Gán vào lô thửa thuộc MGA |
| KCS | Gán vào MGA → Kiểm tra các lô thửa |
| Vụ mùa | Tạo theo từng lô thửa thuộc MGA |
| EUDR | MGA cung cấp context vùng trồng cho báo cáo EUDR |