Skip to main content

Báo Cáo: Tính DRC, Tính Lương & Phân Quyền

1. Tính DRC (Độ Rút Cố Định)​

Công thức DRC​

Vị trí: src/pages/warehouse/_components/latex-receipts-print-view.tsx:230

% DRC = [m2 / m1] × 100
  • m1: Khối lượng mủ tươi (wet weight)
  • m2: Khối lượng mủ khô (dry weight)

Sử dụng DRC trong tính toán​

Vị trí: src/pages/latex-report/page.tsx:355

if (drc && drc > 0) row.dry_kg += qty * (drc / 100);
  • Sản phẩm khô = Sản lượng × (DRC / 100)
  • DRC được lookup theo ngày + lô cạo thông qua drcByKey map

Quản lý DRC​

Vị trí: src/pages/quality-control/page.tsx + src/pages/quality-control/_components/drc-evaluation-form.tsx

Form nhập liệu:

FieldKiểuValidation
Ngày đánh giádateBắt buộc
Lô cạoselectBắt buộc
DRC (%)number0 - 100

Hooks sử dụng:

  • useDrcEvaluations() - CRUD đánh giá DRC
  • useCreateDrcEvaluation() - Tạo mới
  • useUpdateDrcEvaluation() - Cập nhật
  • useDeleteDrcEvaluation() - Xóa
  • useDrcApproval - Phê duyệt DRC

2. Tính Lương​

Công thức tính lương tự động​

Vị trí: src/pages/salary-calculation/services/salary-auto-calculator.ts

gross_salary = Σ (sản lượng × đơn giá) cho từng loại mủ

Chi tiết thực hiện:

  • Chỉ tính cho mủ secondary (tạp) và mủ coagulated (dây) — Line 109
  • Đơn giá lookup từ bảng latex_prices theo ngày hiệu lực — Line 159-167
  • Thành tiền = sản lượng_kg × price_per_kg — Line 192-193

Công thức thực lĩnh​

Vị trí: src/pages/salary-calculation/_components/salary-form.tsx:118-124

expectedNet = gross_salary
- BHXH (Bảo hiểm xã hội)
- BHYT (Bảo hiểm y tế)
- BHTN (Bảo hiểm thất nghiệp)
- Công đoàn
- Tạm ứng

⚠️ Lưu ý: Các khoản trừ BHXH, BHYT, BHTN, Công đoàn hiện đang bị commented out trong form (chưa kích hoạt).

Xuất Excel​

Vị trí: src/pages/salary-calculation/services/salary-export-service.ts

Công thức Excel trong file xuất:

H{row} × J{row} + I{row} × K{row}

(Sản lượng × Đơn giá cho từng loại mủ)

Workflow tính lương​

┌─────────────────────────────────────────────────────────┐
│ 1. Chọn công nhân / tổ / tháng / năm │
├─────────────────────────────────────────────────────────┤
│ 2. SalaryAutoCalculator.calculateForWorker() │
│ ├── Lấy thông tin công nhân │
│ ├── Lấy sản lượng theo tháng │
│ └── Lấy bảng giá mủ hiện tại │
├─────────────────────────────────────────────────────────┤
│ 3. Tính gross_salary = Σ(sản lượng × đơn giá) │
├─────────────────────────────────────────────────────────┤
│ 4. Xem preview → Xác nhận → Lưu bảng lương │
└─────────────────────────────────────────────────────────┘

Các file liên quan​

FileMô tả
services/salary-auto-calculator.tsLogic tính lương tự động
services/salary-service.tsCRUD bảng lương
services/salary-export-service.tsXuất Excel
hooks/use-salary-calculations.tsReact Query hooks
_components/salary-form.tsxForm nhập liệu
_components/data-table.tsxBảng hiển thị

3. Phân Quyền (Permissions)​

Vị trí trong Sidebar​

File: src/constants/data.ts:159

Hệ thống
└── Phân quyền → /dashboard/permissions

Hệ thống quyền​

HookVai tròFile
useIsAdmin()Kiểm tra quyền Adminsrc/features/permissions/api/use-is-admin.ts
useCanManageMenus()Quản lý cấu hình ẩn/hiện menusrc/features/permissions/api/use-can-manage-menus.ts

Cơ chế kiểm tra quyền​

Admin Check:

// Gọi API /permissions để kiểm tra quyền truy cập
await directus.request(
customEndpoint({
path: '/permissions',
method: 'GET',
params: { limit: 1, fields: 'id' }
})
);

