tant/vhrms
5
1
Fork 2
Code Issues Pull requests Projects Releases 2 Packages Wiki Activity Actions
2 releases 9 tags
  • v0.1.0 0d0e58e1de

    VHRMS v0.1.0 — Initial Release Stable

    tant released this 2026-04-18 14:06:41 +07:00 | 350 commits to main since this release

    Giới thiệu

    VHRMS (Vietnam HRMS) là ứng dụng mở rộng cho Frappe HRMS, bổ sung đầy đủ các tính năng tuân thủ quy định lao động, thuế, bảo hiểm và kế toán Việt Nam. Bản v0.1.0 là bản phát hành chính thức đầu tiên, bao trùm toàn bộ nghiệp vụ HR cốt lõi cho doanh nghiệp Việt Nam.

    Điểm nổi bật

    Lương, Thuế & Bảo hiểm

    • Bảo hiểm bắt buộc BHXH / BHYT / BHTN / BHTNLĐ-BNN / Công đoàn với trần đóng tự động theo mức lương cơ sở và lương tối thiểu vùng. Phí Công đoàn cap động theo Luật Công đoàn 50/2024/QH15.
    • Thuế TNCN 7 bậc lũy tiến, đã cập nhật mức giảm trừ 2026 (bản thân 15,5M · NPT 6,2M — Luật TNCN 109/2025/QH15, NQ 110/2025/UBTVQH15).
    • 3 Salary Structure mẫu (Chính thức / Thử việc / Quản lý) tự tạo cho mỗi Company khi cài đặt.
    • 6 Salary Component phụ cấp dựng sẵn: PC_AT, PC_XX, PC_DT, PC_NO, PC_TP, Phụ cấp tăng ca — kèm ngưỡng miễn thuế và soft-warning khi vượt.
    • Pro-rata giữa tháng: tự tính lương theo ngày khi thay đổi Salary Structure Assignment giữa kỳ.
    • Gross-up (binary search, sai số ≤ 1.000đ) và so sánh chi phí DN giữa hợp đồng Gross vs Net.

    Tăng ca (BLLĐ 2019)

    • Tự phát hiện loại ngày (thường / cuối tuần / lễ / lễ trùng nghỉ) theo Holiday List + weekly off.
    • Ca đêm +30% + OT đêm thêm +20% (22:00 – 06:00).
    • Giới hạn giờ OT theo ngày / tháng / năm (Điều 107), cảnh báo khi vượt.

    Hồ sơ nhân viên (TT 06/2023)

    • 80+ custom fields sơ yếu lý lịch chuẩn hành chính.
    • Bảng con: gia đình, ngoại ngữ, quá trình công tác, khen thưởng, kỷ luật.
    • NPT (Người phụ thuộc) quản lý trực tiếp trong Employee form + xuất Mẫu 20-ĐK-TH-TCT theo TT 86/2024.
    • Validation: CCCD (12 số), MST cá nhân, số sổ BHXH, ngày Đảng/quân ngũ.
    • Print format "Sơ yếu lý lịch TT 06/2023".

    Nghỉ phép (BLLĐ 2019)

    • 10 Leave Type chuẩn VN, tự thay thế Leave Type tiếng Anh của HRMS.
    • Leave Period + Leave Policy tự tạo, gán cho Employee mới.

    Hồ sơ hưởng BHXH (BHXH Claim)

    • Quản lý 4 nhóm chế độ ngắn hạn: Ốm đau, Thai sản, Dưỡng sức, TNLĐ-BNN.
    • Tự tính trung bình lương BH 6 tháng, suất hưởng, số ngày, số tiền.
    • State machine: Draft → Submitted → Approved → Paid / Rejected.

    KPI & Thưởng

    • Vietnam KPI Bonus Rule + Monthly KPI Evaluation — tính thưởng theo tầng (tier) gắn Employee Grade và Appraisal.
    • Vietnam Salary Band / Vietnam Reference Level — Salary Structure Assignment tự điền base từ grade × band.

    Nhà thầu (Luật Đấu thầu 2023 · NĐ 214/2025)

    • Correspondent (đơn vị liên hệ) + mở rộng Supplier với ~30 custom fields.
    • 8 child doctype: Legal Rep, Financial Record, Contract History, Equipment, Key Personnel, Production Facility, Certification, Reputation Record.

    Kế toán (TT 200/2014/TT-BTC)

    • Hệ thống 243 tài khoản, 3 cấp — override get_charts_for_country của ERPNext để "Vietnam - TT200" xuất hiện trực tiếp khi tạo Company.
    • Tự gán account VAS cho các Salary Component (6421, 3383, 3384, 3386, 3382, 3335).
    • Lệnh ensure_full_setup idempotent cho Company đã tồn tại.

    Ngày lễ & Tác vụ định kỳ

    • Holiday generator: Dương lịch + Âm lịch (Tết Nguyên đán, Giỗ tổ Hùng Vương).
    • Scheduled tasks: NPT đủ 18 tuổi, giấy tờ sắp hết hạn, nhắc D02-TS hàng tháng, tự tạo Holiday List năm mới.

    Báo cáo tuân thủ

    • D02-TS (danh sách LĐ tham gia BHXH), D03-TS (báo tăng/giảm), C70a-HD (thanh toán chế độ ngắn hạn), PIT Monthly, All Employee NPT.

    REST API

    10 whitelisted endpoint tại vhrms.api — tra cứu tỷ lệ BH, biểu thuế, giảm trừ, lương tối thiểu, hệ số OT, tính khấu trừ, gross-up, NPT.

    Recruitment (đang mở rộng)

    • Job Opening + Job Applicant custom fields (mở rộng pipeline 5 → 9 stages).

    Tương thích

    • Frappe v16+
    • ERPNext v16+
    • Frappe HRMS v16+
    • Python 3.10+
    • MariaDB 10.6+

    Cài đặt

    cd $PATH_TO_YOUR_BENCH
bench get-app https://wedev.carp.vn/tant/vhrms.git --branch main
bench --site [site-name] install-app vhrms
bench --site [site-name] migrate
bench --site [site-name] clear-cache

    Hook after_install + on_company_created sẽ tự import dữ liệu chuẩn (tỷ lệ BH, biểu thuế, lương tối thiểu vùng, ngày lễ), tạo custom fields, Salary Components, Leave Types, Chart of Accounts TT200 và 3 Salary Structure mẫu cho từng Company Country = Vietnam.

    Tài liệu

    • README.md — tổng quan tính năng + danh sách module.
    • HUONG_DAN_SU_DUNG.md — hướng dẫn cài đặt, cấu hình, vận hành, troubleshooting.

    Thống kê repo

    • 210 file · ~33.000 dòng code · 36 doctype mới · 5 báo cáo · 10 REST endpoint · 6 nhóm scheduled task.
    • Test suite: 15 test module bao phủ calculations, fixtures, reports, validations, NPT, Correspondent, print formats.
    Downloads