Skip to main content

Tài liệu yêu cầu — Ứng dụng điểm danh & phần cao su (App cấp tổ)

Nguồn: tổng hợp từ 3 ảnh trong docs/ + docs/rubber.md. Phạm vi minh họa: Tổ CN.1 — ngày 27/10/2026. Trạng thái: bản nháp chờ xác nhận nghiệp vụ (các mục đánh dấu ⚠️).


1. Tổng quan​

Hạng mụcNội dung
Tên hệ thốngApp cấp tổ
Mục đíchQuản lý công nhân theo tổ; ghi nhận điểm danh hằng ngày; theo dõi ngày công và phần cao/phần cao su; tổng hợp theo ngày, tháng, lũy kế
Đối tượng dùngTổ trưởng, nhân viên điểm danh, quản lý, admin
Đơn vị dữ liệuTổ → Công nhân → Phiếu điểm danh theo ngày

Ba nhóm màn hình chính (khớp với 3 ảnh):

  1. Tổng quan — bảng tổng ngày công + tổng phần cao, nút vào điểm danh.
  2. Điểm danh trong ngày — ma trận ghi nhận trạng thái theo từng công nhân.
  3. Tổng hợp — bảng tổng hợp + danh sách điểm danh phân cao, lưu/gửi.

Thuật ngữ: ảnh dùng xen kẽ "phần cao", "phần cao su", "phần ca". Cần chốt tên nghiệp vụ chính thức trước khi triển khai.


2. Dữ liệu mẫu đọc từ ảnh​

2.1. Tổ CN.1​

Hạng mụcGiá trị mẫu
Mã/tên tổTổ CN.1
Tổng số công nhân28
Tổng số phần cao48
Ngày minh họa27/10/2026

2.2. Công nhân xuất hiện​

C.Nhân, P.Cao, Lý A Mua, Lý A Minh, Lò Văn A, Lò Văn B, Lò Văn C, A13, B13, C13, D13.

Một số dòng kèm mã: CN.2.Lý A Mua*IDD:2686, CN.2.Lý A Minh*IDD:2685. ⚠️ Cần chốt quy tắc đặt mã công nhân, ý nghĩa IDD, và việc công nhân tổ khác có xuất hiện trong phiếu điểm danh hay không.

2.3. Bảng tổng quan (ảnh 1 — Quản lý điểm danh)​

Trạng tháiNgày công T.ngàyT.thángLK. Hiện tạiPhần cao T.ngàyT.thángLK. Hiện tại
Có mặt4300180086003600
Cao bù130100140150
Có phép1502003100400
Không phép140150280300
Nghỉ2903505180700
Đã ĐĐ951026001910005150
Chưa ĐĐ(đọc được dạng ], suy đoán 19)100500482001000

Quan sát: Đã ĐĐ T.ngày = tổng 5 trạng thái (4+1+1+1+2 = 9; 8+1+3+2+5 = 19). ⚠️ Đây chỉ là suy đoán từ số liệu mẫu, cần đối soát.

2.4. Bảng tổng hợp theo công nhân (ảnh 3 — TỔNG HỢP)​

Có mặtCao bùCó phépKhông phépChưa ĐĐ
C.Nhân411124
P.Cao1213248

2.5. Danh sách điểm danh phân cao (ảnh 3)​

Công nhân / mãCó mặtCao bùCó phépKhông phépChưa ĐĐ
Lý A Mua22
A13
B131
C1311
D13
Lý A Minh213
Lò Văn A (ô màu hồng)3
Lò Văn B (ô màu hồng)3
Lò Văn C45

Ô màu hồng = phần chưa điểm danh, cần chọn để được thêm mã ở phần "Để điểm danh".


3. Trạng thái điểm danh​

3.1. Trạng thái nghiệp vụ​

Trạng tháiÝ nghĩa dự kiến
Có mặtCó mặt làm việc
Cao bùTrạng thái "cao bù" theo quy định nội bộ ⚠️ cách tính chưa chốt
Có phépNghỉ/vắng có phép
Không phépVắng không phép
NghỉNghỉ theo trạng thái quy định riêng

3.2. Trạng thái hoàn tất điểm danh​

