> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ontime.hosai.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Punch and Today

> The Today screen: your status, the punch flow with selfie and GPS, and the mini-stats.

**Today** is the app's home. It answers one question first — am I clocked in? — and then everything else about today.

## The status card

The top of the screen shows whether you are currently checked in, how long you have been in, and where you punched from. Below it is your assigned shift for the day, so you can see what you are being measured against.

## Punching

The button reads **Punch in** or **Punch out** depending on your state. Depending on your organization's configuration, pressing it asks for:

<Steps>
  <Step title="A selfie">
    The camera opens and captures a single frame. This is what ties the punch to a person rather than a login.

    <Note>
      The photo is stored with the punch as evidence and is visible to your administrator. OnTime does not run face matching or liveness detection on it.
    </Note>
  </Step>

  <Step title="Your location">
    A map shows your position against your work location's geofence ring, with a live pin, and tells you the result before you confirm.
  </Step>

  <Step title="Confirmation">
    The punch is recorded and today's timeline updates immediately.
  </Step>
</Steps>

## What blocks or flags a punch

<AccordionGroup>
  <Accordion title="You are outside the geofence" icon="map-pin-off">
    You are not blocked, but you must pick a **reason** from the list your administrator configured, and the punch is recorded as **pending** until your manager approves it. You can attach an extra photo as proof.

    This is the normal path for client visits and field work — it is an exception, not an error.
  </Accordion>

  <Accordion title="Location is unavailable" icon="satellite-dish">
    If your device cannot get a fix — indoors, or permission denied — the app says so plainly rather than guessing. You can still punch.
  </Accordion>

  <Accordion title="Duplicate punch" icon="copy">
    Pressing the same direction twice within a minute is refused. Check whether your first press registered before pressing again.
  </Accordion>

  <Accordion title="The day is frozen" icon="lock">
    The date belongs to a payroll month that has been frozen. Nobody can add a punch to it. Speak to whoever runs payroll.
  </Accordion>
</AccordionGroup>

## Today's timeline

Every punch for the day in order, with its time, direction and source. Below it: hours worked so far, break time, and overtime accrued.

## Mini-stats

Three figures across the top of the screen, all live:

| Stat              | Shows                                                                     |
| ----------------- | ------------------------------------------------------------------------- |
| **This week**     | Hours worked so far this week.                                            |
| **Leave balance** | The sum of your remaining balance across leave types this financial year. |
| **Last pay**      | The net amount of your most recent payslip.                               |

## Quick links

Shortcuts straight into the things people most often need next: **Apply leave**, **Request regularization**, and your **latest payslip**.

When you are checked in, a heads-up row surfaces your most recent unread notification, so an approval decision does not wait for you to open the bell.
