# Timesheets {#timesheets}


Timesheets aggregate time logs into reviewable, approvable periods for payroll and billing.


## Timesheet Lifecycle {#timesheet-lifecycle}






```mermaid
graph TB
    A["Time Logs Created"] --> B["Timesheet Generated (DRAFT)"]
    B -- "Employee submits" --> C["Status: PENDING"]
    C --> D["Manager Approves"]
    C --> E["Manager Denies"]
    D --> F["Status: APPROVED<br/>Ready for payroll"]
    E --> G["Status: DENIED<br/>Employee revises"]
```






## Timesheet Statuses {#timesheet-statuses}


| Status      | Description                 | Who Can Change    |
| ----------- | --------------------------- | ----------------- |
| `DRAFT`     | Auto-created, not submitted | Employee          |
| `PENDING`   | Submitted for review        | Employee (submit) |
| `IN_REVIEW` | Under manager review        | Manager           |
| `APPROVED`  | Approved for payroll        | Manager           |
| `DENIED`    | Rejected, needs revision    | Manager           |


## Timesheet Views {#timesheet-views}



### Weekly View {#weekly-view}


Displays time logs grouped by day of the week:

| Day       | Project A | Project B |  Total  |
| --------- | :-------: | :-------: | :-----: |
| Mon       |    4h     |    3h     |   7h    |
| Tue       |    5h     |    2h     |   7h    |
| Wed       |    3h     |    4h     |   7h    |
| Thu       |    6h     |    2h     |   8h    |
| Fri       |    4h     |    3h     |   7h    |
| **Total** |  **22h**  |  **14h**  | **36h** |


### Calendar View {#calendar-view}


Monthly calendar showing daily totals with color-coded indicators.


### Report View {#report-view}


Aggregated data with filtering by employee, project, client, and date range.


## Approval Workflow {#approval-workflow}



### For Employees {#for-employees}


1. Track time throughout the week
2. Review daily logs for accuracy
3. Submit timesheet at end of period
4. Receive notification of approval/denial
5. If denied, revise and resubmit


### For Managers {#for-managers}


1. Receive notification of pending timesheets
2. Review employee time logs
3. Check screenshots and activity levels
4. Approve or deny with comments
5. Bulk approve multiple timesheets


## Timesheet Data Model {#timesheet-data-model}


```typescript
interface ITimesheet {
  id: string;
  startedAt: Date;
  stoppedAt: Date;
  duration: number; // Total seconds
  keyboard: number; // Total keyboard events
  mouse: number; // Total mouse events
  overall: number; // Overall activity percentage
  status: TimesheetStatus;
  approvedById?: string; // Manager who approved
  approvedAt?: Date;

  // Relations
  employeeId: string;
  organizationId: string;
  tenantId: string;
  timeLogs: ITimeLog[];
}
```


## Permissions {#permissions}


| Action              | Required Permission     |
| ------------------- | ----------------------- |
| View own timesheets | `TIME_TRACKER`          |
| Submit timesheets   | `TIME_TRACKER`          |
| Approve timesheets  | `CAN_APPROVE_TIMESHEET` |
| Edit time entries   | `TIMESHEET_EDIT`        |
| View all timesheets | Admin role              |


## Related Pages {#related-pages}


- [Time Tracking](https://sourcey-gauzy.pages.dev/features/time-tracking/index.md) — time logging methods
- [Activity Tracking](https://sourcey-gauzy.pages.dev/features/activity-tracking/index.md) — screenshots and monitoring
- [Time Tracking Endpoints](https://sourcey-gauzy.pages.dev/api/time-tracking-endpoints/index.md) — API reference