tant/vhrms
5
1
Fork 2
Code Issues Pull requests Projects Releases 2 Packages Wiki Activity Actions
Vietnam HRMS extension for Frappe HR. Adds Vietnam-specific payroll: Social Insurance (BHXH/BHYT/BHTN), Progressive PIT calculation, Tax Dependents (NPT), Regional Minimum Wages, OT rates per Labor Code 2019. Fully compliant with Vietnamese regulations.
351 commits 2 branches 9 tags 2.3 MiB
  • Python 97.2%
  • JavaScript 1.7%
  • HTML 1%
Find a file
Exact
khanhn ab4a0e6e56
All checks were successful
Test (offline) / test (push) Successful in 53s
Details
feat(meeting-room): Frappe Desk UI đặt phòng — field order + Calendar view + client script (TETRA-2200) (#169)
2026-06-21 12:57:53 +07:00
.forgejo/workflows chore: TETRA-2181 — ruff baseline về 0 + gate full ruff check (#166) 2026-06-17 14:20:41 +07:00
deploy docs: đồng bộ tài liệu với trunk=main + convention test mới (#161) 2026-06-04 19:57:18 +07:00
docs/superpowers test: shared bench-safe frappe stub helper + detector + plan 2026-06-04 11:51:26 +04:00
scripts chore: TETRA-2181 — ruff baseline về 0 + gate full ruff check (#166) 2026-06-17 14:20:41 +07:00
vhrms feat(meeting-room): Frappe Desk UI đặt phòng — field order + Calendar view + client script (TETRA-2200) (#169) 2026-06-21 12:57:53 +07:00
.editorconfig feat: Initialize App 2025-12-13 14:28:00 +00:00
.eslintrc feat: Initialize App 2025-12-13 14:28:00 +00:00
.gitignore chore: ignore .playwright-mcp/ 2026-04-19 08:40:33 +04:00
.pre-commit-config.yaml feat: Initialize App 2025-12-13 14:28:00 +00:00
CHANGELOG.md docs: đồng bộ tài liệu với trunk=main + convention test mới (#161) 2026-06-04 19:57:18 +07:00
DEVELOPMENT.md docs: đồng bộ tài liệu với trunk=main + convention test mới (#161) 2026-06-04 19:57:18 +07:00
HUONG_DAN_SU_DUNG.md docs: đồng bộ tài liệu với trunk=main + convention test mới (#161) 2026-06-04 19:57:18 +07:00
license.txt feat: Initialize App 2025-12-13 14:28:00 +00:00
pyproject.toml chore: TETRA-2181 — ruff baseline về 0 + gate full ruff check (#166) 2026-06-17 14:20:41 +07:00
README.md docs: đồng bộ tài liệu với trunk=main + convention test mới (#161) 2026-06-04 19:57:18 +07:00

README.md

VHRMS - Vietnam HRMS

Ứng dụng mở rộng cho Frappe HRMS, bổ sung tuân thủ quy định lao động Việt Nam.

Tính năng chính:

  • Hệ thống tài khoản kế toán theo Thông tư 200/2014/TT-BTC (243 tài khoản, 3 cấp)
  • Bảo hiểm xã hội (BHXH, BHYT, BHTN, Công đoàn) với tính trần tự động
  • Thuế TNCN lũy tiến 7 bậc, quản lý NPT (người phụ thuộc)
  • Lương tối thiểu vùng, mức lương cơ sở, giảm trừ gia cảnh
  • Tăng ca theo BLLĐ 2019 (Điều 98, 107) - auto-detect ngày lễ/cuối tuần/ca đêm
  • Hồ sơ nhân viên theo TT 06/2023/TT-BNV (80+ custom fields)
  • Quản lý nhà thầu theo Luật Đấu thầu 2023 & NĐ 214/2025
  • Báo cáo D02-TS, D03-TS, C70a-HD, PIT Monthly, NPT (Mẫu 20)
  • Ngày lễ Việt Nam (bao gồm lịch âm + T7/CN weekly off), gross-up calculation
  • Auto-configure Payroll Settings, Salary Component accounts theo VAS
  • REST API cho tích hợp hệ thống bên ngoài

Yêu cầu: Frappe v16, ERPNext v16, HRMS v16, Python 3.10+

Installation

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

Xem HUONG_DAN_SU_DUNG.md để biết chi tiết cài đặt và sử dụng.

Contributing

This app uses pre-commit for code formatting and linting:

cd apps/vhrms
pre-commit install

Tools: ruff, eslint, prettier, pyupgrade

License

MIT