﻿BỘ CÔNG CỤ VỊ TRÍ VIỆC LÀM – v1.2.0
Lập Bộ biểu 09 biểu (A1, A2, B1, B2, C1, C2, C3, D1, D2) theo Hướng dẫn 07-HD/BTCTW
cho một hoặc nhiều cơ quan, đơn vị; có rà soát hồ sơ trước khi lập.

======================================================================
BẮT ĐẦU TRONG 3 BƯỚC
======================================================================

1) Giải nén toàn bộ tệp zip ra một thư mục (không chạy trực tiếp trong zip).

2) Bấm đúp tệp khởi động:
     Windows : BAT_DAU_Windows.bat
     macOS   : BAT_DAU_macOS.command   (lần đầu: chuột phải > Open)
     Linux   : ./bat_dau_linux.sh

   Bản "Windows trọn gói" đã kèm Python, không cần cài gì, không cần mạng.
   Bản gọn cần Python 3.9+; lần đầu chạy tự cài thư viện openpyxl, pypdf.

3) Chọn trong menu:
     7  Tạo ví dụ mẫu (đơn vị giả định) rồi 4 để xem Bộ biểu hoàn chỉnh
     1  Thêm một đơn vị  |  2  Thêm nhiều đơn vị từ DON_VI\DANH_SACH_DON_VI.xlsx
     3  Rà soát hồ sơ    |  4  Lập Bộ biểu  |  5  Chạy tất cả + tổng hợp tiến độ

======================================================================
QUY TRÌNH CHO MỖI ĐƠN VỊ
======================================================================

  a. Chép văn bản của đơn vị vào DON_VI\<số>_<MÃ>\ho_so\
     (chức năng nhiệm vụ, QĐ phê duyệt VTVL, bản mô tả, khung năng lực,
      QĐ giao biên chế, văn bản cấp phó, hướng dẫn, tệp Bộ biểu, dữ liệu kỳ trước)
  b. Chạy mục 3 – đọc DON_VI\<đơn vị>\_ra_soat\RA_SOAT_HO_SO.xlsx:
     lỗi nghiêm trọng, hồ sơ bắt buộc còn thiếu, văn bản hết hiệu lực/bị thay thế.
  c. Nhờ AI (Claude, ChatGPT…) đọc văn bản đã công bố và điền don_vi.json
     – xem cai-cho-AI\HUONG_DAN_CAI_DAT.md. Có thể tự điền theo
       he-thong\skills\de-an-vi-tri-viec-lam\references\schema-don-vi.md
  d. Chạy mục 5 – nhận:
       DON_VI\<đơn vị>\ket_qua\<MÃ>_BoBieu_VTVL_Ky30-09-2026_v01.xlsx
       DON_VI\TONG_HOP_TIEN_DO.xlsx   (mỗi đơn vị một dòng, trạng thái gửi)
  e. Trưởng phòng nhập số liệu (sản lượng, phút, số người) vào ô vàng,
     kiểm tra trang K_KiemTra, dán giá trị (Paste Values) vào tệp chính thức.

Màu ô trong Bộ biểu: trắng = đã nhập · vàng = phải bổ sung ·
xám = công thức, không sửa · cam = chờ xác nhận.

======================================================================
NGUYÊN TẮC BẮT BUỘC
======================================================================

- Chỉ đưa lên AI văn bản đã công bố và tài liệu hướng dẫn chung. Không đưa
  tệp Bộ biểu đã có số liệu, biểu D1, danh sách nhân sự, tài liệu mật.
  Số liệu nhập trực tiếp vào Excel trên máy.
- Không tự tạo số liệu. Thiếu thì để trống, ghi vào danh sách thiếu.
- Không ghi họ tên; D1 dùng mã NL.<MÃ>.001…
- Mã viết liền, không dấu: NV.<MÃ>.001, CV.NV.<MÃ>.001.01, VTVL.<MÃ>.001.
- Một công việc gắn đúng một nhiệm vụ và một vị trí việc làm.
- Người quy đổi ≠ người cần bố trí ≠ biên chế được giao.
- Kết quả là bản soạn thảo; người đứng đầu chịu trách nhiệm xác nhận.

======================================================================
CẤU TRÚC GÓI
======================================================================

  BAT_DAU_Windows.bat / BAT_DAU_macOS.command / bat_dau_linux.sh
  DON_VI\                 thư mục làm việc: mỗi đơn vị một thư mục con
  DON_VI\DANH_SACH_DON_VI.xlsx   mẫu khai báo nhiều đơn vị
  cai-cho-AI\             cài cho Claude.ai (4 bước), Antigravity,
                          Claude Code, ChatGPT; câu lệnh mẫu
  he-thong\               chương trình (không cần mở)
    skills\de-an-vi-tri-viec-lam\   skill (lập biểu + rà soát) + script + tài liệu
    python\                         (chỉ bản Windows trọn gói)

Chạy bằng dòng lệnh (không mở menu):
  BAT_DAU_Windows.bat --tat-ca      ./bat_dau_linux.sh --ra-soat
  Tham số: --vi-du  --ra-soat  --lap-bieu  --tat-ca  --tong-hop

======================================================================
SỰ CỐ THƯỜNG GẶP
======================================================================

- Windows báo "Windows protected your PC": bấm More info > Run anyway.
- macOS báo không mở được: chuột phải tệp > Open; hoặc trong Terminal:
  chmod +x BAT_DAU_macOS.command
- "chưa có dữ liệu": don_vi.json của đơn vị chưa được điền (bước c).
- "DỪNG DO LỖI": mở _trang_thai.json hoặc chạy lại để xem lỗi dữ liệu
  (mã sai quy tắc, công việc không gắn nhiệm vụ…), sửa don_vi.json.
- PDF scan hoặc mất dấu tiếng Việt: báo cáo rà soát đánh dấu, cần đọc bằng ảnh.
