@kernhq/module-hr 0.2.0 → 0.4.0

package/dist/server/jobs.js

@@ -0,0 +1,166 @@
+import { and, eq, inArray, isNull, lte, sql } from 'drizzle-orm';
+import { attendanceDays, offices, punches, schedules } from './schema.js';
+import { AttendanceService } from './services/attendance.js';
+import { todayIn } from './services/db.js';
+import { ResolveService } from './services/resolve.js';
+/**
+ * HR's scheduled work.
+ *
+ * One rule runs through all of it: **a cron expression fires in UTC, and this module's users do
+ * not live there.** A nightly job at 00:00 UTC closes an Amsterdam shift at 01:00 and an Istanbul
+ * one at 03:00, and gets Tehran's half-hour offset wrong in a way nobody would ever guess from the
+ * code. So the jobs run hourly and fan out per office, deciding for each whether *that office's*
+ * local boundary has passed.
+ */
+export function hrJobs() {
+    return [
+        {
+            /**
+             * Keep the punch partitions rolling.
+             *
+             * Runs monthly, creates a year ahead, and goes through the SQL function that also enables
+             * row-level security on what it creates. A partition made with a bare `CREATE TABLE ...
+             * PARTITION OF` is readable directly by any role holding SELECT on it, whatever the parent's
+             * policy says — which an integration test caught rather than a review.
+             *
+             * A missing partition still would not lose a punch: the DEFAULT partition catches it. This
+             * exists so that never becomes normal.
+             */
+            name: 'ensure-partitions',
+            cron: '0 3 1 * *',
+            handler: async (_input, { kernel }) => {
+                await kernel.database.db.execute(sql `
+          do $$
+          declare
+            m date := (date_trunc('month', now()) - interval '1 month')::date;
+            stop date := (date_trunc('month', now()) + interval '12 months')::date;
+          begin
+            while m < stop loop
+              perform "mod_hr".ensure_punch_partition(m);
+              m := (m + interval '1 month')::date;
+            end loop;
+          end $$;
+        `);
+                kernel.log.info({ module: 'hr' }, 'punch partitions ensured');
+            },
+        },
+        {
+            /**
+             * Close shifts somebody forgot to clock out of.
+             *
+             * Hourly, and per office rather than globally: "it is past 3am" is a different moment in every
+             * office, and a single UTC-timed sweep would close a Tehran shift mid-afternoon.
+             *
+             * The auto clock-out is written as a punch like any other, with `method: 'manual'` and a note,
+             * so the sheet shows that a machine closed the day rather than the person. That distinction is
+             * what a regularization request is later arguing about.
+             */
+            name: 'auto-clock-out',
+            cron: '5 * * * *',
+            handler: async (_input, { kernel }) => {
+                const attendance = new AttendanceService();
+                const resolve = new ResolveService();
+                const workspaces = await activeWorkspaces(kernel);
+                for (const workspaceId of workspaces)
+                    await kernel.database.withWorkspace(workspaceId, async (tx) => {
+                        const withAuto = await tx
+                            .select({ id: schedules.id, after: schedules.autoClockOutAfterMinutes })
+                            .from(schedules)
+                            .where(and(eq(schedules.workspaceId, workspaceId), isNull(schedules.archivedAt), sql `${schedules.autoClockOutAfterMinutes} is not null`));
+                        if (!withAuto.length)
+                            return;
+                        // Anyone with an `in` and no matching `out`, older than the longest configured window.
+                        const longest = Math.max(...withAuto.map((s) => s.after ?? 0));
+                        const cutoff = new Date(Date.now() - longest * 60_000);
+                        const open = await tx
+                            .select({
+                            personId: punches.personId,
+                            businessDate: punches.businessDate,
+                            at: punches.at,
+                        })
+                            .from(punches)
+                            .where(and(eq(punches.workspaceId, workspaceId), eq(punches.direction, 'in'), isNull(punches.voidedByPunchId), lte(punches.at, cutoff)));
+                        for (const row of open) {
+                            const rows = await attendance.punchesOn(tx, workspaceId, row.personId, row.businessDate);
+                            const stillOpen = rows.reduce((acc, r) => (r.direction === 'in' ? true : r.direction === 'out' ? false : acc), false);
+                            if (!stillOpen)
+                                continue;
+                            const resolution = await resolve.forPerson(tx, workspaceId, row.personId);
+                            const schedule = await attendance.scheduleFor(tx, workspaceId, row.personId, row.businessDate);
+                            if (!schedule.autoClockOutAfterMinutes)
+                                continue;
+                            if (Date.now() - row.at.getTime() < schedule.autoClockOutAfterMinutes * 60_000)
+                                continue;
+                            await tx.insert(punches).values({
+                                workspaceId,
+                                personId: row.personId,
+                                direction: 'out',
+                                at: new Date(row.at.getTime() + schedule.autoClockOutAfterMinutes * 60_000),
+                                businessDate: row.businessDate,
+                                timezone: resolution.timezone,
+                                method: 'manual',
+                                trust: 'trusted',
+                                note: 'Closed automatically: no clock-out recorded',
+                            });
+                            await attendance.recomputeDay(tx, workspaceId, row.personId, row.businessDate, resolution.timezone, schedule);
+                            kernel.log.info({ module: 'hr', personId: row.personId, businessDate: row.businessDate }, 'auto clock-out');
+                        }
+                    });
+            },
+        },
+        {
+            /**
+             * Rebuild recent unlocked days.
+             *
+             * Punches recompute their own day inline, so this exists for what that path cannot see: a
+             * calendar edited after the fact, a schedule changed retroactively, an enqueue that never
+             * ran. Anything it finds and changes is a bug worth knowing about rather than routine
+             * maintenance — which is why it logs a count instead of running silently.
+             *
+             * Locked days are never touched: a closed month must not move underneath a payroll already
+             * filed.
+             */
+            name: 'reconcile-days',
+            cron: '30 2 * * *',
+            handler: async (_input, { kernel }) => {
+                const attendance = new AttendanceService();
+                const resolve = new ResolveService();
+                const workspaces = await activeWorkspaces(kernel);
+                const WINDOW_DAYS = 14;
+                for (const workspaceId of workspaces)
+                    await kernel.database.withWorkspace(workspaceId, async (tx) => {
+                        const since = new Date(Date.now() - WINDOW_DAYS * 86_400_000).toISOString().slice(0, 10);
+                        const days = await tx
+                            .select({
+                            personId: attendanceDays.personId,
+                            businessDate: attendanceDays.businessDate,
+                        })
+                            .from(attendanceDays)
+                            .where(and(eq(attendanceDays.workspaceId, workspaceId), eq(attendanceDays.locked, false), sql `${attendanceDays.businessDate} >= ${since}`));
+                        let touched = 0;
+                        for (const day of days) {
+                            const resolution = await resolve.forPerson(tx, workspaceId, day.personId, day.businessDate);
+                            const schedule = await attendance.scheduleFor(tx, workspaceId, day.personId, day.businessDate);
+                            const r = await attendance.recomputeDay(tx, workspaceId, day.personId, day.businessDate, resolution.timezone, schedule);
+                            if (!r.locked)
+                                touched++;
+                        }
+                        if (touched)
+                            kernel.log.info({ module: 'hr', workspaceId, touched }, 'days reconciled');
+                    });
+            },
+        },
+    ];
+}
+/**
+ * Workspaces with HR switched on.
+ *
+ * Read from this module's own tables rather than asked of core on every tick: a workspace with an
+ * office has HR enabled, and one job run should not be N broker calls.
+ */
+async function activeWorkspaces(kernel) {
+    const { rows } = await kernel.database.pool.query(`select distinct workspace_id from mod_hr.offices where archived_at is null`);
+    return rows.map((r) => r.workspace_id);
+}
+export { inArray, offices, todayIn };
+//# sourceMappingURL=jobs.js.map

package/dist/server/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/server/jobs.ts"],"names":[],"mappings":"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"}