tant/vhrms
5
1
Fork 2
Code Issues Pull requests Projects Releases 2 Packages Wiki Activity Actions
2 releases 9 tags
  • v0.10.0 4385a2b328

    v0.10.0 Stable

    tant released this 2026-05-14 23:18:25 +07:00 | 70 commits to main since this release

    Highlights

    Setup Wizard với TT200 đã hoạt động end-to-end (PR #136 + #137)

    Site fresh deploy + chọn Vietnam + VND + Chart of Accounts "Thông tư 200/2014/TT-BTC" → Complete Setup → Company persist, Salary Component có account VAS đúng, 2 Salary Structure standard seeded Active, 0 Error Log.

    3 root cause được fix:

    • erpnext_compat.py monkey-patch ERPNext (chỗ override_whitelisted_methods không cover) cho get_chart() direct import + skip create_default_tax_template với TT200
    • Rút gọn account name 4131 từ 175 → 75 ký tự để qua giới hạn 140 của Frappe Account.name
    • Defer _per_company sang background job qua frappe.enqueue(..., enqueue_after_commit=True) để chạy sau khi wizard commit, account đã visible đầy đủ

    TETRA-1787 — Vietnam Minimum Wage hourly_rate theo NĐ 293/2025/NĐ-CP

    Seed hourly_rate tường minh (25500 / 22700 / 20000 / 17800) cho 4 vùng. Patch v0_9_0/fix_minimum_wage_hourly_nd_293.py quét và cập nhật record đã insert sai trước đó.

    TETRA-1692 — Chặn SSA vượt trần band (đối xứng với floor)

    Thêm Vietnam HRMS Settings.block_above_band_ceiling (default ON). HR muốn submit base > max(bands) sẽ bị throw với message gợi ý 3 hướng xử lý (promote ngạch / phụ cấp / sửa thang). Đối xứng với block_below_band_floor (TETRA-1472).

    Install / Upgrade

    bench get-app https://wedev.carp.vn/tant/vhrms.git --branch develop
bench --site <site-name> install-app vhrms
bench --site <site-name> migrate   # apply patch v0_9_0 cho data NĐ 293/2025

    Hoặc deploy qua Dokploy với pre-built stack image: wedev.carp.vn/tant/vhrms:0.10.0 (sẽ build qua CI khi tag này được push lên repo deploy stack — xem repo vhrms-deploy).

    Changelog đầy đủ

    CHANGELOG.md — [0.10.0] section

    Downloads
  • 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