Here’s what’s happening at Shohoj Shop Clothing Ltd.
STATIC PREVIEW · v0.39.4-dev Consolidated
Total Employees👥
6
View employees →
Present Today●
0
—
Absent Today◷
0
—
On Leave Today☂
0
Today
Late Today▦
0
Today
Attendance Summary (Sample Month)
September 2026
Green = Present · Red = Absent. Monthly chart is sample data; today’s cards and register now use the working attendance review data.
Employees by Department
Recent Employees
View all
ID
Name
Department
Designation
Status
Today’s Attendance
Open Attendance →
ID
Name
Check In
Status
Management Approval Center: সব pending approval এবং follow-up এক জায়গায় দেখা যাবে। এখানে Leave, HR Request, OT, Deduction, Bonus, Loan Disbursement এবং Payroll-এর পরবর্তী action দেখানো হয়। Final decision সংশ্লিষ্ট Module-এ করা হবে, যাতে মূল record ও audit trail একই জায়গায় থাকে।
Open Tasks
0
All modules
Leave
0
Waiting decision
HR Requests
0
Pending / under review
Payroll Inputs
0
OT + deduction + bonus
Finance / Payroll
0
Exit + loan + payroll workflow
My Work Queue
Pending actions
Priority
Module
Reference
Employee / Period
Pending Action
Status
Recommended Processing Order
Prevents payroll mismatch
1. Attendance / LeaveResolve attendance corrections and leave first.
2. OTApprove only payable and eligible overtime.
3. Bonus / DeductionReview exceptional earnings and deductions.
4. Loan / AdvanceRecord disbursement and scheduled recovery.
5. PayrollRecalculate → Review → Approve → Lock.
Automated Approval Workflow: Final system-এ application/clearance submit হলেই দায়িত্বপ্রাপ্ত user-এর My Tasks ও notification inbox-এ কাজ পৌঁছাবে। Assignee Open Review থেকে মতামত/decision submit করলে source module, Employee Panel এবং task queue স্বয়ংক্রিয়ভাবে update হবে। HR/Super Admin override শুধু exception হিসেবে থাকবে এবং reason + audit log বাধ্যতামূলক হবে।
My Open Tasks
0
Assigned to selected reviewer
Exit Clearance
0
Automatic department routing
Unread Notifications
0
Task + employee notice inbox
Automation Mode
Active
Manual override is exception only
My Tasks
Demo of role-based automatic routing
Module
Reference
Employee / Case
Task
Status
Action
Task Review
Review the assigned file and submit your decision here.
Decision submit হলে source module, Employee Panel, task queue এবং Audit Log একই সাথে update হবে। Reject/Return করলে কারণ লেখা বাধ্যতামূলক।
Notification Inbox
Selected user
Automation Rules
Final version: configurable by role/responsible user
Leave / Attendance
Request submit হলে Reporting Manager/HR task পাবে। Decision হলে Employee panel-এ status ও note update হবে।
Reporting Manager, IT, Accounts ও HR আলাদা task পাবে। প্রত্যেকে approve করলে Exit Case automatic cleared হবে।
Exit Case → 4 approvers → Final settlement
Exception / Override
Approver unavailable হলে HR/Super Admin override করতে পারবে; কারণ না লিখলে override হবে না এবং Audit Log তৈরি হবে।
Override reason → Audit log → Update
Sample employee data is included intentionally so you can judge the real workflow and screen layout.
Employee
Department
Designation
Branch
Joining Date
Status
Attendance is now a working review module. Sample records are included, and manual entries are saved in this browser. Machine integration will be connected and practically tested during deployment/UAT.
Employees
0
Present
0
Late
0
Absent
0
Leave
0
Total OT
0h
Daily Attendance Register
Manual + future machine data
Employee
Shift
Check In
Check Out
Work Hours
OT
Status
Remarks
Attendance Machine Integration
Deployment/UAT
ZKTeco FO-M1 profile recorded · Live connection pending
The software will keep employee attendance IDs mapped separately from payroll logic. After deployment, your actual machine model and connection method will be configured, then machine punches will be compared with this attendance register.
Shohoj Shop Clothing Ltd.
ZKTeco adapter · protocol verify at setup
Employee ID ↔ Machine ID
Required before Go-Live
Import Attendance File
CSV review
You can test a simple CSV attendance file in this browser review. A sample CSV is included in the ZIP.
Columns: Employee ID, Date, Check In, Check Out, Status, OT Hours, Remarks
Attendance Device Configuration: আপনার test machine ZKTeco FO-M1 এখানে pre-configured profile হিসেবে রাখা হয়েছে। Exact communication mode/port device-এর COMM / Communication menu দেখে Local Setup-এর সময় confirm করা হবে। Browser review কোনো real network/device connection করে না.
Configured Device
ZKTeco FO-M1
Primary practical-test unit
Employee Mapping
0/0
Employee ID ↔ Machine ID
Configuration
Review
Protocol must be verified on device
Live Test
Pending
Required before Go-Live
Device Profile
MODEL RECORDED · PROTOCOL VERIFY
Final mode will be selected after checking the actual device menu.
Use a fixed LAN IP during local deployment.
Common ZKTeco TCP COMM default; verify on FO-M1.
Used only if FO-M1 supports ADMS/Push; verify on device.
Must match device PC Connection / Comm Key setting.
Important: FO-M1-এর exact public model-specific integration document আমরা এখনও confirm করিনি। তাই 4370/8088-কে final compatibility claim হিসেবে নয়, ZKTeco-এর commonly used configuration value হিসেবে রাখা হয়েছে। Local setup-এ device menu/manual দেখে final setting lock হবে.
Leave Management is now a working review module. Leave types and policy rules are dynamic, sample requests are included, and approved leave can update the attendance review data.
Pending Requests
0
Approved This Month
0
On Leave Today
0
Leave Types
0
Leave Requests
Application → Approval → Attendance
Request
Employee
Leave
Dates
Days
Status
Reason
Decision Note
Action
Employee Leave Balance
2026
Approved paid leave reduces the allocated balance. Unpaid leave is tracked separately.
Management Center: HR/Admin can review employee HR requests, approve/reject them with a response, and send notices to all employees or a specific employee.
Pending HR Requests
0
Needs management decision
Approved Requests
0
Current review data
Notices Published
0
All + employee specific
Request Types
0
Dynamic master list
Employee HR Requests
Review → Decision → Employee sees response
Request
Employee
Type
Subject / Details
Status
Management Action
Reject করলে rejection reason বাধ্যতামূলক। Employee তার panel-এ সেই কারণ দেখতে পাবে। Loan / Salary Advance approve করলে sanctioned amount ও installment plan নির্ধারণ করে facility তৈরি হবে.
Published Notices
Latest first
Employee Self-Service Preview: Real use-এ Employee নিজের login দিয়ে শুধু নিজের তথ্য, আবেদন, response এবং নিজের জন্য প্রকাশিত notice দেখবে। Review করার সুবিধার জন্য “Demo Employee” selector রাখা হয়েছে.
◎ EMPLOYEE PORTAL
My HR Desk
All HR applications, management notices, application status and personal attendance.
N
Employee
·
· ·
Active Account
Paid Leave Remaining
0
Across paid leave types
Pending Requests
0
All application types
Management Notices
0
Visible to this employee
Attendance Records
0
Available in this review
My Payslip
September 2026
৳0
Payroll preview
Notices for Me
Published by Management
My Leave Balance
2026
My Recent Attendance
Private to employee
Date
Check In
Check Out
Status
OT
My Applications
Leave + all HR requests
Application
Type
Details
Status
Management Response
Resignation & Exit Clearance: Approved resignation creates an Exit Case. HR can track final working day, handover, IT/accounts/HR clearance, exit interview and final settlement before the employee is marked Resigned. This keeps the resignation application and exit completion traceable end-to-end.
Payroll Processing Review: Salary Structure, unpaid/absence days, approved OT, one-time earnings/bonus, deductions and loan/advance recovery are combined here. The review uses sample monthly inputs so the full scenario is visible. Final production payroll will use approved Attendance, Leave, OT and Loan records automatically.
Payroll Status
Draft
September 2026
Total Earnings
৳0
Structural earnings + OT + bonus
Total Deductions
৳0
Recurring + absence + other + loan
Net Payable
৳0
0 employees
Monthly Payroll Run
Draft → Review → Approve → Lock
Review formula Absence Deduction = Structural Gross ÷ Day Divisor × Unpaid Days OT Amount = Basic ÷ Monthly Hours × OT Multiplier × Approved OT Hours
Employee
Structural Gross
Unpaid Days
Approved OT
Bonus / Other Earning
Other Deduction
Loan / Advance
Approved Correction
Net Payable
Salary Disputes & Payroll Corrections
Employee Request → Payroll Review → Final Resolution
Accepted salary complaints are resolved here. Current-month corrections affect payroll only after review. If payroll is locked, unlock with a reason or approve the correction for next-month arrear.
Request
Employee
Issue
Claim / Current Net
Status
Action
Payroll Controls
Production safety
Effective Salary Structure
Only OT-eligible employees
Review before lock
Authorized unlock + reason
Once locked, monthly inputs are read-only in this review. Production version will also write the unlock/lock reason to Audit Log.
Next Integration
Automatic inputs
Attendance / Leave
→
Unpaid days and absence deduction
Approved OT
→
Payable OT only
Loan / Advance
→
Scheduled installment recovery
Payslip
→
Generated after payroll lock
Overtime Management: Extra working time and payable OT are kept separate. Only employees marked OT Applicable = Yes in Salary Structure can receive payable OT. OT must be approved before it is synced to Payroll.
OT Eligible Employees
0
Salary Structure eligibility
Pending OT
0
Needs approval
Approved Hours
0h
Selected payroll month
Estimated OT Pay
৳0
Based on current payroll rule
OT Entries & Approval
Attendance / Manual → Approval → Payroll
OT Ref
Employee
Date
Hours
Source
Eligibility
Status
Action
OT Policy
Dynamic settings
Payroll Rule
Approved hours are synced only for OT-eligible employees. Non-eligible employees may still have extra working time recorded, but payable OT remains zero.
Deduction Management: This screen handles one-time or recurring payroll deductions outside the fixed Salary Structure. Each deduction keeps employee, month, reason, status and approval history before entering Payroll.
Pending Deductions
0
Needs approval
Approved Deductions
৳0
Selected payroll month
Deduction Types
0
Dynamic list
Employees Affected
0
Approved records
Deduction Register
Review → Approve → Payroll
Ref
Employee
Type
Month
Amount
Frequency
Status
Reason
Action
Deduction Types
Dynamic master
Recurring salary components such as Provident Fund remain in Salary Structure. This list is for operational deductions that can vary by employee/month.
Bonus & Additional Earnings: Festival bonus, performance incentive, attendance bonus and other one-time earnings can be recorded here. Only approved records are synced to Payroll.
Pending Bonuses
0
Needs approval
Approved Bonus
৳0
Selected payroll month
Bonus Types
0
Dynamic list
Employees Receiving
0
Approved records
Bonus Register
Entry → Approval → Payroll
Ref
Employee
Type
Month
Amount
Basis
Status
Note
Action
Bonus Types
Dynamic master
Company policy can add new bonus categories later without changing the main payroll screen.
Loans & Advances Workflow: Standard process starts from the Employee Request Center. HR/Management reviews the request, sets the sanctioned amount and installments, then a Pending Disbursement facility is created. Only after disbursement does it become Active and enter automatic Payroll recovery. Financial outstanding balance changes only when payroll is Locked.
This browser review keeps a manual Sync button for demonstration. In the real backend, due active installments are calculated automatically when the payroll period is built; balances are posted only when Payroll is Locked.
Payslips & Reports Review: Monthly payroll results are presented as employee payslips and management reports. A payslip can be previewed while payroll is in Draft/Reviewed/Approved status, but the production system will mark it as Final only after Payroll Lock. Browser Print can be used as “Save as PDF” during this review.
Payroll Employees
0
Selected month / branch
Total Net Payroll
৳0
Net payable total
Total OT Payment
৳0
OT-eligible employees only
Payroll Status
Draft
Final payslips after lock
Payroll Report
Employee-wise monthly summary
Employee
Branch
Gross Earnings
OT
Bonus
Total Deduction
Loan/Advance
Net Payable
Final system-এ একই report Excel/PDF format-এ export করা যাবে। এই offline review-এ CSV export কার্যকর রাখা হয়েছে।
Payslip Preview
Employee copy
Report Library
Core reports
Attendance Summary
Present, late, absent, leave and attendance detail by employee/date.
Leave Report
Leave requests, status, leave type, days and management decision.
Overtime Report
Approved OT hours and calculated payable OT amount from payroll.
Loan & Advance Report
Principal, installment, recovered amount, outstanding balance and status.
Future Report Expansion
Dynamic report catalog
Department Payroll
+
Department-wise cost
Salary History
+
Employee revision history
Bonus / Deduction
+
Component-wise analysis
Custom Reports
+
New reports can be added later
Salary Structure Review: This step defines salary rules only. Attendance, leave, OT, bonus, deduction and loan will be combined later in the Payroll module. Salary changes are stored with an effective date so old payroll history remains intact.
Salary Components
0
Dynamic earnings + deductions
Salary Templates
0
Reusable structures
Employees Assigned
0
Current salary structure
OT Eligible
0
Payable OT enabled
Employee Salary Structure
Current effective structure
Employee
Template
Basic Salary
Structural Gross
OT
Effective
Salary Components
Dynamic master
Component
Type
Calculation
Default Rule
Recurring
Status
Salary Templates
Reusable by employee group
Salary Revision History
Effective-date based
Why History Matters
Payroll safety
When salary changes, the old record is not overwritten. A new record starts from its effective date. This keeps previous payslips and payroll reports consistent even after increments or structure changes.
Old PayrollPreserved
New RevisionEffective Date
Audit TrailTraceable
M
Employment Information
Personal Information
Employee master
Additional Information
Dynamic fields
These lists are dynamic. Add or remove options here and the Employee form updates automatically.
Organization profile used throughout this review version.
Data Import & Migration Center: Go-Live-এর আগে পুরোনো HR/Payroll data একসাথে আনার জন্য এই screen। Safe process হলো Template → Validate → Preview → Import। Validation error থাকলে সেই row import হবে না, আর প্রতিটি committed import Audit Log ও Import History-তে থাকবে.
Employees
0
Current employee master
Salary Assignments
0
Effective-dated structures
Opening Leave Balances
0
Optional cut-over balances
Import Batches
0
Traceable history
1. Download / Review Templates
Keep column names unchanged
Employee Master
Employee ID, name, contact, branch, department, designation, employee type, joining date, status and shift.
Unknown Employee ID or invalid master value is blocked. Duplicate employee/date attendance updates that date instead of adding another record.
Validate firstAudit every batch
2. Validate & Preview CSV
No file loaded
Waiting for validation
Choose a CSV template/file and click Validate File. Nothing is imported during validation.
Safe Migration Checklist
Recommended order
1
Organization Masters first Branch, Department, Designation, Shift, Leave Type and Salary Template names should exist before import.
2
Employee Master Employee ID is the main link used by Salary, Leave, Loan and Attendance.
3
Opening balances Import Salary, Leave and Loan/Advance data after employees are verified.
4
Attendance Import historical/current attendance only after Employee ID mapping is clean.
5
Run Integration & UAT After migration, run consistency checks before parallel payroll and Go-Live.
Import History
0 batch
Protection Rules
Data safety
• Validation never changes data. • Only rows marked Valid are committed. • Existing Employee ID is updated, not duplicated. • Attendance with the same Employee ID + Date is updated, not duplicated. • Salary creates a new effective-dated revision; old history remains. • Loan opening balance is represented with an opening recovery so outstanding amount stays correct. • Production import will create a pre-import backup before commit.
Local UAT & Go-Live Control Center: এই Browser Review এখনও production server নয়। এখানে আমরা Go-Live gate, Local PC testing, colleague sign-off এবং cut-over plan সাজাচ্ছি। Attendance Machine-এর Live Test, real backup restore এবং parallel payroll বাস্তব deployment/test environment ছাড়া Final Pass হবে না.
v1.0.0 Final Release কেবল তখনই নেওয়া হবে যখন Local UAT-এর critical issues closed, database backup/restore verified, Attendance Machine real punch test passed, opening data verified এবং অন্তত একটি payroll parallel-run reconcile হবে। Browser demo status দিয়ে এই gate bypass করা যাবে না.
Final production deployment-এ HTTPS, environment secrets, scheduled backup, database migrations এবং real user permissions server-side enforce করা হবে.
Production Backend & Database
Local runtime installer is prepared; smoke-test automation and practical UAT scenario pack are now added.
v0.39.4-dev Consolidated Backend Checkpoint
Checkpoint 11: Local UAT setup-এর পর system check, migration drift, database readiness, core unit tests এবং practical UAT scenarios ধারাবাহিকভাবে যাচাই করার smoke-test pack এখন প্রস্তুত।
Backend Modules
✓
Bound
HR · Attendance · Payroll · Loan · Exit
First-run
✓
Prepared
Roles · Masters · Admin · Samples
Migration
→
Local UAT
Generate → Migrate → Verify
Next Gate
→
UAT Pack
Smoke tests + practical scenarios
Checkpoint 11 — Local UAT Smoke Test & Scenario Pack
Prepared
PreparedWindows Local UAT Installer
01-SETUP script Python virtual environment তৈরি করবে, required packages install করবে এবং Local UAT environment file তৈরি করবে।
PreparedTwo Database Paths
প্রথম functional test-এর জন্য Quick SQLite mode এবং production-like test-এর জন্য PostgreSQL mode রাখা হয়েছে। Final production PostgreSQL-এই থাকবে।
PreparedMigration Baseline
Local UAT-এর প্রথম setup-এ reviewed Django models থেকে initial migration baseline তৈরি ও execute হবে। UAT correction শেষ হলে v1.0.0-এর আগে migration files freeze করে final source-এ রাখা হবে।
PreparedFirst-run Seed
Shohoj Shop Clothing Ltd., Head Office, Department/Designation, Shift, Leave Types, Salary Components এবং ZKTeco FO-M1 profile idempotently তৈরি হবে।
PreparedSample UAT Data
চারজন sample employee, salary assignment, leave balance এবং FO-M1 device user ID 101–104 mapping তৈরি করা যাবে, যাতে বাস্তব scenario দ্রুত test করা যায়।
PreparedFirst Super Admin
Setup-এর সময় username/password আপনি নিজেই দেবেন; password input hidden থাকবে এবং package-এ কোনো default production password রাখা হয়নি।
PreparedAutomated Smoke Test
একটি script Django system check, migration status/drift, first-run status, runtime verification এবং core automated tests একসাথে চালাবে। Result log file-এ সংরক্ষিত হবে।
PreparedPractical UAT Scenario Pack
Employee, Attendance, Leave, HR Request, Approval, Payroll, Loan, Exit, Reports, Security এবং Backup-এর step-by-step test cases CSV-তে দেওয়া হয়েছে।
PreparedBug & Payroll Reconciliation Templates
আপনি ও colleagues একই format-এ Bug note এবং Manual Payroll বনাম Software Payroll difference লিখতে পারবেন।
NextPractical Local PC Installation
পরবর্তী বড় gate হলো আপনার Local PC-তে package setup করে automated smoke test চালানো, এরপর team UAT এবং ZKTeco FO-M1 real punch test শুরু করা।
Local runtime sequence
Prepared
Setup→Migrations→Seed→Admin→Start→UAT
Gate
Status
Core backend module binding
Bound
Security + backup/restore commands
Prepared
Local environment + installer scripts
Prepared
Initial migration generation/execution
Run on Local UAT PC
Database persistence + first login smoke test
Local UAT gate
ZKTeco FO-M1 real punch test
Physical device gate
Parallel payroll + backup restore proof
Before v1.0.0
Maintainability: Installer automation only orchestrates standard Python, Django and database commands. No custom deployment framework has been introduced, so your developers can maintain the project with familiar tools.
System Integration & UAT: This page checks whether the modules agree with each other before deployment. It does not replace the final live test. Attendance-machine status remains Pending Live Device Test until your real device is connected after deployment.
1. EmployeeMaster + Salary
2. Time & RequestsAttendance + Leave + ESS
3. Payroll InputsOT + Bonus + Deduction + Loan
4. Payroll OutputCalculation + Payslip
5. ControlPermission + Audit + Backup
Checks Passed
0
Run integration check
Warnings / Failures
0
Review before Go-Live
Payroll Sync
Not Checked
Approved inputs vs Payroll
Attendance Device
Prepared
Live test after deployment
Automated Integration Check
Not run yet
Run the check first. The system will compare Employee, Salary, Attendance, Leave, OT, Bonus, Deduction, Loan, Payroll, Role/Permission, Audit and Backup data.
UAT Scenario Checklist
Business flow review
Scenario
Expected Result
Status
Attendance Machine Preparation
Adapter-ready
Machine Punch→Machine ID Map→Raw Sync Log→Attendance Register→Payroll
Sample sync only demonstrates the data path. ZKTeco FO-M1 exact live protocol will be verified from the physical device during Local UAT.
Employee ↔ Machine ID Mapping
0 mapped
Employee
Machine ID
Status
Device Sync Log
Review trail
Security & Production Readiness: এই Review screen-এ User access, Role/Permission, Audit Log এবং Backup/Restore flow দেখা যাবে। Production version-এ password hashing, secure session, login protection, HTTPS ও server-side authorization কার্যকর থাকবে.
Active Users
0
Enabled login accounts
Roles
0
Permission profiles
Audit Events
0
Traceable actions
Latest Backup
—
No backup
User Accounts
Employee login + management accounts
Employee account শুধু নিজের ESS data দেখবে। HR/Payroll/Manager access তাদের Role Permission অনুযায়ী সীমাবদ্ধ থাকবে। Super Admin access খুব সীমিত সংখ্যক User-এর জন্য রাখা উচিত.
User
Linked Employee
Role
Status
Last Login
Action
Permission পরিবর্তন করলে এই browser demo-তে save হবে এবং Audit Log-এ event তৈরি হবে.
Date & Time
User
Module
Action
Record / Detail
Backup Policy
Data safety
Daily Retention7 Days
Weekly Retention8 Weeks
Monthly Retention12 Months
Production-এ database backup encrypted/off-site location-এ রাখা হবে। একই server-এ একমাত্র backup রাখা হবে না.
Backup History
Latest first
Backup ID
Date
Type
Status
Created By
Restore Test
এই browser review-তে আগে Download করা Demo Backup JSON নির্বাচন করে restore flow পরীক্ষা করা যাবে.
Production restore করার আগে staging/isolated environment-এ validation বাধ্যতামূলক থাকবে.
Production Go-Live Checklist
Before real payroll use
System Configuration Center: Core business rules are kept configurable so future policy changes do not require source-code changes. Values here are review/demo settings and are saved in this browser.
Company & Locale
Organization identity and common display settings.
Attendance Policy
Common attendance thresholds. Employee shift still controls scheduled working time.
Overtime Policy
Only OT-eligible employees can receive payable OT.
Payroll Policy
Core calculation and payroll locking rules.
Approvals & Employee Communication
Workflow safeguards used across ESS requests.
Reference Numbering
Prefixes stay configurable while generated numbers remain unique.
Changing a prefix affects new records only. Existing references remain unchanged for auditability.
Configuration Health Check
Quick validation before Local UAT and deployment.
Employee Custom Fields
Add future employee fields without changing the main employee layout.
Demo Data
This review file saves your demo changes in this browser only.
Reset restores sample employees, master lists, policies and custom fields.