Shiftly

The problem

What it solves

A site runs Hikvision turnstiles that already know who walked through and when. The question this codebase answers is what to do with that stream: authenticate against the devices, survive them going offline, and turn a day of raw passages into an attendance record somebody is willing to sign. Schedules, absences and late minutes are computed from events rather than entered by hand.

Day one

What the boilerplate supplied

Before a line of Shiftly was written, these 11 packages were already working. This project forked a later ShipKit than the others here, so its baseline is wider and its own additions below are only what it genuinely wrote.

That was the baseline Shiftly forked from. ShipKit ships 18 packages and 7 apps today, so some of what follows is now included out of the box.

On top

What this project added

• ▸packages/hikvision — a device client with HTTP digest auth, an event parser, a face-image multipart uploader and a status probe, each with its own tests.
• ▸TimescaleDB hypertables on pass_events and ingest_log, plus a pass_daily continuous aggregate with its own refresh policy — the raw event stream is kept and the daily view is derived from it.
• ▸apps/miniapp — a Telegram Mini App, so staff check their own record without an install.
• ▸An 18-page admin covering employees, schedules, absences, devices, notifications and an audit trail.

Wired in

Integrations and stack

Third-party services

Stack

Measured

By the numbers

Counted from the repository, not estimated.

More

Other apps on the same boilerplate