Tính Toán DRC & Tính Lương — Tổng Hợp
1. TÍNH TOÁN DRC (Dry Rubber Content / Hàm lượng cao su khô)
1.1. Tổng quan
DRC được sử dụng trong 2 ngữ cảnh riêng biệt:
| Ngữ cảnh | Mục đích | Collection Directus |
|---|---|---|
| Kiểm tra chất lượng (KCS) | Ghi nhận DRC theo lô cao su | drc_evaluation |
| Kho hàng | Tính quy khô khi nhập mủ | drc_percent trên inventory_input |
1.2. Các file liên quan
Quality Control — DRC Evaluation
| File | Mô tả |
|---|---|
features/quality-control/types/index.ts:13-22 | Interface DrcEvaluation |
features/quality-control/services/quality-control-service.directus.ts | Service CRUD drc_evaluation |
features/quality-control/pages/quality-control-screen.tsx:27-494 | Screen kết hợp (tab KCS + tab DRC) |
app/(app)/drc.tsx:1-332 | Screen DRC độc lập (hidden tab) |
features/quality-control/components/quality-control-card.tsx:32-117 | Card hiển thị DRC |
Warehouse — DRC trong nhập kho
| File | Mô tả |
|---|---|
features/warehouse/types/index.ts:50,60-74 | Field drc_percent trên InventoryInput |
features/warehouse/components/warehouse-form.tsx:400-414 | Auto-calc quy khô |
features/warehouse/utils/pdf-export.ts:85-147 | PDF "PHIẾU KẾT QUẢ ĐO DRC" |
features/warehouse/hooks/use-warehouse-analytics.ts:106-180 | Weighted-average DRC |
features/warehouse/components/warehouse-analytics-kpi.tsx:49-80 | KPI card hiển thị DRC TB |
Dashboard
| File | Mô tả |
|---|---|
features/dashboard/pages/general-report-screen.tsx:69-77 | DRC trung bình (simple avg) |
1.3. Data Model
// Quality Control
interface DrcEvaluation {
id: string;
evaluation_date: string; // ISO date
drc_content: number; // DRC% (vd: 35.5)
tapping_plot: { id: string; plot_name: string; plot_code: string; };
}
// Warehouse
interface InventoryInput {
quantity: number; // Quy khô (kg)
wet_quantity: number; // Mủ tươi (kg)
drc_percent: number; // DRC%
}
1.4. Công thức tính
A. Công thức phòng lab (in trên PDF)
% DRC = [m2 / m1] × 70
- m1 = trọng lượng mẫu mủ tươi trước khi sấy
- m2 = trọng lượng mẫu mủ sau khi sấy
- 70 = hằng số chuẩn hóa phương pháp đo
Kết quả được nhập thủ công vào app từ phòng lab.
B. Auto-calc quy khô (Form nhập kho)
Quy khô (kg) = Mủ tươi (kg) × DRC% / 100
Ví dụ: 1000 kg mủ tươi × 35% = 350 kg quy khô.
C. DRC trung bình có trọng số (Analytics KPI)
weightedDrcSum += wetQty × drc
averageDrc = weightedDrcSum / totalWet
Tính theo MTD (đầu kỳ đến hiện tại) và YTD (đầu năm đến hiện tại).
D. DRC trung bình đơn giản (Dashboard)
avgDrc = sum(drc_content) / count(records)
1.5. Luồng dữ liệu
[Phòng Lab] [KCS Screen] [Directus DB]
m1, m2 (ngoại) ──────→ User nhập DRC% theo lô ──────→ drc_evaluation
│
[Dashboard] │
Simple avg ←──────────────┘
[Mủ nhập kho] [Form Kho] [Directus DB]
Mủ tươi (kg) ──────→ User nhập DRC% + STL ──────→ inventory_input
DRC% (lab) Auto: quy khô = tươi × DRC/100
│
↓
[Analytics KPI]
Weighted avg DRC by wet qty
1.6. Vấn đề cần lưu ý
-
Hai module DRC không liên kết:
drc_evaluation(KCS) vàdrc_percent(Kho) là hai hệ thống riêng, không có FK liên kết. Cùng một lô có thể có 2 giá trị DRC khác nhau. -
Phương pháp tính TB khác nhau: Dashboard dùng simple average, Warehouse Analytics dùng weighted average → kết quả có thể khác nhau khi so sánh.
-
Không validate khoảng DRC: Form chấp nhận mọi giá trị số (kể cả âm hoặc >100%). Thực tế DRC tự nhiên thường 25-45%.
-
Service mock còn tồn tại:
quality-control-service.tschứa data cứng (35.5, 32.8, 38.2...) dù barrel đã redirect sang.directus. -
Chưa có phân quyền KCS: Yêu cầu kinh doanh nói KCS nhập DRC, nhưng UI không chặn role — mọi user đều có thể tạo/sửa/xóa.
-
Công thức PDF vs auto-calc: PDF in
% DRC = [m2/m1] × 70, auto-calc dùngquy khô = tươi × DRC% / 100. Cần đảm bảo DRC% nhập vào là kết quả đã nhân 70, không phải ratio thô.
2. TÍNH LƯƠNG (Salary Calculation)
2.1. Tổng quan
Lương được tính hoàn toàn dựa trên sản lượng (sản phẩm mủ × đơn giá). Không có lương cơ bản, không phụ cấp ngày công.
2.2. Các file liên quan
Core
| File | Mô tả |
|---|---|
features/salary-calculation/types/index.ts:1-83 | Type definitions |
features/salary-calculation/services/salary-auto-calculator.ts:1-298 | LOGIC TÍNH LƯƠNG CHÍNH |
features/salary-calculation/services/salary-service.ts:1-233 | CRUD salary_calculation |
features/salary-calculation/services/salary-settings-service.ts:1-53 | Cài đặt tỷ lệ BHXH |
features/salary-calculation/services/salary-advance-service.ts:1-42 | Tạm ứng |
Screens
| File | Mô tả |
|---|---|
features/salary-calculation/pages/salary-screen.tsx:1-192 | Screen xem lương (leader/worker) |
features/salary-calculation/pages/production-salary-screen.tsx:1-246 | Mega-Dashboard (lương + ĐT + KH + CC) |
features/salary-calculation/pages/salary-settings-screen.tsx:1-142 | Cài đặt tỷ lệ bảo hiểm |
Components
| File | Mô tả |
|---|---|
components/salary-card.tsx:1-132 | Card lương có thể mở rộng |
components/salary-form.tsx:1-286 | Form nhập/sửa lương thủ công |
components/salary-preview-dialog.tsx:1-114 | Dialog preview trước khi lưu |
components/salary-dashboard.tsx:1-263 | Dashboard tổng hợp |
components/salary-review-dashboard.tsx:1-259 | Review lương theo team/năm |
components/worker-salary-detail-modal.tsx:1-169 | Modal chi tiết lương theo tháng |
components/month-production-accordion.tsx:1-167 | Accordion tháng (SL × ĐG = Thành tiền) |
Hooks
| File | Mô tả |
|---|---|
hooks/use-auto-salary-calculation.ts:1-115 | State machine: input → preview → confirm/save |
2.3. Data Model
// salary_calculation (bảng chính)
{
id: number;
month: number; // 1-12
year: number;
worker: FK → workers;
production_team: FK → production_teams;
gross_salary: number; // Lương sản phẩm
bhxh_amount: number; // BHXH
bh_yt_amount: number; // BHYT
bh_tn_amount: number; // BHTN
cdp_amount: number; // Công đoàn
advance_amount: number; // Tạm ứng
net_salary: number; // Lương thực lĩnh
total_salary: number; // = net_salary (alias)
}
// salary_details (chi tiết theo loại mủ)
{
salary_calculation: FK → salary_calculation;
latex_type: string; // 'fresh' | 'coagulated' | 'secondary'
quantity_kg: number;
price_per_kg: number; // snapshot giá
amount: number; // quantity × price
}
// salary_settings (cấu hình tỷ lệ)
{
bhxh_rate: number; // mặc định 8%
bhyt_rate: number; // mặc định 1.5%
bhtn_rate: number; // mặc định 1%
cdp_rate: number; // mặc định 1%
}
// salary_advances (tạm ứng)
{
worker: FK → workers;
amount: number;
advance_date: string;
status: 'pending' | 'approved' | 'deducted';
}
2.4. Công thức tính lương
BƯỚC 1: Lương sản phẩm (GROSS)
Với mỗi bản ghi latex_production:
amount = quantity_kg × price_per_kg
(price: ưu tiên applied_price trên bản ghi, nếu không có → tra latex_prices theo ngày)
gross_salary = Σ(all amounts)
BƯỚC 2: Khấu trừ bảo hiểm (dựa trên insurance_salary, KHÔNG phải gross)
BHXH = insurance_salary × 8% (mặc định)
BHYT = insurance_salary × 1.5% (mặc định)
BHTN = insurance_salary × 1% (mặc định)
BƯỚC 3: Kinh phí công đoàn (CDP)
CDP = (gross_salary - BHXH - BHYT - BHTN) × 1% (mặc định)
BƯỚC 4: Tạm ứng
advance_amount = Σ(salary_advance.amount trong tháng)
BƯỚC 5: Lương thực lĩnh (NET)
net_salary = gross - BHXH - BHYT - BHTN - CDP - advance
Ví dụ minh họa:
Worker có insurance_salary = 5,000,000 VND
Tháng 1 sản xuất: 500kg mủ tươi × 30,000/kg = 15,000,000 VND
Gross: 15,000,000
BHXH: 5,000,000 × 8% = 400,000
BHYT: 5,000,000 × 1.5% = 75,000
BHTN: 5,000,000 × 1% = 50,000
CDP: (15,000,000 - 525,000) × 1% = 144,750
Tạm ứng: 2,000,000
NET: 15,000,000 - 400,000 - 75,000 - 50,000 - 144,750 - 2,000,000
= 12,330,250 VND
2.5. Luồng dữ liệu
Path A: Tự động tính (Leader)
1. Mở SalaryScreen → SalaryReviewDashboard
hoặc useAutoSalaryCalculation hook
2. TÍNH TOÁN:
calculateTeamReview(teamId, year)
→ Lấy toàn bộ CN trong team
→ Lấy toàn bộ latex_production trong năm
→ Lấy toàn bộ latex_prices
→ Tính gross tích lũy từng CN
calculateForWorker(workerId, month, year)
→ Lấy settings, worker, advances, productions, prices (Promise.all)
→ Tính chi tiết theo loại mủ với giá động
→ Tính BH, CDP, tạm ứng
→ Trả AutoCalculationResult
3. XEM TRƯỚC:
useAutoSalaryCalculation → previewData → SalaryPreviewDialog
Hiển thị: chi tiết theo loại mủ → gross → các khoản trừ → net
4. XÁC NHẬN/LƯU:
handleConfirmSave() → SalaryService.createWithDetails()
→ Tạo salary_calculation + salary_details trong Directus
Path B: Nhập thủ công (Mega-Dashboard)
1. Mở /mega-dashboard → SalaryScreen
2. Click "+" → SalaryForm dialog
3. Nhập: Tháng, Năm, CN, Team, Gross, Tạm ứng
4. BH hiển thị tự động (read-only)
5. Net = Gross - BH - Tạm ứng (auto-calc trong useEffect)
6. Submit → SalaryService.createSalaryCalculation()
Path Xem lương (Worker tự xem)
1. Worker mở /salary-calculation → SalaryScreen
2. Load salary_calculation + details cho năm được chọn
3. Hiển thị SalaryCard cho từng tháng
4. Mở rộng card: loại mủ → gross → các khoản trừ → net
2.6. Tích hợp với các module khác
| Module | Tích hợp | Chi tiết |
|---|---|---|
| Sản lượng mủ | Đọc latex_production | Worker, loại mủ, SL, ngày cạo, giá áp dụng |
| Giá mủ | Tra cứu giá động | latex_prices với effective_from/to |
| Nhân viên | Đọc insurance_salary | Cơ sở tính BHXH/BHYT/BHTN |
| Tạm ứng | Trừ vào lương | salary_advances theo CN + tháng |
| Cài đặt tỷ lệ | Đọc tỷ lệ BH | salary_settings (singleton) |
| Phê duyệt | Loại tài liệu salary_sheet | Định nghĩa trong approval-workflows |
2.7. Vấn đề cần lưu ý
-
Không tính theo ngày công: Lương hoàn toàn dựa trên sản lượng. Không có lương cơ bản, không có "số ngày công × lương/ngày". Worker không đi làm nhưng có sản lượng vẫn nhận lương đầy đủ.
-
Không có thưởng/phạt: Chưa có cơ chế
thưởng(bonus) hoặcphạt(penalty) trong tính lương. -
KPI / Thời tiết chưa kết nối: KPI chỉ có trong warehouse/production analytics, chưa ảnh hưởng đến lương.
-
Text CDP bị hardcoded sai:
salary-form.tsxhiển thị "Công đoàn (0.5%)" nhưng mặc định thực tế là 1%. -
total_salary=net_salary: Fieldtotal_salarytrong DB thực chất là lương NET (thực lĩnh), không phải gross. Có thể gây nhầm lẫn. -
Bulk review chỉ tính gross:
calculateTeamReview()chỉ tínhaccumulatedSalary(gross), không fetch dữ liệu BH/tạm ứng → dashboard team hiển thị gross, không phải net. -
insurance_salary= 0 → không trừ BH: Nếu worker không cóinsurance_salary, tất cả BHXH/BHYT/BHTN = 0. Chỉ CDP vẫn tính (dựa trên gross). -
Chưa có phân quyền nghiêm ngặt: Bất kỳ user nào cũng có thể tạo/sửa lương, không giới hạn theo role.
3. So sánh nhanh
| Tiêu chí | DRC | Lương |
|---|---|---|
| Input chính | DRC% (lab), STL (kho) | Sản lượng mủ × Giá |
| Công thức | quy khô = tươi × DRC/100 | net = gross - BH - CDP - tạm ứng |
| Tích hợp DB | drc_evaluation, inventory_input | salary_calculation, salary_details |
| Tính tự động | Auto-calc quy khô | Auto-calc BH, CDP, net |
| Validation | Không có khoảng DRC | Không validate giá trị |
| Phân quyền | Chưa phân quyền KCS | Chưa phân quyền CNV |