Trạng tháiÝ nghĩa dự kiến
Đã ĐĐĐã điểm danh
Chưa ĐĐChưa điểm danh

⚠️ Không gộp hai nhóm thành một trường duy nhất — nhóm 3.1 là trạng thái nghiệp vụ (tính ngày công/phần cao), nhóm 3.2 là trạng thái hoàn tất thao tác.


4. Màn hình & chức năng​

4.1. Màn hình tổng quan — App cấp tổ (ảnh 1)​

Hiển thị: tên tổ, tổng số công nhân, tổng số phần cao, bảng tổng ngày công, bảng tổng phần cao (cùng cột T.ngày / T.tháng / LK. Hiện tại), và thanh thao tác "Điểm danh trong ngày".

  • Các dòng tổng hợp: Có mặt, Cao bù, Có phép, Không phép, Nghỉ, Đã ĐĐ, Chưa ĐĐ.
  • Ghi chú trong ảnh: tích vào ô "Điểm danh trong ngày" sẽ chuyển sang phần điểm danh.

4.2. Màn hình điểm danh chi tiết (ảnh 2)​

Hiển thị: ngày điểm danh (27/10/2026 — ngày hiện tại), tổ, tổng công nhân/phần cao, danh sách công nhân kèm trạng thái.

Cấu trúc mỗi công nhân (ví dụ Lý A Mua — CN.2.Lý A Mua*IDD:2686):

A13 B13 C13 D13 ← mã theo cột
Có mặt ... ... ... ...
Cao bù ... ... ... ...
Có phép ... ... ... ...
Không phép ... ... ... ...
Chưa ĐĐ ... ... ... ...
[ Để điểm danh ] ← hàng nút/bước ghi nhận

Với Lý A Minh (CN.2.Lý A Minh*IDD:2685) cột là: A14, A18, B14, B18, C14, D14.

Ghi chú thao tác trong ảnh:

  • Tích vào công nhân → vào giao diện màn hình điểm danh phân cao.
  • Tích chọn phần "chưa điểm danh" → được thêm mã ở phần "Để điểm danh".
  • Hàng Để điểm danh: tích chọn ô để ghi nhận trạng thái.
  • Nút xem tóm tắt >> → chuyển sang màn hình tổng hợp.

⚠️ Ý nghĩa mã A13/B13/C13/D13 (mã công nhân, vị trí, nhóm hay mã phần cao?) chưa rõ.

4.3. Màn hình tổng hợp (ảnh 3)​

  • Bảng TỔNG HỢP theo công nhân (Có mặt, Cao bù, Có phép, Không phép, Chưa ĐĐ).
  • Danh sách điểm danh phân cao (xem mục 2.5).
  • Hai nút: quay lại, Lưu và gửi.
  • Ghi chú trong ảnh:
    • Tích Lưu và gửi → chuyển về màn hình điểm danh các công nhân để điểm danh/sửa công nhân nếu chưa khoá.
    • Tích quay lại → về màn hình điểm danh để chỉnh sửa.

4.4. Bộ thao tác chung​

Thao tácHành vi
Điểm danh trong ngàyChuyển đến khu vực điểm danh
Xem tóm tắtMở bảng tổng hợp
Lưu / Lưu và gửiLưu và gửi/tổng hợp theo quy trình — cần chốt người nhận, kênh, duyệt
Quay lạiVề màn hình trước

5. Quy tắc nghiệp vụ​

  1. Người dùng chọn công nhân/ô điểm danh để ghi nhận trạng thái trong ngày.
  2. Dữ liệu điểm danh tổng hợp theo trạng thái.
  3. Tổng hợp hỗ trợ xem theo ngày / tháng / lũy kế hiện tại.
  4. Tích ô điểm danh trong ngày → hệ thống chuyển sang phần điểm danh tương ứng.
  5. Có thao tác Lưu/Gửi và Quay lại.
  6. Có chức năng Xem tóm tắt để chuyển/xem bảng tổng hợp.
  7. Ghi chú màu đỏ về cộng/trừ/phân bổ theo trạng thái — công thức chưa đủ rõ, phải xác minh trước khi lập trình.

Công thức quan sát được trong ảnh (chưa xác nhận)​

