[M-07]

PUNCH & TIMESHEETS

GPS-verified digital time clock with offline-first queuing, automatic timesheet generation, overtime detection, and seamless HR export.

// OPS_COMPANION FIELD MANUAL

The Punch module replaces physical time clocks, paper timesheets, and manual HR data entry. Every punch is GPS-stamped, timestamped to the millisecond, and stored with an immutable cryptographic seal. Timesheets are generated automatically — no manual compilation, no data re-entry, no rounding errors.

Designed for Quebec field operations where employees may work in areas with unreliable cellular coverage, the Punch module operates fully offline. Punches queue locally with vectorized temporal signatures and sync automatically on reconnect — with zero data loss and zero conflicts.

Punch-In / Punch-Out Flow

[01]

TAP PUNCH-IN

Single tap on the punch button. GPS coordinates captured simultaneously. Device timestamp locked.

[02]

ONLINE: INSTANT SYNC

Punch record transmitted to database in under 500ms. Dispatcher sees the technician's active status update on the 3D Map immediately.

[03]

OFFLINE: QUEUE & SIGN

If no network: punch stored locally with a vectorized temporal signature. The signature encodes the exact local time and device identity — preventing backdating.

[04]

RECONNECT: INTELLIGENT MERGE

On reconnect, queued punches are transmitted and merged using intent-aware conflict resolution. No duplicate entries, no lost punches.

[05]

PUNCH-OUT & CLOSE

Punch-out GPS-stamped. Elapsed duration calculated. Timesheet entry sealed and linked to the HR module.

Offline-First Architecture (Jour 13)

Network disconnection is treated as a normal operating state — not an error. The Punch module works identically with or without connectivity. The vectorized temporal signature on each offline record encodes:

Device timestampLocal clock at moment of punch (cannot be altered retroactively)

Device identityHardware fingerprint of the employee's device

GPS coordinatesCaptured at punch moment — stored in local queue

Sequence vectorMonotonic counter prevents reordering of queued events

Sync latency< 5 seconds from reconnect to full sync for typical queues

QUEUE DEPTH

The offline queue has no depth limit. Multi-hour and multi-day outages are handled without data loss. Each queued event is cryptographically ordered — the server-side merge cannot be manipulated.

Automatic Timesheet Generation

Timesheets are generated from the sealed punch records — daily and weekly. The HR role can review and approve timesheets; the employee can view their own. Timesheets are generated in both French and English according to each employee's language preference.

DAILY SUMMARY

Total hours, punch-in/out times, GPS verification flags, break deductions

WEEKLY TIMESHEET

Aggregated weekly hours per employee with day-by-day breakdown

OVERTIME DETECTION

Configurable thresholds (daily 8hr / weekly 40hr Quebec defaults). Overtime hours highlighted in HR view.

PDF EXPORT

Branded PDF with company logo — signable by HR and employee for payroll submission

PAYROLL INTEGRATION

CSV export format compatible with major Quebec payroll providers

GPS Punch Verification

Each punch-in and punch-out is GPS-stamped. The HR module displays the punch location on the 3D Map, enabling supervisors to verify that employees punched in at the correct site. If an employee punches in outside of a configured client site geofence, the punch is flagged — not rejected — for HR review.

For organization-issued devices, GPS tracking can be enforced by policy. For personal devices, employees can review their GPS tracking status and understand exactly what location data is recorded. Opt-out is available for personal devices, subject to HR policy.