Tuân thủ EUDR — Xác định Vùng trồng không phá rừng

Hướng dẫn chi tiết về công nghệ và phương án TrustID sử dụng để xác định vùng trồng có thuộc khu vực phá rừng hay không — tuân thủ Quy định Chống phá rừng của EU (EUDR).

EUDR là gì?

EUDR (EU Deforestation Regulation — Quy định 2023/1115) là quy định bắt buộc của Liên minh Châu Âu, yêu cầu tất cả sản phẩm nông sản xuất khẩu vào EU phải chứng minh không liên quan đến phá rừng sau ngày 31/12/2020.

Sản phẩm áp dụng

Nhóm	Sản phẩm
Nông nghiệp	Cà phê, Ca cao, Đậu nành, Dầu cọ
Lâm nghiệp	Gỗ, Cao su
Chăn nuôi	Thịt bò

Yêu cầu dữ liệu EUDR

Yêu cầu	Mô tả	TrustID đáp ứng
Tọa độ GPS	Sai số < 4m	✅ GPS Walking Mode
Ranh giới Polygon	Vùng khép kín, không chỉ 1 điểm	✅ Polygon Drawing
Diện tích GIS	Tính từ tọa độ thực tế	✅ Turf.js auto-calc
Lịch sử mất rừng	Từ 31/12/2020 trở đi	✅ GFW API check
Xác nhận độc lập	Bên thứ 3 xác minh	✅ Trang xác thực công khai

Quy trình xác minh EUDR trong TrustID

┌───────────────────────────────────────────────────────────────────────────┐
│                    QUY TRÌNH XÁC MINH EUDR                               │
├───────────────────────────────────────────────────────────────────────────┤
│                                                                           │
│  BƯỚC 1            BƯỚC 2             BƯỚC 3            BƯỚC 4           │
│  Vẽ Polygon ──►  Xem 3D ──►  Gửi kiểm tra GFW ──►  Xác nhận độc lập   │
│  (Web/Mobile)     Terrain          (Tự động)           (Bên thứ 3)      │
│                                                                           │
│  ┌─────────┐    ┌─────────┐      ┌─────────┐        ┌─────────┐         │
│  │ Polygon │    │ MapLibre│      │  Global │        │ Trang   │         │
│  │ Drawing │──► │  3D Map │──►   │ Forest  │──►     │ Verify  │         │
│  │ + GPS   │    │ Terrain │      │  Watch  │        │ Công    │         │
│  │ Walking │    │ View    │      │  (GFW)  │        │ khai    │         │
│  └─────────┘    └─────────┘      └─────────┘        └─────────┘         │
│                                                                           │
│  Kết quả: COMPLIANT ✅  hoặc  NON_COMPLIANT ❌  hoặc  PENDING ⏳        │
└───────────────────────────────────────────────────────────────────────────┘

Bước 1: Vẽ Polygon ranh giới vùng trồng

1a. Vẽ trên Web (MapLibre 3D Drawer)

Đường dẫn: Quản lý Lô thửa → Chọn lô → "Vẽ ranh giới"

Vẽ polygon trên bản đồ

Công cụ	Mô tả
Chế độ Vẽ	Nhấn từng điểm trên bản đồ vệ tinh để tạo đỉnh polygon
Hoàn tất	Nhấn đúp (double-click) để đóng polygon
Chỉnh sửa	Kéo thả từng đỉnh để điều chỉnh
Hoàn tác (Undo)	Xóa đỉnh vừa thêm
Xóa	Xóa toàn bộ polygon đã vẽ
Lưu	Nhấn "Lưu ranh giới" → Gửi lên hệ thống

Thông tin tự động tính:

Diện tích (m² và ha) — tính bằng thư viện Turf.js
Số đỉnh (vertex)
Tọa độ trung tâm

1b. Vẽ trên Mobile (GPS Walking Mode)

Tính năng đặc biệt cho hiện trường — đi bộ quanh ranh giới để vẽ polygon tự động:

Mở lô thửa trên Mobile → "Vẽ ranh giới GPS"
Bật GPS → Đi bộ quanh ranh giới thực tế
Mỗi bước, nhấn "Thêm điểm" → Ghi tọa độ GPS
Hoàn thành vòng → Nhấn "Đóng polygon"

Thông số	Giá trị
Độ chính xác GPS	< 4m (High Accuracy)
Tối thiểu điểm	3 đỉnh
Hiển thị realtime	Tọa độ, Số điểm, Diện tích

💡 GPS Walking phù hợp EUDR vì đảm bảo sai số < 4m theo yêu cầu EU, và ranh giới phản ánh thực tế hiện trường.

Bước 2: Xem bản đồ 3D (MapLibre Terrain)

Sau khi vẽ polygon, hệ thống hỗ trợ xem 3D địa hình thực tế để đánh giá trực quan.

