Quét sổ đỏ hàng loạt (OCR Project)
Module OCR Project giúp bạn số hóa sổ đỏ (giấy chứng nhận quyền sử dụng đất) bằng cách:
- Upload ảnh chụp sổ đỏ
- Ứng dụng tự động trích xuất thông tin (OCR)
- Lưu kết quả dưới dạng text + các trường có cấu trúc
- Gắn vị trí thửa đất trên bản đồ
Quy trình tổng quan
OCRProjectListScreen
├── Tạo dự án mới
├── Danh sách dự án (Table)
└── Click vào dự án → OCRProjectDetailScreen
├── Thông tin dự án
├── Chọn vị trí thửa đất trên bản đồ
├── Upload ảnh sổ đỏ
└── Lưu kết quả OCR
Bước 1: Tạo dự án mới
- Từ màn hình chính, click thẻ Quét sổ đỏ hàng loạt (nhóm KHÁC)
- Tại danh sách dự án, click Tạo dự án mới
- Điền thông tin:
- Tên dự án
- TODO: Các trường thông tin khác (kiểm tra trong code)
- Click Lưu
TODO: Chụp ảnh màn hình CreateForm.
Bước 2: Chọn vị trí thửa đất trên bản đồ
- Trong trang chi tiết dự án, click Chọn vị trí (MapModal)
- Trên bản đồ Mapbox, click vào vị trí của thửa đất
- Tọa độ sẽ được lưu lại
TODO: Chụp ảnh màn hình MapModal.
Bước 3: Upload ảnh sổ đỏ
- Click Upload ảnh → chọn ảnh chụp sổ đỏ (định dạng
.jpg,.png, TODO) - Có thể upload nhiều ảnh cùng lúc cho một dự án
- Ảnh sẽ được lưu trên backend Strapi
TODO: Chụp ảnh màn hình ImageUploader.
Yêu cầu ảnh:
- Ảnh rõ nét, không bị mờ
- Chụp thẳng, không bị nghiêng quá nhiều
- Đủ ánh sáng
- TODO: Yêu cầu kích thước tối thiểu
Bước 4: Chạy OCR và lưu kết quả
- Click Chạy OCR để ứng dụng trích xuất thông tin
- Kết quả sẽ hiển thị tại panel OCR Result Panel:
- Text: Toàn bộ text trích xuất được
- Structured fields: TODO (liệt kê các trường — kiểm tra code: tên chủ sử dụng, số thửa, diện tích, mục đích sử dụng, …)
TODO: Chụp ảnh màn hình OCRResultPanel.
- Bạn có thể chỉnh sửa các trường nếu OCR sai
- Click Lưu để lưu kết quả
Hạn chế theo gói license
| Gói | Giới hạn |
|---|---|
| BASIC | Tối đa 3 dự án OCR |
| PRO | 30 dự án / tháng |
| GOD | Không giới hạn |
Khi đạt giới hạn, bạn cần:
- Nâng cấp gói
- Hoặc xóa bớt dự án cũ
- TODO: Có thể archive dự án thay vì xóa?
Lỗi thường gặp & cách xử lý
| Lỗi | Nguyên nhân | Cách xử lý |
|---|---|---|
| Không upload được ảnh | File quá lớn | TODO: Giới hạn kích thước file |
| OCR trả về text rỗng | Ảnh chất lượng kém | Chụp lại ảnh rõ hơn |
| Không chọn được vị trí | Bản đồ chưa load | Đợi bản đồ load xong |
Liên kết
- Bản đồ — module bản đồ được dùng để chọn vị trí
- TODO: Link đến trang giá nếu cần nâng cấp license