Menu Management Check:

// Gọi API /permissions/me để lấy quyền hiện tại
const perms = await directus.request(
customEndpoint({
path: '/permissions/me',
method: 'GET',
params: { limit: -1 }
})
);

// Kiểm tra quyền create/update/delete trên collection role_hidden_menus
const entry = perms?.role_hidden_menus;
return ['create', 'update', 'delete'].some(
(action) => entry[action]?.access === 'full'
);

Vị trí trong cấu trúcmenu​

Quản lý nhân sự
├── Người dùng → /dashboard/users
├── Công nhân → /dashboard/workers
├── Đào tạo & Chứng chỉ → /dashboard/worker-trainings
├── Điểm danh → /dashboard/attendance
├── Báo cáo chấm công → /dashboard/timekeeping-history
└── Tính lương → /dashboard/salary-calculation ⭐

Phân quyền theo vai trò​

Vai tròTính lươngQuản lý DRCPhân quyền
Admin✅ Toàn quyền✅ Toàn quyền✅ Toàn quyền
Quản lý✅ Xem/Sửa✅ Xem/Sửa❌
Công nhân✅ Chỉ xem❌❌

4. Tóm tắt kỹ thuật​

Tech Stack​

  • Frontend: React + TypeScript + Next.js
  • UI: Tailwind CSS + Shadcn/UI
  • State: React Query (TanStack Query) + Zustand
  • Backend: Directus CMS (Headless CMS)
  • Export: SheetJS (xlsx)

API Endpoints chính​

EndpointMethodMô tả
/items/latex_productionGETSản lượng mủ
/items/latex_pricesGETBảng giá mủ
/items/salary_calculationCRUDBảng lương
/items/salary_detailsCRUDChi tiết lương
/items/drc_evaluationsCRUDĐánh giá DRC
/permissionsGETKiểm tra quyền
/permissions/meGETQuyền hiện tại

5. Lên Lên App Store​

Timeline dự kiến​

Mốc thời gianNội dung
18/09/2026Hoàn thiện code, test cơ bản
19-22/09/2026Test tổng thể, fix bug
23-25/09/2026Prepare App Store assets, submit review
26/09/2026🎯 Ngày sớm nhất có thể release
03/10/2026📅 Ngày muộn nhất保证 release

Các bước chuẩn bị​

1. Code hoàn thiện​

  • Hoàn thành module Tính DRC
  • Hoàn thành module Tính Lương
  • Kiểm tra phân quyền tất cả các vai trò
  • Fix các bug còn tồn đọng

2. Testing​

  • Unit test cho các công thức tính
  • Integration test cho flow tính lương
  • Test phân quyền trên từng vai trò
  • UAT với người dùng thực tế

3. App Store Assets​

  • App icon (1024x1024)
  • Screenshot cho iPhone (6.7", 6.5", 5.5")
  • Screenshot cho iPad (12.9", 10.5")
  • App description (tiếng Việt + tiếng Anh)
  • Privacy Policy URL
  • Support URL

4. Cấu hình kỹ thuật​

  • Bundle Identifier: com.rubber.admin (hoặc tương tự)
  • Version: 1.0.0
  • Build number: 1
  • Minimum iOS: 15.0+
  • App Transport Security (ATS) config

5. Submit Review​

  • Upload lên App Store Connect
  • Điền metadata (mô tả, từ khóa, danh mục)
  • Chọn pricing (Free / Paid)
  • Submit cho Apple review
  • Time review dự kiến: 24-48 giờ

Yêu cầu Apple Review​

Yêu cầuTrạng thái
Đăng nhập/đăng ký✅ Có
Functionality hoạt động đúng✅ Cần test
Privacy Policy⚠️ Cần bổ sung
App crashes❌ Không được có
Broken links❌ Không được có
Placeholder content❌ Không được có

Risk & Mitigation​

Rủi roKhả năngGiải pháp
Apple rejectTrung bìnhReview kỹ trước khi submit
Bug nghiêm trọngThấpTest kỹ các flow chính
Không kịp deadlineThấpƯu tiên feature chính

Checklist cuối cùng​

  • Test trên device thật (không chỉ simulator)
  • Test offline/online transition
  • Kiểm tra memory leak
  • Verify API endpoints hoạt động
  • Kiểm tra permissions trên production
  • Backup dữ liệu trước khi release