feat(time): add span-based attendance tracking under 2.0

This commit is contained in:
2026-10-03 15:55:45 +02:00
parent 4c67ddd908
commit 677ae0f4fb
32 changed files with 1681 additions and 47 deletions

View File

@@ -0,0 +1,93 @@
CREATE TABLE staff_time_v2_accounts (
tenant_id bigint NOT NULL REFERENCES tenants(id), user_id uuid NOT NULL REFERENCES auth_users(id),
activated_at timestamptz NOT NULL DEFAULT now(), activated_by uuid REFERENCES auth_users(id),
PRIMARY KEY(tenant_id,user_id)
);
--> statement-breakpoint
CREATE TABLE staff_time_spans (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(), tenant_id bigint NOT NULL REFERENCES tenants(id),
user_id uuid NOT NULL REFERENCES auth_users(id),
type text NOT NULL CHECK(type IN ('work','vacation','sick','overtime_compensation','holiday','other')),
started_at timestamptz NOT NULL, ended_at timestamptz,
date_from date, date_to date, timezone text NOT NULL DEFAULT 'Europe/Berlin',
description text NOT NULL DEFAULT '', source text NOT NULL,
status text NOT NULL DEFAULT 'factual' CHECK(status IN ('factual','submitted','approved','rejected')),
version integer NOT NULL DEFAULT 1 CHECK(version > 0),
created_at timestamptz NOT NULL DEFAULT now(), updated_at timestamptz NOT NULL DEFAULT now(),
CHECK(ended_at IS NULL OR ended_at > started_at),
CHECK((date_from IS NULL AND date_to IS NULL) OR (type <> 'work' AND date_from IS NOT NULL AND date_to IS NOT NULL AND date_to > date_from AND ended_at IS NOT NULL)),
CHECK(status = 'factual' OR ended_at IS NOT NULL)
);
CREATE INDEX staff_time_spans_user_time ON staff_time_spans(tenant_id,user_id,started_at);
CREATE UNIQUE INDEX staff_time_spans_one_open ON staff_time_spans(tenant_id,user_id) WHERE ended_at IS NULL;
--> statement-breakpoint
CREATE TABLE staff_time_span_breaks (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(), span_id uuid NOT NULL REFERENCES staff_time_spans(id),
started_at timestamptz NOT NULL, ended_at timestamptz,
CHECK(ended_at IS NULL OR ended_at > started_at)
);
CREATE INDEX staff_time_span_breaks_parent ON staff_time_span_breaks(span_id);
CREATE UNIQUE INDEX staff_time_span_breaks_one_open ON staff_time_span_breaks(span_id) WHERE ended_at IS NULL;
CREATE TABLE staff_time_span_projects (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(), span_id uuid NOT NULL REFERENCES staff_time_spans(id),
project_id bigint NOT NULL REFERENCES projects(id), started_at timestamptz NOT NULL, ended_at timestamptz NOT NULL,
notes text NOT NULL DEFAULT '', CHECK(ended_at > started_at)
);
CREATE INDEX staff_time_span_projects_parent ON staff_time_span_projects(span_id);
--> statement-breakpoint
CREATE TABLE staff_time_span_history (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(), span_id uuid NOT NULL REFERENCES staff_time_spans(id),
actor_id uuid REFERENCES auth_users(id), action text NOT NULL, reason text NOT NULL DEFAULT '',
before_data jsonb, after_data jsonb NOT NULL, created_at timestamptz NOT NULL DEFAULT now()
);
CREATE INDEX staff_time_span_history_parent ON staff_time_span_history(span_id,created_at);
CREATE TABLE staff_time_v2_requests (
tenant_id bigint NOT NULL, user_id uuid NOT NULL, request_id text NOT NULL,
fingerprint text NOT NULL, response jsonb NOT NULL, created_at timestamptz NOT NULL DEFAULT now(),
PRIMARY KEY(tenant_id,user_id,request_id)
);
CREATE TABLE staff_time_span_origins (
tenant_id bigint NOT NULL, source_kind text NOT NULL, source_id uuid NOT NULL,
span_id uuid NOT NULL REFERENCES staff_time_spans(id), PRIMARY KEY(tenant_id,source_kind,source_id)
);
--> statement-breakpoint
-- The same lock as the service makes cutover atomic with concurrent legacy writers.
CREATE FUNCTION staff_time_legacy_write_guard() RETURNS trigger LANGUAGE plpgsql AS $$
DECLARE t bigint; u uuid;
BEGIN
IF TG_OP = 'DELETE' THEN t := OLD.tenant_id; u := OLD.user_id;
ELSE t := NEW.tenant_id; u := NEW.user_id; END IF;
PERFORM pg_advisory_xact_lock(hashtextextended('staff-time:' || t || ':' || u,0));
IF EXISTS(SELECT 1 FROM staff_time_v2_accounts WHERE tenant_id=t AND user_id=u) THEN
RAISE EXCEPTION 'Zeiterfassung 2.0 ist aktiv. Bitte die neue Erfassung verwenden.' USING ERRCODE='23514';
END IF;
IF TG_OP = 'DELETE' THEN RETURN OLD; END IF;
RETURN NEW;
END $$;
CREATE TRIGGER staff_time_events_cutover BEFORE INSERT OR UPDATE OR DELETE ON staff_time_events FOR EACH ROW EXECUTE FUNCTION staff_time_legacy_write_guard();
CREATE TRIGGER staff_time_entries_cutover BEFORE INSERT OR UPDATE OR DELETE ON staff_time_entries FOR EACH ROW EXECUTE FUNCTION staff_time_legacy_write_guard();
--> statement-breakpoint
CREATE FUNCTION staff_time_span_overlap_guard() RETURNS trigger LANGUAGE plpgsql AS $$
BEGIN
PERFORM pg_advisory_xact_lock(hashtextextended('staff-time:' || NEW.tenant_id || ':' || NEW.user_id,0));
IF EXISTS(SELECT 1 FROM staff_time_spans s WHERE s.tenant_id=NEW.tenant_id AND s.user_id=NEW.user_id AND s.id<>NEW.id
AND s.started_at<COALESCE(NEW.ended_at,'infinity'::timestamptz) AND COALESCE(s.ended_at,'infinity'::timestamptz)>NEW.started_at) THEN
RAISE EXCEPTION 'Überlappende Zeitspannen' USING ERRCODE='23514';
END IF;
RETURN NEW;
END $$;
CREATE TRIGGER staff_time_span_no_overlap BEFORE INSERT OR UPDATE ON staff_time_spans FOR EACH ROW EXECUTE FUNCTION staff_time_span_overlap_guard();
--> statement-breakpoint
CREATE FUNCTION staff_time_legacy_project_guard() RETURNS trigger LANGUAGE plpgsql AS $$
DECLARE parent staff_time_entries;
BEGIN
IF TG_OP = 'DELETE' THEN SELECT * INTO parent FROM staff_time_entries WHERE id=OLD.time_entry_id;
ELSE SELECT * INTO parent FROM staff_time_entries WHERE id=NEW.time_entry_id; END IF;
PERFORM pg_advisory_xact_lock(hashtextextended('staff-time:' || parent.tenant_id || ':' || parent.user_id,0));
IF EXISTS(SELECT 1 FROM staff_time_v2_accounts WHERE tenant_id=parent.tenant_id AND user_id=parent.user_id) THEN
RAISE EXCEPTION 'Projektzeiten unter 2.0 bearbeiten.' USING ERRCODE='23514';
END IF;
IF TG_OP = 'DELETE' THEN RETURN OLD; END IF;
RETURN NEW;
END $$;
CREATE TRIGGER staff_time_project_cutover BEFORE INSERT OR UPDATE OR DELETE ON staff_time_entry_connects FOR EACH ROW EXECUTE FUNCTION staff_time_legacy_project_guard();