Ghi chú đỏ trong ảnhSuy đoán
= có mặt - có phép - không phépMột cột phái sinh (nghỉ/đã đếm) = Có mặt − Có phép − Không phép
= có phép - không phépMột cột phái sinh khác = Có phép − Không phép

⚠️ 100% phải chốt với nghiệp vụ trước khi code.


6. Mô hình dữ liệu đề xuất​

6.1. Tổ — teams​

TrườngMô tả
idKhóa chính
codeMã tổ, ví dụ CN.1
nameTên tổ
is_activeCòn hoạt động
created_at, updated_atThời điểm tạo/cập nhật

6.2. Công nhân — workers​

TrườngMô tả
idKhóa chính
worker_codeMã công nhân
full_nameHọ tên
team_idTổ quản lý
portion_countSố phần cao/hệ số — chỉ dùng nếu nghiệp vụ xác nhận
external_idMã ngoài hệ thống / IDD
is_activeCòn làm việc
created_at, updated_atThời điểm tạo/cập nhật

⚠️ Không mặc định portion_count cố định trên hồ sơ nếu số phần thay đổi theo ngày.

6.3. Trạng thái điểm danh — attendance_statuses​

TrườngMô tả
idKhóa chính
codeMã ổn định
nameTên hiển thị
affects_workdayCó tính ngày công không
affects_portionCó ảnh hưởng phần cao không
sort_orderThứ tự hiển thị

⚠️ Hai trường affects_* chỉ cấu hình sau khi nghiệp vụ chốt công thức.

6.4. Phiếu điểm danh — attendance_sessions​

TrườngMô tả
idKhóa chính
team_idTổ được điểm danh
attendance_dateNgày điểm danh
statusNháp / đã lưu / đã gửi–đã chốt
created_byNgười lập
submitted_atThời điểm gửi/chốt
created_at, updated_atThời điểm tạo/cập nhật

⚠️ Ràng buộc: không hai phiếu đã chốt cùng tổ + cùng ngày (trừ khi nghiệp vụ cho phép nhiều ca).

6.5. Chi tiết điểm danh — attendance_records​

TrườngMô tả
idKhóa chính
session_idPhiếu điểm danh
worker_idCông nhân
status_idTrạng thái nghiệp vụ
workday_valueGiá trị ngày công (nếu áp dụng)
portion_valueGiá trị phần cao (nếu áp dụng)
noteGhi chú
marked_by, marked_atNgười/thời điểm thao tác

⚠️ Nếu mỗi công nhân chỉ 1 trạng thái/ngày → unique session_id + worker_id.

6.6. Tổng hợp​

Tính từ chi tiết điểm danh (không lưu tổng thủ công): tổng theo ngày, theo tháng, lũy kế, tổng công nhân và tổng phần cao theo trạng thái. Nếu cần chốt sổ → bổ sung bảng snapshot theo kỳ.


7. Quy tắc tính toán cần xác nhận ⚠️​

  1. Ngày công: mỗi trạng thái tính 1, 0.5 hay 0?
  2. Phần cao: định mức cố định theo công nhân / theo ngày / theo sản lượng?
  3. Đã ĐĐ – Chưa ĐĐ: trạng thái hoàn tất hay nhóm số liệu độc lập trong báo cáo?
  4. Lũy kế hiện tại: từ đầu tháng, đầu năm, đầu vụ hay từ ngày bắt đầu làm việc?
  5. Cao bù: cách tính phần cao bù và liên kết với ngày công.
  6. Điều chỉnh sau khi lưu: ai được sửa phiếu đã gửi/chốt, có lưu lịch sử không?
  7. Tổ – công nhân: một công nhân có thể thuộc nhiều tổ/điều chuyển không?
  8. Lịch làm việc: có cần ngày lễ, ca làm việc không?
  9. Lưu và gửi: gửi cho ai, qua kênh nào, có duyệt không?
  10. Mã A13/B13/C13/D13: mã công nhân, vị trí, nhóm hay mã phần cao?

8. Phân quyền đề xuất​

Vai tròQuyền
Nhân viên điểm danhXem tổ được giao; lập/cập nhật phiếu ở trạng thái nháp
Tổ trưởngĐiểm danh, xem tổng hợp, lưu/gửi phiếu
Quản lýXem báo cáo nhiều tổ; xác nhận hoặc trả lại phiếu (nếu có duyệt)
Quản trị hệ thốngQuản lý tổ, công nhân, trạng thái, cấu hình nghiệp vụ

