Add Qualifications module - DB schema, roadmap

This commit is contained in:
2026-03-12 19:47:12 +00:00
parent a44a848cdf
commit 7fe8460d9c
2 changed files with 433 additions and 0 deletions

View File

@@ -0,0 +1,182 @@
-- Migration: 003_qualifications.sql
-- Qualifikationen & Zertifikate Modul
-- Verfügbare Qualifikationstypen (System-weit)
CREATE TABLE IF NOT EXISTS qualification_types (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
key VARCHAR(50) UNIQUE NOT NULL,
name VARCHAR(100) NOT NULL,
description TEXT,
category VARCHAR(50) NOT NULL DEFAULT 'general',
has_expiry BOOLEAN DEFAULT true,
validity_months INTEGER, -- Standard-Gültigkeit in Monaten
is_required BOOLEAN DEFAULT false, -- Pflicht für alle MA?
icon VARCHAR(10) DEFAULT '📜',
sort_order INTEGER DEFAULT 0,
is_system BOOLEAN DEFAULT true, -- System-vorgegeben oder custom
created_at TIMESTAMPTZ DEFAULT NOW()
);
-- Standard-Qualifikationstypen einfügen
INSERT INTO qualification_types (key, name, description, category, has_expiry, validity_months, is_required, icon, sort_order, is_system) VALUES
-- Gesetzliche Pflicht
('sachkunde_34a', '§34a Sachkundenachweis', 'Sachkundeprüfung nach §34a GewO - Pflicht für Bewachungsgewerbe', 'legal', false, NULL, true, '📋', 1, true),
('unterrichtung_34a', '§34a Unterrichtungsnachweis', '40-Stunden Unterrichtung nach §34a GewO', 'legal', false, NULL, false, '📋', 2, true),
-- Waffen
('waffensachkunde', 'Waffensachkunde', 'Sachkundenachweis für Waffenbesitz', 'weapons', false, NULL, false, '🔫', 10, true),
('waffenschein_gruen', 'Waffenschein (grün)', 'Waffenschein für Schusswaffen', 'weapons', true, 36, false, '🟢', 11, true),
('waffenschein_gelb', 'Waffenschein (gelb)', 'Kleiner Waffenschein', 'weapons', true, 36, false, '🟡', 12, true),
-- Erste Hilfe & Sicherheit
('erste_hilfe', 'Erste-Hilfe-Kurs', 'Erste-Hilfe-Ausbildung (9 UE)', 'safety', true, 24, false, '🏥', 20, true),
('brandschutzhelfer', 'Brandschutzhelfer', 'Ausbildung zum Brandschutzhelfer', 'safety', true, 36, false, '🔥', 21, true),
('evakuierungshelfer', 'Evakuierungshelfer', 'Ausbildung zum Evakuierungshelfer', 'safety', true, 24, false, '🚪', 22, true),
('defibrillator', 'AED/Defibrillator', 'Einweisung Automatisierter Externer Defibrillator', 'safety', true, 24, false, '💓', 23, true),
-- Führerscheine
('fuehrerschein_b', 'Führerschein Klasse B', 'PKW Führerschein', 'driving', true, NULL, false, '🚗', 30, true),
('fuehrerschein_c', 'Führerschein Klasse C', 'LKW Führerschein', 'driving', true, 60, false, '🚛', 31, true),
('fuehrerschein_d', 'Führerschein Klasse D', 'Bus Führerschein', 'driving', true, 60, false, '🚌', 32, true),
-- Spezial-Ausbildungen
('personenschutz', 'Personenschutz', 'Ausbildung zum Personenschützer', 'special', false, NULL, false, '🛡️', 40, true),
('hundefuehrer', 'Diensthundeführer', 'Ausbildung zum Diensthundeführer', 'special', true, 12, false, '🐕', 41, true),
('intervention', 'Interventionskraft', 'Ausbildung zur Interventionskraft (IK)', 'special', false, NULL, false, '', 42, true),
('nsk', 'NSK (Notruf-Service-Kraft)', 'Notruf- und Service-Leitstelle', 'special', false, NULL, false, '📞', 43, true),
-- Sprachen
('sprache_englisch', 'Englisch', 'Englischkenntnisse', 'language', false, NULL, false, '🇬🇧', 50, true),
('sprache_franzoesisch', 'Französisch', 'Französischkenntnisse', 'language', false, NULL, false, '🇫🇷', 51, true),
('sprache_russisch', 'Russisch', 'Russischkenntnisse', 'language', false, NULL, false, '🇷🇺', 52, true),
('sprache_tuerkisch', 'Türkisch', 'Türkischkenntnisse', 'language', false, NULL, false, '🇹🇷', 53, true),
('sprache_arabisch', 'Arabisch', 'Arabischkenntnisse', 'language', false, NULL, false, '🇸🇦', 54, true)
ON CONFLICT (key) DO NOTHING;
-- Custom Qualifikationstypen pro Organisation
CREATE TABLE IF NOT EXISTS org_qualification_types (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
org_id UUID NOT NULL REFERENCES organizations(id) ON DELETE CASCADE,
key VARCHAR(50) NOT NULL,
name VARCHAR(100) NOT NULL,
description TEXT,
category VARCHAR(50) DEFAULT 'custom',
has_expiry BOOLEAN DEFAULT true,
validity_months INTEGER,
icon VARCHAR(10) DEFAULT '📜',
sort_order INTEGER DEFAULT 100,
created_at TIMESTAMPTZ DEFAULT NOW(),
UNIQUE(org_id, key)
);
-- Mitarbeiter-Qualifikationen
CREATE TABLE IF NOT EXISTS employee_qualifications (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
user_id UUID NOT NULL REFERENCES users(id) ON DELETE CASCADE,
org_id UUID NOT NULL REFERENCES organizations(id) ON DELETE CASCADE,
-- Entweder System-Typ oder Custom-Typ
qualification_type_id UUID REFERENCES qualification_types(id),
org_qualification_type_id UUID REFERENCES org_qualification_types(id),
-- Daten
issued_date DATE, -- Ausstellungsdatum
expiry_date DATE, -- Ablaufdatum (falls zutreffend)
issuer VARCHAR(255), -- Ausstellende Stelle
certificate_number VARCHAR(100), -- Zertifikatsnummer
-- Level/Stufe (optional)
level VARCHAR(50), -- z.B. "A1", "B2" für Sprachen
-- Dokument
document_url TEXT, -- Scan des Zertifikats
document_name VARCHAR(255),
-- Status
status VARCHAR(20) DEFAULT 'active', -- active, expired, revoked, pending
verified_by UUID REFERENCES users(id), -- Wer hat verifiziert
verified_at TIMESTAMPTZ,
-- Notizen
notes TEXT,
created_at TIMESTAMPTZ DEFAULT NOW(),
updated_at TIMESTAMPTZ DEFAULT NOW(),
-- Constraint: Entweder System-Typ oder Custom-Typ
CONSTRAINT chk_qualification_type CHECK (
(qualification_type_id IS NOT NULL AND org_qualification_type_id IS NULL) OR
(qualification_type_id IS NULL AND org_qualification_type_id IS NOT NULL)
)
);
-- Index für schnelle Abfragen
CREATE INDEX IF NOT EXISTS idx_emp_qual_user ON employee_qualifications(user_id);
CREATE INDEX IF NOT EXISTS idx_emp_qual_org ON employee_qualifications(org_id);
CREATE INDEX IF NOT EXISTS idx_emp_qual_expiry ON employee_qualifications(expiry_date);
CREATE INDEX IF NOT EXISTS idx_emp_qual_status ON employee_qualifications(status);
-- Erinnerungen für ablaufende Qualifikationen
CREATE TABLE IF NOT EXISTS qualification_reminders (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
employee_qualification_id UUID NOT NULL REFERENCES employee_qualifications(id) ON DELETE CASCADE,
reminder_date DATE NOT NULL,
days_before INTEGER NOT NULL, -- 30, 14, 7, 1
sent BOOLEAN DEFAULT false,
sent_at TIMESTAMPTZ,
created_at TIMESTAMPTZ DEFAULT NOW()
);
CREATE INDEX IF NOT EXISTS idx_qual_reminder_date ON qualification_reminders(reminder_date, sent);
-- View: Qualifikationen mit Details
CREATE OR REPLACE VIEW v_employee_qualifications AS
SELECT
eq.id,
eq.user_id,
eq.org_id,
u.first_name,
u.last_name,
u.email,
COALESCE(qt.key, oqt.key) as qualification_key,
COALESCE(qt.name, oqt.name) as qualification_name,
COALESCE(qt.category, oqt.category) as category,
COALESCE(qt.icon, oqt.icon) as icon,
COALESCE(qt.has_expiry, oqt.has_expiry) as has_expiry,
eq.issued_date,
eq.expiry_date,
eq.issuer,
eq.certificate_number,
eq.level,
eq.document_url,
eq.status,
eq.verified_by,
eq.verified_at,
eq.notes,
eq.created_at,
-- Berechnete Felder
CASE
WHEN eq.expiry_date IS NULL THEN 'no_expiry'
WHEN eq.expiry_date < CURRENT_DATE THEN 'expired'
WHEN eq.expiry_date < CURRENT_DATE + INTERVAL '30 days' THEN 'expiring_soon'
ELSE 'valid'
END as expiry_status,
CASE
WHEN eq.expiry_date IS NOT NULL
THEN eq.expiry_date - CURRENT_DATE
ELSE NULL
END as days_until_expiry
FROM employee_qualifications eq
JOIN users u ON eq.user_id = u.id
LEFT JOIN qualification_types qt ON eq.qualification_type_id = qt.id
LEFT JOIN org_qualification_types oqt ON eq.org_qualification_type_id = oqt.id;
-- Modul in modules Tabelle einfügen
INSERT INTO modules (key, name, description, icon, is_premium, price_monthly, price_yearly, sort_order) VALUES
('qualifications', 'Qualifikationen', 'Zertifikate, Nachweise & Ablauf-Tracking', '🎓', true, 29.00, 290.00, 10)
ON CONFLICT (key) DO UPDATE SET
name = EXCLUDED.name,
description = EXCLUDED.description,
price_monthly = EXCLUDED.price_monthly,
price_yearly = EXCLUDED.price_yearly;