View File

@@ -540,6 +540,13 @@
"when": 1791072000000,
"tag": "0079_notification_matrix",
"breakpoints": true
},
{
"idx": 77,
"version": "7",
"when": 1791158400000,
"tag": "0080_staff_time_spans",
"breakpoints": true
}
]
}

View File

@@ -105,3 +105,4 @@ export * from "./scanner_inbox"
export * from "./collaboration";
export * from "./collaboration_federation"
export * from './staff_time_spans'

View File

@@ -0,0 +1,48 @@
import { pgTable, uuid, bigint, text, timestamp, date, integer, jsonb, primaryKey, index, uniqueIndex, check } from 'drizzle-orm/pg-core';
import { sql } from 'drizzle-orm';
import { tenants } from './tenants';
import { authUsers } from './auth_users';
import { projects } from './projects';
const stamp = (name: string) => timestamp(name, { withTimezone: true });
export const staffTimeV2Accounts = pgTable('staff_time_v2_accounts', {
tenant_id: bigint('tenant_id', { mode: 'number' }).notNull().references(() => tenants.id),
user_id: uuid('user_id').notNull().references(() => authUsers.id),
activated_at: stamp('activated_at').notNull().defaultNow(), activated_by: uuid('activated_by').references(() => authUsers.id),
}, t => [primaryKey({ columns: [t.tenant_id, t.user_id] })]);
export const staffTimeSpans = pgTable('staff_time_spans', {
id: uuid('id').primaryKey().defaultRandom(), tenant_id: bigint('tenant_id', { mode: 'number' }).notNull().references(() => tenants.id),
user_id: uuid('user_id').notNull().references(() => authUsers.id), type: text('type').notNull(),
started_at: stamp('started_at').notNull(), ended_at: stamp('ended_at'), date_from: date('date_from'), date_to: date('date_to'),
timezone: text('timezone').notNull().default('Europe/Berlin'), description: text('description').notNull().default(''), source: text('source').notNull(),
status: text('status').notNull().default('factual'), version: integer('version').notNull().default(1),
created_at: stamp('created_at').notNull().defaultNow(), updated_at: stamp('updated_at').notNull().defaultNow(),
}, t => [index('staff_time_spans_user_time').on(t.tenant_id, t.user_id, t.started_at),
uniqueIndex('staff_time_spans_one_open').on(t.tenant_id, t.user_id).where(sql `${t.ended_at} IS NULL`),
check('staff_time_spans_check', sql `${t.ended_at} IS NULL OR ${t.ended_at} > ${t.started_at}`),
check('staff_time_spans_type_check', sql `${t.type} IN ('work','vacation','sick','overtime_compensation','holiday','other')`),
check('staff_time_spans_status_check', sql `${t.status} IN ('factual','submitted','approved','rejected')`),
check('staff_time_spans_version_check', sql `${t.version} > 0`),
check('staff_time_spans_check1', sql `(${t.date_from} IS NULL AND ${t.date_to} IS NULL) OR (${t.type} <> 'work' AND ${t.date_from} IS NOT NULL AND ${t.date_to} IS NOT NULL AND ${t.date_to} > ${t.date_from} AND ${t.ended_at} IS NOT NULL)`),
check('staff_time_spans_check2', sql `${t.status} = 'factual' OR ${t.ended_at} IS NOT NULL`)]);
export const staffTimeSpanBreaks = pgTable('staff_time_span_breaks', {
id: uuid('id').primaryKey().defaultRandom(), span_id: uuid('span_id').notNull().references(() => staffTimeSpans.id),
started_at: stamp('started_at').notNull(), ended_at: stamp('ended_at'),
}, t => [index('staff_time_span_breaks_parent').on(t.span_id), uniqueIndex('staff_time_span_breaks_one_open').on(t.span_id).where(sql `${t.ended_at} IS NULL`), check('staff_time_span_breaks_check', sql `${t.ended_at} IS NULL OR ${t.ended_at} > ${t.started_at}`)]);
export const staffTimeSpanProjects = pgTable('staff_time_span_projects', {
id: uuid('id').primaryKey().defaultRandom(), span_id: uuid('span_id').notNull().references(() => staffTimeSpans.id),
project_id: bigint('project_id', { mode: 'number' }).notNull().references(() => projects.id),
started_at: stamp('started_at').notNull(), ended_at: stamp('ended_at').notNull(), notes: text('notes').notNull().default(''),
}, t => [index('staff_time_span_projects_parent').on(t.span_id), check('staff_time_span_projects_check', sql `${t.ended_at} > ${t.started_at}`)]);
export const staffTimeSpanHistory = pgTable('staff_time_span_history', {
id: uuid('id').primaryKey().defaultRandom(), span_id: uuid('span_id').notNull().references(() => staffTimeSpans.id),
actor_id: uuid('actor_id').references(() => authUsers.id), action: text('action').notNull(), reason: text('reason').notNull().default(''),
before_data: jsonb('before_data'), after_data: jsonb('after_data').notNull(), created_at: stamp('created_at').notNull().defaultNow(),
}, t => [index('staff_time_span_history_parent').on(t.span_id, t.created_at)]);
export const staffTimeV2Requests = pgTable('staff_time_v2_requests', {
tenant_id: bigint('tenant_id', { mode: 'number' }).notNull(), user_id: uuid('user_id').notNull(), request_id: text('request_id').notNull(),
fingerprint: text('fingerprint').notNull(), response: jsonb('response').notNull(), created_at: stamp('created_at').notNull().defaultNow(),
}, t => [primaryKey({ columns: [t.tenant_id, t.user_id, t.request_id] })]);
export const staffTimeSpanOrigins = pgTable('staff_time_span_origins', {
tenant_id: bigint('tenant_id', { mode: 'number' }).notNull(), source_kind: text('source_kind').notNull(), source_id: uuid('source_id').notNull(),
span_id: uuid('span_id').notNull().references(() => staffTimeSpans.id),
}, t => [primaryKey({ columns: [t.tenant_id, t.source_kind, t.source_id] })]);