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
drcByKeymap
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:
| Field | Kiểu | Validation |
|---|---|---|
| Ngày đánh giá | date | Bắt buộc |
| Lô cạo | select | Bắt buộc |
| DRC (%) | number | 0 - 100 |
Hooks sử dụng:
useDrcEvaluations()- CRUD đánh giá DRCuseCreateDrcEvaluation()- Tạo mớiuseUpdateDrcEvaluation()- Cập nhậtuseDeleteDrcEvaluation()- XóauseDrcApproval- 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_pricestheo 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
| File | Mô tả |
|---|---|
services/salary-auto-calculator.ts | Logic tính lương tự động |
services/salary-service.ts | CRUD bảng lương |
services/salary-export-service.ts | Xuất Excel |
hooks/use-salary-calculations.ts | React Query hooks |
_components/salary-form.tsx | Form nhập liệu |
_components/data-table.tsx | Bả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
| Hook | Vai trò | File |
|---|---|---|
useIsAdmin() | Kiểm tra quyền Admin | src/features/permissions/api/use-is-admin.ts |
useCanManageMenus() | Quản lý cấu hình ẩn/hiện menu | src/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ương | Quản lý DRC | Phâ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
| Endpoint | Method | Mô tả |
|---|---|---|
/items/latex_production | GET | Sản lượng mủ |
/items/latex_prices | GET | Bảng giá mủ |
/items/salary_calculation | CRUD | Bảng lương |
/items/salary_details | CRUD | Chi tiết lương |
/items/drc_evaluations | CRUD | Đánh giá DRC |
/permissions | GET | Kiểm tra quyền |
/permissions/me | GET | Quyền hiện tại |
5. Lên Lên App Store
Timeline dự kiến
| Mốc thời gian | Nội dung |
|---|---|
| 18/09/2026 | Hoàn thiện code, test cơ bản |
| 19-22/09/2026 | Test tổng thể, fix bug |
| 23-25/09/2026 | Prepare 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ầu | Trạ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 ro | Khả năng | Giải pháp |
|---|---|---|
| Apple reject | Trung bình | Review kỹ trước khi submit |
| Bug nghiêm trọng | Thấp | Test kỹ các flow chính |
| Không kịp deadline | Thấ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