9. Báo cáo & bộ lọc​

Bộ lọc: ngày điểm danh · tháng/năm · tổ · công nhân · trạng thái điểm danh · trạng thái phiếu (nháp/đã lưu/đã gửi–chốt).

Báo cáo:

  • Tổng hợp theo tổ trong ngày.
  • Tổng hợp ngày công theo tháng.
  • Tổng hợp phần cao theo tháng.
  • Lũy kế hiện tại.
  • Danh sách công nhân chưa điểm danh.
  • Lịch sử chỉnh sửa điểm danh (nếu có).

10. Luồng thao tác đề xuất​

  1. Đăng nhập → chọn tổ.
  2. Chọn ngày điểm danh.
  3. Hệ thống tải danh sách công nhân của tổ.
  4. Người dùng chọn trạng thái cho từng công nhân.
  5. Hệ thống cập nhật tổng tạm tính theo trạng thái.
  6. Mở Xem tóm tắt để kiểm tra.
  7. Chọn Lưu hoặc Lưu và gửi.
  8. Khi gửi/chốt: kiểm tra dữ liệu bắt buộc, cảnh báo công nhân chưa có trạng thái.
  9. Báo cáo ngày/tháng/lũy kế được cập nhật.
  10. Nếu được phép sửa sau chốt → lưu lịch sử thay đổi.

11. Yêu cầu giao diện​

  • Tiếng Việt, trạng thái dùng màu kèm nhãn chữ (không chỉ màu).
  • Bảng có lọc, sắp xếp, tìm kiếm công nhân.
  • Màn hình nhỏ: chuyển danh sách/thẻ hoặc cuộn ngang.
  • Nút rõ ràng: Điểm danh, Xem tóm tắt, Lưu, Lưu và gửi, Quay lại.
  • Cảnh báo khi còn công nhân chưa điểm danh.
  • Xác nhận trước khi chốt/gửi và trước khi rời trang khi còn dữ liệu chưa lưu.
  • Ngày tháng định dạng thống nhất dd/MM/yyyy.

12. Tiêu chí nghiệm thu sơ bộ​

  • Tạo/chọn tổ và quản lý danh sách công nhân.
  • Tạo phiếu điểm danh theo ngày.
  • Mỗi công nhân ghi nhận đúng trạng thái theo quy tắc đã thống nhất.
  • Lưu nháp, xem tóm tắt, gửi/chốt phiếu theo quyền.
  • Số tổng theo trạng thái khớp chi tiết điểm danh.
  • Báo cáo ngày/tháng/lũy kế tính đúng công thức đã xác nhận.
  • Cảnh báo bản ghi thiếu/trùng.
  • Có lịch sử thao tác quan trọng và phân quyền phù hợp.
  • Lọc và xuất báo cáo (nếu là yêu cầu vận hành).

13. Phụ lục — Đối chiếu ảnh ↔ màn hình​

File ảnhMàn hình tương ứngNội dung chính
cff5f019-6b18-4311-8f58-c86d967bed9c.jpegTổng quan — App cấp tổBảng tổng ngày công + tổng phần cao, nút "Điểm danh trong ngày"
62a36e10-dcb4-484f-bb23-c346083f6d6d.jpegĐiểm danh trong ngàyMa trận trạng thái theo công nhân, mã cột A13…D14, "Để điểm danh", "xem tóm tắt"
d685c3e0-dc9d-466b-b64e-31e44d622735.jpegTổng hợpBảng TỔNG HỢP, danh sách điểm danh phân cao, "quay lại" / "Lưu và gửi"

14. Kết luận​

Ảnh thể hiện ứng dụng nội bộ cấp tổ, trọng tâm là điểm danh công nhân, tổng hợp ngày công, quản lý phần cao và báo cáo theo ngày/tháng/lũy kế. Có thể bắt đầu thiết kế giao diện và mô hình dữ liệu theo tài liệu này, nhưng bắt buộc chốt các công thức tính ngày công/phần cao (mục 7) và ý nghĩa mã trong ma trận trước khi triển khai logic tính toán chính thức.