Manual Punch Attendance Documentation
Create professional documentation using Nextra (.mdx) for the Manual Punch Attendance module in the Worksphere application.
Audience: Admin / Super Admin
Style: Atomic CRM–style documentation
Scope: Add, View, Edit, Delete
Exclude: Separate list page, implementation details, code logic, screenshots
MODULE: MANUAL PUNCH ATTENDANCE MANAGEMENT
Navigation Path
Company → Attendance → Manual Punch Attendance
Manual Punch Attendance Page
URL
/attendance/manual-punch-attendance
Page Description
- Used to add manual attendance records for employees
- Works as a single-page module
- Attendance records are retrieved by searching Employee Code
- Existing records are displayed in a table below the form
- Records can be edited or deleted from the same page
1. Attendance Entry Form
Form Fields
| Field Name | Type | Description |
|---|---|---|
| Month | Dropdown | Select attendance month |
| Year | Dropdown | Select attendance year |
| Unit | Select / Create | Select employee unit |
| Unit Code | Text | Displays unit code |
| Employee Code | Text Input | Enter employee code |
| Employee Name | Text | Auto-filled employee name |
| Designation | Dropdown | Select designation |
| Duty Type | Dropdown | Main Duty / Other |
| Attendance Days | Number | Enter attendance days |
| Month Days | Number | Total days in month |
| OT Days | Number | Overtime days |
| OT Rate | Number | Overtime rate |
| OT Hours | Number | Overtime hours |
| NFH Days | Number | National festival holiday days |
| Weekoff Duty Days | Number | Weekoff duty days |
| Remarks | Text Input | Enter remarks |
2. Search Employee Attendance
Search Flow
- Select Month, Year, and Unit
- Enter Employee Code
- Click Search
Search Result
- If attendance exists:
- Records are displayed in a table below
- Form fields are populated for edit
- If no record exists:
- Form remains empty for new entry
3. Attendance Records Table
Table Description
- Displays manual attendance records for the selected employee
- Appears below the form after successful search
Table Columns
| Column Name | Description |
|---|---|
| Month | Attendance month |
| Year | Attendance year |
| Duty Type | Duty type |
| Attendance Days | Total attendance |
| OT Days | Overtime days |
| OT Hours | Overtime hours |
| NFH Days | National holiday days |
| Weekoff Duty Days | Weekoff duty days |
| Actions | Edit / Delete |
4. Row Actions
Edit Attendance
- Triggered by clicking Edit button
- Selected record details are populated into the form
- Admin can modify values and click Update
Delete Attendance
- Triggered by clicking Delete button
- Opens a confirmation alert
5. Delete Confirmation Alert
Alert Content
- Confirmation message before deletion
Actions:
- Confirm / Yes → Deletes the attendance record
- Cancel → Closes the alert without action
6. Actions
| Action | Behavior |
|---|---|
| Save | Saves new attendance entry |
| Update | Updates existing attendance record |
| Reset | Clears form fields |
| Cancel | Navigates away from the page |
Validation Rules
- Month and Year must be selected
- Employee Code is mandatory
- Attendance Days cannot exceed Month Days
- Numeric fields accept only valid numbers
End of Documentation