Skip to main content

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ảnhMục đíchCollection Directus
Kiểm tra chất lượng (KCS)Ghi nhận DRC theo lô cao sudrc_evaluation
Kho hàngTí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​

FileMô tả
features/quality-control/types/index.ts:13-22Interface DrcEvaluation
features/quality-control/services/quality-control-service.directus.tsService CRUD drc_evaluation
features/quality-control/pages/quality-control-screen.tsx:27-494Screen kết hợp (tab KCS + tab DRC)
app/(app)/drc.tsx:1-332Screen DRC độc lập (hidden tab)
features/quality-control/components/quality-control-card.tsx:32-117Card hiển thị DRC

Warehouse — DRC trong nhập kho​

FileMô tả
features/warehouse/types/index.ts:50,60-74Field drc_percent trên InventoryInput
features/warehouse/components/warehouse-form.tsx:400-414Auto-calc quy khô
features/warehouse/utils/pdf-export.ts:85-147PDF "PHIẾU KẾT QUẢ ĐO DRC"
features/warehouse/hooks/use-warehouse-analytics.ts:106-180Weighted-average DRC
features/warehouse/components/warehouse-analytics-kpi.tsx:49-80KPI card hiển thị DRC TB

Dashboard​

FileMô tả
features/dashboard/pages/general-report-screen.tsx:69-77DRC 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 ý​

  1. 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.

  2. 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.

  3. 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%.

  4. Service mock còn tồn tại: quality-control-service.ts chứa data cứng (35.5, 32.8, 38.2...) dù barrel đã redirect sang .directus.

  5. 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.

  6. Công thức PDF vs auto-calc: PDF in % DRC = [m2/m1] × 70, auto-calc dùng quy 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​

FileMô tả
features/salary-calculation/types/index.ts:1-83Type definitions
features/salary-calculation/services/salary-auto-calculator.ts:1-298LOGIC TÍNH LƯƠNG CHÍNH
features/salary-calculation/services/salary-service.ts:1-233CRUD salary_calculation
features/salary-calculation/services/salary-settings-service.ts:1-53Cài đặt tỷ lệ BHXH
features/salary-calculation/services/salary-advance-service.ts:1-42Tạm ứng

Screens​

FileMô tả
features/salary-calculation/pages/salary-screen.tsx:1-192Screen xem lương (leader/worker)
features/salary-calculation/pages/production-salary-screen.tsx:1-246Mega-Dashboard (lương + ĐT + KH + CC)
features/salary-calculation/pages/salary-settings-screen.tsx:1-142Cài đặt tỷ lệ bảo hiểm

Components​

FileMô tả
components/salary-card.tsx:1-132Card lương có thể mở rộng
components/salary-form.tsx:1-286Form nhập/sửa lương thủ công
components/salary-preview-dialog.tsx:1-114Dialog preview trước khi lưu
components/salary-dashboard.tsx:1-263Dashboard tổng hợp
components/salary-review-dashboard.tsx:1-259Review lương theo team/năm
components/worker-salary-detail-modal.tsx:1-169Modal chi tiết lương theo tháng
components/month-production-accordion.tsx:1-167Accordion tháng (SL × ĐG = Thành tiền)

Hooks​

FileMô tả
hooks/use-auto-salary-calculation.ts:1-115State 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​

ModuleTích hợpChi tiết
Sản lượng mủĐọc latex_productionWorker, loại mủ, SL, ngày cạo, giá áp dụng
Giá mủTra cứu giá độnglatex_prices với effective_from/to
Nhân viênĐọc insurance_salaryCơ sở tính BHXH/BHYT/BHTN
Tạm ứngTrừ vào lươngsalary_advances theo CN + tháng
Cài đặt tỷ lệĐọc tỷ lệ BHsalary_settings (singleton)
Phê duyệtLoại tài liệu salary_sheetĐịnh nghĩa trong approval-workflows

2.7. Vấn đề cần lưu ý​

  1. 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 đủ.

  2. Không có thưởng/phạt: Chưa có cơ chế thưởng (bonus) hoặc phạt (penalty) trong tính lương.

  3. 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.

  4. Text CDP bị hardcoded sai: salary-form.tsx hiển thị "Công đoàn (0.5%)" nhưng mặc định thực tế là 1%.

  5. total_salary = net_salary: Field total_salary trong 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.

  6. Bulk review chỉ tính gross: calculateTeamReview() chỉ tính accumulatedSalary (gross), không fetch dữ liệu BH/tạm ứng → dashboard team hiển thị gross, không phải net.

  7. 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).

  8. 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íDRCLương
Input chínhDRC% (lab), STL (kho)Sản lượng mủ × Giá
Công thứcquy khô = tươi × DRC/100net = gross - BH - CDP - tạm ứng
Tích hợp DBdrc_evaluation, inventory_inputsalary_calculation, salary_details
Tính tự độngAuto-calc quy khôAuto-calc BH, CDP, net
ValidationKhông có khoảng DRCKhông validate giá trị
Phân quyềnChưa phân quyền KCSChưa phân quyền CNV