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ục | Nội dung |
|---|---|
| Tên hệ thống | App cấp tổ |
| Mục đích | Quả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ùng | Tổ trưởng, nhân viên điểm danh, quản lý, admin |
| Đơn vị dữ liệu | Tổ → 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):
- Tổng quan — bảng tổng ngày công + tổng phần cao, nút vào điểm danh.
- Điểm danh trong ngày — ma trận ghi nhận trạng thái theo từng công nhân.
- 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ục | Giá trị mẫu |
|---|---|
| Mã/tên tổ | Tổ CN.1 |
| Tổng số công nhân | 28 |
| Tổng số phần cao | 48 |
| Ngày minh họa | 27/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ái | Ngày công T.ngày | T.tháng | LK. Hiện tại | Phần cao T.ngày | T.tháng | LK. Hiện tại |
|---|---|---|---|---|---|---|
| Có mặt | 4 | 300 | 1800 | 8 | 600 | 3600 |
| Cao bù | 1 | 30 | 100 | 1 | 40 | 150 |
| Có phép | 1 | 50 | 200 | 3 | 100 | 400 |
| Không phép | 1 | 40 | 150 | 2 | 80 | 300 |
| Nghỉ | 2 | 90 | 350 | 5 | 180 | 700 |
| Đã ĐĐ | 9 | 510 | 2600 | 19 | 1000 | 5150 |
| Chưa ĐĐ | (đọc được dạng ], suy đoán 19) | 100 | 500 | 48 | 200 | 1000 |
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ặt | Cao bù | Có phép | Không phép | Chưa ĐĐ | |
|---|---|---|---|---|---|
| C.Nhân | 4 | 1 | 1 | 1 | 24 |
| P.Cao | 12 | 1 | 3 | 2 | 48 |
2.5. Danh sách điểm danh phân cao (ảnh 3)
| Công nhân / mã | Có mặt | Cao bù | Có phép | Không phép | Chưa ĐĐ |
|---|---|---|---|---|---|
| Lý A Mua | 2 | 2 | |||
| A13 | |||||
| B13 | 1 | ||||
| C13 | 1 | 1 | |||
| D13 | |||||
| Lý A Minh | 2 | 1 | 3 | ||
| Lò Văn A (ô màu hồng) | 3 | ||||
| Lò Văn B (ô màu hồng) | 3 | ||||
| Lò Văn C | 4 | 5 |
Ô 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ặt | Có 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ép | Nghỉ/vắng có phép |
| Không phép | Vắ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ác | Hành vi |
|---|---|
| Điểm danh trong ngày | Chuyển đến khu vực điểm danh |
| Xem tóm tắt | Mở bảng tổng hợp |
| Lưu / Lưu và gửi | Lư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ại | Về màn hình trước |
5. Quy tắc nghiệp vụ
- Người dùng chọn công nhân/ô điểm danh để ghi nhận trạng thái trong ngày.
- Dữ liệu điểm danh tổng hợp theo trạng thái.
- Tổng hợp hỗ trợ xem theo ngày / tháng / lũy kế hiện tại.
- Tích ô điểm danh trong ngày → hệ thống chuyển sang phần điểm danh tương ứng.
- Có thao tác Lưu/Gửi và Quay lại.
- Có chức năng Xem tóm tắt để chuyển/xem bảng tổng hợp.
- 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 ảnh | Suy đoán |
|---|---|
= có mặt - có phép - không phép | Một cột phái sinh (nghỉ/đã đếm) = Có mặt − Có phép − Không phép |
= có phép - không phép | Mộ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ường | Mô tả |
|---|---|
id | Khóa chính |
code | Mã tổ, ví dụ CN.1 |
name | Tên tổ |
is_active | Còn hoạt động |
created_at, updated_at | Thời điểm tạo/cập nhật |
6.2. Công nhân — workers
| Trường | Mô tả |
|---|---|
id | Khóa chính |
worker_code | Mã công nhân |
full_name | Họ tên |
team_id | Tổ quản lý |
portion_count | Số phần cao/hệ số — chỉ dùng nếu nghiệp vụ xác nhận |
external_id | Mã ngoài hệ thống / IDD |
is_active | Còn làm việc |
created_at, updated_at | Thờ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ường | Mô tả |
|---|---|
id | Khóa chính |
code | Mã ổn định |
name | Tên hiển thị |
affects_workday | Có tính ngày công không |
affects_portion | Có ảnh hưởng phần cao không |
sort_order | Thứ 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ường | Mô tả |
|---|---|
id | Khóa chính |
team_id | Tổ được điểm danh |
attendance_date | Ngày điểm danh |
status | Nháp / đã lưu / đã gửi–đã chốt |
created_by | Người lập |
submitted_at | Thời điểm gửi/chốt |
created_at, updated_at | Thờ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ường | Mô tả |
|---|---|
id | Khóa chính |
session_id | Phiếu điểm danh |
worker_id | Công nhân |
status_id | Trạng thái nghiệp vụ |
workday_value | Giá trị ngày công (nếu áp dụng) |
portion_value | Giá trị phần cao (nếu áp dụng) |
note | Ghi chú |
marked_by, marked_at | Ngườ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 ⚠️
- Ngày công: mỗi trạng thái tính 1, 0.5 hay 0?
- Phần cao: định mức cố định theo công nhân / theo ngày / theo sản lượng?
- Đã ĐĐ – Chưa ĐĐ: trạng thái hoàn tất hay nhóm số liệu độc lập trong báo cáo?
- 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?
- Cao bù: cách tính phần cao bù và liên kết với ngày công.
- Đ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?
- Tổ – công nhân: một công nhân có thể thuộc nhiều tổ/điều chuyển không?
- Lịch làm việc: có cần ngày lễ, ca làm việc không?
- Lưu và gửi: gửi cho ai, qua kênh nào, có duyệt không?
- 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 danh | Xem 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ống | Quả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
- Đăng nhập → chọn tổ.
- Chọn ngày điểm danh.
- Hệ thống tải danh sách công nhân của tổ.
- Người dùng chọn trạng thái cho từng công nhân.
- Hệ thống cập nhật tổng tạm tính theo trạng thái.
- Mở Xem tóm tắt để kiểm tra.
- Chọn Lưu hoặc Lưu và gửi.
- 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.
- Báo cáo ngày/tháng/lũy kế được cập nhật.
- 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 ảnh | Màn hình tương ứng | Nội dung chính |
|---|---|---|
cff5f019-6b18-4311-8f58-c86d967bed9c.jpeg | Tổ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ày | Ma 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.jpeg | Tổng hợp | Bả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.