Developer Notes
Developer-focused notes for maintaining forms, tables, UI components, routes, docs, screenshots, and tests.
Workflow
- Core route and view mapAdmin / Reviewer: Gives implementers the fastest path from a docs section to code.
- UI component referenceAdmin / Reviewer: Explains what each reusable component is normally used for.
| Stage | Actor | Action | Result |
|---|---|---|---|
| Core route and view map | Admin / Reviewer | Gives implementers the fastest path from a docs section to code. | The filtered list supports review, export, or action. |
| UI component reference | Admin / Reviewer | Explains what each reusable component is normally used for. | The filtered list supports review, export, or action. |
Component rule
Most workforce forms already use resources/views/components/ui/*.blade.php. New form fields should use those components unless a local module pattern clearly needs something else.
Essential table
Database listing
Core route and view map
Gives implementers the fastest path from a docs section to code.
Filters: Module, Route, Controller
| Column | What it means | Where it comes from | Example interpretation |
|---|---|---|---|
| Docs area | Manual page or module. | documentation pages. | Attendance. |
| Route group | Route prefix/name. | routes/modules.php. | attendance.*. |
| Controller | PHP class handling requests. | app/Http/Controllers. | AttendanceController. |
| Views | Blade templates and partials. | resources/views. | admin/workforce/attendance/*.blade.php. |
| Tests | Feature tests covering behavior. | tests/Feature. | WorkforceNotificationsAndAttendanceTest. |
Available actions
- Open or edit the record when permission allows it.
- Filter the list without losing the current page context.
- Use status badges to decide which item needs attention first.
Essential table
Database listing
UI component reference
Explains what each reusable component is normally used for.
Filters: Component, Use case
| Column | What it means | Where it comes from | Example interpretation |
|---|---|---|---|
| x-ui.input | Text/email/url fields. | resources/views/components/ui/input.blade.php | Employee name, company email. |
| x-ui.search-select | Dropdown/search selections. | search-select component. | Branch, employee, role. |
| x-ui.date-picker / time-picker | Date and time inputs. | date/time components. | Attendance date, check-in. |
| x-ui.textarea | Long notes and reasons. | textarea component. | Approval reason. |
| x-ui.switch-toggle | Boolean settings. | switch component. | MFA enabled. |
| x-ui.button | Consistent action buttons. | button component. | Save, reset, export. |
Available actions
- Open or edit the record when permission allows it.
- Filter the list without losing the current page context.
- Use status badges to decide which item needs attention first.
Full field appendix
Main docs show essential fields only. Open Documentation Coverage for every detected source field, action, column, route hint, controller hint, and test hint.