Đường dẫn: Chi tiết lô thửa → "Xem 3D"

Bản đồ 3D địa hình

Công nghệ sử dụng

Thành phần	Công nghệ	Mục đích
Engine bản đồ	MapLibre GL JS	Render 3D trong trình duyệt
Ảnh vệ tinh	Esri World Imagery	Lớp nền ảnh chụp từ vệ tinh
Dữ liệu địa hình	AWS Elevation Tiles (Terrarium)	Mô hình độ cao DEM
Hillshade	Tự tính từ DEM	Đổ bóng địa hình
Phân tích hình học	Turf.js	Tính diện tích, trung tâm

Tính năng 3D

Tính năng	Mô tả
Chuyển 2D ↔ 3D	Nút toggle 2D/3D Terrain trên header
Phóng đại địa hình	Thanh trượt 0.5× đến 3× (mặc định 1.5×)
Xoay / Nghiêng	Kéo chuột phải để xoay góc nhìn (pitch lên đến 80°)
Hiển thị tọa độ	Realtime lat/lng khi di chuột
Popup thông tin	Nhấn vào polygon → Hiện tên, nông hộ, diện tích

Phân tích địa hình

Hệ thống tự động phân tích:

Chỉ số	Mô tả
Độ cao thấp nhất	Elevation min (m)
Độ cao cao nhất	Elevation max (m)
Chênh lệch	Độ cao chênh (m)
Độ dốc trung bình	Avg slope (°)
Độ dốc tối đa	Max slope (°)
Biểu đồ cao độ	Elevation profile 40 điểm

🔍 Mục đích: Bản đồ 3D giúp đơn vị kiểm tra xác nhận trực quan rằng vùng trồng nằm trên đất nông nghiệp thực tế, không phải rừng tự nhiên hay đồi núi chưa khai phá.

Bước 3: Gửi kiểm tra GFW (Global Forest Watch)

Cách hoạt động (Tự động trong hệ thống)

Khi nhấn "Kiểm tra EUDR" trên lô thửa, hệ thống thực hiện quy trình 4 bước tự động:

1. Gửi Polygon ──► GFW Geostore API ──► Đăng ký vùng (geostore_id)
                                              │
2. Truy vấn SQL ──► UMD Tree Cover Loss ◄────┘
   "Mất rừng từ 2021?"     Dataset
                              │
3. Phân tích kết quả ◄───────┘
   - Tổng diện tích mất rừng (ha)
   - Tỷ lệ vi phạm (%)
   - Chi tiết theo năm
                              │
4. Cập nhật trạng thái ◄─────┘
   COMPLIANT / NON_COMPLIANT / ERROR

Chi tiết kỹ thuật

Bước	API	Mô tả
1. Đăng ký Geostore	`POST /geostore/`	Gửi GeoJSON polygon lên GFW, nhận lại `geostore_id`
2. Truy vấn mất rừng	`GET /dataset/umd_tree_cover_loss/latest/query`	Truy vấn UMD dataset cho geostore, lọc năm ≥ 2021
3. Tính tỷ lệ	Backend tính	`violationRate = (totalLossHa / farmAreaHa) × 100`
4. Kết luận	Backend lưu	Nếu tỷ lệ < 0.1% → COMPLIANT, ngược lại → NON_COMPLIANT

Trạng thái kiểm tra EUDR

Trạng thái	Ý nghĩa	Hành động
`NOT_CHECKED`	Chưa kiểm tra	Nhấn "Kiểm tra EUDR"
`PENDING`	Đang xử lý (hàng đợi Redis)	Chờ kết quả (tự động retry 3 lần)
✅ `COMPLIANT`	Hợp lệ — Không phát hiện phá rừng	Sẵn sàng xuất khẩu EU
❌ `NON_COMPLIANT`	Vi phạm — Phát hiện mất rừng > 0.1%	Cần điều tra thêm
`ERROR`	Lỗi kỹ thuật	Đặt lại và thử lại

Dữ liệu kiểm tra được lưu (Check Log)

Trường	Mô tả
`geostoreId`	ID vùng trồng trên GFW
`treeCoverLossHa`	Tổng diện tích mất rừng (ha)
`farmAreaHa`	Diện tích vùng trồng (ha)
`yearlySummary`	Mất rừng theo từng năm (2021, 2022...)
`dataSource`	UMD Tree Cover Loss (via GFW Data API)
`checkedAt`	Thời điểm kiểm tra

Bước 4: Trang xác nhận độc lập (Public Verify)

Trang xác thực EUDR công khai

Đường dẫn: /verify/eudr/:id — Không cần đăng nhập

Trang xác thực EUDR

Trang này cho phép đơn vị độc lập, đối tác quốc tế, cơ quan kiểm định truy cập để xác minh:

