Quy trình canh tác, Vụ mùa & Vật tư

Quản lý quy trình canh tác mẫu, chu kỳ vụ mùa, và danh mục vật tư nông nghiệp.

---

1. Quy trình canh tác mẫu (Templates)

Truy cập

• Menu: QUẢN LÝ CANH TÁC → Quy trình mẫu
• Đường dẫn: /farm/templates
• Vai trò: ADMIN, TENANT_ADMIN

Mô tả

Quy trình mẫu là bộ các bước canh tác chuẩn cho từng loại cây trồng. Ví dụ: "Quy trình VietGAP cho Vải thiều", "GlobalGAP cho Sầu riêng".

Tạo quy trình mẫu

1. Nhấn "+ Tạo quy trình"
2. Nhập: Tên quy trình, Loại cây trồng, Mô tả
3. Thêm các giai đoạn (stages): Xuống giống, Chăm sóc, Thu hoạch...
4. Trong mỗi giai đoạn, thêm các công việc (tasks):
   • Tên công việc (VD: Bón phân NPK)
   • Ngày thực hiện (tính từ ngày bắt đầu vụ)
   • Vật tư cần dùng
   • Bắt buộc / Tùy chọn
5. Nhấn "Lưu"

---

2. Chu kỳ vụ mùa (Crop Cycles)

Truy cập

• Menu: QUẢN LÝ CANH TÁC → Mùa vụ
• Đường dẫn: /farm/cycles
• Vai trò: ADMIN, TENANT_ADMIN, FARMER

Tạo vụ mùa mới

1. Nhấn "+ Tạo vụ mùa"
2. Chọn: Lô thửa, Quy trình mẫu, Ngày bắt đầu
3. Hệ thống tự động sinh lịch công việc dựa trên quy trình mẫu
4. Nhấn "Tạo"

Trạng thái vụ mùa

Trạng thái	Mô tả
Active	Đang canh tác
Harvested	Đã thu hoạch
Closed	Đã kết thúc

---

3. Vật tư nông nghiệp / Kho nông trại

Truy cập

• Menu: CANH TÁC → Vật tư & Kho nông trại
• Đường dẫn: /farm/materials
• Vai trò: ADMIN, TENANT_ADMIN

Đây là vật tư canh tác như phân bón, thuốc BVTV, giống. Không nhầm với lô nguyên liệu sản xuất trong nhóm menu NGUYÊN LIỆU của chuỗi cung ứng.

Danh sách vật tư

Cột	Mô tả
Mã vật tư	Mã hệ thống, ví dụ PB-001, TB-001, GI-001, VT-001
Tên vật tư	Tên phân bón, thuốc BVTV, giống hoặc vật tư khác
Loại	Phân bón / Thuốc BVTV / Giống / Khác
Tồn kho	Số lượng hiện có theo đơn vị tính
Trạng thái	Bật/Tắt sử dụng
Mô tả	Ghi chú bổ sung

Placeholder ảnh cần chụp: Màn hình Quản lý Vật tư & Kho, có bộ lọc loại/trạng thái, bảng tồn kho và các nút sửa, nhập kho, phân bổ.

Ảnh: farm-material-management.png

Tạo vật tư mới

1. Nhấn "Thêm vật tư mới".
2. Chọn Loại: FERTILIZER, PESTICIDE, SEED, OTHER.
3. Nhấn nút lấy mã gợi ý nếu muốn hệ thống sinh mã:
   • PB-xxx cho phân bón.
   • TB-xxx cho thuốc BVTV.
   • GI-xxx cho giống.
   • VT-xxx cho vật tư khác.
4. Nhập tên vật tư, đơn vị tính, mô tả và trạng thái.
5. Nhấn Tạo mới.

Nhập kho và phân bổ vật tư

Thao tác	Ý nghĩa
Nhập kho	Tăng tồn vật tư, tạo giao dịch IMPORT
Phân bổ / Xuất kho	Giảm tồn vật tư, tạo giao dịch ALLOCATE; hệ thống chặn nếu tồn không đủ
Bật/Tắt	Ẩn vật tư khỏi luồng sử dụng khi không còn dùng

Khi xác nhận công việc canh tác, người dùng có thể chọn vật tư đã dùng và nhập số lượng. Hệ thống ghi nhận vật tư vào nhật ký và có thể trừ tồn thông qua giao dịch phân bổ.

---

4. Công việc hàng ngày (Daily Tasks)

Truy cập

• Menu: QUẢN LÝ CANH TÁC → Việc hôm nay
• Đường dẫn: /farm/tasks
• Vai trò: ADMIN, TENANT_ADMIN, FARMER

Mô tả

Danh sách tất cả công việc canh tác, được sinh tự động từ quy trình mẫu hoặc tạo thủ công.

Cột	Mô tả
Công việc	Tên task
Lô thửa	Thuộc lô nào
Ngày	Ngày thực hiện
Người làm	Nông dân thực hiện
Trạng thái	Chờ / Hoàn thành / Quá hạn
Vật tư	Vật tư đã sử dụng

---

5. Lô nguyên liệu (Batches) & Kiểm duyệt ranh giới

Lô nguyên liệu (/farm/batches)

Sau khi thu hoạch, tạo lô nguyên liệu liên kết toàn bộ lịch sử canh tác.

Kiểm duyệt ranh giới (/admin/farm-approvals)

• Vai trò: ADMIN
• Admin kiểm tra và phê duyệt Polygon do nông dân/đội trưởng vẽ
• Trạng thái: Chờ duyệt → Phê duyệt / Từ chối

---

Tiếp theo

• Tồn kho →
• Sản xuất & Đóng gói →