Nội dung hiển thị

Khu vực	Nội dung
Banner	Ảnh EUDR + Tên vùng trồng + Mã định danh
Kết quả EUDR	Logo COMPLIANT ✅ hoặc NON_COMPLIANT ❌ (hình ảnh lớn, nổi bật)
Mô tả	Giải thích bằng tiếng Việt về ý nghĩa kết quả
Phân tích chi tiết	Mất rừng phát hiện (ha) + Thời điểm xác thực
Thông tin vùng trồng	Chủ vùng, Địa chỉ, Diện tích GIS
Bản đồ Polygon	Bản đồ vệ tinh Mapbox + Polygon ranh giới (xanh = hợp lệ, đỏ = vi phạm)
Footer	Copyright + Slogan: Transparency · Sustainability · EUDR Ready

Cách sử dụng

Doanh nghiệp gửi link /verify/eudr/:id cho đối tác nhập khẩu EU
Đối tác mở link → Xem kết quả xác thực không cần tài khoản
Kết quả hiển thị: Trạng thái EUDR, diện tích mất rừng, bản đồ ranh giới
Đối tác xác nhận vùng trồng đạt chuẩn → Tiến hành nhập khẩu

🔐 Tin cậy: Dữ liệu trên trang xác thực được lấy trực tiếp từ API public (/public/eudr-verify/:id), không qua xác thực — đảm bảo tính minh bạch và khách quan.

Kiểm duyệt ranh giới (Admin Approval)

Ngoài GFW, hệ thống còn có quy trình kiểm duyệt bởi Admin:

Đường dẫn: /admin/farm-approvals

Bước	Người thực hiện	Hành động
1	Nông dân / Đội trưởng	Vẽ Polygon (Web hoặc GPS Walking)
2	Hệ thống	Lưu `pendingBoundary` (chưa active)
3	Admin	Xem polygon trên ảnh vệ tinh + 3D
4	Admin	Phê duyệt → Polygon thành `boundary` chính thức
		Hoặc Từ chối → Yêu cầu vẽ lại
5	Hệ thống	Tự động chạy EUDR check khi phê duyệt

⚠️ Tại sao cần kiểm duyệt? Đảm bảo polygon do người dùng vẽ chính xác với thực tế, tránh trường hợp vẽ sai vùng hoặc vẽ vào đất không thuộc quyền quản lý.

Xuất báo cáo EUDR (PDF)

API: GET /farm/eudr/:id/eudr-report

Hệ thống tự động tạo báo cáo PDF tuân thủ EUDR, bao gồm:

Nội dung	Chi tiết
Thông tin vùng trồng	Tên, Mã, Địa chỉ, Diện tích
Polygon GeoJSON	Tọa độ ranh giới đầy đủ
Kết quả GFW	Trạng thái, Tỷ lệ vi phạm, Chi tiết theo năm
Hình ảnh bản đồ	Ảnh vệ tinh + polygon
Chứng nhận	Dấu COMPLIANT / NON_COMPLIANT

Cấu hình EUDR (Admin)

Đường dẫn: /admin/eudr-config

Trường	Mô tả
API Key GFW	Khóa truy cập Global Forest Watch API
Endpoint	URL API GFW (mặc định: `https://data-api.globalforestwatch.org`)
Ngưỡng cảnh báo	Tỷ lệ % mất rừng cho phép (mặc định: 0.1%)
Khoảng thời gian	Kiểm tra từ năm nào (mặc định: 2021 theo EUDR cutoff)

Tuân thủ EUDR — Xác định Vùng trồng không phá rừng ​

EUDR là gì? ​

Sản phẩm áp dụng ​

Yêu cầu dữ liệu EUDR ​

Quy trình xác minh EUDR trong TrustID ​

Bước 1: Vẽ Polygon ranh giới vùng trồng ​

1a. Vẽ trên Web (MapLibre 3D Drawer) ​

1b. Vẽ trên Mobile (GPS Walking Mode) ​

Bước 2: Xem bản đồ 3D (MapLibre Terrain) ​

Công nghệ sử dụng ​

Tính năng 3D ​

Phân tích địa hình ​

Bước 3: Gửi kiểm tra GFW (Global Forest Watch) ​

Cách hoạt động (Tự động trong hệ thống) ​

Chi tiết kỹ thuật ​

Trạng thái kiểm tra EUDR ​

Dữ liệu kiểm tra được lưu (Check Log) ​

Bước 4: Trang xác nhận độc lập (Public Verify) ​

Trang xác thực EUDR công khai ​

Nội dung hiển thị ​

Cách sử dụng ​

Kiểm duyệt ranh giới (Admin Approval) ​

Xuất báo cáo EUDR (PDF) ​

Cấu hình EUDR (Admin) ​

Tiếp theo ​