Compare commits

...
35 Commits
Author SHA1 Message Date
michael 649dd6f028 Final 2026-10-08 09:03:15 +02:00
michael fc0dfd0556 Update 2026-10-06 08:57:37 +02:00
michael e1456ed4ca v1.0.11-rc1 2026-10-02 08:50:10 +02:00
michael d5952d82bb Update 2026-09-30 16:59:14 +02:00
michael 35cb578a96 Update 2026-09-30 12:43:01 +02:00
michael 39690b1d2b Update 2026-09-29 14:17:08 +02:00
michael 62794f72f1 Update 2026-09-29 13:26:18 +02:00
michael c89d4825e2 Update 2026-09-29 07:46:21 +02:00
michael 2105a0c5f7 Update 2026-09-23 13:34:38 +00:00
michael 0c14a3acbd Update 2026-09-23 11:37:33 +00:00
michael fa6db04370 Update 2026-09-23 11:09:10 +00:00
michael 9be6c6e36a Update 2026-09-23 08:47:34 +00:00
michael 9107296900 Update 2026-09-23 08:33:48 +00:00
michael 008bc8d09c Update 2026-09-23 08:10:07 +00:00
michael d6c8877ed7 Update 2026-09-23 07:52:15 +00:00
michael 040f1903e6 Tag 2026-09-21 09:53:48 +00:00
michael 89429c70cf Tag 2026-09-21 09:46:53 +00:00
michael 904b123884 Tagessteuerung 2026-09-16 08:29:58 +00:00
michael 560b747d5d first 2026-09-16 06:23:26 +00:00
michael c5495ddffa rc1 2026-09-16 06:20:58 +00:00
michael 4f4fb0baf2 Update 2026-09-16 05:30:23 +00:00
michael 312dd3b3ad Update 2026-09-15 14:59:30 +00:00
michael 3ebcea0b3d Update 2026-09-15 14:26:46 +00:00
michael c66b5a9aa9 Update 2026-09-15 14:24:18 +00:00
michael d33b2c487d Update 2026-09-15 14:18:21 +00:00
michael 8a4cf3fc9b Update 2026-09-15 14:11:23 +00:00
michael 62d8f537a8 Update 2026-09-15 14:00:30 +00:00
michael 8288d9f7bc Update 2026-09-15 13:02:28 +00:00
michael 227644cfeb Update 2026-09-15 11:49:47 +00:00
michael 235c19e51b Update 2026-09-15 10:49:33 +00:00
michael c01d747352 Update 2026-09-15 09:51:30 +00:00
michael b7f7d7e793 Update 2026-09-14 06:42:52 +00:00
michael cfb96f03c0 move 2026-09-14 08:13:18 +02:00
michael 9a08bfbf44 Update 2026-09-11 10:52:13 +02:00
michael 87d6c9b3ce Update 2026-09-11 10:41:07 +02:00
52 changed files with 22232 additions and 2718 deletions

No files matched your search

+2
View File
@@ -2,6 +2,8 @@ TICKETTRACKER_IMAGE=git.d-razz.de/michael/tickettracker:latest
APP_PORT=3910
DATABASE_URL=postgresql://tickettracker:change-me@10.10.10.23:5432/tickettracker
SECRET_ENCRYPTION_KEY=change-me-secret-encryption-key
ZAMMAD_EMAIL_WEBHOOK_TOKEN=change-me-zammad-webhook-token
DB_POOL_SIZE=10
COOKIE_SECURE=false
+2
View File
@@ -4,6 +4,8 @@ APP_PORT=3910
POSTGRES_DB=tickettracker
POSTGRES_USER=tickettracker
POSTGRES_PASSWORD=change-me-db-password
SECRET_ENCRYPTION_KEY=change-me-secret-encryption-key
ZAMMAD_EMAIL_WEBHOOK_TOKEN=change-me-zammad-webhook-token
DB_POOL_SIZE=10
COOKIE_SECURE=false
+2
View File
@@ -1,4 +1,6 @@
DATABASE_URL=postgresql://tickettracker:change-me@10.10.10.23:5432/tickettracker
SECRET_ENCRYPTION_KEY=change-me-secret-encryption-key
ZAMMAD_EMAIL_WEBHOOK_TOKEN=change-me-zammad-webhook-token
APP_PORT=3910
TICKETTRACKER_IMAGE=git.d-razz.de/michael/tickettracker:latest
COOKIE_SECURE=false
+5 -2
View File
@@ -1,5 +1,8 @@
DATABASE_URL=postgresql://ticket:ticket@10.10.10.21:5433/tickettracker_dev
APP_PORT=3910
PP_PASSWORD='$ouzs4D$@RAi9'
DATABASE_URL=postgresql://tickettracker:${PP_PASSWORD}@172.22.0.4:5432/tickettracker_dev
APP_PORT=3911
TICKETTRACKER_IMAGE=git.d-razz.de/michael/tickettracker:latest
COOKIE_SECURE=false
DB_POOL_SIZE=10
ZAMMAD_EMAIL_WEBHOOK_TOKEN='sPXJc87R@ySW3uTFKjGFMrti8BcDkNv8mN2g71hRkdg='
SECRET_ENCRYPTION_KEY='7qDJ1bcJprs$eSv57c2QXmQKh4kT^kb/w0vPBeJ4z^4='
+1
View File
@@ -8,6 +8,7 @@
"dev": "tsx watch src/index.ts",
"build": "tsc -p tsconfig.json",
"start": "node dist/index.js",
"test": "node --import tsx --test test/*.test.ts",
"typecheck": "tsc -p tsconfig.json --noEmit"
},
"dependencies": {
+47 -2
View File
@@ -17,6 +17,21 @@ export type AuthUser = {
active: boolean;
zammad_user_id: string | null;
has_zammad_api_token: boolean;
teamspace_user_id: string | null;
has_teamspace_credentials: boolean;
zammad_email_session_webhook_enabled: boolean;
session_billing_prompt_enabled: boolean;
teamspace_time_tracking_enabled: boolean;
zammad_session_note_default_enabled: boolean;
zammad_time_unit_rounding_enabled: boolean;
zammad_time_unit_rounding_minutes: number;
zammad_atoss_email_sync_enabled: boolean;
zammad_article_type_id: number;
project_followup_enabled: boolean;
project_followup_weeks: number;
project_followup_second_enabled: boolean;
project_followup_second_weeks: number;
project_followup_complete_on_session: boolean;
};
declare global {
@@ -77,7 +92,22 @@ function publicUser(user: AuthUser) {
role: user.role,
active: user.active,
zammad_user_id: user.zammad_user_id ?? null,
has_zammad_api_token: Boolean(user.has_zammad_api_token)
has_zammad_api_token: Boolean(user.has_zammad_api_token),
teamspace_user_id: user.teamspace_user_id ?? null,
has_teamspace_credentials: Boolean(user.has_teamspace_credentials),
zammad_email_session_webhook_enabled: Boolean(user.zammad_email_session_webhook_enabled),
session_billing_prompt_enabled: Boolean(user.session_billing_prompt_enabled),
teamspace_time_tracking_enabled: Boolean(user.teamspace_time_tracking_enabled ?? true),
zammad_session_note_default_enabled: Boolean(user.zammad_session_note_default_enabled),
zammad_time_unit_rounding_enabled: Boolean(user.zammad_time_unit_rounding_enabled),
zammad_time_unit_rounding_minutes: Number(user.zammad_time_unit_rounding_minutes ?? 15),
zammad_atoss_email_sync_enabled: Boolean(user.zammad_atoss_email_sync_enabled ?? true),
zammad_article_type_id: Number(user.zammad_article_type_id ?? 6),
project_followup_enabled: Boolean(user.project_followup_enabled ?? true),
project_followup_weeks: Number(user.project_followup_weeks ?? 4),
project_followup_second_enabled: Boolean(user.project_followup_second_enabled ?? true),
project_followup_second_weeks: Number(user.project_followup_second_weeks ?? 2),
project_followup_complete_on_session: Boolean(user.project_followup_complete_on_session ?? true)
};
}
@@ -134,7 +164,22 @@ export async function requireAuth(req: Request, res: Response, next: NextFunctio
u.role,
u.active,
u.zammad_user_id::text AS zammad_user_id,
(u.zammad_api_token IS NOT NULL) AS has_zammad_api_token
(u.zammad_api_token IS NOT NULL) AS has_zammad_api_token,
u.teamspace_user_id::text AS teamspace_user_id,
(u.teamspace_device_id IS NOT NULL AND u.teamspace_device_password IS NOT NULL) AS has_teamspace_credentials,
u.zammad_email_session_webhook_enabled,
u.session_billing_prompt_enabled,
u.teamspace_time_tracking_enabled,
u.zammad_session_note_default_enabled,
u.zammad_time_unit_rounding_enabled,
u.zammad_time_unit_rounding_minutes,
u.zammad_atoss_email_sync_enabled,
COALESCE(u.zammad_article_type_id, 6) AS zammad_article_type_id,
u.project_followup_enabled,
u.project_followup_weeks,
u.project_followup_second_enabled,
u.project_followup_second_weeks,
u.project_followup_complete_on_session
FROM auth_sessions s
JOIN users u ON u.id = s.user_id
WHERE s.token_hash = $1
+365
View File
@@ -0,0 +1,365 @@
type QueryResult<T> = {
rows: T[];
rowCount: number | null;
};
export type QueryExecutor = {
query<T extends Record<string, unknown> = Record<string, unknown>>(text: string, params?: unknown[]): Promise<QueryResult<T>>;
};
export const databaseExportTables = [
"users",
"auth_sessions",
"app_settings",
"user_preferences",
"organizations",
"tickets",
"projects",
"project_teamspace_entries",
"hidden_user_projects",
"ticket_todos",
"recurring_billings",
"recurring_billing_slots",
"recurring_billing_exceptions",
"sessions",
"active_timers",
"ticket_month_closures",
"month_closures",
"ticket_day_closures",
"day_closures",
"ticket_day_billings",
"ticket_day_billing_acknowledgements"
] as const;
type ColumnInfo = {
columnName: string;
dataType: string;
udtName: string;
ordinalPosition: number;
isNullable: "YES" | "NO";
};
const jsonDataTypes = new Set(["json", "jsonb"]);
const insertBatchSize = 500;
export function quoteIdentifier(value: string) {
return `"${value.replace(/"/g, '""')}"`;
}
function quoteSqlString(value: string) {
return `'${value.replace(/'/g, "''")}'`;
}
function isJsonColumn(column?: Pick<ColumnInfo, "dataType" | "udtName">) {
return Boolean(column && (jsonDataTypes.has(column.dataType) || jsonDataTypes.has(column.udtName)));
}
function jsonValueForSql(value: unknown) {
if (value instanceof Date) {
return JSON.stringify(value.toISOString());
}
const json = JSON.stringify(value);
return json === undefined ? "null" : json;
}
export function sqlLiteral(value: unknown, column?: Pick<ColumnInfo, "dataType" | "udtName">): string {
if (value === null || value === undefined) {
return "NULL";
}
if (Buffer.isBuffer(value)) {
return `decode('${value.toString("hex")}', 'hex')`;
}
if (isJsonColumn(column)) {
return quoteSqlString(jsonValueForSql(value));
}
if (value instanceof Date) {
return quoteSqlString(value.toISOString());
}
if (typeof value === "boolean") {
return value ? "TRUE" : "FALSE";
}
if (typeof value === "number") {
if (!Number.isFinite(value)) {
throw new Error("Cannot export non-finite number");
}
return String(value);
}
if (typeof value === "bigint") {
return String(value);
}
if (typeof value === "object") {
return quoteSqlString(jsonValueForSql(value));
}
return quoteSqlString(String(value));
}
function chunk<T>(items: T[], size: number) {
const chunks: T[][] = [];
for (let index = 0; index < items.length; index += size) {
chunks.push(items.slice(index, index + size));
}
return chunks;
}
async function tableColumns(client: QueryExecutor, table: string) {
const result = await client.query<ColumnInfo>(
`
SELECT
column_name AS "columnName",
data_type AS "dataType",
udt_name AS "udtName",
ordinal_position::int AS "ordinalPosition",
is_nullable AS "isNullable"
FROM information_schema.columns
WHERE table_schema = 'public'
AND table_name = $1
ORDER BY ordinal_position ASC;
`,
[table]
);
return result.rows;
}
function orderByClause(columns: ColumnInfo[]) {
if (columns.some((column) => column.columnName === "id")) {
return ` ORDER BY ${quoteIdentifier("id")}`;
}
const orderableColumns = columns.filter((column) => !isJsonColumn(column)).map((column) => quoteIdentifier(column.columnName));
return orderableColumns.length > 0 ? ` ORDER BY ${orderableColumns.join(", ")}` : "";
}
async function sequenceNameForIdColumn(client: QueryExecutor, table: string, columns: ColumnInfo[]) {
if (!columns.some((column) => column.columnName === "id")) {
return null;
}
const result = await client.query<{ sequenceName: string | null }>(
"SELECT pg_get_serial_sequence($1, 'id') AS \"sequenceName\";",
[`public.${table}`]
);
return result.rows[0]?.sequenceName ?? null;
}
export function sequenceSetvalSql(table: string, sequenceName: string) {
const quotedTable = quoteIdentifier(table);
return `SELECT setval(${quoteSqlString(sequenceName)}, COALESCE((SELECT MAX("id") FROM ${quotedTable}), 1), COALESCE((SELECT MAX("id") FROM ${quotedTable}), 0) > 0);`;
}
export function nextSequenceIdAfterRestore(maxId: number | null | undefined) {
return maxId && maxId > 0 ? maxId + 1 : 1;
}
export async function exportTableSql(client: QueryExecutor, table: string) {
const columns = await tableColumns(client, table);
if (columns.length === 0) {
return [`-- Tabelle ${table} existiert nicht im aktuellen Schema.`];
}
const columnNames = columns.map((column) => column.columnName);
const quotedColumns = columnNames.map(quoteIdentifier);
const rowsResult = await client.query<Record<string, unknown>>(
`
SELECT ${quotedColumns.join(", ")}
FROM ${quoteIdentifier(table)}${orderByClause(columns)};
`
);
const lines = [`-- ${table}: ${rowsResult.rows.length} Datensatz/Datensätze`, `-- columns ${table}: ${columnNames.join(",")}`];
for (const rows of chunk(rowsResult.rows, insertBatchSize)) {
if (rows.length === 0) {
continue;
}
lines.push(
[
`INSERT INTO ${quoteIdentifier(table)} (${quotedColumns.join(", ")}) VALUES`,
rows
.map((row) => ` (${columns.map((column) => sqlLiteral(row[column.columnName], column)).join(", ")})`)
.join(",\n") + ";"
].join("\n")
);
}
const sequenceName = await sequenceNameForIdColumn(client, table, columns);
if (sequenceName) {
lines.push(sequenceSetvalSql(table, sequenceName));
}
return lines;
}
export async function currentTableColumns(client: QueryExecutor) {
const result = await client.query<{ table_name: string; column_name: string }>(
`
SELECT table_name, column_name
FROM information_schema.columns
WHERE table_schema = 'public'
AND table_name = ANY($1::text[])
ORDER BY table_name, ordinal_position ASC;
`,
[[...databaseExportTables]]
);
const columns = new Map<string, string[]>();
for (const row of result.rows) {
columns.set(row.table_name, [...(columns.get(row.table_name) ?? []), row.column_name]);
}
return columns;
}
export function restoreSqlText(sql: string) {
const trimmed = sql.replace(/^\uFEFF/, "").trim();
if (!trimmed.includes("TicketTracker Datenbankexport")) {
throw new Error("Nur TicketTracker-SQL-Backups können eingespielt werden");
}
return trimmed
.replace(/^\s*BEGIN\s*;\s*$/gim, "")
.replace(/^\s*SET\s+LOCAL\s+(?:lock_timeout|statement_timeout)\s*=\s*'[^']*'\s*;\s*$/gim, "")
.replace(/^\s*COMMIT\s*;\s*$/gim, "")
.replace(/TRUNCATE\s+TABLE[\s\S]*?;\s*/i, "")
.trim();
}
function parseDumpColumnList(value: string) {
const quoted = [...value.matchAll(/"((?:[^"]|"")+)"/g)].map((match) => match[1].replace(/""/g, '"'));
if (quoted.length > 0) {
return quoted;
}
return value
.split(",")
.map((column) => column.trim().replace(/^"|"$/g, ""))
.filter(Boolean);
}
export type RestoreValidationResult = {
valid: boolean;
checkedTables: number;
issues: string[];
};
export async function validateTicketTrackerBackup(client: QueryExecutor, sql: string): Promise<RestoreValidationResult> {
const issues: string[] = [];
let body = "";
try {
body = restoreSqlText(sql);
} catch (error) {
return {
valid: false,
checkedTables: 0,
issues: [error instanceof Error ? error.message : "Backup-Datei konnte nicht gelesen werden"]
};
}
const dumpColumns = new Map<string, Set<string>>();
for (const match of sql.matchAll(/^--\s*columns\s+([a-z_][a-z0-9_]*):\s*(.+)$/gim)) {
dumpColumns.set(match[1], new Set(parseDumpColumnList(match[2])));
}
for (const match of body.matchAll(/INSERT\s+INTO\s+"?([a-z_][a-z0-9_]*)"?\s*\(([^)]+)\)\s*VALUES/gi)) {
const table = match[1];
const columns = dumpColumns.get(table) ?? new Set<string>();
for (const column of parseDumpColumnList(match[2])) {
columns.add(column);
}
dumpColumns.set(table, columns);
}
for (const table of dumpColumns.keys()) {
if (!(databaseExportTables as readonly string[]).includes(table)) {
issues.push(`Dump enthält unbekannte Tabelle "${table}".`);
}
}
const dbColumns = await currentTableColumns(client);
for (const table of databaseExportTables) {
const currentColumns = dbColumns.get(table) ?? [];
const backupColumns = dumpColumns.get(table);
if (currentColumns.length === 0) {
issues.push(`Aktuelle Datenbank enthält Tabelle "${table}" nicht.`);
continue;
}
if (!backupColumns) {
issues.push(`Dump enthält keine Strukturinformationen für Tabelle "${table}". Bitte ein aktuelles TicketTracker-Backup verwenden.`);
continue;
}
const missingInDump = currentColumns.filter((column) => !backupColumns.has(column));
const extraInDump = [...backupColumns].filter((column) => !currentColumns.includes(column));
if (missingInDump.length > 0) {
issues.push(`Dump passt nicht zu Tabelle "${table}": Feld(er) fehlen: ${missingInDump.join(", ")}.`);
}
if (extraInDump.length > 0) {
issues.push(`Dump passt nicht zu Tabelle "${table}": unbekannte Feld(er): ${extraInDump.join(", ")}.`);
}
}
return {
valid: issues.length === 0,
checkedTables: databaseExportTables.length,
issues
};
}
export async function exportDatabaseSql(client: QueryExecutor) {
const lines = [
"-- TicketTracker Datenbankexport",
`-- Erstellt: ${new Date().toISOString()}`,
"--",
"-- Restore:",
"-- 1. Frische PostgreSQL-Datenbank erstellen.",
"-- 2. TicketTracker-Migrationen ausführen.",
"-- 3. TicketTracker-Backend stoppen.",
"-- 4. Diese Datei einspielen:",
"-- psql -v ON_ERROR_STOP=1 -d DATABASE -f backup.sql",
"-- 5. TicketTracker-Backend wieder starten.",
"--",
"-- Der Restore läuft atomar in einer Transaktion.",
"-- ACHTUNG: TRUNCATE benötigt exklusive PostgreSQL-Locks auf den betroffenen Tabellen.",
"-- Für den Restore sollte das TicketTracker-Backend gestoppt werden.",
"",
"BEGIN;",
"SET LOCAL lock_timeout = '10s';",
"SET LOCAL statement_timeout = '15min';",
`TRUNCATE TABLE ${[...databaseExportTables].reverse().map(quoteIdentifier).join(", ")} RESTART IDENTITY CASCADE;`
];
for (const table of databaseExportTables) {
lines.push("", ...(await exportTableSql(client, table)));
}
lines.push("", "COMMIT;", "");
return lines.join("\n");
}
+10391 -1094
View File
File diff suppressed because it is too large. Load diff
+600 -6
View File
@@ -1,4 +1,7 @@
import { query } from "./db.js";
import { encryptSecret, isEncryptedSecret } from "./secrets.js";
const zammadApiKeySettingKey = "zammad.api_key";
async function findMigrationAdmin() {
const adminResult = await query<{ id: string }>("SELECT id FROM users WHERE role = 'admin' ORDER BY id ASC LIMIT 1;");
@@ -39,6 +42,54 @@ async function ensureClosureOwnership(table: string, column: string, primaryKeyC
await query(`CREATE INDEX IF NOT EXISTS idx_${table}_${column}_user ON ${table}(${column}, user_id);`);
}
async function encryptStoredApiSecrets() {
const userTokenResult = await query<{ id: string; zammad_api_token: string | null }>(`
SELECT id::text AS id, zammad_api_token
FROM users
WHERE zammad_api_token IS NOT NULL;
`);
for (const row of userTokenResult.rows) {
if (row.zammad_api_token && !isEncryptedSecret(row.zammad_api_token)) {
await query("UPDATE users SET zammad_api_token = $1, updated_at = now() WHERE id = $2;", [encryptSecret(row.zammad_api_token), row.id]);
}
}
const teamspaceCredentialResult = await query<{ id: string; teamspace_device_id: string | null; teamspace_device_password: string | null }>(`
SELECT id::text AS id, teamspace_device_id, teamspace_device_password
FROM users
WHERE teamspace_device_id IS NOT NULL
OR teamspace_device_password IS NOT NULL;
`);
for (const row of teamspaceCredentialResult.rows) {
const updates: string[] = [];
const values: unknown[] = [];
if (row.teamspace_device_id && !isEncryptedSecret(row.teamspace_device_id)) {
values.push(encryptSecret(row.teamspace_device_id));
updates.push(`teamspace_device_id = $${values.length}`);
}
if (row.teamspace_device_password && !isEncryptedSecret(row.teamspace_device_password)) {
values.push(encryptSecret(row.teamspace_device_password));
updates.push(`teamspace_device_password = $${values.length}`);
}
if (updates.length > 0) {
values.push(row.id);
await query(`UPDATE users SET ${updates.join(", ")}, updated_at = now() WHERE id = $${values.length};`, values);
}
}
const zammadApiKeyResult = await query<{ value: string }>("SELECT value FROM app_settings WHERE key = $1;", [zammadApiKeySettingKey]);
const zammadApiKey = zammadApiKeyResult.rows[0]?.value ?? null;
if (zammadApiKey && !isEncryptedSecret(zammadApiKey)) {
await query("UPDATE app_settings SET value = $1, updated_at = now() WHERE key = $2;", [encryptSecret(zammadApiKey), zammadApiKeySettingKey]);
}
}
export async function migrate() {
await query(`
CREATE TABLE IF NOT EXISTS users (
@@ -62,6 +113,46 @@ export async function migrate() {
`);
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS zammad_api_token TEXT;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS zammad_user_id BIGINT;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS teamspace_device_id TEXT;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS teamspace_device_password TEXT;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS teamspace_user_id BIGINT;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS zammad_email_session_webhook_enabled BOOLEAN NOT NULL DEFAULT false;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS session_billing_prompt_enabled BOOLEAN NOT NULL DEFAULT true;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS teamspace_time_tracking_enabled BOOLEAN NOT NULL DEFAULT true;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS zammad_session_note_default_enabled BOOLEAN NOT NULL DEFAULT false;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS zammad_time_unit_rounding_enabled BOOLEAN NOT NULL DEFAULT false;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS zammad_time_unit_rounding_minutes INTEGER NOT NULL DEFAULT 15;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS zammad_atoss_email_sync_enabled BOOLEAN NOT NULL DEFAULT true;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS zammad_article_type_id INTEGER DEFAULT 6;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS project_followup_enabled BOOLEAN NOT NULL DEFAULT true;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS project_followup_weeks INTEGER NOT NULL DEFAULT 4;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS project_followup_second_enabled BOOLEAN NOT NULL DEFAULT true;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS project_followup_second_weeks INTEGER NOT NULL DEFAULT 2;");
await query("ALTER TABLE users ADD COLUMN IF NOT EXISTS project_followup_complete_on_session BOOLEAN NOT NULL DEFAULT true;");
await query("ALTER TABLE users DROP COLUMN IF EXISTS teamspace_subproject_assignment_enabled;");
await query("UPDATE users SET zammad_article_type_id = 6 WHERE zammad_article_type_id IS NULL;");
await query("ALTER TABLE users ALTER COLUMN zammad_article_type_id SET DEFAULT 6;");
await query("ALTER TABLE users ALTER COLUMN zammad_article_type_id SET NOT NULL;");
await query(`
ALTER TABLE users
DROP CONSTRAINT IF EXISTS users_zammad_time_unit_rounding_minutes_valid,
ADD CONSTRAINT users_zammad_time_unit_rounding_minutes_valid CHECK (zammad_time_unit_rounding_minutes IN (5, 10, 15, 30));
`);
await query(`
ALTER TABLE users
DROP CONSTRAINT IF EXISTS users_zammad_article_type_id_valid,
ADD CONSTRAINT users_zammad_article_type_id_valid CHECK (zammad_article_type_id IN (1, 2, 3, 4, 5, 6));
`);
await query(`
ALTER TABLE users
DROP CONSTRAINT IF EXISTS users_project_followup_weeks_valid,
ADD CONSTRAINT users_project_followup_weeks_valid CHECK (project_followup_weeks BETWEEN 1 AND 52);
`);
await query(`
ALTER TABLE users
DROP CONSTRAINT IF EXISTS users_project_followup_second_weeks_valid,
ADD CONSTRAINT users_project_followup_second_weeks_valid CHECK (project_followup_second_weeks BETWEEN 1 AND 52);
`);
await query(`
CREATE TABLE IF NOT EXISTS auth_sessions (
@@ -91,6 +182,8 @@ export async function migrate() {
);
`);
await encryptStoredApiSecrets();
await query(`
CREATE TABLE IF NOT EXISTS user_preferences (
user_id BIGINT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
@@ -143,7 +236,11 @@ export async function migrate() {
await query("ALTER TABLE tickets ADD COLUMN IF NOT EXISTS zammad_group_id BIGINT;");
await query("ALTER TABLE tickets ADD COLUMN IF NOT EXISTS zammad_priority_id BIGINT;");
await query("ALTER TABLE tickets ADD COLUMN IF NOT EXISTS zammad_state_id BIGINT;");
await query("UPDATE tickets SET zammad_state_id = 2 WHERE zammad_state_id = 1;");
await query("ALTER TABLE tickets ADD COLUMN IF NOT EXISTS zammad_owner_id BIGINT;");
await query("ALTER TABLE tickets ADD COLUMN IF NOT EXISTS user_id BIGINT REFERENCES users(id) ON DELETE SET NULL;");
await query("ALTER TABLE tickets ADD COLUMN IF NOT EXISTS zammad_merged_from_ticket_id BIGINT;");
await query("ALTER TABLE tickets ADD COLUMN IF NOT EXISTS zammad_merged_from_ticket_number TEXT;");
await query("ALTER TABLE tickets ADD COLUMN IF NOT EXISTS zammad_preferences JSONB NOT NULL DEFAULT '{}'::jsonb;");
await query(`
ALTER TABLE tickets
@@ -161,6 +258,55 @@ export async function migrate() {
END IF;
END $$;
`);
await query(`
WITH unique_zammad_users AS (
SELECT zammad_user_id, MIN(id) AS user_id
FROM users
WHERE role = 'user'
AND active
AND zammad_user_id IS NOT NULL
GROUP BY zammad_user_id
HAVING COUNT(*) = 1
),
zammad_ticket_owners AS (
SELECT t.id, uzu.user_id
FROM tickets t
LEFT JOIN unique_zammad_users uzu ON uzu.zammad_user_id = t.zammad_owner_id
WHERE t.zammad_owner_id IS NOT NULL
)
UPDATE tickets t
SET user_id = zto.user_id
FROM zammad_ticket_owners zto
WHERE t.id = zto.id
AND t.user_id IS DISTINCT FROM zto.user_id;
`);
await query(`
UPDATE tickets t
SET user_id = owner.user_id
FROM (
SELECT ticket_id, MIN(user_id) AS user_id
FROM projects
GROUP BY ticket_id
) owner
WHERE t.user_id IS NULL
AND t.zammad_owner_id IS NULL
AND t.id = owner.ticket_id;
`);
await query(`
UPDATE tickets t
SET user_id = owner.user_id
FROM (
SELECT ticket_id, MIN(user_id) AS user_id
FROM sessions
WHERE user_id IS NOT NULL
GROUP BY ticket_id
) owner
WHERE t.user_id IS NULL
AND t.zammad_owner_id IS NULL
AND t.id = owner.ticket_id;
`);
await query("CREATE INDEX IF NOT EXISTS idx_tickets_user ON tickets(user_id);");
await query("CREATE INDEX IF NOT EXISTS idx_tickets_zammad_owner ON tickets(zammad_owner_id);");
await query(`
CREATE TABLE IF NOT EXISTS sessions (
@@ -179,7 +325,7 @@ export async function migrate() {
billing_updated_at TIMESTAMPTZ,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
CONSTRAINT work_type_valid CHECK (work_type IN ('support', 'consulting')),
CONSTRAINT billing_status_valid CHECK (billing_status IS NULL OR billing_status IN ('billed', 'non_billable')),
CONSTRAINT billing_status_valid CHECK (billing_status IS NULL OR billing_status IN ('billable', 'billed', 'non_billable')),
CONSTRAINT duration_non_negative CHECK (duration_seconds >= 0),
CONSTRAINT rounded_minutes_positive CHECK (rounded_minutes >= 1),
CONSTRAINT ended_after_started CHECK (ended_at >= started_at)
@@ -193,6 +339,164 @@ export async function migrate() {
await query("ALTER TABLE sessions ADD COLUMN IF NOT EXISTS recurring_occurrence_date DATE;");
await query("ALTER TABLE sessions ADD COLUMN IF NOT EXISTS recurring_occurrence_key TEXT;");
await query("ALTER TABLE sessions ADD COLUMN IF NOT EXISTS project_teamspace_entry_id BIGINT;");
await query("ALTER TABLE sessions ADD COLUMN IF NOT EXISTS activity_html TEXT;");
await query(`
CREATE TABLE IF NOT EXISTS active_timers (
id BIGSERIAL PRIMARY KEY,
user_id BIGINT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
ticket_number TEXT NOT NULL,
organization_name TEXT,
work_type TEXT,
is_project BOOLEAN NOT NULL DEFAULT false,
project_name TEXT,
ticket_lookup_done BOOLEAN NOT NULL DEFAULT false,
activity TEXT NOT NULL DEFAULT '',
activity_html TEXT,
billing_status TEXT,
started_at TIMESTAMPTZ NOT NULL,
paused_total_ms BIGINT NOT NULL DEFAULT 0,
paused_at TIMESTAMPTZ,
phase TEXT NOT NULL DEFAULT 'running',
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
CONSTRAINT active_timers_ticket_number_format CHECK (ticket_number ~ '^Ticket#[0-9]{6}$'),
CONSTRAINT active_timers_work_type_valid CHECK (work_type IS NULL OR work_type IN ('support', 'consulting')),
CONSTRAINT active_timers_billing_status_valid CHECK (billing_status IS NULL OR billing_status IN ('billable', 'billed', 'non_billable')),
CONSTRAINT active_timers_phase_valid CHECK (phase IN ('running', 'paused')),
CONSTRAINT active_timers_paused_total_non_negative CHECK (paused_total_ms >= 0),
CONSTRAINT active_timers_paused_state_valid CHECK (
(phase = 'running' AND paused_at IS NULL)
OR (phase = 'paused' AND paused_at IS NOT NULL)
)
);
`);
await query("ALTER TABLE active_timers ADD COLUMN IF NOT EXISTS organization_name TEXT;");
await query("ALTER TABLE active_timers ADD COLUMN IF NOT EXISTS work_type TEXT;");
await query("ALTER TABLE active_timers ADD COLUMN IF NOT EXISTS is_project BOOLEAN NOT NULL DEFAULT false;");
await query("ALTER TABLE active_timers ADD COLUMN IF NOT EXISTS project_name TEXT;");
await query("ALTER TABLE active_timers ADD COLUMN IF NOT EXISTS ticket_lookup_done BOOLEAN NOT NULL DEFAULT false;");
await query("ALTER TABLE active_timers ADD COLUMN IF NOT EXISTS activity TEXT NOT NULL DEFAULT '';");
await query("ALTER TABLE active_timers ADD COLUMN IF NOT EXISTS activity_html TEXT;");
await query("ALTER TABLE active_timers ADD COLUMN IF NOT EXISTS billing_status TEXT;");
await query("ALTER TABLE active_timers ADD COLUMN IF NOT EXISTS paused_total_ms BIGINT NOT NULL DEFAULT 0;");
await query("ALTER TABLE active_timers ADD COLUMN IF NOT EXISTS paused_at TIMESTAMPTZ;");
await query("ALTER TABLE active_timers ADD COLUMN IF NOT EXISTS phase TEXT NOT NULL DEFAULT 'running';");
await query("ALTER TABLE active_timers ADD COLUMN IF NOT EXISTS created_at TIMESTAMPTZ NOT NULL DEFAULT now();");
await query("ALTER TABLE active_timers ADD COLUMN IF NOT EXISTS updated_at TIMESTAMPTZ NOT NULL DEFAULT now();");
await query(`
ALTER TABLE active_timers
DROP CONSTRAINT IF EXISTS active_timers_ticket_number_format,
ADD CONSTRAINT active_timers_ticket_number_format CHECK (ticket_number ~ '^Ticket#[0-9]{6}$');
`);
await query(`
ALTER TABLE active_timers
DROP CONSTRAINT IF EXISTS active_timers_work_type_valid,
ADD CONSTRAINT active_timers_work_type_valid CHECK (work_type IS NULL OR work_type IN ('support', 'consulting'));
`);
await query(`
ALTER TABLE active_timers
DROP CONSTRAINT IF EXISTS active_timers_billing_status_valid,
ADD CONSTRAINT active_timers_billing_status_valid CHECK (billing_status IS NULL OR billing_status IN ('billable', 'billed', 'non_billable'));
`);
await query(`
ALTER TABLE active_timers
DROP CONSTRAINT IF EXISTS active_timers_phase_valid,
ADD CONSTRAINT active_timers_phase_valid CHECK (phase IN ('running', 'paused'));
`);
await query(`
ALTER TABLE active_timers
DROP CONSTRAINT IF EXISTS active_timers_paused_total_non_negative,
ADD CONSTRAINT active_timers_paused_total_non_negative CHECK (paused_total_ms >= 0);
`);
await query(`
ALTER TABLE active_timers
DROP CONSTRAINT IF EXISTS active_timers_paused_state_valid,
ADD CONSTRAINT active_timers_paused_state_valid CHECK (
(phase = 'running' AND paused_at IS NULL)
OR (phase = 'paused' AND paused_at IS NOT NULL)
);
`);
await query("CREATE UNIQUE INDEX IF NOT EXISTS idx_active_timers_user_ticket ON active_timers(user_id, ticket_number);");
await query("CREATE UNIQUE INDEX IF NOT EXISTS idx_active_timers_single_running ON active_timers(user_id) WHERE phase = 'running';");
await query("CREATE INDEX IF NOT EXISTS idx_active_timers_user_updated ON active_timers(user_id, updated_at);");
await query(`
ALTER TABLE sessions
DROP CONSTRAINT IF EXISTS billing_status_valid,
ADD CONSTRAINT billing_status_valid CHECK (billing_status IS NULL OR billing_status IN ('billable', 'billed', 'non_billable'));
`);
await query(`
CREATE TABLE IF NOT EXISTS zammad_email_session_events (
id BIGSERIAL PRIMARY KEY,
user_id BIGINT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
zammad_article_id BIGINT,
delivery_id TEXT,
session_id BIGINT REFERENCES sessions(id) ON DELETE SET NULL,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
CONSTRAINT zammad_email_session_event_source CHECK (zammad_article_id IS NOT NULL OR delivery_id IS NOT NULL)
);
`);
await query(`
CREATE UNIQUE INDEX IF NOT EXISTS idx_zammad_email_session_events_user_article
ON zammad_email_session_events(user_id, zammad_article_id)
WHERE zammad_article_id IS NOT NULL;
`);
await query(`
CREATE UNIQUE INDEX IF NOT EXISTS idx_zammad_email_session_events_delivery
ON zammad_email_session_events(delivery_id)
WHERE delivery_id IS NOT NULL;
`);
await query("CREATE INDEX IF NOT EXISTS idx_zammad_email_session_events_session ON zammad_email_session_events(session_id);");
await query(`
CREATE TABLE IF NOT EXISTS zammad_session_article_queue (
id BIGSERIAL PRIMARY KEY,
user_id BIGINT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
session_id BIGINT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
ticket_id BIGINT NOT NULL REFERENCES tickets(id) ON DELETE CASCADE,
ticket_number TEXT NOT NULL,
zammad_ticket_id BIGINT,
activity TEXT NOT NULL,
article_body TEXT,
article_content_type TEXT NOT NULL DEFAULT 'text/plain',
time_unit NUMERIC(10, 2) NOT NULL,
zammad_article_type_id INTEGER NOT NULL DEFAULT 6,
status TEXT NOT NULL DEFAULT 'pending',
attempt_count INTEGER NOT NULL DEFAULT 0,
last_error TEXT,
last_attempt_at TIMESTAMPTZ,
sent_at TIMESTAMPTZ,
zammad_article_id BIGINT,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
CONSTRAINT zammad_session_article_queue_status_valid CHECK (status IN ('pending', 'sent'))
);
`);
await query("ALTER TABLE zammad_session_article_queue ADD COLUMN IF NOT EXISTS article_body TEXT;");
await query("ALTER TABLE zammad_session_article_queue ADD COLUMN IF NOT EXISTS article_content_type TEXT NOT NULL DEFAULT 'text/plain';");
await query("UPDATE zammad_session_article_queue SET article_body = activity WHERE article_body IS NULL;");
await query(`
ALTER TABLE zammad_session_article_queue
DROP CONSTRAINT IF EXISTS zammad_session_article_queue_content_type_valid,
ADD CONSTRAINT zammad_session_article_queue_content_type_valid CHECK (article_content_type IN ('text/plain', 'text/html'));
`);
await query("ALTER TABLE zammad_session_article_queue ADD COLUMN IF NOT EXISTS zammad_article_type_id INTEGER DEFAULT 6;");
await query("UPDATE zammad_session_article_queue SET zammad_article_type_id = 6 WHERE zammad_article_type_id IS NULL;");
await query("ALTER TABLE zammad_session_article_queue ALTER COLUMN zammad_article_type_id SET DEFAULT 6;");
await query("ALTER TABLE zammad_session_article_queue ALTER COLUMN zammad_article_type_id SET NOT NULL;");
await query(`
ALTER TABLE zammad_session_article_queue
DROP CONSTRAINT IF EXISTS zammad_session_article_queue_type_id_valid,
ADD CONSTRAINT zammad_session_article_queue_type_id_valid CHECK (zammad_article_type_id IN (1, 2, 3, 4, 5, 6));
`);
await query(`
CREATE UNIQUE INDEX IF NOT EXISTS idx_zammad_session_article_queue_pending_session
ON zammad_session_article_queue(session_id)
WHERE status = 'pending';
`);
await query(`
CREATE INDEX IF NOT EXISTS idx_zammad_session_article_queue_user_pending
ON zammad_session_article_queue(user_id, created_at)
WHERE status = 'pending';
`);
if (adminId) {
await query("UPDATE sessions SET user_id = $1 WHERE user_id IS NULL;", [adminId]);
}
@@ -437,14 +741,19 @@ export async function migrate() {
CREATE TABLE IF NOT EXISTS ticket_day_billings (
ticket_id BIGINT NOT NULL REFERENCES tickets(id) ON DELETE CASCADE,
user_id BIGINT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
project_teamspace_entry_id BIGINT,
day DATE NOT NULL,
billed_minutes INTEGER NOT NULL,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
PRIMARY KEY (ticket_id, user_id, day),
CONSTRAINT ticket_day_billings_minutes_non_negative CHECK (billed_minutes >= 0)
);
`);
await query("ALTER TABLE ticket_day_billings ADD COLUMN IF NOT EXISTS project_teamspace_entry_id BIGINT;");
await query("ALTER TABLE ticket_day_billings DROP CONSTRAINT IF EXISTS ticket_day_billings_pkey;");
await query("DROP INDEX IF EXISTS idx_ticket_day_billings_ticket_user_day_default;");
await query("DROP INDEX IF EXISTS idx_ticket_day_billings_ticket_user_day_entry;");
await query("DROP INDEX IF EXISTS idx_ticket_day_billings_ticket_user_day_subentry;");
await query(`
CREATE TABLE IF NOT EXISTS ticket_day_billing_acknowledgements (
@@ -469,6 +778,7 @@ export async function migrate() {
hour_budget_minutes INTEGER,
manual_consumption_minutes INTEGER NOT NULL DEFAULT 0,
closed_at TIMESTAMPTZ,
close_review_required BOOLEAN NOT NULL DEFAULT false,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
UNIQUE (user_id, ticket_id),
@@ -479,7 +789,45 @@ export async function migrate() {
`);
await query("ALTER TABLE projects ADD COLUMN IF NOT EXISTS closed_at TIMESTAMPTZ;");
await query("ALTER TABLE projects ADD COLUMN IF NOT EXISTS close_review_required BOOLEAN NOT NULL DEFAULT false;");
await query("ALTER TABLE projects ADD COLUMN IF NOT EXISTS manual_consumption_minutes INTEGER NOT NULL DEFAULT 0;");
await query("ALTER TABLE projects ADD COLUMN IF NOT EXISTS zammad_owner_id BIGINT;");
await query("ALTER TABLE projects ALTER COLUMN user_id DROP NOT NULL;");
await query(`
UPDATE projects p
SET zammad_owner_id = t.zammad_owner_id
FROM tickets t
WHERE p.ticket_id = t.id
AND p.zammad_owner_id IS NULL
AND t.zammad_owner_id IS NOT NULL;
`);
await query(`
UPDATE projects p
SET user_id = t.user_id,
zammad_owner_id = t.zammad_owner_id
FROM tickets t
WHERE p.ticket_id = t.id
AND t.zammad_owner_id IS NOT NULL
AND (
p.user_id IS DISTINCT FROM t.user_id
OR p.zammad_owner_id IS DISTINCT FROM t.zammad_owner_id
)
AND NOT EXISTS (
SELECT 1
FROM projects existing
WHERE existing.ticket_id = p.ticket_id
AND existing.id <> p.id
AND (
(t.user_id IS NOT NULL AND existing.user_id = t.user_id)
OR (
t.user_id IS NULL
AND existing.user_id IS NULL
AND existing.zammad_owner_id IS NOT DISTINCT FROM t.zammad_owner_id
)
)
);
`);
await query("CREATE UNIQUE INDEX IF NOT EXISTS idx_projects_zammad_owner_ticket ON projects(zammad_owner_id, ticket_id) WHERE user_id IS NULL AND zammad_owner_id IS NOT NULL;");
await query(`
DO $$
BEGIN
@@ -499,8 +847,10 @@ export async function migrate() {
id BIGSERIAL PRIMARY KEY,
project_id BIGINT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
teamspace_project TEXT,
teamspace_description TEXT NOT NULL DEFAULT '',
is_default BOOLEAN NOT NULL DEFAULT false,
hour_budget_minutes INTEGER,
budget_sync_disabled BOOLEAN NOT NULL DEFAULT false,
manual_consumption_minutes INTEGER NOT NULL DEFAULT 0,
display_order INTEGER NOT NULL DEFAULT 0,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
@@ -510,8 +860,119 @@ export async function migrate() {
);
`);
await query("ALTER TABLE project_teamspace_entries ADD COLUMN IF NOT EXISTS teamspace_description TEXT NOT NULL DEFAULT '';");
await query("ALTER TABLE project_teamspace_entries ADD COLUMN IF NOT EXISTS budget_sync_disabled BOOLEAN NOT NULL DEFAULT false;");
await query("ALTER TABLE project_teamspace_entries ADD COLUMN IF NOT EXISTS teamspace_api_project_id BIGINT;");
await query("ALTER TABLE project_teamspace_entries ADD COLUMN IF NOT EXISTS teamspace_api_project_url TEXT;");
await query("CREATE UNIQUE INDEX IF NOT EXISTS idx_project_teamspace_entries_default ON project_teamspace_entries(project_id) WHERE is_default;");
await query("CREATE INDEX IF NOT EXISTS idx_project_teamspace_entries_project_order ON project_teamspace_entries(project_id, display_order, id);");
await query("CREATE INDEX IF NOT EXISTS idx_project_teamspace_entries_ts_api_id ON project_teamspace_entries(teamspace_api_project_id) WHERE teamspace_api_project_id IS NOT NULL;");
await query(`
CREATE TABLE IF NOT EXISTS project_teamspace_subentries (
id BIGSERIAL PRIMARY KEY,
user_id BIGINT REFERENCES users(id) ON DELETE CASCADE,
project_teamspace_entry_id BIGINT NOT NULL REFERENCES project_teamspace_entries(id) ON DELETE CASCADE,
teamspace_api_project_id BIGINT NOT NULL,
teamspace_api_project_url TEXT,
teamspace_project_id TEXT,
billing_type TEXT,
name TEXT,
alias TEXT NOT NULL DEFAULT '',
description TEXT NOT NULL DEFAULT '',
progress INTEGER,
planned_minutes INTEGER,
sum_minutes INTEGER,
planned_minutes_billable INTEGER,
sum_minutes_billable INTEGER,
planned_income NUMERIC,
sum_income NUMERIC,
display_order INTEGER NOT NULL DEFAULT 0,
synced_at TIMESTAMPTZ NOT NULL DEFAULT now(),
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
`);
await query("ALTER TABLE project_teamspace_subentries ADD COLUMN IF NOT EXISTS user_id BIGINT REFERENCES users(id) ON DELETE CASCADE;");
await query(`
UPDATE project_teamspace_subentries pts
SET user_id = p.user_id
FROM project_teamspace_entries pte
JOIN projects p ON p.id = pte.project_id
WHERE pte.id = pts.project_teamspace_entry_id
AND pts.user_id IS NULL
AND p.user_id IS NOT NULL;
`);
await query(`
DO $$
DECLARE
constraint_name text;
BEGIN
SELECT c.conname
INTO constraint_name
FROM pg_constraint c
JOIN pg_class t ON t.oid = c.conrelid
JOIN pg_namespace n ON n.oid = t.relnamespace
WHERE n.nspname = current_schema()
AND t.relname = 'project_teamspace_subentries'
AND c.contype = 'u'
AND pg_get_constraintdef(c.oid) LIKE '%project_teamspace_entry_id%'
AND pg_get_constraintdef(c.oid) LIKE '%teamspace_api_project_id%'
AND pg_get_constraintdef(c.oid) NOT LIKE '%user_id%'
LIMIT 1;
IF constraint_name IS NOT NULL THEN
EXECUTE format('ALTER TABLE project_teamspace_subentries DROP CONSTRAINT %I', constraint_name);
END IF;
END $$;
`);
await query("ALTER TABLE project_teamspace_subentries ADD COLUMN IF NOT EXISTS alias TEXT NOT NULL DEFAULT '';");
await query("ALTER TABLE project_teamspace_subentries ADD COLUMN IF NOT EXISTS description TEXT NOT NULL DEFAULT '';");
await query("ALTER TABLE project_teamspace_subentries ADD COLUMN IF NOT EXISTS billing_type TEXT;");
await query("ALTER TABLE project_teamspace_subentries ADD COLUMN IF NOT EXISTS planned_income NUMERIC;");
await query("ALTER TABLE project_teamspace_subentries ADD COLUMN IF NOT EXISTS sum_income NUMERIC;");
await query("ALTER TABLE project_teamspace_subentries DROP CONSTRAINT IF EXISTS project_teamspace_subentries_hour_budget_nonnegative;");
await query("ALTER TABLE project_teamspace_subentries DROP CONSTRAINT IF EXISTS project_teamspace_subentries_manual_consumption_nonnegative;");
await query("ALTER TABLE project_teamspace_subentries DROP CONSTRAINT IF EXISTS project_teamspace_subentries_manual_unit_quantity_nonnegative;");
await query("ALTER TABLE project_teamspace_subentries DROP COLUMN IF EXISTS hour_budget_minutes;");
await query("ALTER TABLE project_teamspace_subentries DROP COLUMN IF EXISTS manual_consumption_minutes;");
await query("ALTER TABLE project_teamspace_subentries DROP COLUMN IF EXISTS manual_unit_quantity;");
await query("ALTER TABLE project_teamspace_subentries DROP COLUMN IF EXISTS is_fulfilled;");
await query("CREATE INDEX IF NOT EXISTS idx_project_teamspace_subentries_entry_order ON project_teamspace_subentries(project_teamspace_entry_id, display_order, id);");
await query("CREATE INDEX IF NOT EXISTS idx_project_teamspace_subentries_user_entry_order ON project_teamspace_subentries(user_id, project_teamspace_entry_id, display_order, id);");
await query("CREATE UNIQUE INDEX IF NOT EXISTS idx_project_teamspace_subentries_user_entry_api ON project_teamspace_subentries(user_id, project_teamspace_entry_id, teamspace_api_project_id);");
await query(`
DO $$
BEGIN
IF EXISTS (
SELECT 1 FROM pg_constraint
WHERE conname = 'ticket_day_billings_project_teamspace_entry_fkey'
AND confdeltype <> 'n'
) THEN
ALTER TABLE ticket_day_billings
DROP CONSTRAINT ticket_day_billings_project_teamspace_entry_fkey;
END IF;
IF NOT EXISTS (
SELECT 1 FROM pg_constraint WHERE conname = 'ticket_day_billings_project_teamspace_entry_fkey'
) THEN
ALTER TABLE ticket_day_billings
ADD CONSTRAINT ticket_day_billings_project_teamspace_entry_fkey
FOREIGN KEY (project_teamspace_entry_id) REFERENCES project_teamspace_entries(id) ON DELETE SET NULL;
END IF;
ALTER TABLE ticket_day_billings
DROP CONSTRAINT IF EXISTS ticket_day_billings_project_teamspace_subentry_fkey;
END $$;
`);
await query(`
CREATE TABLE IF NOT EXISTS hidden_user_projects (
user_id BIGINT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
project_id BIGINT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
hidden_at TIMESTAMPTZ NOT NULL DEFAULT now(),
PRIMARY KEY (user_id, project_id)
);
`);
await query("CREATE INDEX IF NOT EXISTS idx_hidden_user_projects_project ON hidden_user_projects(project_id, user_id);");
await query(`
DO $$
BEGIN
@@ -524,6 +985,78 @@ export async function migrate() {
END IF;
END $$;
`);
await query("ALTER TABLE sessions DROP CONSTRAINT IF EXISTS sessions_project_teamspace_subentry_fkey;");
await query(`
DO $$
BEGIN
IF EXISTS (
SELECT 1
FROM information_schema.columns
WHERE table_schema = current_schema()
AND table_name = 'sessions'
AND column_name = 'project_teamspace_subentry_id'
) THEN
UPDATE sessions s
SET project_teamspace_entry_id = COALESCE(s.project_teamspace_entry_id, pts.project_teamspace_entry_id)
FROM project_teamspace_subentries pts
WHERE s.project_teamspace_subentry_id = pts.id;
END IF;
END $$;
`);
await query(`
DO $$
BEGIN
IF EXISTS (
SELECT 1
FROM information_schema.columns
WHERE table_schema = current_schema()
AND table_name = 'ticket_day_billings'
AND column_name = 'project_teamspace_subentry_id'
) THEN
CREATE TEMP TABLE migrated_subentry_day_billings ON COMMIT DROP AS
SELECT
tdb.ticket_id,
tdb.user_id,
tdb.day,
pts.project_teamspace_entry_id,
SUM(tdb.billed_minutes)::int AS billed_minutes
FROM ticket_day_billings tdb
JOIN project_teamspace_subentries pts ON pts.id = tdb.project_teamspace_subentry_id
GROUP BY tdb.ticket_id, tdb.user_id, tdb.day, pts.project_teamspace_entry_id;
DELETE FROM ticket_day_billings tdb
WHERE tdb.project_teamspace_subentry_id IS NOT NULL;
UPDATE ticket_day_billings target
SET billed_minutes = target.billed_minutes + source.billed_minutes,
updated_at = now()
FROM migrated_subentry_day_billings source
WHERE target.ticket_id = source.ticket_id
AND target.user_id = source.user_id
AND target.day = source.day
AND target.project_teamspace_entry_id = source.project_teamspace_entry_id;
INSERT INTO ticket_day_billings (ticket_id, user_id, project_teamspace_entry_id, day, billed_minutes)
SELECT source.ticket_id, source.user_id, source.project_teamspace_entry_id, source.day, source.billed_minutes
FROM migrated_subentry_day_billings source
WHERE NOT EXISTS (
SELECT 1
FROM ticket_day_billings target
WHERE target.ticket_id = source.ticket_id
AND target.user_id = source.user_id
AND target.day = source.day
AND target.project_teamspace_entry_id = source.project_teamspace_entry_id
);
END IF;
END $$;
`);
await query("DROP INDEX IF EXISTS idx_sessions_project_teamspace_subentry;");
await query("DROP INDEX IF EXISTS idx_ticket_day_billings_teamspace_subentry;");
await query("DROP INDEX IF EXISTS idx_ticket_day_billings_ticket_user_day_subentry;");
await query("ALTER TABLE sessions DROP COLUMN IF EXISTS project_teamspace_subentry_id;");
await query("ALTER TABLE ticket_day_billings DROP COLUMN IF EXISTS project_teamspace_subentry_id;");
await query("CREATE UNIQUE INDEX IF NOT EXISTS idx_ticket_day_billings_ticket_user_day_default ON ticket_day_billings(ticket_id, user_id, day) WHERE project_teamspace_entry_id IS NULL;");
await query("CREATE UNIQUE INDEX IF NOT EXISTS idx_ticket_day_billings_ticket_user_day_entry ON ticket_day_billings(ticket_id, user_id, day, project_teamspace_entry_id) WHERE project_teamspace_entry_id IS NOT NULL;");
await query(`
UPDATE tickets t
@@ -537,13 +1070,26 @@ export async function migrate() {
`);
await query(`
INSERT INTO projects (user_id, ticket_id, teamspace_project, description, goals)
SELECT DISTINCT s.user_id, s.ticket_id, COALESCE(t.title, ''), '', ''
INSERT INTO projects (user_id, zammad_owner_id, ticket_id, teamspace_project, description, goals)
SELECT DISTINCT
CASE
WHEN t.zammad_owner_id IS NOT NULL THEN zammad_owner_user.id
ELSE s.user_id
END,
t.zammad_owner_id,
s.ticket_id,
COALESCE(t.title, ''),
'',
''
FROM sessions s
JOIN tickets t ON t.id = s.ticket_id
LEFT JOIN users zammad_owner_user
ON zammad_owner_user.role = 'user'
AND zammad_owner_user.active
AND zammad_owner_user.zammad_user_id = t.zammad_owner_id
WHERE s.work_type = 'consulting'
AND s.user_id IS NOT NULL
ON CONFLICT (user_id, ticket_id) DO NOTHING;
ON CONFLICT DO NOTHING;
`);
await query(`
@@ -663,7 +1209,8 @@ export async function migrate() {
await query("CREATE UNIQUE INDEX IF NOT EXISTS idx_sessions_recurring_occurrence_key ON sessions(recurring_occurrence_key) WHERE recurring_occurrence_key IS NOT NULL;");
await query("CREATE INDEX IF NOT EXISTS idx_sessions_billing_status ON sessions(billing_status);");
await query("CREATE INDEX IF NOT EXISTS idx_ticket_day_closures_day ON ticket_day_closures(day);");
await query("CREATE INDEX IF NOT EXISTS idx_ticket_day_billings_user_day ON ticket_day_billings(user_id, day);");
await query("CREATE INDEX IF NOT EXISTS idx_ticket_day_billings_user_day ON ticket_day_billings(user_id, day);");
await query("CREATE INDEX IF NOT EXISTS idx_ticket_day_billings_teamspace_entry ON ticket_day_billings(project_teamspace_entry_id);");
await query("CREATE INDEX IF NOT EXISTS idx_ticket_day_billing_ack_user_day ON ticket_day_billing_acknowledgements(user_id, day);");
await query("CREATE INDEX IF NOT EXISTS idx_projects_user_ticket ON projects(user_id, ticket_id);");
await query("CREATE INDEX IF NOT EXISTS idx_projects_user_updated ON projects(user_id, updated_at DESC);");
@@ -672,6 +1219,53 @@ export async function migrate() {
await query("CREATE INDEX IF NOT EXISTS idx_ticket_todos_ticket_user ON ticket_todos(ticket_id, user_id);");
await query("CREATE INDEX IF NOT EXISTS idx_ticket_todos_user_period ON ticket_todos(user_id, starts_on, ends_on);");
await query("CREATE INDEX IF NOT EXISTS idx_ticket_todos_user_sort_order ON ticket_todos(user_id, sort_order, id);");
await query(`
CREATE TABLE IF NOT EXISTS project_followup_reminders (
id BIGSERIAL PRIMARY KEY,
user_id BIGINT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
project_id BIGINT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
ticket_id BIGINT NOT NULL REFERENCES tickets(id) ON DELETE CASCADE,
todo_id BIGINT REFERENCES ticket_todos(id) ON DELETE SET NULL,
stage INTEGER NOT NULL DEFAULT 1,
latest_tt_update_at TIMESTAMPTZ NOT NULL,
due_on DATE NOT NULL,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
CONSTRAINT project_followup_reminders_stage_valid CHECK (stage IN (1, 2))
);
`);
await query("ALTER TABLE project_followup_reminders ADD COLUMN IF NOT EXISTS stage INTEGER NOT NULL DEFAULT 1;");
await query(`
ALTER TABLE project_followup_reminders
DROP CONSTRAINT IF EXISTS project_followup_reminders_stage_valid,
ADD CONSTRAINT project_followup_reminders_stage_valid CHECK (stage IN (1, 2));
`);
await query(`
DO $$
DECLARE
constraint_name text;
BEGIN
SELECT c.conname
INTO constraint_name
FROM pg_constraint c
WHERE c.conrelid = 'project_followup_reminders'::regclass
AND c.contype = 'u'
AND c.conkey = ARRAY[
(SELECT attnum FROM pg_attribute WHERE attrelid = 'project_followup_reminders'::regclass AND attname = 'user_id'),
(SELECT attnum FROM pg_attribute WHERE attrelid = 'project_followup_reminders'::regclass AND attname = 'project_id'),
(SELECT attnum FROM pg_attribute WHERE attrelid = 'project_followup_reminders'::regclass AND attname = 'latest_tt_update_at')
]::smallint[];
IF constraint_name IS NOT NULL THEN
EXECUTE format('ALTER TABLE project_followup_reminders DROP CONSTRAINT %I', constraint_name);
END IF;
END $$;
`);
await query("CREATE UNIQUE INDEX IF NOT EXISTS idx_project_followup_reminders_unique_stage ON project_followup_reminders(user_id, project_id, latest_tt_update_at, stage);");
await query("CREATE INDEX IF NOT EXISTS idx_project_followup_reminders_user_project ON project_followup_reminders(user_id, project_id, latest_tt_update_at DESC);");
await query("CREATE INDEX IF NOT EXISTS idx_project_followup_reminders_todo ON project_followup_reminders(todo_id) WHERE todo_id IS NOT NULL;");
await query("CREATE INDEX IF NOT EXISTS idx_recurring_billings_user_active ON recurring_billings(user_id, active);");
await query("UPDATE recurring_billings SET active = true WHERE active = false;");
await query(`
+72
View File
@@ -0,0 +1,72 @@
import crypto from "node:crypto";
const encryptedSecretPrefix = "ttenc:v1:";
let warnedAboutFallbackKey = false;
let cachedKey: Buffer | null = null;
function getEncryptionMaterial() {
const configuredKey = process.env.SECRET_ENCRYPTION_KEY ?? process.env.TICKETTRACKER_SECRET_KEY;
if (configuredKey) {
return configuredKey;
}
if (!process.env.DATABASE_URL) {
throw new Error("SECRET_ENCRYPTION_KEY is required to encrypt database secrets");
}
if (!warnedAboutFallbackKey) {
console.warn("SECRET_ENCRYPTION_KEY is not set; deriving database secret encryption from DATABASE_URL.");
warnedAboutFallbackKey = true;
}
return process.env.DATABASE_URL;
}
function getEncryptionKey() {
if (!cachedKey) {
cachedKey = crypto.createHash("sha256").update(getEncryptionMaterial()).digest();
}
return cachedKey;
}
export function isEncryptedSecret(value: string | null | undefined) {
return typeof value === "string" && value.startsWith(encryptedSecretPrefix);
}
export function encryptSecret(value: string) {
if (isEncryptedSecret(value)) {
return value;
}
const iv = crypto.randomBytes(12);
const cipher = crypto.createCipheriv("aes-256-gcm", getEncryptionKey(), iv);
const encrypted = Buffer.concat([cipher.update(value, "utf8"), cipher.final()]);
const tag = cipher.getAuthTag();
return `${encryptedSecretPrefix}${iv.toString("base64url")}.${tag.toString("base64url")}.${encrypted.toString("base64url")}`;
}
export function decryptSecret(value: string | null | undefined) {
if (!value) {
return null;
}
if (!isEncryptedSecret(value)) {
return value;
}
const parts = value.slice(encryptedSecretPrefix.length).split(".");
if (parts.length !== 3) {
throw new Error("Encrypted database secret has an invalid format");
}
const [ivText, tagText, encryptedText] = parts;
const decipher = crypto.createDecipheriv("aes-256-gcm", getEncryptionKey(), Buffer.from(ivText, "base64url"));
decipher.setAuthTag(Buffer.from(tagText, "base64url"));
return Buffer.concat([decipher.update(Buffer.from(encryptedText, "base64url")), decipher.final()]).toString("utf8");
}
+38 -2
View File
@@ -1,6 +1,7 @@
export const ticketPattern = /^Ticket#\d{6}$/;
export const trackableTicketPattern = /^(Ticket#\d{6}|Fix#\d+)$/;
export const monthPattern = /^\d{4}-\d{2}$/;
export const weekPattern = /^\d{4}-W\d{2}$/;
export const dayPattern = /^\d{4}-\d{2}-\d{2}$/;
export const usernamePattern = /^\S{3,40}$/u;
@@ -87,6 +88,41 @@ export function parseDay(value: string) {
};
}
export function parseWeek(value: string) {
if (!weekPattern.test(value)) {
throw badRequest("week must use YYYY-Www");
}
const year = Number(value.slice(0, 4));
const week = Number(value.slice(6, 8));
if (!Number.isInteger(year) || !Number.isInteger(week) || week < 1 || week > 53) {
throw badRequest("week is invalid");
}
const jan4 = new Date(Date.UTC(year, 0, 4));
const jan4Weekday = jan4.getUTCDay() || 7;
const weekStart = new Date(jan4);
weekStart.setUTCDate(jan4.getUTCDate() - jan4Weekday + 1 + (week - 1) * 7);
const checkThursday = new Date(weekStart);
checkThursday.setUTCDate(weekStart.getUTCDate() + 3);
if (checkThursday.getUTCFullYear() !== year) {
throw badRequest("week is invalid");
}
const next = new Date(weekStart);
next.setUTCDate(weekStart.getUTCDate() + 7);
return {
label: value,
start: weekStart.toISOString().slice(0, 10),
startIso: weekStart.toISOString(),
endIso: next.toISOString()
};
}
export function parsePositiveInteger(value: unknown, field: string) {
const number = Number(value);
@@ -110,8 +146,8 @@ export function parseBillingStatus(value: unknown) {
return null;
}
if (value !== "billed" && value !== "non_billable") {
throw badRequest("billingStatus must be billed, non_billable or null");
if (value !== "billable" && value !== "billed" && value !== "non_billable") {
throw badRequest("billingStatus must be billable, billed, non_billable or null");
}
return value;
+97
View File
@@ -0,0 +1,97 @@
import assert from "node:assert/strict";
import test from "node:test";
import { nextSequenceIdAfterRestore, restoreSqlText, sequenceSetvalSql, sqlLiteral, type QueryExecutor } from "../src/databaseExport.ts";
import { exportTableSql } from "../src/databaseExport.ts";
const jsonbColumn = { dataType: "jsonb", udtName: "jsonb" };
test("sqlLiteral serializes primitive values", () => {
assert.equal(sqlLiteral(null), "NULL");
assert.equal(sqlLiteral(undefined), "NULL");
assert.equal(sqlLiteral("normaler Text"), "'normaler Text'");
assert.equal(sqlLiteral("O'Brien"), "'O''Brien'");
assert.equal(sqlLiteral("erste Zeile\nzweite Zeile"), "'erste Zeile\nzweite Zeile'");
assert.equal(sqlLiteral("Grüße"), "'Grüße'");
assert.equal(sqlLiteral(true), "TRUE");
assert.equal(sqlLiteral(false), "FALSE");
assert.equal(sqlLiteral(0), "0");
assert.equal(sqlLiteral(42), "42");
assert.equal(sqlLiteral(-10), "-10");
assert.equal(sqlLiteral(1.25), "1.25");
});
test("sqlLiteral serializes dates, buffers, objects and arrays", () => {
assert.equal(sqlLiteral(new Date("2026-09-11T10:15:30.000Z")), "'2026-09-11T10:15:30.000Z'");
assert.equal(sqlLiteral(Buffer.from("abc")), "decode('616263', 'hex')");
assert.equal(sqlLiteral({}), "'{}'");
assert.equal(sqlLiteral([]), "'[]'");
assert.equal(sqlLiteral({ foo: "bar" }), `'{"foo":"bar"}'`);
assert.equal(sqlLiteral({ foo: "O'Brien" }), `'{"foo":"O''Brien"}'`);
assert.equal(sqlLiteral({ nested: { enabled: true }, items: [{ id: 1 }] }), `'{"nested":{"enabled":true},"items":[{"id":1}]}'`);
});
test("sqlLiteral serializes JSON columns as valid JSON values", () => {
assert.equal(sqlLiteral({ foo: "bar", enabled: true }, jsonbColumn), `'{"foo":"bar","enabled":true}'`);
assert.equal(sqlLiteral("plain json string", jsonbColumn), `'"plain json string"'`);
assert.equal(sqlLiteral(true, jsonbColumn), "'true'");
});
test("generated table export never contains implicit object stringification", async () => {
const client: QueryExecutor = {
async query<T extends Record<string, unknown>>(text: string): Promise<{ rows: T[]; rowCount: number | null }> {
if (text.includes("information_schema.columns")) {
return {
rowCount: 3,
rows: [
{ columnName: "id", dataType: "bigint", udtName: "int8", ordinalPosition: 1, isNullable: "NO" },
{ columnName: "value", dataType: "jsonb", udtName: "jsonb", ordinalPosition: 2, isNullable: "NO" },
{ columnName: "label", dataType: "text", udtName: "text", ordinalPosition: 3, isNullable: "YES" }
] as T[]
};
}
if (text.includes("pg_get_serial_sequence")) {
return { rowCount: 1, rows: [{ sequenceName: "public.example_id_seq" }] as T[] };
}
return {
rowCount: 1,
rows: [{ id: 4, value: { foo: "bar" }, label: "O'Brien" }] as T[]
};
}
};
const sql = (await exportTableSql(client, "example")).join("\n");
assert.doesNotMatch(sql, /\[object Object\]/);
assert.match(sql, /'\{"foo":"bar"\}'/);
});
test("sequence helper advances after restored max id", () => {
assert.equal(nextSequenceIdAfterRestore(4), 5);
assert.equal(nextSequenceIdAfterRestore(null), 1);
assert.match(sequenceSetvalSql("users", "public.users_id_seq"), /SELECT setval\('public\.users_id_seq'/);
assert.match(sequenceSetvalSql("users", "public.users_id_seq"), /MAX\("id"\) FROM "users"/);
});
test("restoreSqlText removes dump transaction wrapper after export header", () => {
const body = restoreSqlText(`
-- TicketTracker Datenbankexport
-- Erstellt: 2026-09-14T10:00:00.000Z
BEGIN;
SET LOCAL lock_timeout = '10s';
SET LOCAL statement_timeout = '15min';
TRUNCATE TABLE "users", "auth_sessions" RESTART IDENTITY CASCADE;
INSERT INTO "users" ("id", "username") VALUES
(1, 'admin');
COMMIT;
`);
assert.doesNotMatch(body, /^\s*BEGIN\s*;/im);
assert.doesNotMatch(body, /^\s*COMMIT\s*;/im);
assert.doesNotMatch(body, /^\s*SET\s+LOCAL/im);
assert.doesNotMatch(body, /TRUNCATE\s+TABLE/i);
assert.match(body, /INSERT INTO "users"/);
});
+26
View File
@@ -0,0 +1,26 @@
import assert from "node:assert/strict";
import test from "node:test";
import { decryptSecret, encryptSecret, isEncryptedSecret } from "../src/secrets.js";
test("database secrets are encrypted and can be decrypted", () => {
process.env.SECRET_ENCRYPTION_KEY = "test-secret-key";
const encrypted = encryptSecret("zammad-token-with-specials-!$%&/()=?");
assert.equal(isEncryptedSecret(encrypted), true);
assert.notEqual(encrypted, "zammad-token-with-specials-!$%&/()=?");
assert.equal(decryptSecret(encrypted), "zammad-token-with-specials-!$%&/()=?");
});
test("plain legacy secrets are read as-is until migration encrypts them", () => {
assert.equal(decryptSecret("legacy-token"), "legacy-token");
assert.equal(decryptSecret(null), null);
});
test("already encrypted secrets are not encrypted twice", () => {
process.env.SECRET_ENCRYPTION_KEY = "test-secret-key";
const encrypted = encryptSecret("zammad-token");
assert.equal(encryptSecret(encrypted), encrypted);
});
+1
View File
@@ -0,0 +1 @@
{"_url":"https://app1.teamspace.de/api/project;limit=1000;depth=1;sort=projectId?parent=18260325&isActive=true&isTemplate=false","_links":[{"caption":"Self","href":"https://app1.teamspace.de/api/project;limit=1000;depth=1;sort=projectId?parent=18260325&isActive=true&isTemplate=false","rel":"self"},{"caption":"|< firstPage","href":"https://app1.teamspace.de/api/project;offset=0;limit=1000;sort=projectId?parent=18260325&isActive=true&isTemplate=false","rel":"first","title":"First page of projects of this CollectionResource"},{"caption":">| lastPage","href":"https://app1.teamspace.de/api/project;offset=0;limit=1000;sort=projectId?parent=18260325&isActive=true&isTemplate=false","rel":"last","title":"Last page of projects of this CollectionResource"}],"_etag":{"value":"ee49b390d3cca9c74112cb0d0dc361be","weak":false},"size":13,"offset":0,"limit":1000,"items":[{"caption":"Time Control Installation Software","title":"referenced resource","href":"https://app1.teamspace.de/api/project/18260341","lastModifiedDate":"2026-09-30T12:01:22.000+00:00","value":18260341,"idKey":"22","data":{"_url":"https://app1.teamspace.de/api/project/18260341","_id":18260341,"_idKey":"22","_links":[{"caption":"Holzwerk Schilling GmbH & Co. KG ∕ 49951 ∕ Neukunde","title":"parent project","href":"https://app1.teamspace.de/api/project/18260325","value":18260325,"idKey":"22","rel":"parent"}],"_lastModifiedDate":"2026-09-30T12:01:22.000+00:00","name":"Time Control Installation Software","mainprojectId":"EP-2025-Comp-009","mainProject":{"caption":"Holzwerk Schilling GmbH & Co. KG / 49951 / Neukunde","title":"main project","href":"https://app1.teamspace.de/api/project/18260325","value":18260325,"idKey":"22"},"projectId":"0001","path":"Holzwerk Schilling GmbH & Co. KG ∕ 49951 ∕ Neukunde/Time Control Installation Software","description":"","isMainproject":false,"isWorkpackage":true,"isActive":true,"type":null,"projectFolder":null,"projectWorkflow":null,"priority":null,"state":{"caption":"Abgeschlossen","title":"projectState","href":"https://app1.teamspace.de/api/projectstate/13338166","value":13338166,"idKey":"154","rel":"projectState set to this project","optionsUrl":"https://app1.teamspace.de/api/projectstate?workflow=13338231"},"stateRelevant":{"caption":"Abgeschlossen","title":"projectStateRelevant","href":"https://app1.teamspace.de/api/projectstate/13338166","value":13338166,"idKey":"154","rel":"effective projectState of this project"},"progress":100,"progressRelevant":100,"plannedMinutesEnabled":true,"sumMinutes":360,"plannedMinutesBillableEnabled":true,"sumMinutesBillable":180,"plannedMinutesPerformanceEnabled":true,"sumMinutesPerformance":0,"plannedWorkingCostsEnabled":true,"sumWorkingCosts":0.0,"plannedExpensesEnabled":true,"sumExpenses":0.0,"plannedIncomeEnabled":true,"plannedIncome":360.0,"plannedIncomeCalculated":360.0,"sumIncome":360.0,"customer":{"caption":"CompData Computer GmbH","title":"customer","href":"https://app1.teamspace.de/api/organization/13905417","value":13905417,"idKey":"78"},"customerContact":null,"contractor":{"caption":"AIKAVA GmbH","title":"contractor","href":"https://app1.teamspace.de/api/organization/13343077","value":13343077,"idKey":"78"},"contractorContact":null,"currency":{"title":"currency","href":"https://app1.teamspace.de/api/currency/13337775","value":13337775,"idKey":"105"},"colorlabel":null,"colorlabelRelevant":null,"contractPositions":[{"caption":"Contract position","title":"contractPosition","href":"https://app1.teamspace.de/api/contractposition/18260213","value":18260213,"idKey":"104"}],"exportId":null,"exportComment":null,"exportDate":null,"customfields":[],"article":null,"articleRelevant":null,"ticket":null,"endless":false,"parent":{"caption":"Holzwerk Schilling GmbH & Co. KG ∕ 49951 ∕ Neukunde","title":"parent project","href":"https://app1.teamspace.de/api/project/18260325","value":18260325,"idKey":"22","rel":"parent"}},"path":"Holzwerk Schilling GmbH & Co. KG ∕ 49951 ∕ Neukunde/Time Control Installation Software","rel":"link"},{"caption":"Time Control Installation Kommunikationssoftware","title":"referenced resource","href":"https://app1.teamspace.de/api/project/18260349","lastModifiedDate":"2026-09-30T12:01:22.000+00:00","value":18260349,"idKey":"22","data":{"_url":"https://app1.teamspace.de/api/project/18260349","_id":18260349,"_idKey":"22","_links":[{"caption":"Holzwerk Schilling GmbH & Co. KG ∕ 49951 ∕ Neukunde","title":"parent project","href":"https://app1.teamspace.de/api/project/18260325","value":18260325,"idKey":"22","rel":"parent"}],"_lastModifiedDate":"2026-09-30T12:01:22.000+00:00","name":"Time Control Installation Kommunikationssoftware","mainprojectId":"EP-2025-Comp-009","mainProject":{"caption":"Holzwerk Schilling GmbH & Co. KG / 49951 / Neukunde","title":"main project","href":"https://app1.teamspace.de/api/project/18260325","value":18260325,"idKey":"22"},"projectId":"0002","path":"Holzwerk Schilling GmbH & Co. KG ∕ 49951 ∕ Neukunde/Time Control Installation KoLine truncated
+3 -1
View File
@@ -8,7 +8,7 @@ services:
POSTGRES_USER: ${POSTGRES_USER:-tickettracker}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?POSTGRES_PASSWORD muss gesetzt sein}
volumes:
- tickettracker_postgres_data:/var/lib/postgresql/data
- ${POSTGRES_DATA_PATH:-tickettracker_postgres_data}:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U \"$${POSTGRES_USER}\" -d \"$${POSTGRES_DB}\""]
interval: 10s
@@ -26,6 +26,8 @@ services:
condition: service_healthy
environment:
DATABASE_URL: postgresql://${POSTGRES_USER:-tickettracker}:${POSTGRES_PASSWORD}@postgres:5432/${POSTGRES_DB:-tickettracker}
SECRET_ENCRYPTION_KEY: ${SECRET_ENCRYPTION_KEY:-}
ZAMMAD_EMAIL_WEBHOOK_TOKEN: ${ZAMMAD_EMAIL_WEBHOOK_TOKEN:-}
PORT: 3000
BACKEND_PORT: 3001
API_PROXY_TARGET: http://127.0.0.1:3001
+2
View File
@@ -7,6 +7,8 @@ services:
restart: unless-stopped
environment:
DATABASE_URL: ${DATABASE_URL}
SECRET_ENCRYPTION_KEY: ${SECRET_ENCRYPTION_KEY:-}
ZAMMAD_EMAIL_WEBHOOK_TOKEN: ${ZAMMAD_EMAIL_WEBHOOK_TOKEN:-}
PORT: 3000
BACKEND_PORT: 3001
API_PROXY_TARGET: http://127.0.0.1:3001
+55 -20
View File
@@ -21,7 +21,7 @@ Es gibt drei zentrale Zeitebenen:
- Session-Zeit: Die gemessene oder manuell erfasste Arbeitszeit einer einzelnen Taetigkeit.
- Teamspace-Zeit: Die Zeit, die fuer ein Ticket an einem konkreten Tag wirklich im CRM beziehungsweise Teamspace eingetragen wurde.
- Monatsabschluss: Der Abschluss eines ganzen Monats, sobald alle Sessions des Monats bewertet sind.
- Monatsabschluss: Der Abschluss eines ganzen Monats, sobald alle Sessions des Monats final bewertet sind.
Wichtig: Tickets werden nicht geschlossen. Tickets dienen nur als Gruppierung fuer Sessions. Abgeschlossen wird ausschliesslich der Monat.
@@ -71,19 +71,27 @@ Die Seite `Timer` ist fuer laufende Arbeit an Tickets gedacht.
1. Ticketnummer im Format `Ticket#XXXXXX` eingeben.
2. `Timer starten` klicken.
3. Der Timer startet.
4. Bei Bedarf kann der Timer pausiert, aktiviert, beendet oder entfernt werden.
4. Taetigkeit und optional Bewertung in den Details des ausgewaehlten Timers erfassen.
5. Bei Bedarf kann der Timer pausiert, aktiviert, beendet oder entfernt werden.
Es koennen mehrere Timer vorbereitet sein, aber immer nur ein Timer laeuft aktiv. Wird ein anderer Timer aktiviert, werden alle anderen Timer automatisch pausiert.
Alle laufenden und pausierten Timer stehen in der Seitenleiste. Dadurch bleiben sie auf allen Unterseiten sichtbar.
Beim Klick auf `Beenden` stoppt der Timer sofort. Das spaetere Ausfuellen des Modals verlaengert die gemessene Zeit nicht.
Die Taetigkeit und Bewertung werden im ausgewaehlten Timer erfasst. Pausierte Timer behalten diese Notizen. Wird ein Timer entfernt, werden auch die noch nicht gespeicherten Details verworfen.
Beim Klick auf `Beenden` stoppt der Timer sofort. Die vorher im Timer erfasste Taetigkeit wird beim Speichern an die Session gehaengt.
Die Bewertung hat drei Optionen: `---`, `Abrechenbar` und `Nicht abrechenbar`. `---` ist der Standard und laesst die Session offen. Wenn im Profil die Bewertungsabfrage aktiv ist, fragt TicketTracker beim Beenden eines Timers mit `---` noch einmal nach.
Im Abschlussdialog kann die Taetigkeit als interner Zammad-Article an das Ticket uebertragen werden. Der Article wird mit `internal: true` angelegt und enthaelt die Taetigkeit sowie den `time_unit`-Wert aus der gemessenen Zeit abzueglich Pausen. Wenn die interne Zammad-Notiz aktiv ist, kann dort auch der Zammad-Zeitbuchungstyp gewaehlt werden.
Wenn Zammad beim Speichern nicht erreichbar ist, wird die Session trotzdem in TicketTracker gespeichert. Der Zammad-Article wird dann in einer Parktabelle vorgemerkt und kann spaeter im Profil erneut gesendet werden.
Beim Speichern nach dem Beenden gilt:
- Existiert das Ticket bereits, werden Organisation und Art vom Ticket uebernommen.
- Dann muss nur noch die Taetigkeit eingetragen werden.
- Existiert das Ticket noch nicht, muessen Organisation, Taetigkeit und Art ausgefuellt werden.
- Existiert das Ticket noch nicht, muessen Organisation und Art ausgefuellt werden.
Die gemessene Zeit wird auf Minuten gerundet. Pausen werden von der Gesamtdauer abgezogen.
@@ -101,10 +109,16 @@ Beim Nachtragen werden angegeben:
- Datum
- Von-Uhrzeit
- Bis-Uhrzeit
- Bewertung: `---`, `Abrechenbar` oder `Nicht abrechenbar`
- Taetigkeit
- optional interne Zammad-Notiz
Das Taetigkeitsfeld ist mehrzeilig. Zeilenumbrueche bleiben in der Auswertung erhalten.
Mit Bewertung `---` bleibt eine nachgetragene Session offen. `Abrechenbar` und `Nicht abrechenbar` werden direkt an der neuen Session gespeichert.
Wenn die interne Zammad-Notiz aktiviert ist, wird die Taetigkeit auch beim Nachtragen als interner Zammad-Article uebertragen. Der Zammad-Typ kann dabei angepasst werden. Bei Zammad-Fehlern wird der Eintrag wie beim Timerabschluss geparkt und kann spaeter im Profil gesendet werden.
Das Ende muss nach dem Beginn liegen. Die Dauer wird automatisch berechnet und auf Minuten gerundet.
In der Ticketdetailansicht gibt es ebenfalls `Session nachtragen`. Dort wird die neue Session direkt dem geoeffneten Ticket zugeordnet.
@@ -145,8 +159,9 @@ Die oberen Karten zeigen:
- Tickets: Anzahl der Tickets im Zeitraum
- Sessions: Anzahl der Sessions im Zeitraum
- Abgerechnet: Summe der Sessions mit Bewertung `Abgerechnet` und, sofern vorhanden, die dazugehoerige Teamspace-Zeit als Vergleichswert
- Abrechenbar: Summe der Sessions mit Bewertung `Abrechenbar`, noch ohne Teamspace-Wirkung
- Nicht abrechenbar: Summe der Sessions mit Bewertung `Nicht abrechenbar`
- Offen: Anzahl unbewerteter Sessions
- Offen: Anzahl nicht final bewerteter Sessions, inklusive `Abrechenbar`
Der Verlauf der abgerechneten Zeit liegt auf der Seite `Statistiken`. Dort wird der Monatsverlauf gemeinsam mit Teamspace und Bewertungsstand betrachtet.
@@ -170,8 +185,8 @@ Neben der Ticketnummer gibt es ein Copy-Icon. Ein Klick kopiert die Ticketnummer
Der Status bedeutet:
- `offen`: Es gibt noch unbewertete Sessions.
- `bewertet`: Alle Sessions dieses Tickets im gewaehlten Zeitraum sind bewertet.
- `offen`: Es gibt noch nicht final bewertete Sessions oder Sessions mit Status `Abrechenbar`.
- `bewertet`: Alle Sessions dieses Tickets im gewaehlten Zeitraum sind `Abgerechnet` oder `Nicht abrechenbar`.
### Filtern, Gruppieren und Sortieren
@@ -213,8 +228,11 @@ In der Ticketdetailansicht sieht man:
- ToDos zu diesem Ticket oder Projekt
- Session-Eintraege nach Tagen gruppiert
- Teamspace-Wert pro Ticket und Tag
- Moeglichkeit, direkt einen Timer fuer dieses Ticket zu starten
- Moeglichkeit, direkt eine Session zu diesem Ticket nachzutragen
`Timer starten` nutzt dieselbe Timerlogik wie der globale Schnellstart. Existiert bereits ein Timer fuer das Ticket, wird dieser aktiviert.
Geoeffnete Tickets erscheinen in der Seitenleiste unter `Geoeffnete Tickets`. Die Liste bleibt nach Aktualisierung und Browserneustart erhalten. Mit einem Klick auf die Ticketnummer gelangt man direkt zur Ticketdetailansicht zurueck. Die Reihenfolge bleibt beim Anklicken unveraendert und kann nur per Drag and Drop angepasst werden. Der Schliessen-Button entfernt das Ticket aus der Seitenleiste. Wenn im aktuell geoeffneten Ticket noch ungespeicherte Werte vorhanden sind, muss zuerst gespeichert werden.
## Projekte und ToDos
@@ -306,8 +324,9 @@ Die Sessions sind pro Tag gruppiert. In jeder Tagesgruppe stehen:
- Tagesdatum
- `Tag abgerechnet`: Summe der als `Abgerechnet` bewerteten Session-Zeit dieses Tages
- `Abrechenbar`: Summe der als `Abrechenbar` bewerteten Session-Zeit dieses Tages
- `Nicht`: Summe der als `Nicht abrechenbar` bewerteten Session-Zeit dieses Tages
- `Offen`: Summe der noch unbewerteten Session-Zeit dieses Tages
- `Offen`: Summe der noch nicht final bewerteten Session-Zeit dieses Tages, inklusive `Abrechenbar`
- `Teamspace`: Stunden, die fuer dieses Ticket an diesem Tag wirklich im CRM eingetragen wurden
Das Teamspace-Feld wird in Stunden eingetragen, zum Beispiel:
@@ -330,11 +349,12 @@ Jede einzelne Session ist innerhalb der Tagesgruppe aufklappbar. In der geschlos
Jede Session kann bewertet werden als:
- Abgerechnet
- Abrechenbar
- Nicht abrechenbar
Ein erneuter Klick auf den bereits gewaehlten Zustand nimmt die Bewertung zurueck. Dadurch wird die Session wieder offen.
Nicht abrechenbare Sessions gelten als bewertet. Sie blockieren den Monatsabschluss nicht.
`Abgerechnet` und `Nicht abrechenbar` schliessen die Bewertung ab. `Abrechenbar` ist nur ein Zwischenstatus, gilt fuer Abschluss und offene Bewertungen weiterhin als offen und blockiert den Monatsabschluss. In Teamspace-Statistiken zaehlt erst `Abgerechnet`.
Es gibt keinen Ticketabschluss. Tickets dienen nur als Gruppierung fuer Sessions. Abgeschlossen wird ausschliesslich der Monat.
@@ -373,7 +393,7 @@ Der Monatsabschluss ist eine eigene Unterseite.
Ein Monat kann abgeschlossen werden, wenn:
- Alle Sessions im Monat bewertet sind.
- Keine offenen Bewertungen mehr vorhanden sind. Sessions mit Status `Abrechenbar` gelten dabei weiterhin als offen.
Einen separaten Tagesabschluss gibt es nicht. Die Tagesansicht ist nur eine gefilterte Kontrolle einzelner Tage. Bewertungen und Teamspace-Tageswerte wirken in Monats- und Tagesansicht auf dieselben Daten, abgeschlossen wird aber ausschliesslich der Monat.
@@ -430,9 +450,9 @@ Die Seite `Statistiken` betrachtet immer einen Monat. Sie dient als Ueberblick f
### Kennzahlen
`Abgerechnet` zeigt die Summe aller Sessions mit Bewertung `Abgerechnet`. Nicht abrechenbare und offene Sessions sind darin nicht enthalten. Dieser Wert ist die Basis fuer den Vergleich mit Teamspace.
`Abgerechnet` zeigt die Summe aller Sessions mit Bewertung `Abgerechnet`. Abrechenbare, nicht abrechenbare und offene Sessions sind darin nicht enthalten. Dieser Wert ist die Basis fuer den Vergleich mit Teamspace.
Alle Statistik- und Vergleichswerte verwenden nur abgerechnete Zeiten. Nicht ausgewaehlte/offene und nicht abrechenbare Sessions werden nicht in Relationen, Graphen, Teamspace-Differenzen, Hotspots, Manuell/Fix-Werte oder Durchschnittswerte eingerechnet.
Teamspace-Statistiken und -Vergleiche verwenden nur abgerechnete Zeiten. Nicht ausgewaehlte/offene, abrechenbare und nicht abrechenbare Sessions werden nicht in Teamspace-Differenzen, Hotspots, Manuell/Fix-Werte oder Durchschnittswerte eingerechnet.
`Teamspace` zeigt die Summe aller Teamspace-Tageswerte im Monat. Die Differenz wird immer so berechnet:
@@ -449,15 +469,16 @@ Das bedeutet:
Farben:
- Abgerechnet: blau
- Abrechenbar: grau
- Teamspace: fuchsia
- Positive oder ausgeglichene Differenz: gruen
- Negative Differenz: rot
- Nicht abrechenbar: indigo
- Offen: gelb/orange
`Nicht abrechenbar` zeigt Sessions, die bewusst nicht fakturiert werden. In den Statistiken wird dazu kein Stundenwert ausgegeben; diese Sessions werden nicht mit Teamspace verglichen.
`Abrechenbar` zeigt Sessions im Zwischenstatus, die noch offen bleiben. `Nicht abrechenbar` zeigt final bewertete Sessions, die nicht als abgerechnet gelten. Beide werden nicht mit Teamspace verglichen.
`Offen` zeigt Sessions ohne Bewertung. Diese blockieren den Monatsabschluss.
`Offen` zeigt Sessions ohne finalen Status, also auch `Abrechenbar`. Diese blockieren den Monatsabschluss.
### Monatsverlauf und Abrechnungsqualitaet
@@ -465,7 +486,7 @@ Diese Card kombiniert den Tagesverlauf und die Bewertungsqualitaet.
- Balken zeigen abgerechnete Session-Zeit.
- Die Linie zeigt Teamspace-Zeit.
- Der Bewertungsstand trennt abgerechnete, nicht abrechenbare und offene Sessions.
- Der Bewertungsstand trennt abgerechnete, abrechenbare, nicht abrechenbare und offene Sessions. Abrechenbar bleibt dabei zusaetzlich offen.
- Der Teamspace-Abgleich zeigt die Gesamtdifferenz.
- Manuell und Fix trennen manuell erfasste abrechenbare Sessions von automatisch erzeugten abrechenbaren Sessions.
@@ -477,7 +498,7 @@ Sichtbar sind:
- Organisation
- Sessions
- Zeiten: Abgerechnet, nicht abrechenbar und Teamspace
- Zeiten: Abgerechnet, abrechenbar, nicht abrechenbar und Teamspace
- Differenz
- Anteil an der abgerechneten Monatszeit
@@ -495,7 +516,7 @@ Sie zeigt je Typ:
- Nicht abrechenbare Session-Zeit
- Teamspace-Zeit
- Differenz
- Anzahl abgerechnet, nicht abrechenbar und offen
- Anzahl abgerechnet, abrechenbar, nicht abrechenbar und offen
### Ticket-Hotspots
@@ -511,6 +532,10 @@ Unter `Profil` kann jeder Benutzer seine eigenen Daten pflegen:
- Voller Name
- Passwort
- persoenlicher Zammad API-Token
- Bewertungsabfrage beim Timerabschluss
- interne Zammad-Notiz beim Timerabschluss
- Standard-Typ fuer interne Zammad-Notizen
- Zammad-Zeitaufrundung fuer `time_unit`
Passwortaenderungen erfordern das aktuelle Passwort. Bleiben die Passwortfelder leer, werden nur Benutzername und voller Name gespeichert.
@@ -520,6 +545,16 @@ Die Pruefung findet nur statt, wenn der Token im Profil neu eingetragen oder ent
Der persoenliche Zammad Token ist unabhaengig vom Admin-Token fuer den Organisations-Sync. Der gleiche Token kann technisch in beiden Bereichen eingetragen sein, wird aber getrennt gespeichert und getrennt verwendet. Im Admin-Profil gibt es keinen persoenlichen Zammad-Token.
Die Bewertungsabfrage beim Timerabschluss kann im Profil ein- oder ausgeschaltet werden. Sie erscheint nur, wenn der Timer beim Beenden noch auf Bewertung `---` steht.
Die interne Zammad-Notiz beim Timerabschluss steuert, ob die Checkbox im Abschlussdialog standardmaessig aktiv ist. Ist sie aktiv, legt TicketTracker beim Speichern einen internen Zammad-Article zum Ticket an. Nur dann werden auch der Standard-Typ und die Zeitaufrundung im Profil angezeigt.
Der Standard-Typ belegt den Zammad-Zeitbuchungstyp fuer neue interne Notizen vor. Es muss immer eine Kategorie gewaehlt sein; falls noch kein Profilwert gespeichert ist, verwendet TicketTracker `Nicht kategorisiert`. Beim Timerabschluss und beim Nachtragen kann der Typ vor dem Speichern noch geaendert werden.
Fuer `time_unit` kann optional eine Aufrundung aktiviert werden. Dann wird die tatsaechlich getrackte Zeit immer auf 5, 10, 15 oder 30 Minuten aufgerundet und als Stundenwert an Zammad gesendet. Ohne Rundung wird der konkrete Stundenwert mit zwei Nachkommastellen gesendet.
Unter `Geparkte Zammad-Notizen` zeigt das Profil interne Notizen, die wegen eines Zammad-Fehlers noch nicht uebertragen wurden. Mit `Senden` werden die offenen Eintraege erneut nach Zammad gepusht.
## Adminbereich
Der feste Admin ist nur fuer die Systemverwaltung vorgesehen. Er kann:
@@ -562,12 +597,12 @@ Neue Organisationen werden hinzugefuegt, geaenderte Namen aktualisiert und nicht
3. Am Monatsende `Tickets` oeffnen.
4. Monat auswaehlen.
5. Offene Sessions pruefen.
6. Pro Ticket jede Session als `Abgerechnet` oder `Nicht abrechenbar` markieren.
6. Pro Ticket jede Session final als `Abgerechnet` oder `Nicht abrechenbar` markieren. `Abrechenbar` kann als Zwischenstatus stehen bleiben, blockiert dann aber den Abschluss.
7. Pro Tag und Ticket die wirklich in Teamspace eingetragene Zeit im Feld `Teamspace` pflegen.
8. `Monatsabschluss` oeffnen.
9. Offene Bewertungen abarbeiten.
10. Tage ohne Teamspace-Wert pruefen oder zur Kenntnis nehmen.
11. Wenn keine Sessions im Monat mehr offen sind, Monat abschliessen.
11. Wenn keine Sessions im Monat mehr offen sind und keine Session mehr auf `Abrechenbar` steht, Monat abschliessen.
## Hinweise
+368 -200
View File
@@ -1,11 +1,11 @@
import {
AlertCircle,
CalendarDays,
CheckCircle2,
ClipboardCheck,
Command,
ChartNoAxesCombined,
CircleHelp,
DatabaseZap,
ExternalLink,
FileText,
FolderKanban,
@@ -27,9 +27,10 @@ import {
Trash2,
UserCog,
UserCircle,
FolderGit,
X,
} from "lucide-react";
import { FormEvent, MouseEvent, useCallback, useEffect, useMemo, useState } from "react";
import { FormEvent, MouseEvent, useCallback, useEffect, useMemo, useRef, useState } from "react";
import { useShallow } from "zustand/react/shallow";
import { toast } from "sonner";
@@ -65,10 +66,25 @@ import {
import { usePreferencesStore } from "@/stores/preferences/preferences-provider";
import { cn } from "./lib/utils";
import { ApiError, deleteTodo, getCurrentUser, getRecurringBillings, getSetupStatus, getTodos, logout, lookupTicket, searchTickets, updateTodo } from "./api";
import {
ApiError,
createActiveTimer,
deleteActiveTimer,
deleteTodo,
getActiveTimers,
getCurrentUser,
getRecurringBillings,
getSetupStatus,
getTodos,
logout,
lookupTicket,
searchTickets,
updateActiveTimer,
updateTodo
} from "./api";
import { currentDay, formatDateTime, formatMinutes, formatTimer } from "./format";
import { isRecurringBillingTicketNumber, ticketHasRecurringBilling } from "./recurring-billings";
import { activeElapsedMs, pauseEntry, readStoredTimers, resumeEntry, storageKeyForUser, ticketPattern, type TimerEntry } from "./timers";
import { activeElapsedMs, mergeTimerActivityDrafts, readStoredTimers, storageKeyForUser, ticketPattern, type TimerEntry } from "./timers";
import { formatTodoPeriod, isTodoActiveOnDay, isTodoFixedOnDay, isTodoOverdue } from "./todos";
import { AdminUsersPage } from "./views/AdminUsersPage";
import { AnalysisPage } from "./views/AnalysisPage";
@@ -84,6 +100,7 @@ import { SetupPage } from "./views/SetupPage";
import { TicketDetailPage } from "./views/TicketDetailPage";
import { TimerPage } from "./views/TimerPage";
import { TodosPage } from "./views/TodosPage";
import { ZammadSyncPage } from "./views/ZammadSyncPage";
import type { AuthUser, PeriodType, TicketDetailPeriodType, TicketSearchResult, TicketTodo } from "./types";
import type { Dispatch, DragEvent, SetStateAction } from "react";
@@ -217,6 +234,10 @@ function routeFromPath(pathWithSearch: string) {
return { page: "recurring" as const };
}
if (pathname.startsWith("/zammad-sync")) {
return { page: "zammad-sync" as const };
}
if (pathname.startsWith("/admin/users")) {
return { page: "admin-users" as const };
}
@@ -440,12 +461,12 @@ type SidebarTimersProps = {
timers: TimerEntry[];
selectedTimerId: string | null;
setSelectedTimerId: Dispatch<SetStateAction<string | null>>;
setTimers: Dispatch<SetStateAction<TimerEntry[]>>;
tick: number;
onToggleTimer: (timerId: string) => void;
onOpenTimer: () => void;
};
function SidebarTimers({ timers, selectedTimerId, setSelectedTimerId, setTimers, tick, onOpenTimer }: SidebarTimersProps) {
function SidebarTimers({ timers, selectedTimerId, setSelectedTimerId, tick, onToggleTimer, onOpenTimer }: SidebarTimersProps) {
const sortedTimers = useMemo(
() =>
[...timers].sort((first, second) => {
@@ -466,17 +487,8 @@ function SidebarTimers({ timers, selectedTimerId, setSelectedTimerId, setTimers,
return;
}
const now = Date.now();
setSelectedTimerId(timerId);
setTimers((current) =>
current.map((entry) => {
if (entry.id !== timerId) {
return pauseEntry(entry, now);
}
return timer.phase === "running" ? pauseEntry(entry, now) : resumeEntry(entry, now);
}),
);
onToggleTimer(timerId);
}
return (
@@ -521,9 +533,9 @@ function SidebarTimers({ timers, selectedTimerId, setSelectedTimerId, setTimers,
<span className="truncate text-xs font-medium">{timer.ticketNumber}</span>
</span>
{timer.organizationName ? (
<span className="block truncate text-[11px] leading-4 text-muted-foreground">
{timer.isProject ? "Projekt · " : ""}
{timer.projectName || timer.organizationName}
<span className="flex min-w-0 items-center gap-1 truncate text-[11px] leading-4 text-muted-foreground">
{timer.isProject ? <FolderGit className="size-3 shrink-0" aria-label="Projekt" /> : null}
<span className="truncate">{timer.organizationName}</span>
</span>
) : null}
<span className="block font-mono text-[11px] font-semibold leading-4 tracking-normal text-muted-foreground">
@@ -578,20 +590,57 @@ const sidebarTodoCalendarClasses: Record<TicketTodo["priority"], string> = {
};
const sidebarOverdueTodoClass = "border-red-500/60 bg-red-500/15 text-red-100";
const sidebarTodoPriorityOrder: Record<TicketTodo["priority"], number> = {
urgent: 0,
high: 1,
medium: 2,
low: 3
};
function sortSidebarCurrentTodos(todos: TicketTodo[], today: string) {
return [...todos].sort((left, right) => {
const leftOverdue = isTodoOverdue(left, today);
const rightOverdue = isTodoOverdue(right, today);
if (leftOverdue !== rightOverdue) {
return leftOverdue ? -1 : 1;
}
return sidebarTodoPriorityOrder[left.priority] - sidebarTodoPriorityOrder[right.priority] || left.sort_order - right.sort_order || left.title.localeCompare(right.title, "de-DE", { sensitivity: "base" });
});
}
function notifyTodosChanged() {
window.dispatchEvent(new Event("tickettracker:todos-changed"));
}
function SidebarTodayTodos({ todos, onNavigate }: SidebarTodayTodosProps) {
const [runningTodosOpen, setRunningTodosOpen] = useState(false);
const [todosModalOpen, setTodosModalOpen] = useState(false);
const [modalBusy, setModalBusy] = useState(false);
const today = currentDay();
const fixedTodos = todos.filter((todo) => isTodoFixedOnDay(todo, today));
const summarizedTodos = todos.filter((todo) => todo.status === "open" && isTodoActiveOnDay(todo, today) && !isTodoFixedOnDay(todo, today));
const overdueTodos = todos.filter((todo) => isTodoOverdue(todo, today));
const currentTodos = sortSidebarCurrentTodos(
[...overdueTodos, ...fixedTodos, ...summarizedTodos].filter((todo, index, list) => list.findIndex((item) => item.id === todo.id) === index),
today
);
const visibleCurrentTodos = currentTodos.slice(0, 6);
const additionalTodosCount = Math.max(0, currentTodos.length - visibleCurrentTodos.length);
const hasTodos = fixedTodos.length > 0 || summarizedTodos.length > 0 || overdueTodos.length > 0;
function todoStateLabel(todo: TicketTodo) {
if (isTodoOverdue(todo, today)) {
return "Überfällig";
}
if (isTodoFixedOnDay(todo, today)) {
return "Fester Termin";
}
return "Laufend";
}
async function toggleTodo(todo: TicketTodo) {
setModalBusy(true);
@@ -653,42 +702,30 @@ function SidebarTodayTodos({ todos, onNavigate }: SidebarTodayTodosProps) {
{hasTodos ? (
<div className="space-y-1">
{overdueTodos.slice(0, 3).map((todo) => (
{visibleCurrentTodos.map((todo) => (
<button
key={`overdue-${todo.id}`}
key={`current-${todo.id}`}
type="button"
className="block w-full rounded-md border border-red-500/45 bg-red-500/10 px-2 py-1.5 text-left hover:bg-red-500/15"
onClick={() => onNavigate(`/tickets/${todo.ticket_id}`)}
>
<span className="flex min-w-0 items-center gap-1.5 text-[11px] font-semibold text-red-200">
<AlertCircle className="size-3.5 shrink-0" />
<span className="truncate">{todo.title}</span>
</span>
<span className="block truncate text-[11px] text-muted-foreground">{todo.ticket_number ?? "Ticket"} · {formatTodoPeriod(todo)}</span>
</button>
))}
{overdueTodos.length > 3 ? <p className="px-1 text-[11px] text-red-200">+{overdueTodos.length - 3} weitere überfällig</p> : null}
{fixedTodos.slice(0, 3).map((todo) => (
<button
key={`fixed-${todo.id}`}
type="button"
className="block w-full rounded-md border bg-background/70 px-2 py-1.5 text-left hover:bg-muted"
className={`block w-full rounded-md border px-2 py-1.5 text-left hover:brightness-110 ${isTodoOverdue(todo, today) ? sidebarOverdueTodoClass : sidebarTodoCalendarClasses[todo.priority]}`}
onClick={() => onNavigate(`/tickets/${todo.ticket_id}`)}
>
<span className="block truncate text-[11px] font-semibold">{todo.title}</span>
<span className="block truncate text-[11px] text-muted-foreground">{todo.ticket_number ?? "Ticket"} · {todo.organization_name ?? "Keine Organisation"}</span>
<span className="block truncate text-[11px] text-muted-foreground">
{todo.ticket_number ?? "Ticket"} · {todoStateLabel(todo)}
</span>
</button>
))}
{fixedTodos.length > 3 ? <p className="px-1 text-[11px] text-muted-foreground">+{fixedTodos.length - 3} weitere feste Termine</p> : null}
{summarizedTodos.length > 0 ? (
{additionalTodosCount > 0 ? (
<button
type="button"
className="block w-full rounded-md border border-muted-foreground/20 bg-background/60 px-2 py-1.5 text-left text-[11px] font-medium text-muted-foreground hover:bg-muted"
onClick={() => setRunningTodosOpen(true)}
onClick={() => setTodosModalOpen(true)}
>
+{summarizedTodos.length} laufende ToDo{summarizedTodos.length === 1 ? "" : "s"}
<span className="block">+{additionalTodosCount} weitere aktuelle ToDo{additionalTodosCount === 1 ? "" : "s"}</span>
<span className="block truncate font-normal">
{overdueTodos.length} überfällig · {summarizedTodos.length} laufend · {fixedTodos.length} feste
</span>
</button>
) : null}
</div>
@@ -699,22 +736,24 @@ function SidebarTodayTodos({ todos, onNavigate }: SidebarTodayTodosProps) {
</SidebarGroupContent>
</SidebarGroup>
<Dialog open={runningTodosOpen} onOpenChange={setRunningTodosOpen}>
<Dialog open={todosModalOpen} onOpenChange={setTodosModalOpen}>
<DialogContent className="max-h-[calc(100dvh-2rem)] overflow-y-auto sm:max-w-xl">
<DialogHeader>
<DialogTitle>ToDos am Tag</DialogTitle>
<DialogDescription>Heute · {summarizedTodos.length} laufende ToDo(s)</DialogDescription>
<DialogTitle>Aktuelle ToDos</DialogTitle>
<DialogDescription>
{overdueTodos.length} überfällig · {fixedTodos.length} feste Termine · {summarizedTodos.length} laufende ToDo(s)
</DialogDescription>
</DialogHeader>
<div className="space-y-2">
{summarizedTodos.map((todo) => (
{currentTodos.map((todo) => (
<div key={todo.id} className={`rounded-md border p-2.5 ${isTodoOverdue(todo, today) ? sidebarOverdueTodoClass : sidebarTodoCalendarClasses[todo.priority]}`}>
<div className="flex flex-col gap-2">
<div className="flex items-start justify-between gap-3">
<div className="min-w-0">
<div className="flex min-w-0 flex-wrap items-center gap-2">
<span className="min-w-0 truncate text-sm font-semibold">{todo.title}</span>
<Badge variant={isTodoOverdue(todo, today) ? "destructive" : isTodoFixedOnDay(todo, today) ? "outline" : "secondary"}>{todoStateLabel(todo)}</Badge>
<span className={`shrink-0 rounded-full border px-2 py-0.5 text-xs font-medium ${sidebarTodoPriorityClasses[todo.priority]}`}>{sidebarTodoPriorityLabels[todo.priority]}</span>
{isTodoOverdue(todo, today) ? <Badge variant="destructive">überfällig</Badge> : null}
</div>
<p className="mt-1 truncate text-xs text-muted-foreground" title={todo.organization_name ?? "Keine Organisation"}>
{todo.organization_name ?? "Keine Organisation"}
@@ -736,7 +775,7 @@ function SidebarTodayTodos({ todos, onNavigate }: SidebarTodayTodosProps) {
size="sm"
variant="ghost"
onClick={() => {
setRunningTodosOpen(false);
setTodosModalOpen(false);
onNavigate(`/tickets/${todo.ticket_id}`);
}}
>
@@ -751,8 +790,8 @@ function SidebarTodayTodos({ todos, onNavigate }: SidebarTodayTodosProps) {
</div>
</div>
))}
{summarizedTodos.length === 0 ? (
<p className="rounded-md border bg-muted/20 p-4 text-center text-sm text-muted-foreground">Keine laufenden ToDos an diesem Tag.</p>
{currentTodos.length === 0 ? (
<p className="rounded-md border bg-muted/20 p-4 text-center text-sm text-muted-foreground">Keine aktuellen ToDos.</p>
) : null}
</div>
</DialogContent>
@@ -775,6 +814,8 @@ export function App() {
const [ticketReturnPaths, setTicketReturnPaths] = useState<Record<string, string>>({});
const [draggedOpenTicketKey, setDraggedOpenTicketKey] = useState<string | null>(null);
const [sidebarTodos, setSidebarTodos] = useState<TicketTodo[]>([]);
const openTicketsListRef = useRef<HTMLDivElement | null>(null);
const hydratingTimerIds = useRef(new Set<string>());
const navigate = useCallback(
(to: string) => {
@@ -852,10 +893,48 @@ export function App() {
return;
}
setTimers(readStoredTimers(currentUser.id));
let cancelled = false;
const userId = currentUser.id;
setTimersLoaded(false);
setTimers([]);
setOpenTickets(readOpenTickets(currentUser.id));
setTimerOwnerId(currentUser.id);
setTimersLoaded(true);
async function loadTimers() {
try {
let serverTimers = (await getActiveTimers()).timers;
const storedTimers = readStoredTimers(userId);
if (serverTimers.length === 0 && storedTimers.length > 0) {
for (const timer of storedTimers) {
serverTimers = (await createActiveTimer(timer)).timers;
}
}
localStorage.removeItem(storageKeyForUser(userId));
if (!cancelled) {
setTimers(mergeTimerActivityDrafts(userId, serverTimers));
}
} catch (error) {
if (!cancelled) {
setTimers(mergeTimerActivityDrafts(userId, readStoredTimers(userId)));
toast.error("Timer konnten nicht geladen werden", {
description: error instanceof Error ? error.message : "Unbekannter Fehler"
});
}
} finally {
if (!cancelled) {
setTimersLoaded(true);
}
}
}
void loadTimers();
return () => {
cancelled = true;
};
}, [currentUser]);
useEffect(() => {
@@ -869,13 +948,16 @@ export function App() {
);
}, [currentUser, openTickets]);
useEffect(() => {
const activeTicket = openTicketsListRef.current?.querySelector<HTMLElement>("[data-open-ticket-active='true']");
activeTicket?.scrollIntoView({ block: "nearest" });
}, [path, openTickets]);
useEffect(() => {
if (!currentUser || currentUser.role === "admin" || !timersLoaded || timerOwnerId !== currentUser.id) {
return;
}
localStorage.setItem(storageKeyForUser(currentUser.id), JSON.stringify(timers));
if (timers.length === 0) {
setSelectedTimerId(null);
return;
@@ -886,6 +968,31 @@ export function App() {
}
}, [currentUser, timers, selectedTimerId, timersLoaded, timerOwnerId]);
const refreshActiveTimers = useCallback(async () => {
if (!currentUser || currentUser.role === "admin") {
return;
}
try {
const result = await getActiveTimers();
setTimers(mergeTimerActivityDrafts(currentUser.id, result.timers));
} catch {
// Keep the currently displayed timers if the refresh fails.
}
}, [currentUser]);
useEffect(() => {
if (!currentUser || currentUser.role === "admin" || !timersLoaded || timerOwnerId !== currentUser.id) {
return;
}
window.addEventListener("focus", refreshActiveTimers);
return () => {
window.removeEventListener("focus", refreshActiveTimers);
};
}, [currentUser, refreshActiveTimers, timersLoaded, timerOwnerId]);
const loadSidebarTodos = useCallback(async () => {
if (!currentUser || currentUser.role === "admin") {
return;
@@ -925,60 +1032,77 @@ export function App() {
return;
}
const timersToHydrate = timers.filter((timer) => !timer.ticketLookupDone);
const timersToHydrate = timers.filter((timer) => !timer.ticketLookupDone && !hydratingTimerIds.current.has(timer.id));
if (timersToHydrate.length === 0) {
return;
}
let cancelled = false;
timersToHydrate.forEach((timer) => hydratingTimerIds.current.add(timer.id));
async function hydrateTimers() {
const results = await Promise.all(
timersToHydrate.map(async (timer) => {
try {
const result = await lookupTicket(timer.ticketNumber);
return {
id: timer.id,
organizationName: result.ticket?.organization_name ?? result.ticket?.customer_name ?? null,
workType: result.ticket?.work_type ?? null,
isProject: Boolean(result.ticket?.is_project),
projectName: result.ticket?.project_name ?? null
};
} catch {
return {
id: timer.id,
organizationName: null,
workType: null,
isProject: false,
projectName: null
};
}
})
);
try {
const results = await Promise.all(
timersToHydrate.map(async (timer) => {
try {
const result = await lookupTicket(timer.ticketNumber);
return {
id: timer.id,
organizationName: result.ticket?.organization_name ?? result.ticket?.customer_name ?? null,
workType: result.ticket?.work_type ?? null,
isProject: Boolean(result.ticket?.is_project),
projectName: result.ticket?.project_name ?? null
};
} catch {
return {
id: timer.id,
organizationName: null,
workType: null,
isProject: false,
projectName: null
};
}
})
);
if (cancelled) {
return;
if (cancelled) {
return;
}
setTimers((current) =>
current.map((timer) => {
const result = results.find((entry) => entry.id === timer.id);
if (!result) {
return timer;
}
return {
...timer,
organizationName: result.organizationName,
workType: result.workType,
isProject: result.isProject,
projectName: result.projectName,
ticketLookupDone: true
};
})
);
await Promise.all(
results.map((result) =>
updateActiveTimer(result.id, {
organizationName: result.organizationName,
workType: result.workType,
isProject: result.isProject,
projectName: result.projectName,
ticketLookupDone: true
}).catch(() => undefined)
)
);
} finally {
timersToHydrate.forEach((timer) => hydratingTimerIds.current.delete(timer.id));
}
setTimers((current) =>
current.map((timer) => {
const result = results.find((entry) => entry.id === timer.id);
if (!result) {
return timer;
}
return {
...timer,
organizationName: result.organizationName,
workType: result.workType,
isProject: result.isProject,
projectName: result.projectName,
ticketLookupDone: true
};
})
);
}
void hydrateTimers();
@@ -993,6 +1117,26 @@ export function App() {
return () => window.clearInterval(interval);
}, []);
async function toggleActiveTimer(timerId: string) {
const userId = currentUser?.id;
const timer = timers.find((entry) => entry.id === timerId);
if (!timer || !userId) {
return;
}
try {
const result = await updateActiveTimer(timerId, {
phase: timer.phase === "running" ? "paused" : "running"
});
setTimers(mergeTimerActivityDrafts(userId, result.timers));
} catch (error) {
toast.error("Timer konnte nicht aktualisiert werden", {
description: error instanceof Error ? error.message : "Unbekannter Fehler"
});
}
}
useEffect(() => {
if (!currentUser || currentUser.role !== "admin") {
return;
@@ -1006,6 +1150,12 @@ export function App() {
}, [currentUser, route.page]);
async function startQuickTimer(rawTicketNumber: string) {
const userId = currentUser?.id;
if (!userId) {
return false;
}
if (currentUser?.role === "admin") {
toast.error("Admin erfasst keine Sessions", {
description: "Der Adminbereich ist nur für die Systemverwaltung vorgesehen."
@@ -1013,14 +1163,14 @@ export function App() {
return false;
}
const ticketNumber = rawTicketNumber.trim();
const ticketNumber = rawTicketNumber.trim();
if (!ticketPattern.test(ticketNumber)) {
if (!ticketPattern.test(ticketNumber)) {
toast.error("Ticketnummer prüfen", {
description: "Das Format muss Ticket#XXXXXX sein."
});
return false;
}
return false;
}
const [ticketResult, recurringResult] = await Promise.all([
lookupTicket(ticketNumber).catch(() => ({ ticket: null })),
@@ -1028,7 +1178,9 @@ export function App() {
]);
if (ticketHasRecurringBilling(ticketResult.ticket, recurringResult.recurringBillings) || isRecurringBillingTicketNumber(ticketNumber, recurringResult.recurringBillings)) {
setTimers((current) => current.filter((timer) => timer.ticketNumber !== ticketNumber));
const existingRecurringTimer = timers.find((timer) => timer.ticketNumber === ticketNumber);
const result = existingRecurringTimer ? await deleteActiveTimer(existingRecurringTimer.id).catch(() => null) : null;
setTimers((current) => result?.timers ?? current.filter((timer) => timer.ticketNumber !== ticketNumber));
toast.error("Fixe Abrechnung", {
description: "Für fixe Abrechnungen dürfen keine manuellen Sessions gestartet werden. Bitte die Definition bearbeiten."
});
@@ -1039,36 +1191,50 @@ export function App() {
const now = Date.now();
if (existingTimer) {
setTimers((current) =>
current.map((timer) => (timer.id === existingTimer.id ? resumeEntry(timer, now) : pauseEntry(timer, now)))
);
setSelectedTimerId(existingTimer.id);
toast.info("Bestehender Timer aktiviert", {
description: ticketNumber
});
return true;
try {
const result = await updateActiveTimer(existingTimer.id, { phase: "running" });
setTimers(mergeTimerActivityDrafts(userId, result.timers));
setSelectedTimerId(existingTimer.id);
toast.info("Bestehender Timer aktiviert", {
description: ticketNumber
});
return true;
} catch (error) {
toast.error("Timer konnte nicht aktiviert werden", {
description: error instanceof Error ? error.message : "Unbekannter Fehler"
});
return false;
}
}
const newTimer: TimerEntry = {
id: crypto.randomUUID(),
ticketNumber,
organizationName: ticketResult.ticket?.organization_name ?? ticketResult.ticket?.customer_name ?? null,
workType: ticketResult.ticket?.work_type ?? null,
isProject: Boolean(ticketResult.ticket?.is_project),
projectName: ticketResult.ticket?.project_name ?? null,
ticketLookupDone: true,
startedAt: now,
pausedTotalMs: 0,
pausedAt: null,
phase: "running"
};
setTimers((current) => [...current.map((timer) => pauseEntry(timer, now)), newTimer]);
setSelectedTimerId(newTimer.id);
toast.success("Timer gestartet", {
description: ticketResult.ticket?.is_project ? `${ticketNumber} ist ein Projekt` : ticketNumber
});
return true;
try {
const result = await createActiveTimer({
ticketNumber,
organizationName: ticketResult.ticket?.organization_name ?? ticketResult.ticket?.customer_name ?? null,
workType: ticketResult.ticket?.work_type ?? null,
isProject: Boolean(ticketResult.ticket?.is_project),
projectName: ticketResult.ticket?.project_name ?? null,
ticketLookupDone: true,
startedAt: now,
pausedTotalMs: 0,
pausedAt: null,
activity: "",
billingStatus: null,
phase: "running"
});
const timersWithDrafts = mergeTimerActivityDrafts(userId, result.timers);
setTimers(timersWithDrafts);
setSelectedTimerId(timersWithDrafts.find((timer) => timer.ticketNumber === ticketNumber)?.id ?? null);
toast.success("Timer gestartet", {
description: ticketResult.ticket?.is_project ? `${ticketNumber} ist ein Projekt` : ticketNumber
});
return true;
} catch (error) {
toast.error("Timer konnte nicht gestartet werden", {
description: error instanceof Error ? error.message : "Unbekannter Fehler"
});
return false;
}
}
async function handleLogout() {
@@ -1149,7 +1315,7 @@ export function App() {
setOpenTickets((items) => items.filter((item) => item.key !== ticket.key));
if (pathWithoutSearch(path) === pathWithoutSearch(ticket.path)) {
if (route.page === "ticket" && route.ticketId === ticket.ticketId) {
const returnPath = current.returnPath && pathWithoutSearch(current.returnPath) !== pathWithoutSearch(ticket.path) ? current.returnPath : "/analysis";
routerNavigate(returnPath);
}
@@ -1207,6 +1373,7 @@ export function App() {
{ type: "item" as const, href: "/statistics", label: "Statistiken", icon: ChartNoAxesCombined, active: path.startsWith("/statistics") },
{ type: "item" as const, href: "/recurring", label: "Fixe Abrechnung", icon: Repeat, active: path.startsWith("/recurring") },
{ type: "separator" as const, key: "before-profile" },
{ type: "item" as const, href: "/zammad-sync", label: "Zammad-Sync", icon: DatabaseZap, active: path.startsWith("/zammad-sync") },
{ type: "item" as const, href: "/profile", label: "Profil", icon: UserCog, active: path.startsWith("/profile") },
{ type: "separator" as const, key: "before-faq" },
{ type: "item" as const, href: "/faq", label: "FAQ", icon: CircleHelp, active: path.startsWith("/faq") }
@@ -1232,7 +1399,7 @@ export function App() {
<SidebarMenuButton asChild>
<a href={isAdmin ? "/admin/users" : "/timer"} onClick={navHandler(isAdmin ? "/admin/users" : "/timer")}>
<Command />
<span className="font-semibold text-base">TicketTracker</span>
<span className="font-semibold text-base">TicketTracker </span>
</a>
</SidebarMenuButton>
</SidebarMenuItem>
@@ -1265,8 +1432,8 @@ export function App() {
timers={timers}
selectedTimerId={selectedTimerId}
setSelectedTimerId={setSelectedTimerId}
setTimers={setTimers}
tick={tick}
onToggleTimer={(timerId) => void toggleActiveTimer(timerId)}
onOpenTimer={() => navigate("/timer")}
/>
</>
@@ -1294,62 +1461,65 @@ export function App() {
)}
</SidebarMenu>
</SidebarGroupContent>
</SidebarGroup>
</SidebarGroup>
{!isAdmin ? <SidebarTodayTodos todos={sidebarTodos} onNavigate={navigate} /> : null}
{!isAdmin ? <SidebarTodayTodos todos={sidebarTodos} onNavigate={navigate} /> : null}
{!isAdmin && openTickets.length > 0 ? (
<SidebarGroup className="pt-0 group-data-[collapsible=icon]:hidden">
{!isAdmin && openTickets.length > 0 ? (
<SidebarGroup className="min-h-0 flex-1 pt-0 group-data-[collapsible=icon]:hidden">
<SidebarGroupLabel className="h-6 px-2 text-xs">Geöffnete Tickets</SidebarGroupLabel>
<SidebarGroupContent>
<SidebarMenu>
{openTickets.map((ticket) => {
const isActive = pathWithoutSearch(path) === pathWithoutSearch(ticket.path);
<SidebarGroupContent className="min-h-0 flex-1 overflow-hidden">
<div ref={openTicketsListRef} className="max-h-[clamp(8rem,calc(100svh-31rem),24rem)] overflow-y-auto overscroll-contain pr-1 [scrollbar-gutter:stable] [scrollbar-width:thin]">
<SidebarMenu>
{openTickets.map((ticket) => {
const isActive = pathWithoutSearch(path) === pathWithoutSearch(ticket.path);
return (
<SidebarMenuItem key={ticket.key}>
<div
draggable
onDragStart={(event) => startOpenTicketDrag(event, ticket)}
onDragOver={(event) => overOpenTicket(event, ticket)}
onDrop={(event) => dropOpenTicket(event, ticket)}
onDragEnd={() => setDraggedOpenTicketKey(null)}
className={cn(
"mx-2 flex cursor-grab items-center gap-1 rounded-md px-2 py-1.5 active:cursor-grabbing",
isActive ? "bg-primary text-primary-foreground" : "hover:bg-sidebar-accent hover:text-sidebar-accent-foreground",
draggedOpenTicketKey === ticket.key && "opacity-60",
)}
>
<GripVertical className="size-3.5 shrink-0 text-muted-foreground" />
<a
href={ticket.path}
className="flex min-w-0 flex-1 items-center gap-2 text-sm"
title={
ticket.periodType === "all"
? `${ticket.ticketNumber} (alle Sessions)`
: `${ticket.ticketNumber} (${ticket.periodType === "month" ? "Monat" : "Tag"} ${ticket.period})`
}
onClick={navHandler(ticket.path)}
return (
<SidebarMenuItem key={ticket.key}>
<div
data-open-ticket-active={isActive ? "true" : undefined}
draggable
onDragStart={(event) => startOpenTicketDrag(event, ticket)}
onDragOver={(event) => overOpenTicket(event, ticket)}
onDrop={(event) => dropOpenTicket(event, ticket)}
onDragEnd={() => setDraggedOpenTicketKey(null)}
className={cn(
"mx-2 flex cursor-grab items-center gap-1 rounded-md px-2 py-1.5 active:cursor-grabbing",
isActive ? "bg-primary text-primary-foreground" : "hover:bg-sidebar-accent hover:text-sidebar-accent-foreground",
draggedOpenTicketKey === ticket.key && "opacity-60",
)}
>
<span className={cn("size-2 shrink-0 rounded-full", ticket.dirty ? "bg-amber-400" : isActive ? "bg-primary-foreground" : "bg-muted-foreground/70")} />
<FileText className="size-4 shrink-0" />
<span className="truncate">{ticket.ticketNumber}</span>
</a>
<Button
type="button"
size="icon"
variant="ghost"
className={cn("size-6 shrink-0", isActive ? "hover:bg-primary-foreground/15 hover:text-primary-foreground" : "")}
onClick={() => closeOpenTicket(ticket)}
aria-label={`${ticket.ticketNumber} schließen`}
>
<X className="size-3.5" />
</Button>
</div>
</SidebarMenuItem>
);
})}
</SidebarMenu>
<GripVertical className="size-3.5 shrink-0 text-muted-foreground" />
<a
href={ticket.path}
className="flex min-w-0 flex-1 items-center gap-2 text-sm"
title={
ticket.periodType === "all"
? `${ticket.ticketNumber} (alle Sessions)`
: `${ticket.ticketNumber} (${ticket.periodType === "month" ? "Monat" : "Tag"} ${ticket.period})`
}
onClick={navHandler(ticket.path)}
>
<span className={cn("size-2 shrink-0 rounded-full", ticket.dirty ? "bg-amber-400" : isActive ? "bg-primary-foreground" : "bg-muted-foreground/70")} />
<FileText className="size-4 shrink-0" />
<span className="truncate">{ticket.ticketNumber}</span>
</a>
<Button
type="button"
size="icon"
variant="ghost"
className={cn("size-6 shrink-0", isActive ? "hover:bg-primary-foreground/15 hover:text-primary-foreground" : "")}
onClick={() => closeOpenTicket(ticket)}
aria-label={`${ticket.ticketNumber} schließen`}
>
<X className="size-3.5" />
</Button>
</div>
</SidebarMenuItem>
);
})}
</SidebarMenu>
</div>
</SidebarGroupContent>
</SidebarGroup>
) : null}
@@ -1357,18 +1527,11 @@ export function App() {
</SidebarContent>
<SidebarFooter>
{!isAdmin ? <div className="mx-2 rounded-lg border bg-card p-3 text-sm shadow-xs group-data-[collapsible=icon]:hidden">
<div className="mb-2 flex items-center gap-2 font-medium">
<CheckCircle2 className="size-4 text-muted-foreground" />
Abschluss
</div>
<p className="text-muted-foreground">Offene Bewertungen findest du im Monatsabschluss.</p>
</div> : null}
<SidebarMenu>
<SidebarMenuItem>
<SidebarMenuButton tooltip="Worklog">
<UserCircle />
<span>Worklog lokal</span>
<FolderGit />
<span className="text-xs text-muted-foreground">v1.0.11-rc1</span>
</SidebarMenuButton>
</SidebarMenuItem>
</SidebarMenu>
@@ -1462,15 +1625,17 @@ export function App() {
selectedTimerId={selectedTimerId}
setSelectedTimerId={setSelectedTimerId}
tick={tick}
currentUser={currentUser}
/>
) : null}
{!isAdmin && route.page === "dashboard" ? <DashboardPage onNavigate={navigate} /> : null}
{!isAdmin && route.page === "analysis" ? <AnalysisPage onNavigate={navigate} /> : null}
{!isAdmin && route.page === "dashboard" ? <DashboardPage currentUser={currentUser} onNavigate={navigate} /> : null}
{!isAdmin && route.page === "analysis" ? <AnalysisPage currentUser={currentUser} onNavigate={navigate} /> : null}
{!isAdmin && route.page === "monthly-close" ? <MonthlyClosePage onNavigate={navigate} /> : null}
{!isAdmin && route.page === "statistics" ? <StatisticsPage onNavigate={navigate} /> : null}
{!isAdmin && route.page === "projects" ? <ProjectsPage onNavigate={navigate} onStartTimer={startQuickTimer} /> : null}
{!isAdmin && route.page === "statistics" ? <StatisticsPage currentUser={currentUser} onNavigate={navigate} /> : null}
{!isAdmin && route.page === "projects" ? <ProjectsPage currentUser={currentUser} onNavigate={navigate} onStartTimer={startQuickTimer} /> : null}
{!isAdmin && route.page === "todos" ? <TodosPage onNavigate={navigate} /> : null}
{!isAdmin && route.page === "recurring" ? <RecurringBillingsPage /> : null}
{!isAdmin && route.page === "zammad-sync" ? <ZammadSyncPage currentUser={currentUser} /> : null}
{route.page === "faq" ? <FaqPage /> : null}
{route.page === "profile" ? <ProfilePage currentUser={currentUser} onUserUpdated={setCurrentUser} /> : null}
{route.page === "admin-users" && isAdmin ? <AdminUsersPage currentUser={currentUser} /> : null}
@@ -1481,6 +1646,7 @@ export function App() {
selectedTimerId={selectedTimerId}
setSelectedTimerId={setSelectedTimerId}
tick={tick}
currentUser={currentUser}
/>
) : null}
{!isAdmin && route.page === "ticket" ? (
@@ -1489,6 +1655,8 @@ export function App() {
period={route.period}
ticketId={route.ticketId}
onNavigate={navigate}
onStartTimer={startQuickTimer}
currentUser={currentUser}
onOpenTicketChange={updateOpenTicket}
returnPath={ticketReturnPaths[route.ticketId] ?? openTickets.find((ticket) => ticket.ticketId === route.ticketId)?.returnPath ?? "/analysis"}
/>
+488 -26
View File
@@ -2,34 +2,59 @@ import type {
AdminUser,
AuthUser,
BillingStatus,
DashboardDayTicket,
DashboardPreference,
Organization,
PeriodOverview,
PeriodType,
ProjectTeamspaceSubentry,
ProjectSummary,
RecurringBilling,
StatisticsOverview,
StatisticsProjectFollowupOverview,
TicketMeta,
TicketPeriod,
TicketTodo,
TicketSearchResult,
TodoPriority,
TodoStatus,
WorkType
WorkType,
ZammadSessionArticleQueueItem
} from "./types";
import type { TimerEntry, TimerPhase } from "./timers";
type CreateSessionPayload = {
ticketNumber: string;
organizationId: string;
activity: string;
zammadArticleBody?: string | null;
workType: WorkType;
startedAt: string;
endedAt: string;
durationSeconds: number;
zammadLookup?: boolean;
projectTeamspaceEntryId?: string | null;
billingStatus?: BillingStatus;
createZammadArticle?: boolean;
zammadArticleTypeId?: number;
};
type CreateTimerPayload = Omit<TimerEntry, "id"> & {
id?: string;
};
type UpdateTimerPayload = Partial<{
organizationName: string | null;
workType: TimerEntry["workType"];
isProject: boolean;
projectName: string | null;
ticketLookupDone: boolean;
activity: string;
zammadArticleBody?: string | null;
billingStatus: TimerEntry["billingStatus"];
phase: TimerPhase;
}>;
type DeleteSessionResult = {
deleted: {
id: string;
@@ -42,6 +67,129 @@ type DeleteSessionResult = {
};
};
export type CreateSessionResult = {
zammadArticle?: {
requested: boolean;
status: "not_requested" | "sent" | "failed";
error: string | null;
articleId: number | null;
};
};
export type ZammadSyncExistingFields = {
title: boolean;
organization: boolean;
type: boolean;
projectName: boolean;
budget: boolean;
overrideBudget: boolean;
pendingTodo: boolean;
};
export type ZammadSyncChange = {
field: string;
from: unknown;
to: unknown;
};
export type ZammadSyncItem = {
ticketNumber: string;
action: "update" | "create" | "skip" | "error";
reason: string | null;
local: Record<string, unknown> | null;
zammad: Record<string, unknown> | null;
changes: ZammadSyncChange[];
};
export type ZammadSyncResult = {
mode: "preview" | "applied";
checked: number;
updated: number;
created: number;
skipped: number;
missingInZammad: number;
organizationMissing: number;
markedForCloseReview: number;
convertedToConsulting: number;
convertedToSupport: number;
errors: Array<{ ticketNumber: string; error: string }>;
items: ZammadSyncItem[];
};
export type ZammadSyncJob = {
id: string;
userId: string;
status: "running" | "complete" | "error";
result: ZammadSyncResult | null;
error: string | null;
startedAt: string;
finishedAt: string | null;
};
export type TeamspaceProjectIdSyncItem = {
entryId: string;
projectId: string;
ticketNumber: string;
teamspaceProject: string;
previousApiProjectId: string | null;
apiProjectId: string | null;
apiProjectUrl: string | null;
status: "updated" | "current" | "missing" | "ambiguous";
message: string | null;
};
export type TeamspaceProjectIdSyncResult = {
checkedEntries: number;
matched: number;
updated: number;
alreadyCurrent: number;
missing: number;
ambiguous: number;
cleared: number;
remoteProjectsScanned: number;
remoteProjectIds: number;
remoteSubprojectsScanned: number;
subentriesSynced: number;
subentriesRemoved: number;
duplicateRemoteProjectIds: string[];
items: TeamspaceProjectIdSyncItem[];
};
export type TeamspaceProjectSubentrySyncResult = {
projectId: string;
checkedEntries: number;
remoteProjectsScanned: number;
subentriesSynced: number;
subentriesRemoved: number;
};
export type TeamspaceAllSubentrySyncResult = {
checkedProjects: number;
checkedEntries: number;
remoteProjectsScanned: number;
subentriesSynced: number;
subentriesRemoved: number;
};
export type TicketZammadMailSessionItem = {
articleId: number;
ticketNumber: string;
subject: string | null;
activity: string;
createdAt: string;
endedAt: string;
timeUnit: number;
durationSeconds: number;
};
export type TicketZammadMailSessionResult = {
checked: number;
created: number;
skipped: number;
items: TicketZammadMailSessionItem[];
errors: Array<{ articleId: number; error: string }>;
};
export type RestoreValidationResult = {
valid: boolean;
checkedTables: number;
@@ -58,15 +206,50 @@ export class ApiError extends Error {
}
}
async function request<T>(url: string, options: RequestInit = {}): Promise<T> {
const response = await fetch(url, {
credentials: "same-origin",
headers: {
"Content-Type": "application/json",
...options.headers
},
...options
});
type ApiRequestInit = RequestInit & {
timeoutMs?: number;
};
async function request<T>(url: string, options: ApiRequestInit = {}): Promise<T> {
const { timeoutMs, signal, ...fetchOptions } = options;
const controller = timeoutMs ? new AbortController() : null;
const timeout = controller
? window.setTimeout(() => {
controller.abort();
}, timeoutMs)
: null;
if (signal && controller) {
signal.addEventListener("abort", () => controller.abort(), { once: true });
}
let response: Response;
try {
response = await fetch(url, {
signal: controller?.signal ?? signal,
...fetchOptions,
credentials: "same-origin",
headers: {
"Content-Type": "application/json",
...fetchOptions.headers
}
});
} catch (error) {
if (error instanceof DOMException && error.name === "AbortError") {
throw new ApiError("Anfrage hat zu lange gedauert", 408);
}
if (error instanceof TypeError) {
throw new ApiError("Verbindung zum Server wurde unterbrochen. Bitte prüfen, ob Backend und Frontend laufen und ob das Backup kleiner als das Upload-Limit ist.", 503);
}
throw error;
} finally {
if (timeout) {
window.clearTimeout(timeout);
}
}
if (!response.ok) {
const body = await response.json().catch(() => ({}));
@@ -76,6 +259,18 @@ async function request<T>(url: string, options: RequestInit = {}): Promise<T> {
return response.json() as Promise<T>;
}
async function requestRestoreEndpoint<T>(path: string, options: ApiRequestInit) {
return request<T>(path, options);
}
function backupValidationSql(sql: string) {
const lines = sql.replace(/^\uFEFF/, "").split(/\r?\n/);
const marker = lines.find((line) => line.includes("TicketTracker Datenbankexport")) ?? "-- TicketTracker Datenbankexport";
const structuralLines = lines.filter((line) => /^--\s*(?:[a-z_][a-z0-9_]*:\s*\d+\s+Datensatz|columns\s+[a-z_][a-z0-9_]*:)/i.test(line.trim()));
return [marker, ...structuralLines].join("\n");
}
export function login(payload: { username: string; password: string }) {
return request<{ user: AuthUser }>("/api/auth/login", {
method: "POST",
@@ -99,6 +294,21 @@ export function updateCurrentUser(payload: {
currentPassword?: string;
newPassword?: string;
zammadApiToken?: string;
teamspaceDeviceId?: string;
teamspaceDevicePassword?: string;
zammadEmailSessionWebhookEnabled?: boolean;
sessionBillingPromptEnabled?: boolean;
teamspaceTimeTrackingEnabled?: boolean;
zammadSessionNoteDefaultEnabled?: boolean;
zammadTimeUnitRoundingEnabled?: boolean;
zammadTimeUnitRoundingMinutes?: number;
zammadAtossEmailSyncEnabled?: boolean;
zammadArticleTypeId?: number;
projectFollowupEnabled?: boolean;
projectFollowupWeeks?: number;
projectFollowupSecondEnabled?: boolean;
projectFollowupSecondWeeks?: number;
projectFollowupCompleteOnSession?: boolean;
}) {
return request<{ user: AuthUser }>("/api/auth/me", {
method: "PATCH",
@@ -110,6 +320,10 @@ export function getDashboardPreference() {
return request<{ preference: Partial<DashboardPreference> }>("/api/dashboard/preferences");
}
export function getDashboardDayControl() {
return request<{ tickets: DashboardDayTicket[] }>("/api/dashboard/day-control");
}
export function saveDashboardPreference(preference: DashboardPreference) {
return request<{ preference: Partial<DashboardPreference> }>("/api/dashboard/preferences", {
method: "PUT",
@@ -142,16 +356,20 @@ export function createSetupAdmin(payload: { username: string; displayName: strin
}
export function restoreSetupBackup(sql: string) {
return request<{ ok: boolean }>("/api/setup/restore", {
return requestRestoreEndpoint<{ ok: boolean }>("/api/setup/restore", {
method: "POST",
body: JSON.stringify({ sql })
timeoutMs: 10 * 60 * 1000,
headers: { "Content-Type": "text/plain; charset=utf-8" },
body: sql
});
}
export function validateSetupBackup(sql: string) {
return request<RestoreValidationResult>("/api/setup/restore/validate", {
return requestRestoreEndpoint<RestoreValidationResult>("/api/setup/restore/validate", {
method: "POST",
body: JSON.stringify({ sql })
timeoutMs: 60_000,
headers: { "Content-Type": "text/plain; charset=utf-8" },
body: backupValidationSql(sql)
});
}
@@ -206,16 +424,20 @@ export async function downloadDatabaseExport() {
}
export function restoreDatabaseBackup(sql: string) {
return request<{ ok: boolean }>("/api/admin/restore/database", {
return requestRestoreEndpoint<{ ok: boolean }>("/api/admin/restore/database", {
method: "POST",
body: JSON.stringify({ sql })
timeoutMs: 10 * 60 * 1000,
headers: { "Content-Type": "text/plain; charset=utf-8" },
body: sql
});
}
export function validateDatabaseBackup(sql: string) {
return request<RestoreValidationResult>("/api/admin/restore/database/validate", {
return requestRestoreEndpoint<RestoreValidationResult>("/api/admin/restore/database/validate", {
method: "POST",
body: JSON.stringify({ sql })
timeoutMs: 60_000,
headers: { "Content-Type": "text/plain; charset=utf-8" },
body: backupValidationSql(sql)
});
}
@@ -259,6 +481,17 @@ export function saveZammadSettings(payload: { baseUrl: string; apiKey?: string }
});
}
export function getTeamspaceSettings() {
return request<{ settings: { baseUrl: string } }>("/api/admin/teamspace/settings");
}
export function saveTeamspaceSettings(payload: { baseUrl: string }) {
return request<{ settings: { baseUrl: string } }>("/api/admin/teamspace/settings", {
method: "PUT",
body: JSON.stringify(payload)
});
}
export function syncZammadOrganizations(payload: { baseUrl?: string; apiKey?: string }) {
return request<{ synced: number; skipped: number; removed: number; unlinkedTickets: number; unlinkedSessions: number }>("/api/admin/zammad/organizations/sync", {
method: "POST",
@@ -266,6 +499,137 @@ export function syncZammadOrganizations(payload: { baseUrl?: string; apiKey?: st
});
}
function wait(milliseconds: number) {
return new Promise((resolve) => window.setTimeout(resolve, milliseconds));
}
export async function waitForZammadSyncJob(jobId: string) {
const startedAt = Date.now();
const timeoutMs = 10 * 60 * 1000;
for (;;) {
if (Date.now() - startedAt > timeoutMs) {
throw new ApiError("Zammad-Sync läuft länger als erwartet. Bitte Vorschau neu starten.", 408);
}
const { job } = await request<{ job: ZammadSyncJob }>(`/api/zammad-sync/jobs/${encodeURIComponent(jobId)}`, { timeoutMs: 20_000 });
if (job.status === "complete" && job.result) {
return job.result;
}
if (job.status === "error") {
throw new ApiError(job.error ?? "Zammad-Sync fehlgeschlagen", 500);
}
await wait(1200);
}
}
async function runZammadSyncJob(url: string, body: Record<string, unknown>, onJobStarted?: (job: ZammadSyncJob) => void) {
const { job } = await request<{ job: ZammadSyncJob }>(url, {
method: "POST",
timeoutMs: 20_000,
body: JSON.stringify(body)
});
onJobStarted?.(job);
const result = await waitForZammadSyncJob(job.id);
return { jobId: job.id, result };
}
export async function syncExistingZammadTickets(fields: ZammadSyncExistingFields, options: { dryRun?: boolean; ticketNumbers?: string[] } = {}) {
const { result } = await runZammadSyncJob("/api/zammad-sync/jobs/existing", {
fields,
dryRun: options.dryRun ?? true,
ticketNumbers: options.ticketNumbers
});
return result;
}
export async function importOwnZammadConsultingTickets(options: { dryRun?: boolean; ticketNumbers?: string[] } = {}) {
const { result } = await runZammadSyncJob("/api/zammad-sync/jobs/consulting-import", {
dryRun: options.dryRun ?? true,
ticketNumbers: options.ticketNumbers
});
return result;
}
export function previewExistingZammadTickets(fields: ZammadSyncExistingFields, onJobStarted?: (job: ZammadSyncJob) => void) {
return runZammadSyncJob("/api/zammad-sync/jobs/existing", {
fields,
dryRun: true
}, onJobStarted);
}
export function applyExistingZammadTicketsFromPreview(previewJobId: string, fields: ZammadSyncExistingFields, ticketNumbers: string[], onJobStarted?: (job: ZammadSyncJob) => void) {
return runZammadSyncJob(`/api/zammad-sync/jobs/${encodeURIComponent(previewJobId)}/apply-existing`, {
fields,
ticketNumbers
}, onJobStarted);
}
export function previewOwnZammadConsultingTickets(onJobStarted?: (job: ZammadSyncJob) => void) {
return runZammadSyncJob("/api/zammad-sync/jobs/consulting-import", {
dryRun: true
}, onJobStarted);
}
export function applyOwnZammadConsultingTicketsFromPreview(previewJobId: string, ticketNumbers: string[], onJobStarted?: (job: ZammadSyncJob) => void) {
return runZammadSyncJob(`/api/zammad-sync/jobs/${encodeURIComponent(previewJobId)}/apply-consulting-import`, {
ticketNumbers
}, onJobStarted);
}
export function previewZammadMailSessions(daysBack: number, perPage: number, onJobStarted?: (job: ZammadSyncJob) => void) {
return runZammadSyncJob("/api/zammad-sync/jobs/mail-sessions", {
dryRun: true,
daysBack,
perPage
}, onJobStarted);
}
export function applyZammadMailSessionsFromPreview(previewJobId: string, articleIds: number[], onJobStarted?: (job: ZammadSyncJob) => void) {
return runZammadSyncJob(`/api/zammad-sync/jobs/${encodeURIComponent(previewJobId)}/apply-mail-sessions`, {
articleIds
}, onJobStarted);
}
export function syncTeamspaceProjectIds() {
return request<{ result: TeamspaceProjectIdSyncResult }>("/api/teamspace/project-ids/sync", {
method: "POST",
timeoutMs: 5 * 60 * 1000
});
}
export function syncProjectTeamspaceSubentries(projectId: string) {
return request<{ result: TeamspaceProjectSubentrySyncResult }>(`/api/projects/${projectId}/teamspace-subentries/sync`, {
method: "POST",
timeoutMs: 5 * 60 * 1000
});
}
export function syncAllTeamspaceSubentries() {
return request<{ result: TeamspaceAllSubentrySyncResult }>("/api/teamspace/subentries/sync", {
method: "POST",
timeoutMs: 5 * 60 * 1000
});
}
export function updateProjectTeamspaceSubentry(
subentryId: string,
payload: {
alias: string;
}
) {
return request<{ subentry: ProjectTeamspaceSubentry }>(`/api/project-teamspace-subentries/${subentryId}`, {
method: "PATCH",
body: JSON.stringify(payload)
});
}
export function getRecurringBillings() {
return request<{ recurringBillings: RecurringBilling[] }>("/api/recurring-billings");
}
@@ -324,14 +688,18 @@ export function deleteRecurringBilling(billingId: string) {
});
}
export function getProjects(includeClosed = false) {
export function getProjects(includeClosed = false, hidden = false) {
const params = new URLSearchParams();
if (includeClosed) {
params.set("includeClosed", "true");
}
return request<{ projects: ProjectSummary[] }>(`/api/projects${params.size ? `?${params}` : ""}`);
if (hidden) {
params.set("hidden", "true");
}
return request<{ projects: ProjectSummary[]; hiddenCount: number; totalCount: number }>(`/api/projects${params.size ? `?${params}` : ""}`);
}
export function getProject(projectId: string) {
@@ -347,8 +715,10 @@ export function createProject(payload: {
teamspaceEntries?: Array<{
id?: string | null;
teamspaceProject?: string | null;
teamspaceDescription?: string | null;
isDefault: boolean;
hourBudgetMinutes?: number | null;
budgetSyncDisabled?: boolean;
manualConsumptionMinutes?: number | null;
}>;
description: string;
@@ -374,8 +744,10 @@ export function updateProject(
teamspaceEntries?: Array<{
id?: string | null;
teamspaceProject?: string | null;
teamspaceDescription?: string | null;
isDefault: boolean;
hourBudgetMinutes?: number | null;
budgetSyncDisabled?: boolean;
manualConsumptionMinutes?: number | null;
}>;
description: string;
@@ -399,12 +771,31 @@ export function updateProjectStatus(projectId: string, closed: boolean) {
});
}
export function acknowledgeProjectReview(projectId: string) {
return request<{ project: { id: string; ticket_id: string; close_review_required: boolean } }>(`/api/projects/${projectId}/review`, {
method: "PATCH",
body: JSON.stringify({ acknowledged: true })
});
}
export function deleteProject(projectId: string) {
return request<{ deleted: { id: string; ticket_id: string } }>(`/api/projects/${projectId}`, {
method: "DELETE"
});
}
export function hideProject(projectId: string) {
return request<{ hidden: { id: string } }>(`/api/projects/${projectId}/hide`, {
method: "POST"
});
}
export function unhideProject(projectId: string) {
return request<{ shown: { id: string } }>(`/api/projects/${projectId}/hide`, {
method: "DELETE"
});
}
export function getTodos(status?: TodoStatus | "all") {
const params = new URLSearchParams();
@@ -462,12 +853,58 @@ export function deleteTodo(todoId: string) {
}
export function createSession(payload: CreateSessionPayload) {
return request("/api/sessions", {
return request<CreateSessionResult>("/api/sessions", {
method: "POST",
body: JSON.stringify(payload)
});
}
export function resendSessionZammadArticle(sessionId: string, payload: { zammadArticleTypeId?: number } = {}) {
return request<CreateSessionResult>(`/api/sessions/${encodeURIComponent(sessionId)}/zammad-article`, {
method: "POST",
body: JSON.stringify(payload)
});
}
export function getActiveTimers() {
return request<{ timers: TimerEntry[] }>("/api/timers");
}
export function createActiveTimer(payload: CreateTimerPayload) {
return request<{ timers: TimerEntry[] }>("/api/timers", {
method: "POST",
body: JSON.stringify(payload)
});
}
export function updateActiveTimer(timerId: string, payload: UpdateTimerPayload) {
return request<{ timers: TimerEntry[] }>(`/api/timers/${encodeURIComponent(timerId)}`, {
method: "PATCH",
body: JSON.stringify(payload)
});
}
export function deleteActiveTimer(timerId: string) {
return request<{ timers: TimerEntry[] }>(`/api/timers/${encodeURIComponent(timerId)}`, {
method: "DELETE"
});
}
export function getZammadSessionArticleQueue() {
return request<{ queue: ZammadSessionArticleQueueItem[] }>("/api/zammad/session-article-queue");
}
export function retryZammadSessionArticleQueue() {
return request<{
sent: number;
failed: number;
queue: ZammadSessionArticleQueueItem[];
results: Array<{ id: string; status: "sent" | "failed"; error?: string; zammadArticleId?: number | null }>;
}>("/api/zammad/session-article-queue/retry", {
method: "POST"
});
}
export function lookupTicket(ticketNumber: string, source: "local" | "zammad" = "local") {
const params = new URLSearchParams({ ticketNumber });
@@ -503,6 +940,7 @@ export function updateSessionDetails(
payload: {
organizationId: string;
activity: string;
zammadArticleBody?: string | null;
workType: WorkType;
removeProjectData?: boolean;
projectTeamspaceEntryId?: string | null;
@@ -516,10 +954,18 @@ export function updateSessionDetails(
});
}
export function updateTicketDayBilling(ticketId: string, day: string, billedMinutes: number | null) {
export function updateTicketDayBilling(
ticketId: string,
day: string,
billedMinutes: number | null,
projectTeamspaceEntryId?: string | null
) {
return request(`/api/tickets/${ticketId}/day-billings/${day}`, {
method: "PATCH",
body: JSON.stringify({ billedMinutes })
body: JSON.stringify({
billedMinutes,
projectTeamspaceEntryId: projectTeamspaceEntryId ?? null
})
});
}
@@ -546,8 +992,12 @@ export function getPeriodOverview(type: PeriodType, period: string) {
return request<PeriodOverview>(`/api/periods/${periodPath(type)}/${period}/overview`);
}
export function getStatisticsOverview(month: string) {
return request<StatisticsOverview>(`/api/statistics/months/${month}`);
export function getStatisticsOverview(period: string, type: "month" | "week" = "month") {
return request<StatisticsOverview>(`/api/statistics/${type === "week" ? "weeks" : "months"}/${period}`);
}
export function getProjectFollowups() {
return request<StatisticsProjectFollowupOverview>("/api/statistics/project-followups");
}
export function getTicketPeriod(type: PeriodType, period: string, ticketId: string) {
@@ -558,7 +1008,7 @@ export function getTicketDetails(
ticketId: string,
filters: {
month?: string;
status?: "all" | "open" | "billed" | "non_billable";
status?: "all" | "open" | "billable" | "billed" | "non_billable";
source?: "all" | "manual" | "recurring";
} = {}
) {
@@ -579,6 +1029,18 @@ export function getTicketDetails(
return request<TicketPeriod>(`/api/tickets/${ticketId}/details${params.size ? `?${params}` : ""}`);
}
export function previewTicketZammadMailSessions(ticketId: string, daysBack: number) {
const params = new URLSearchParams({ daysBack: String(daysBack) });
return request<TicketZammadMailSessionResult>(`/api/tickets/${ticketId}/zammad-mail-sessions?${params}`);
}
export function importTicketZammadMailSessions(ticketId: string, daysBack: number, articleIds: number[]) {
return request<TicketZammadMailSessionResult>(`/api/tickets/${ticketId}/zammad-mail-sessions`, {
method: "POST",
body: JSON.stringify({ daysBack, articleIds })
});
}
export function updateSessionBilling(sessionId: string, billingStatus: BillingStatus) {
return request(`/api/sessions/${sessionId}/billing`, {
method: "PATCH",
+1
View File
@@ -53,6 +53,7 @@
--font-heading: var(--font-sans);
--font-sans: var(--font-sans);
--breakpoint-xxl: 108.125rem;
--breakpoint-details: 85rem;
}
+24 -1
View File
@@ -8,9 +8,32 @@ type CopyTicketButtonProps = {
};
export function CopyTicketButton({ ticketNumber }: CopyTicketButtonProps) {
async function writeToClipboard(value: string) {
if (navigator.clipboard?.writeText) {
await navigator.clipboard.writeText(value);
return;
}
const textarea = document.createElement("textarea");
textarea.value = value;
textarea.style.position = "fixed";
textarea.style.left = "-9999px";
textarea.setAttribute("readonly", "");
document.body.appendChild(textarea);
textarea.select();
try {
if (!document.execCommand("copy")) {
throw new Error("Zwischenablage nicht verfügbar");
}
} finally {
document.body.removeChild(textarea);
}
}
async function copyTicketNumber() {
try {
await navigator.clipboard.writeText(ticketNumber);
await writeToClipboard(ticketNumber);
toast.success("Ticketnummer kopiert", {
description: ticketNumber
});
@@ -0,0 +1,92 @@
import { ChevronsUpDown } from "lucide-react";
import { useState } from "react";
import { cn } from "@/lib/utils";
import { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { Input } from "@/components/ui/input";
import { Popover, PopoverContent, PopoverTrigger } from "@/components/ui/popover";
export type MultiFilterOption = { value: string; label: string };
type MultiFilterDropdownProps = {
values: string[];
options: MultiFilterOption[];
onChange: (values: string[]) => void;
placeholder?: string;
countLabel?: string;
emptyLabel?: string;
};
export function MultiFilterDropdown({
values,
options,
onChange,
placeholder = "Alle Filter",
countLabel = "Filter",
emptyLabel = "Keine Filter."
}: MultiFilterDropdownProps) {
const [open, setOpen] = useState(false);
const [search, setSearch] = useState("");
const normalizedSearch = search.trim().toLocaleLowerCase("de-DE");
const visibleOptions = normalizedSearch
? options.filter((option) => option.label.toLocaleLowerCase("de-DE").includes(normalizedSearch) || option.value.toLocaleLowerCase("de-DE").includes(normalizedSearch))
: options;
const activeLabels = values.map((value) => options.find((option) => option.value === value)?.label).filter(Boolean);
function toggle(value: string) {
onChange(values.includes(value) ? values.filter((filter) => filter !== value) : [...values, value]);
}
return (
<Popover open={open} onOpenChange={setOpen}>
<PopoverTrigger asChild>
<Button type="button" variant="outline" role="combobox" aria-expanded={open} className="h-8 w-full justify-between px-2 text-xs font-normal">
<span className={cn("truncate", values.length === 0 && "text-muted-foreground")}>
{activeLabels.length === 0 ? placeholder : activeLabels.length === 1 ? activeLabels[0] : `${activeLabels.length} ${countLabel}`}
</span>
<ChevronsUpDown className="size-3.5 opacity-60" />
</Button>
</PopoverTrigger>
<PopoverContent align="start" className="w-[--radix-popover-trigger-width] gap-1 p-1.5">
<Input className="h-7 text-xs" value={search} placeholder="Suchen..." onChange={(event) => setSearch(event.currentTarget.value)} />
<div className="max-h-64 overflow-y-auto pr-1">
{visibleOptions.length === 0 ? (
<p className="px-2 py-3 text-center text-xs text-muted-foreground">{emptyLabel}</p>
) : (
<div className="space-y-0.5">
{visibleOptions.map((option) => {
const checked = values.includes(option.value);
return (
<div
key={option.value}
role="button"
tabIndex={0}
aria-pressed={checked}
className="flex h-7 w-full min-w-0 cursor-default items-center gap-2 rounded-md px-2 text-left text-xs outline-none hover:bg-muted focus-visible:bg-muted"
onClick={() => toggle(option.value)}
onKeyDown={(event) => {
if (event.key === "Enter" || event.key === " ") {
event.preventDefault();
toggle(option.value);
}
}}
>
<Checkbox checked={checked} tabIndex={-1} className="pointer-events-none" />
<span className="truncate">{option.label}</span>
</div>
);
})}
</div>
)}
</div>
{values.length > 0 ? (
<Button type="button" size="sm" variant="ghost" className="h-6 justify-start px-2 text-[11px]" onClick={() => onChange([])}>
Zurücksetzen
</Button>
) : null}
</PopoverContent>
</Popover>
);
}
@@ -0,0 +1,412 @@
import { Bold, Heading1, Heading2, Heading3, Italic, List, ListOrdered, RemoveFormatting, Strikethrough, Underline } from "lucide-react";
import { type ClipboardEvent, type KeyboardEvent, useEffect, useRef, useState } from "react";
import { toast } from "sonner";
import { cn } from "@/lib/utils";
type RichActivityEditorProps = {
id: string;
value: string;
htmlValue: string;
disabled?: boolean;
placeholder?: string;
onChange: (value: string, htmlValue: string) => void;
};
function escapeHtml(value: string) {
return value
.replace(/&/g, "&amp;")
.replace(/</g, "&lt;")
.replace(/>/g, "&gt;")
.replace(/"/g, "&quot;");
}
function escapeAttribute(value: string) {
return escapeHtml(value).replace(/'/g, "&#39;");
}
function escapeHtmlText(value: string) {
return escapeHtml(value)
.replace(/\t/g, "&nbsp;&nbsp;&nbsp;&nbsp;")
.replace(/ /g, "&nbsp;")
.replace(/\r\n|\r|\n/g, "<br>");
}
function textToEditorHtml(value: string) {
return value
.split(/\r?\n/)
.map((line) => `<div>${line ? escapeHtml(line) : "<br>"}</div>`)
.join("");
}
function fileToDataUrl(file: File) {
return new Promise<string>((resolve, reject) => {
const reader = new FileReader();
reader.addEventListener("load", () => resolve(String(reader.result ?? "")));
reader.addEventListener("error", () => reject(reader.error ?? new Error("Bild konnte nicht gelesen werden")));
reader.readAsDataURL(file);
});
}
function currentSelectionRange() {
const selection = window.getSelection();
return selection && selection.rangeCount > 0 ? selection.getRangeAt(0).cloneRange() : null;
}
function restoreSelectionRange(range: Range | null) {
if (!range) {
return;
}
const selection = window.getSelection();
selection?.removeAllRanges();
selection?.addRange(range);
}
function editorPlainText(element: HTMLElement) {
return element.innerText.replace(/\u00a0/g, " ");
}
function hasInlineImage(element: HTMLElement) {
return Boolean(element.querySelector("img[src^='data:image/']"));
}
function textStyleTagsFromElement(element: HTMLElement) {
const style = element.getAttribute("style")?.toLowerCase() ?? "";
const tags: Array<"b" | "i" | "u" | "strike"> = [];
if (/font-weight\s*:\s*(bold|[7-9]00)\b/.test(style)) {
tags.push("b");
}
if (/font-style\s*:\s*italic\b/.test(style)) {
tags.push("i");
}
if (/text-decoration(?:-line)?\s*:[^;]*underline/.test(style)) {
tags.push("u");
}
if (/text-decoration(?:-line)?\s*:[^;]*(line-through|strike)/.test(style)) {
tags.push("strike");
}
return tags;
}
function wrapHtml(html: string, tags: string[]) {
return tags.reduceRight((current, tag) => `<${tag}>${current}</${tag}>`, html);
}
function serializeEditorChildren(element: Element | DocumentFragment) {
return Array.from(element.childNodes).map(serializeEditorNode).join("");
}
function serializeEditorNode(node: ChildNode): string {
if (node.nodeType === Node.TEXT_NODE) {
return escapeHtmlText(node.textContent ?? "");
}
if (!(node instanceof HTMLElement)) {
return "";
}
const tagName = node.tagName.toLowerCase();
const children = serializeEditorChildren(node);
if (tagName === "br") {
return "<br>";
}
if (tagName === "img") {
const src = node.getAttribute("src") ?? "";
return src.startsWith("data:image/") ? `<img src="${escapeAttribute(src)}" style="max-width:100%;">` : "";
}
if (tagName === "b" || tagName === "strong") {
return `<b>${children}</b>`;
}
if (tagName === "i" || tagName === "em") {
return `<i>${children}</i>`;
}
if (tagName === "u") {
return `<u>${children}</u>`;
}
if (tagName === "s" || tagName === "strike") {
return `<strike>${children}</strike>`;
}
if (tagName === "span" || tagName === "font") {
return wrapHtml(children, textStyleTagsFromElement(node));
}
if (tagName === "div" || tagName === "p" || tagName === "blockquote" || tagName === "pre" || tagName === "code") {
return `<${tagName}>${children || "<br>"}</${tagName}>`;
}
if (tagName === "h1" || tagName === "h2" || tagName === "h3" || tagName === "ul" || tagName === "ol" || tagName === "li") {
return `<${tagName}>${children}</${tagName}>`;
}
return children;
}
function editorHtml(element: HTMLElement) {
return serializeEditorChildren(element);
}
function normalizedEditorHtml(element: HTMLElement) {
const html = editorHtml(element);
return html && (editorPlainText(element).trim() || hasInlineImage(element)) ? html : "";
}
export function readRichActivityEditorValue(id: string) {
const element = typeof document === "undefined" ? null : document.getElementById(id);
if (!(element instanceof HTMLElement)) {
return null;
}
return {
activity: editorPlainText(element),
zammadArticleBody: normalizedEditorHtml(element)
};
}
function editorButtonClass(active = false) {
return cn(
"inline-flex size-8 items-center justify-center rounded-sm text-sm font-semibold text-zinc-100 outline-none transition-colors hover:bg-zinc-700 focus-visible:ring-2 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50",
active && "bg-zinc-700"
);
}
export function RichActivityEditor({
id,
value,
htmlValue,
disabled = false,
placeholder = "Tätigkeit beschreiben, Screenshot mit Strg+V einfügen",
onChange
}: RichActivityEditorProps) {
const editorRef = useRef<HTMLDivElement | null>(null);
const lastEmittedTextRef = useRef("");
const lastEmittedHtmlRef = useRef("");
const [selectedImage, setSelectedImage] = useState<HTMLImageElement | null>(null);
useEffect(() => {
const editor = editorRef.current;
if (!editor) {
return;
}
const nextHtml = htmlValue || (value ? textToEditorHtml(value) : "");
const currentHtml = normalizedEditorHtml(editor);
if (htmlValue === lastEmittedHtmlRef.current && value === lastEmittedTextRef.current) {
return;
}
if (!htmlValue && value === lastEmittedTextRef.current && currentHtml === lastEmittedHtmlRef.current) {
return;
}
if (editor.innerHTML !== nextHtml) {
editor.innerHTML = nextHtml;
}
lastEmittedTextRef.current = editorPlainText(editor);
lastEmittedHtmlRef.current = normalizedEditorHtml(editor);
}, [htmlValue, value]);
function clearSelectedImage() {
selectedImage?.classList.remove("ring-2", "ring-ring", "ring-offset-2");
setSelectedImage(null);
}
function emitChange() {
const editor = editorRef.current;
if (!editor) {
return;
}
const text = editorPlainText(editor);
const html = normalizedEditorHtml(editor);
lastEmittedTextRef.current = text;
lastEmittedHtmlRef.current = html;
onChange(text, html);
}
function focusEditor() {
editorRef.current?.focus();
}
function runCommand(command: string, value?: string) {
if (disabled) {
return;
}
focusEditor();
document.execCommand("styleWithCSS", false, "false");
document.execCommand(command, false, value);
emitChange();
}
function selectImage(image: HTMLImageElement) {
clearSelectedImage();
image.classList.add("ring-2", "ring-ring", "ring-offset-2");
setSelectedImage(image);
const range = document.createRange();
range.selectNode(image);
const selection = window.getSelection();
selection?.removeAllRanges();
selection?.addRange(range);
}
function removeSelectedImage() {
const image = selectedImage;
if (!image) {
return;
}
image.remove();
setSelectedImage(null);
emitChange();
}
function handleKeyDown(event: KeyboardEvent<HTMLDivElement>) {
if ((event.key === "Delete" || event.key === "Backspace") && selectedImage) {
event.preventDefault();
removeSelectedImage();
return;
}
if (event.key === "Tab" && !disabled) {
event.preventDefault();
document.execCommand("insertText", false, " ");
emitChange();
}
}
async function handlePaste(event: ClipboardEvent<HTMLDivElement>) {
if (disabled) {
return;
}
const imageFiles = Array.from(event.clipboardData.items)
.filter((item) => item.kind === "file" && item.type.startsWith("image/"))
.map((item) => item.getAsFile())
.filter((file): file is File => Boolean(file));
if (imageFiles.length === 0) {
const text = event.clipboardData.getData("text/plain");
if (text) {
event.preventDefault();
document.execCommand("styleWithCSS", false, "false");
document.execCommand("insertText", false, text);
emitChange();
}
return;
}
event.preventDefault();
clearSelectedImage();
let insertionRange = currentSelectionRange();
const text = event.clipboardData.getData("text/plain");
if (text) {
document.execCommand("styleWithCSS", false, "false");
document.execCommand("insertText", false, `${text}\n`);
insertionRange = currentSelectionRange();
}
try {
for (const file of imageFiles) {
const dataUrl = await fileToDataUrl(file);
restoreSelectionRange(insertionRange);
document.execCommand("insertHTML", false, `<img src="${dataUrl}" style="display:block;max-width:100%;height:auto;margin-top:0.5rem;border-radius:0.375rem;"><br>`);
insertionRange = currentSelectionRange();
}
emitChange();
} catch (error) {
toast.error("Screenshot konnte nicht eingefügt werden", {
description: error instanceof Error ? error.message : "Unbekannter Fehler"
});
}
}
const toolbarDisabled = disabled;
return (
<div className={cn("min-w-0 max-w-full overflow-hidden rounded-lg border border-input bg-transparent", disabled && "opacity-60")}>
<div className="flex min-w-0 flex-wrap items-center gap-1 border-b border-zinc-700 bg-zinc-900 px-2 py-1">
<button type="button" className={editorButtonClass()} disabled={toolbarDisabled} title="Fett" onMouseDown={(event) => event.preventDefault()} onClick={() => runCommand("bold")}>
<Bold className="size-4" />
</button>
<button type="button" className={editorButtonClass()} disabled={toolbarDisabled} title="Kursiv" onMouseDown={(event) => event.preventDefault()} onClick={() => runCommand("italic")}>
<Italic className="size-4" />
</button>
<button type="button" className={editorButtonClass()} disabled={toolbarDisabled} title="Unterstrichen" onMouseDown={(event) => event.preventDefault()} onClick={() => runCommand("underline")}>
<Underline className="size-4" />
</button>
<button type="button" className={editorButtonClass()} disabled={toolbarDisabled} title="Durchgestrichen" onMouseDown={(event) => event.preventDefault()} onClick={() => runCommand("strikeThrough")}>
<Strikethrough className="size-4" />
</button>
<button type="button" className={editorButtonClass()} disabled={toolbarDisabled} title="Formatierung entfernen" onMouseDown={(event) => event.preventDefault()} onClick={() => runCommand("removeFormat")}>
<RemoveFormatting className="size-4" />
</button>
<span className="mx-1 h-6 w-px bg-zinc-700" aria-hidden="true" />
<button type="button" className={editorButtonClass()} disabled={toolbarDisabled} title="Überschrift 1" onMouseDown={(event) => event.preventDefault()} onClick={() => runCommand("formatBlock", "h1")}>
<Heading1 className="size-4" />
</button>
<button type="button" className={editorButtonClass()} disabled={toolbarDisabled} title="Überschrift 2" onMouseDown={(event) => event.preventDefault()} onClick={() => runCommand("formatBlock", "h2")}>
<Heading2 className="size-4" />
</button>
<button type="button" className={editorButtonClass()} disabled={toolbarDisabled} title="Überschrift 3" onMouseDown={(event) => event.preventDefault()} onClick={() => runCommand("formatBlock", "h3")}>
<Heading3 className="size-4" />
</button>
<span className="mx-1 h-6 w-px bg-zinc-700" aria-hidden="true" />
<button type="button" className={editorButtonClass()} disabled={toolbarDisabled} title="Nummerierte Liste" onMouseDown={(event) => event.preventDefault()} onClick={() => runCommand("insertOrderedList")}>
<ListOrdered className="size-4" />
</button>
<button type="button" className={editorButtonClass()} disabled={toolbarDisabled} title="Liste" onMouseDown={(event) => event.preventDefault()} onClick={() => runCommand("insertUnorderedList")}>
<List className="size-4" />
</button>
</div>
<div
id={id}
ref={editorRef}
role="textbox"
aria-multiline="true"
contentEditable={!disabled}
suppressContentEditableWarning
className="min-h-24 w-full min-w-0 overflow-hidden break-words bg-transparent px-2.5 py-2 text-base outline-none transition-colors [overflow-wrap:anywhere] empty:before:text-muted-foreground empty:before:content-[attr(data-placeholder)] focus-visible:ring-3 focus-visible:ring-ring/50 md:text-sm [&_h1]:text-2xl [&_h1]:font-semibold [&_h2]:text-xl [&_h2]:font-semibold [&_h3]:text-lg [&_h3]:font-semibold [&_img]:my-2 [&_img]:max-h-[28rem] [&_img]:max-w-full [&_img]:rounded-md [&_ol]:ml-5 [&_ol]:list-decimal [&_ul]:ml-5 [&_ul]:list-disc"
data-placeholder={placeholder}
onInput={emitChange}
onBlur={() => {
clearSelectedImage();
emitChange();
}}
onClick={(event) => {
const target = event.target;
if (target instanceof HTMLImageElement) {
selectImage(target);
return;
}
clearSelectedImage();
}}
onKeyDown={handleKeyDown}
onPaste={(event) => void handlePaste(event)}
/>
</div>
);
}
+1 -1
View File
@@ -68,7 +68,7 @@ function AccordionContent({
>
<div
className={cn(
"h-(--radix-accordion-content-height) pt-0 pb-2.5 [&_a]:underline [&_a]:underline-offset-3 [&_a]:hover:text-foreground [&_p:not(:last-child)]:mb-4",
"pt-0 pb-2.5 [&_a]:underline [&_a]:underline-offset-3 [&_a]:hover:text-foreground [&_p:not(:last-child)]:mb-4",
className
)}
>
+11
View File
@@ -53,6 +53,17 @@ export function currentMonth() {
return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}`;
}
export function currentWeek() {
const now = new Date();
const date = new Date(Date.UTC(now.getFullYear(), now.getMonth(), now.getDate()));
const weekday = date.getUTCDay() || 7;
date.setUTCDate(date.getUTCDate() + 4 - weekday);
const yearStart = new Date(Date.UTC(date.getUTCFullYear(), 0, 1));
const week = Math.ceil(((date.getTime() - yearStart.getTime()) / 86_400_000 + 1) / 7);
return `${date.getUTCFullYear()}-W${String(week).padStart(2, "0")}`;
}
export function currentDay() {
const now = new Date();
return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}`;
+71 -37
View File
@@ -16,6 +16,7 @@ export const helpSections: HelpSection[] = [
quickItems: [
"Sessions sind die getrackten oder nachgetragenen Arbeitszeiten.",
"Teamspace-Werte sind Tageswerte pro Ticket, nicht einzelne Sessions.",
"Projekt-Sessions können einem Teamspace-Eintrag zugeordnet sein.",
"Abgeschlossen wird nur der Monat."
],
details: [
@@ -23,7 +24,8 @@ export const helpSections: HelpSection[] = [
"TicketTracker ersetzt auch nicht das CRM. Die CRM- beziehungsweise Teamspace-Zeit wird als Kontrollwert gepflegt, damit abgerechnete Zeiten und eingetragene Abrechnung gegenübergestellt werden können.",
"Eine Session ist immer einem Benutzer zugeordnet. In den normalen Auswertungen sieht jeder Benutzer nur seine eigenen Sessions.",
"Ticketdaten wie Organisation und Art können aus bestehenden Tickets übernommen werden, auch wenn ein anderer Benutzer das Ticket schon bearbeitet hat.",
"Tickets werden nicht abgeschlossen. Sie gruppieren Sessions. Relevant für den Abschluss ist nur, ob alle Sessions eines Monats bewertet sind.",
"Consulting-Projekte können einen oder mehrere Teamspace-Einträge haben. Einer davon ist immer der Standard-Eintrag.",
"Tickets werden nicht abgeschlossen. Sie gruppieren Sessions. Relevant für den Abschluss ist nur, ob alle Sessions eines Monats final bewertet sind.",
"Der Monatsabschluss sperrt den Monat gegen versehentliche Änderungen. Muss doch noch etwas korrigiert werden, kann der Monat wieder geöffnet werden."
]
},
@@ -32,31 +34,33 @@ export const helpSections: HelpSection[] = [
title: "Monatsworkflow",
description: "Der empfohlene Ablauf vom Start einer Arbeitssession bis zum sauberen Monatsabschluss.",
quickItems: [
"Während des Monats: Ticketnummer eingeben, Timer starten, Session beenden und Tätigkeit dokumentieren.",
"Während des Monats: Ticketnummer eingeben, Timer starten, Tätigkeit dokumentieren und Session beenden.",
"Vergessene Zeiten: Session manuell auf dem Ticket oder als neues Ticket nachtragen.",
"Am Monatsende: offene Bewertungen bearbeiten, Teamspace-Tageswerte pflegen, Kontrolle durchführen und Monat schließen."
],
details: [
"Der normale Einstieg ist das Ticketfeld im Kopfbereich oder die Seite Session starten. Dort gibst du die Ticketnummer ein und startest den Timer mit Timer starten.",
"Während der Arbeit läuft genau ein Timer aktiv. Wechselst du zu einem anderen Timer, pausiert TicketTracker die übrigen Timer automatisch.",
"Wenn die Arbeit erledigt ist, beendest du den Timer. Die Zeit stoppt sofort beim Klick auf Beenden; das anschließende Ausfüllen der Tätigkeit zählt nicht mehr zur Sessionzeit.",
"Im Beenden-Dialog trägst du die Tätigkeit ein. Wenn das Ticket bereits bekannt ist, übernimmt TicketTracker Organisation und Art automatisch. Bei neuen Tickets wählst du Organisation und Art zusätzlich aus.",
"Während der Timer läuft oder pausiert ist, trägst du die Tätigkeit direkt in den Timer-Details ein. Pausierte Timer behalten diese Notizen.",
"Wenn die Arbeit erledigt ist, beendest du den Timer. Die Zeit stoppt sofort beim Klick auf Beenden; die bereits erfasste Tätigkeit wird mit der Session gespeichert.",
"Wenn das Ticket bereits bekannt ist, übernimmt TicketTracker Organisation und Art automatisch. Bei neuen Tickets wählst du Organisation und Art beim Speichern zusätzlich aus.",
"Hat ein Consulting-Projekt mehrere Teamspace-Einträge, wählst du beim Speichern der Session den passenden Eintrag aus. Bei genau einem Teamspace-Eintrag ordnet TicketTracker automatisch zu.",
"Vergessene Sessions trägst du auf der Seite Session starten im Bereich Session nachtragen nach. Wenn das Ticket bereits in der Ticketliste geöffnet ist, nutzt du in der Ticketdetailansicht ebenfalls Session nachtragen; dann ist die Zuordnung zum Ticket bereits vorbelegt.",
"Unter Tickets wählst du Monat oder Tag, öffnest ein Ticket über Öffnen und siehst dort alle Sessions nach Tag gruppiert.",
"Im Ticket bewertest du jede Session mit Abgerechnet oder Nicht abrechenbar. Ein erneuter Klick auf den aktiven Status nimmt die Bewertung zurück.",
"Im Ticket setzt du je Session den Status Abrechenbar, Abgerechnet oder Nicht abrechenbar. Abrechenbar bleibt eine offene Bewertung, bis daraus Abgerechnet oder Nicht abrechenbar wird.",
"Im Ticket steht pro Tag das Feld Teamspace. Dort trägst du die Stunden ein, die du für genau dieses Ticket an genau diesem Tag wirklich im CRM beziehungsweise Teamspace erfasst hast. Nach einer Änderung erscheint der Speichern-Button.",
"Die Teamspace-Zeit ist ein Tageswert pro Ticket und Benutzer. Monats- und Tagesansicht zeigen denselben Wert; er muss also nur einmal gepflegt werden.",
"Am Monatsende öffnest du Monatsabschluss. Dort findest du offene Bewertungen gruppiert nach Ticket, Tage ohne Teamspace-Wert und die Schaltfläche Monat abschließen.",
"Offene Bewertungen sind Pflicht: Öffne das Ticket aus der Liste, bewerte die Sessions und kehre zum Monatsabschluss zurück.",
"Tage ohne Teamspace-Wert sind eine Prüfliste. Wenn die Arbeit wirklich nicht in Teamspace eingetragen werden soll, nutzt du Zur Kenntnis. Mit Zur Kenntnis anzeigen blendest du solche Einträge wieder ein und kannst die Kenntnisnahme zurücknehmen.",
"Kontrolliere vor dem Abschluss die Kennzahl Teamspace im Monatsabschluss. Idealerweise entspricht dieser Wert der Summe, die du im CRM beziehungsweise Teamspace für den Monat eingetragen hast.",
"Wenn alle Sessions bewertet sind und die Teamspace-Kontrolle passt, schließt du den Monat mit Monat abschließen. Danach sind Bewertungen und Änderungen für den Monat geschützt, bis der Monat wieder geöffnet wird."
"Wenn keine offenen Bewertungen mehr vorhanden sind und die Teamspace-Kontrolle passt, schließt du den Monat mit Monat abschließen. Danach sind Bewertungen und Änderungen für den Monat geschützt, bis der Monat wieder geöffnet wird."
],
workflow: [
"Ticketfeld im Kopfbereich oder Session starten öffnen.",
"Ticketnummer eingeben und Timer starten.",
"Arbeit erledigen; bei Bedarf zwischen vorbereiteten Timern wechseln.",
"Timer beenden und Tätigkeit speichern.",
"Tätigkeit im Timer erfassen und Timer beenden.",
"Vergessene Zeiten über Session nachtragen ergänzen.",
"Tickets öffnen, Monat wählen und Einträge prüfen.",
"Ticket öffnen, Sessions pro Tag bewerten und Teamspace-Tageswerte speichern.",
@@ -68,8 +72,8 @@ export const helpSections: HelpSection[] = [
"Ticketnummer eingeben",
"Timer starten",
"Arbeit am Ticket erledigen",
"Tätigkeit im Timer eintragen",
"Timer beenden",
"Tätigkeit eintragen",
"Session wird dem Ticket und Benutzer gespeichert",
"Optional: vergessene Session nachtragen",
"Tickets öffnen und Ticket prüfen",
@@ -108,15 +112,21 @@ export const helpSections: HelpSection[] = [
quickItems: [
"Ticketnummer eingeben und Timer starten.",
"Aktivieren eines Timers pausiert alle anderen Timer automatisch.",
"Beim Beenden stoppt die Zeit sofort; Details werden danach gespeichert."
"Die Tätigkeit wird im ausgewählten Timer erfasst und beim Beenden gespeichert."
],
details: [
"Neue Timer werden mit einer Ticketnummer im Format Ticket#XXXXXX gestartet.",
"Alle laufenden und pausierten Timer bleiben in der Seitenleiste sichtbar, damit du auf jeder Unterseite sehen kannst, was vorbereitet oder aktiv ist.",
"Wenn ein anderer Timer aktiviert wird, pausiert TicketTracker die übrigen Timer automatisch. Dadurch kann nie versehentlich auf zwei Tickets gleichzeitig Zeit laufen.",
"Beim Klick auf Beenden wird die Stoppuhr sofort angehalten. Das Speichern der Tätigkeit findet danach statt und verlängert die gemessene Zeit nicht.",
"Existiert das Ticket bereits, übernimmt TicketTracker Organisation und Art. Dann muss beim Beenden nur noch die Tätigkeit eingetragen werden.",
"Existiert das Ticket noch nicht, müssen Organisation, Tätigkeit und Art angegeben werden.",
"Wenn du einen Timer auswählst, zeigt die Timerseite dessen Details inklusive gemessener Zeit und Tätigkeitsfeld.",
"Pausierte Timer behalten ihre Tätigkeit. Entfernst du einen Timer, wird auch die noch nicht gespeicherte Tätigkeit verworfen.",
"Beim Klick auf Beenden wird die Stoppuhr sofort angehalten. Die bereits im Timer erfasste Tätigkeit wird beim Speichern an die Session gehängt.",
"Im Abschlussdialog kann die Tätigkeit als interne Zammad-Notiz übertragen werden. Der Article wird intern erstellt und bekommt die getrackte Zeit als time_unit sowie den gewählten Zammad-Typ.",
"Wenn Zammad beim Speichern nicht erreichbar ist, bleibt die Session trotzdem gespeichert. Die interne Notiz wird geparkt und kann später im Profil erneut gesendet werden.",
"Existiert das Ticket bereits, übernimmt TicketTracker Organisation und Art.",
"Bei Projekt-Tickets mit mehreren Teamspace-Einträgen zeigt der Beenden-Dialog eine Auswahl. Der Standard-Eintrag ist dort mit Standard gekennzeichnet.",
"Bei Projekt-Tickets mit genau einem Teamspace-Eintrag wird die Session automatisch diesem Eintrag zugeordnet.",
"Existiert das Ticket noch nicht, müssen Organisation und Art angegeben werden.",
"Pausen werden von der Gesamtdauer abgezogen. Die gespeicherte Zeit wird auf volle Minuten gerundet.",
"Der Schnellstart im Kopfbereich funktioniert auf allen Unterseiten und nutzt dieselbe Timerlogik."
]
@@ -126,7 +136,7 @@ export const helpSections: HelpSection[] = [
title: "Session Nachtragen",
description: "Nachtragen ist für vergessene Zeiten gedacht, wenn kein Timer gelaufen ist.",
quickItems: [
"Datum, Von, Bis und Tätigkeit eintragen.",
"Datum, Von, Bis, Bewertung und Tätigkeit eintragen.",
"Benutzer tragen eigene Sessions nach.",
"Tätigkeiten sind mehrzeilig."
],
@@ -135,8 +145,10 @@ export const helpSections: HelpSection[] = [
"Das Ende muss nach dem Beginn liegen. Übernacht-Sessions sind aktuell nicht vorgesehen und sollten als getrennte Einträge gepflegt werden.",
"Die Organisation muss aus der synchronisierten Organisationsliste gewählt werden. Freitext ist absichtlich gesperrt.",
"Die Tätigkeit ist eine Textarea. Zeilenumbrüche bleiben erhalten und werden in der Ticketdetailansicht wieder ausgegeben.",
"Nachgetragene Sessions starten immer offen. Sie müssen später als Abgerechnet oder Nicht abrechenbar bewertet werden.",
"In der Ticketdetailansicht kann eine Session direkt zum geöffneten Ticket nachgetragen werden. Ticketnummer und Stammdaten sind dort schon vorbelegt beziehungsweise aus dem Ticket abgeleitet."
"Mit Bewertung --- bleibt die Session offen. Abrechenbar oder Nicht abrechenbar werden direkt an der neuen Session gespeichert.",
"Die interne Zammad-Notiz kann auch beim Nachtragen gesetzt werden. Ist sie aktiv, kann der Zammad-Typ angepasst werden. Bei Zammad-Fehlern wird sie geparkt und kann später im Profil gesendet werden.",
"In der Ticketdetailansicht kann eine Session direkt zum geöffneten Ticket nachgetragen werden. Ticketnummer und Stammdaten sind dort schon vorbelegt beziehungsweise aus dem Ticket abgeleitet.",
"Bei Consulting-Projekten mit mehreren Teamspace-Einträgen ist der passende Teamspace-Eintrag Pflicht. Bei nur einem Eintrag wird er automatisch gesetzt."
]
},
{
@@ -207,12 +219,15 @@ export const helpSections: HelpSection[] = [
],
details: [
"Oben steht die Ticketnummer mit Copy-Icon, damit sie schnell in andere Systeme übernommen werden kann.",
"Über Timer starten kann direkt für dieses Ticket ein Timer gestartet oder ein vorhandener Timer aktiviert werden.",
"Die Session-Einträge sind nach Kalendertagen gruppiert. Pro Tagesgruppe steht die Summe der abgerechneten Zeit.",
"Nicht abrechenbare und offene Zeiten werden neben der abgerechneten Tageszeit separat angezeigt.",
"Abrechenbare, nicht abrechenbare und offene Zeiten werden neben der abgerechneten Tageszeit separat angezeigt.",
"Bei Projekt-Tickets mit mehreren Teamspace-Einträgen zeigt jede zugeordnete Session den gewählten Teamspace-Eintrag. Nicht zugeordnete Sessions werden hervorgehoben.",
"Das Teamspace-Feld wird als Stundenwert gepflegt, zum Beispiel 1, 1,5 oder 2.25.",
"Während der Eingabe wird der Teamspace-Wert nicht sofort gespeichert. Sobald eine Änderung vorliegt, erscheint ein Speichern-Button.",
"Ein leeres Teamspace-Feld entfernt den gespeicherten Teamspace-Wert für diesen Ticket-Tag.",
"Der Teamspace-Wert hängt am Ticket, Benutzer und Tag. Deshalb ist er in Monats- und Tagesansicht identisch.",
"Im Projektbereich der Ticketdetailansicht werden einzelne Teamspace-Budgetzeilen nur angezeigt, wenn mehrere Teamspace-Einträge tatsächlich ein Budget haben. Ein einzelnes Budget bleibt im Hauptbalken.",
"Geöffnete Tickets werden in der Seitenleiste unter Geöffnete Tickets abgelegt und bleiben nach Refresh oder Browserneustart erhalten.",
"Die Reihenfolge bleibt beim Anklicken stabil und kann nur per Drag and Drop geändert werden.",
"Der Schließen-Button in der Seitenleiste entfernt ein Ticket nur, wenn im aktuell geöffneten Ticket keine ungespeicherten Werte mehr vorhanden sind.",
@@ -222,17 +237,18 @@ export const helpSections: HelpSection[] = [
{
id: "sessions-bewerten",
title: "Sessions Bewerten",
description: "Bewertungen bestimmen, ob eine Session abgerechnet wurde oder bewusst nicht abrechenbar ist.",
description: "Bewertungen bestimmen, ob eine Session offen, abrechenbar, abgerechnet oder bewusst nicht abrechenbar ist.",
quickItems: [
"Jede Session braucht genau eine Bewertung.",
"Abgerechnet und Nicht abrechenbar können durch erneuten Klick zurückgenommen werden.",
"Jede Session braucht vor dem Monatsabschluss einen finalen Status.",
"Abrechenbar, Abgerechnet und Nicht abrechenbar können durch erneuten Klick zurückgenommen werden.",
"Offene Bewertungen blockieren den Monatsabschluss."
],
details: [
"Abrechenbar bedeutet: Die Session ist als potenziell abrechenbar markiert, bleibt aber für Abschluss und offene Bewertungen noch offen.",
"Abgerechnet bedeutet: Die Session wurde für die Abrechnung beziehungsweise im CRM berücksichtigt.",
"Nicht abrechenbar bedeutet: Die Session gehört zum Arbeitsnachweis, wird aber nicht abgerechnet.",
"Ein erneuter Klick auf den aktiven Bewertungsbutton entfernt die Bewertung und macht die Session wieder offen.",
"Nicht abrechenbare Sessions zählen als bewertet. Sie blockieren den Monatsabschluss nicht.",
"Nur Abgerechnet und Nicht abrechenbar schließen die Bewertung ab. Abrechenbar blockiert den Monatsabschluss weiterhin.",
"Wenn ein Monat abgeschlossen ist, sind Bewertungen gesperrt. Öffne den Monat zuerst wieder, wenn du etwas korrigieren musst.",
"Die offenen Bewertungen findest du gebündelt im Monatsabschluss."
]
@@ -244,6 +260,7 @@ export const helpSections: HelpSection[] = [
quickItems: [
"Projekte werden über eine Ticketnummer angelegt.",
"Vorhandene Ticketdaten werden automatisch übernommen.",
"Ein Projekt kann mehrere Teamspace-Einträge haben.",
"Projekt-Sessions sind immer Consulting."
],
details: [
@@ -251,11 +268,18 @@ export const helpSections: HelpSection[] = [
"Beim Anlegen gibst du die Ticketnummer ein. Existiert das Ticket bereits, übernimmt TicketTracker Organisation und Stammdaten automatisch.",
"Existiert das Ticket noch nicht, muss eine Organisation aus der synchronisierten Organisationsliste gewählt werden.",
"Ein Projekt-Ticket bleibt ein normales Ticket. Es kann über Suche, Tickets, geöffnete Tickets und ToDos geöffnet werden.",
"Zusätzlich speicherst du Teamspace-Projekt, Beschreibung/Ziele, ungefähren Zeitraum und gesamtes Stundenkontingent.",
"Der Projektverbrauch wird nur aus gepflegten Teamspace-Tageswerten und einem optionalen manuellen Projektverbrauch berechnet. Getrackte Sessionzeiten zählen nicht in den Projektverbrauch.",
"Zusätzlich speicherst du einen oder mehrere Teamspace-Einträge, Beschreibung/Ziele, ungefähren Zeitraum und Budgets.",
"Der erste Teamspace-Eintrag ist der Standard. Er bekommt die aus Teamspace gebuchten Tageswerte und das Budget aus Zammad, solange kein Budgetschutz greift.",
"Hat ein Projekt genau einen Teamspace-Eintrag, ordnet TicketTracker Consulting-Sessions automatisch diesem Eintrag zu. Bei mehreren Einträgen muss der passende Eintrag beim Speichern oder Bearbeiten der Session gewählt werden.",
"Die Auswahl zeigt den Standard-Eintrag ausdrücklich mit Standard an, auch wenn der Eintrag eine normale Teamspace-ID hat.",
"Der Projektverbrauch wird aus gepflegten Teamspace-Tageswerten und optionalem manuellem Verbrauch je Teamspace-Eintrag berechnet. Getrackte Sessionzeiten zählen nicht in den Projektverbrauch.",
"Der manuelle Projektverbrauch ist für Altbestände oder einmalige Vorbuchungen gedacht und wirkt ausschließlich im Projektverbrauch. Er erscheint nicht in Auswertungen, Statistiken, CSV-Export oder Monatsabschluss.",
"Manuelle Änderungen am Budget setzen den Budgetschutz des betroffenen Teamspace-Eintrags automatisch. Der Haken kann im Projekt wieder entfernt werden, wenn das Budget künftig wieder aus Zammad synchronisiert werden soll.",
"Projekte können offen oder geschlossen sein. Standardmäßig zeigt die Projektseite offene Projekte; geschlossene können zusätzlich eingeblendet werden.",
"Auf der Projektseite kannst du Projekte nach Freitext, Status, Organisation, Kontingentstatus und ToDos filtern sowie nach Ticket, Titel, Organisation, Teamspace-ID, Verbrauch, Reststunden, Kontingent oder ToDos sortieren. Diese Einstellungen bleiben im Browser gespeichert.",
"Auf der Projektseite gibt es ein gemeinsames Filter-Dropdown. Filter derselben Gruppe wirken als Oder, unterschiedliche Gruppen werden kombiniert.",
"Filterbar sind unter anderem TicketTracker-Status, Zammad-Status, Zammad-Priorität, Organisation, Kontingentstatus und Nur Std.-Budget.",
"Nur Std.-Budget zeigt Projekte, bei denen ein Budget vorhanden ist und dieses ausschließlich auf dem Standard-Teamspace-Eintrag liegt.",
"In der Projektliste und im Budget-Widget werden einzelne Teamspace-Budgetzeilen nur angezeigt, wenn mehrere Teamspace-Einträge ein Budget haben. Nicht budgetierte Einträge werden dort ausgeblendet.",
"Reststunden werden aus dem Stundenkontingent minus Projektverbrauch berechnet. Gibt es kein Kontingent, kann TicketTracker keinen offenen Rest berechnen.",
"Offene Projekte stehen immer vor geschlossenen Projekten. Der Projektstatus ändert nicht die Anzeige der Sessions im Ticket.",
"Projekt-Tickets sind immer Consulting. Auch wenn Sessions später über den normalen Timer oder das Nachtragen erfasst werden, erkennt TicketTracker das Projekt und übernimmt Consulting.",
@@ -282,6 +306,7 @@ export const helpSections: HelpSection[] = [
"In der linken Navigation zeigt die Kachel Termine die festen heutigen ToDos, laufende ToDos als Summe und überfällige Aufgaben.",
"Unter der Aufgabenliste zeigt der ToDo-Kalender offene ToDos im Monatsüberblick. Erledigte ToDos werden dort ausgeblendet; Wochenenden und bayerische Feiertage bleiben ohne ToDo-Einträge.",
"Ein-Tages-ToDos werden einzeln und farblich nach Priorität angezeigt. Zeiträume, offene Von-Daten und Bis-Daten werden pro Tag nur als Summe angezeigt.",
"Wenn der Zammad-Sync entsprechend aktiviert ist, kann aus Zammad-Wartedaten automatisch ein ToDo als Erinnerung oder Abschlussprüfung erzeugt werden.",
"Bei Nur-Von läuft die Summe ab diesem Datum weiter, bis das ToDo erledigt, gelöscht oder mit einem Bis-Datum begrenzt wird. Bei Nur-Bis zählt der Kalender ab heute bis zum Bis-Datum.",
"Ein offenes ToDo ist überfällig, wenn Umsetzung bis vor heute liegt. Im Kalender bleibt es ab dem Tag nach der Deadline an jedem Arbeitstag als roter +X üf-Badge sichtbar, bis es erledigt oder gelöscht wird.",
"Ein Klick auf ein einzelnes ToDo öffnet die Bearbeitung. Eine Tagessumme öffnet eine kompakte Tagesliste; daraus kannst du ein ToDo separat öffnen, erledigen, löschen oder das Ticket öffnen.",
@@ -320,7 +345,7 @@ export const helpSections: HelpSection[] = [
"Der Monat kann wieder geöffnet werden."
],
details: [
"Ein Monat kann abgeschlossen werden, sobald alle Sessions dieses Monats bewertet sind.",
"Ein Monat kann abgeschlossen werden, sobald keine offenen Bewertungen mehr vorhanden sind.",
"Tage ohne Teamspace-Wert blockieren den Abschluss nicht automatisch. Sie sind eine Prüfliste für CRM-Abgleich und Nacharbeit.",
"Wenn eine Session bewusst nicht in Teamspace eingetragen wird, kann der fehlende Tageswert zur Kenntnis genommen werden.",
"Zur Kenntnis genommene Einträge können über die Checkbox Zur Kenntnis anzeigen wieder eingeblendet werden.",
@@ -361,12 +386,12 @@ export const helpSections: HelpSection[] = [
],
details: [
"Die Statistikseite betrachtet immer einen Monat.",
"Abgerechnet zeigt nur Sessions mit der Bewertung Abgerechnet. Offene Zeiten sind dort nicht enthalten.",
"Alle Statistik- und Vergleichswerte nutzen nur abgerechnete Zeiten.",
"Teamspace zeigt, wie viel Zeit für dieselben abrechenbaren Ticket-Tage im CRM eingetragen wurde.",
"Abgerechnet zeigt nur Sessions mit der Bewertung Abgerechnet. Abrechenbare, nicht abrechenbare und offene Zeiten sind dort nicht enthalten.",
"Teamspace-Vergleiche nutzen nur abgerechnete Zeiten.",
"Teamspace zeigt, wie viel Zeit für dieselben abgerechneten Ticket-Tage im CRM eingetragen wurde.",
"Eine positive Differenz bedeutet: In Teamspace steht mehr Zeit als abgerechnet wurde.",
"Eine negative Differenz bedeutet: In Teamspace steht weniger Zeit als abgerechnet wurde.",
"Offene Sessions werden nicht in Relationen, Graphen, Teamspace-Differenzen, Hotspots, Manuell/Fix-Werte oder Durchschnittswerte eingerechnet.",
"Abrechenbare, nicht abrechenbare und offene Sessions werden nicht in Teamspace-Differenzen, Hotspots, Manuell/Fix-Werte oder Durchschnittswerte eingerechnet.",
"Der Monatsverlauf zeigt abgerechnete Session-Zeit als Balken und Teamspace als Linie.",
"Organisationen, Typen und Ticket-Hotspots helfen dabei, Auffälligkeiten im Monat schnell zu finden."
]
@@ -374,7 +399,7 @@ export const helpSections: HelpSection[] = [
{
id: "statistik-getrackt",
title: "Statistik: Abgerechnet",
description: "Diese Kennzahl zeigt die abrechenbare Session-Zeit im gewählten Monat.",
description: "Diese Kennzahl zeigt die abgerechnete Session-Zeit im gewählten Monat.",
quickItems: [
"Summe aller Sessions mit Bewertung Abgerechnet.",
"Zeigt zusätzlich die abgerechnete Sessionanzahl.",
@@ -382,7 +407,7 @@ export const helpSections: HelpSection[] = [
],
details: [
"Abgerechnet umfasst nur Sessions des angemeldeten Benutzers, die aktiv als Abgerechnet markiert wurden.",
"Offene Sessions werden aus diesem Wert herausgehalten.",
"Abrechenbare, nicht abrechenbare und offene Sessions werden aus diesem Wert herausgehalten.",
"Auch automatisch erzeugte Sessions aus fixen Abrechnungen zählen hier mit, sobald sie als Abgerechnet markiert wurden.",
"Es werden keine offenen Zeiten in diesen Wert eingerechnet.",
"Dieser Wert ist die Ausgangsbasis für Teamspace-Differenzen: Teamspace minus abgerechnete Session-Zeit ergibt die Differenz."
@@ -402,7 +427,7 @@ export const helpSections: HelpSection[] = [
"Die Statistik summiert alle Teamspace-Werte des Monats für den angemeldeten Benutzer.",
"Eine positive Differenz bedeutet, dass in Teamspace mehr Zeit steht als abgerechnet wurde.",
"Eine negative Differenz bedeutet, dass in Teamspace weniger Zeit steht als abgerechnet wurde.",
"Offene Sessions fließen nicht in diese Differenz ein.",
"Abrechenbare, nicht abrechenbare und offene Sessions fließen nicht in diese Differenz ein.",
"Fehlende Teamspace-Werte können im Monatsabschluss geprüft und bei Bedarf zur Kenntnis genommen werden."
]
},
@@ -416,9 +441,9 @@ export const helpSections: HelpSection[] = [
"Die Klärung erfolgt in der Ticketdetailansicht."
],
details: [
"Offen umfasst alle Sessions des Monats ohne Bewertung.",
"Diese Sessions müssen vor dem Monatsabschluss bewertet werden.",
"Die offene Zeit zeigt, wie viele Minuten noch bewertet werden müssen.",
"Offen umfasst alle Sessions des Monats ohne finalen Status sowie Sessions mit dem Zwischenstatus Abrechenbar.",
"Diese Sessions müssen vor dem Monatsabschluss auf Abgerechnet oder Nicht abrechenbar gesetzt werden.",
"Die offene Zeit zeigt, wie viele Minuten noch final bewertet werden müssen.",
"Der Monatsabschluss listet offene Bewertungen gruppiert nach Ticket, damit du direkt in die passende Ticketdetailansicht springen kannst.",
"Wird eine Bewertung zurückgenommen, steigt die offene Anzahl wieder."
]
@@ -436,7 +461,7 @@ export const helpSections: HelpSection[] = [
"Der Monatsverlauf zeigt jeden Tag des Monats. Tage ohne Sessions bleiben leer, damit die Monatsstruktur sichtbar bleibt.",
"Die blauen Balken stehen für abgerechnete Session-Zeit.",
"Die fuchsiafarbene Linie steht für Teamspace-Zeit, sofern für den Tag Werte gepflegt wurden.",
"Der Bewertungsstand weist Abgerechnet und Offen getrennt aus.",
"Der Bewertungsstand weist Abgerechnet, Abrechenbar, Nicht abrechenbar und Offen getrennt aus.",
"Der Teamspace-Abgleich zeigt die Gesamtdifferenz zwischen CRM-Werten und abgerechneter Session-Zeit.",
"Manuell und Fix trennen selbst erfasste abrechenbare Sessions von automatisch erzeugten abrechenbaren Sessions aus fixen Abrechnungen."
]
@@ -473,7 +498,7 @@ export const helpSections: HelpSection[] = [
"Support und Consulting werden getrennt summiert.",
"Die Zeitwerte zeigen abgerechnete Sessions und Teamspace für den jeweiligen Typ.",
"Die Differenz folgt derselben Logik wie überall: Teamspace minus abgerechnete Session-Zeit.",
"Die Zeile Abr. und Offen zeigt, wie viele Sessions dieses Typs bereits abgerechnet oder noch offen sind."
"Die Zeile Abr., Abrechenbar, Nicht abrechenbar und Offen zeigt, wie viele Sessions dieses Typs bereits abgerechnet, als abrechenbar markiert, bewusst nicht abrechenbar oder noch offen sind."
]
},
{
@@ -512,7 +537,12 @@ export const helpSections: HelpSection[] = [
"Beim Speichern eines neuen Tokens fragt TicketTracker Zammad über /api/v1/users/me ab und speichert die zurückgelieferte Zammad User-ID.",
"Die gespeicherte Zammad User-ID wird danach read-only im Profil angezeigt.",
"Die Token-Prüfung läuft nur, wenn der Token im Profil geändert oder entfernt wird. Normale Profiländerungen prüfen Zammad nicht erneut.",
"Der persönliche Zammad Token ist vom Admin-Token für den Organisations-Sync getrennt. Es kann zufällig derselbe Token sein, wird aber separat gespeichert und verwendet.",
"Der persönliche Zammad Token ist vom Admin-Token für den Organisations-Sync getrennt. Er wird für ticketbezogene Zammad-Abgleiche, Consulting-Importe und die Zuordnung zum Zammad-Owner verwendet.",
"Die Bewertungsabfrage beim Timerabschluss kann im Profil ein- oder ausgeschaltet werden. Sie erscheint nur, wenn der Timer noch auf --- steht.",
"Die interne Zammad-Notiz beim Timerabschluss steuert, ob die Checkbox im Abschlussdialog standardmäßig aktiv ist. Nur dann werden Standard-Typ und Zeitaufrundung angezeigt.",
"Der Standard-Typ belegt die Zammad-Zeitbuchungskategorie für interne Notizen vor. Es gibt keine leere Auswahl; ohne gespeicherten Profilwert wird Nicht kategorisiert verwendet.",
"Für die an Zammad gesendete time_unit kann optional eine Aufrundung auf 5, 10, 15 oder 30 Minuten aktiviert werden. Ohne Rundung wird die konkrete Zeit mit zwei Nachkommastellen gesendet.",
"Geparkte Zammad-Notizen listet interne Notizen, die wegen eines Zammad-Fehlers noch nicht übertragen wurden. Über Senden werden sie gesammelt nach Zammad gepusht.",
"Im Admin-Profil wird kein persönlicher Zammad-Token angezeigt.",
"Admins können Benutzer ebenfalls verwalten, aber jeder Benutzer kann die eigenen Daten jederzeit selbst pflegen."
]
@@ -531,6 +561,10 @@ export const helpSections: HelpSection[] = [
"Admins können bestehende Benutzer bearbeiten, Passwörter setzen und Benutzer deaktivieren.",
"Der feste Admin-Zugang kann nicht deaktiviert oder zur normalen User-Rolle herabgestuft werden.",
"Der Data-Sync speichert Zammad-Zugangsdaten und synchronisiert Organisationen in die lokale Datenbank.",
"Der Zammad-Ticket-Sync aktualisiert Titel, Organisation, Typ, Zammad-Status, Zammad-Priorität sowie Teamspace-Projekte und Budgets je nach gewählter Option.",
"Zammad-Projektwerte können mehrere Teamspace-IDs enthalten. TicketTracker erkennt zusammenhängende IDs und legt entsprechend mehrere Teamspace-Einträge an.",
"Beim Budget-Sync bleiben geschützte TicketTracker-Budgets unverändert. Die Option Budget-Schutz im Sync ignorieren überschreibt auch geschützte Budgets mit Zammad-Werten.",
"Optional kann der Ticket-Sync bei Zammad-Status Wartend oder Abschluss und vorhandenem Wartedatum ein hoch priorisiertes ToDo für dieses Datum erzeugen.",
"Der Datenbankexport erzeugt eine SQL-Datei mit Benutzern, Einstellungen, Organisationen, Tickets, Sessions, Teamspace-Werten, fixen Abrechnungen und Abschlüssen.",
"Der Restore im Adminbereich prüft zuerst, ob die Dump-Struktur zur aktuellen Datenbank passt.",
"Der Restore-Button wird erst nach erfolgreicher Prüfung aktiv.",
+97
View File
@@ -0,0 +1,97 @@
Datensatz aus api/v1/ticket_articles/
{
"id": 2,
"ticket_id": 2,
"type_id": 1,
"sender_id": 1,
"from": "",
"to": "",
"cc": null,
"subject": "Test Bestellung",
"reply_to": null,
"message_id": "",
"message_id_md5": "",
"in_reply_to": null,
"content_type": "text/html",
"body": "",
"internal": false,
"preferences": {
"send-auto-response": true,
"is-auto-response": false
},
"updated_by_id": 3,
"created_by_id": 3,
"origin_by_id": null,
"created_at": "2023-01-06T11:17:03.919Z",
"updated_at": "2023-01-06T11:17:03.919Z",
"detected_language": null,
"ai_stored_result_ids": [],
"attachments": [
{
"id": 3,
"store_file_id": 3,
"filename": "message.html",
"size": "5733",
"preferences": {
"content-alternative": true,
"original-format": true,
"Mime-Type": "text/html",
"Charset": "utf-8"
}
}
],
"body_rendering_error": false
}
Datensatz aus api/v1/ticket_articles/{id]}
{
"id": 2,
"ticket_id": 2,
"type_id": 1,
"sender_id": 1,
"from": "",
"to": "",
"cc": null,
"subject": "",
"reply_to": null,
"message_id": "",
"message_id_md5": "a9cc698b80f75fe08ca6d2dc6dec69ae",
"in_reply_to": null,
"content_type": "text/html",
"body": "",
"internal": false,
"preferences": {
"send-auto-response": true,
"is-auto-response": false
},
"updated_by_id": 3,
"created_by_id": 3,
"origin_by_id": null,
"created_at": "2023-01-06T11:17:03.919Z",
"updated_at": "2023-01-06T11:17:03.919Z",
"detected_language": null,
"ai_stored_result_ids": [],
"attachments": [
{
"id": 3,
"store_file_id": 3,
"filename": "message.html",
"size": "5733",
"preferences": {
"content-alternative": true,
"original-format": true,
"Mime-Type": "text/html",
"Charset": "utf-8"
}
}
],
"body_rendering_error": false,
"created_by": "",
"updated_by": "",
"type": "email",
"sender": "Agent",
"ai_stored_results": [],
"time_unit": null
}
+100 -6
View File
@@ -1,3 +1,5 @@
import type { BillingStatus } from "./types";
export type TimerPhase = "running" | "paused";
export type TimerEntry = {
@@ -8,6 +10,9 @@ export type TimerEntry = {
isProject?: boolean;
projectName?: string | null;
ticketLookupDone?: boolean;
activity: string;
zammadArticleBody?: string;
billingStatus: BillingStatus;
startedAt: number;
pausedTotalMs: number;
pausedAt: number | null;
@@ -16,9 +21,18 @@ export type TimerEntry = {
const storageKeyPrefix = "tickettracker.timers";
const legacyStorageKey = "tickettracker.activeTimer";
const activityDraftStorageKeyPrefix = "tickettracker.timerActivityDrafts";
export const ticketPattern = /^Ticket#\d{6}$/;
export function createClientId(prefix = "client") {
if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
return crypto.randomUUID();
}
return `${prefix}-${Date.now()}-${Math.random().toString(16).slice(2)}`;
}
export function pauseEntry(timer: TimerEntry, now = Date.now()): TimerEntry {
if (timer.phase === "paused") {
return timer;
@@ -51,23 +65,30 @@ export function normalizeTimers(timers: TimerEntry[]) {
return timers
.filter((timer) => ticketPattern.test(timer.ticketNumber))
.map((timer) => {
const normalizedTimer = {
...timer,
activity: typeof timer.activity === "string" ? timer.activity : "",
zammadArticleBody: typeof timer.zammadArticleBody === "string" ? timer.zammadArticleBody : "",
billingStatus: timer.billingStatus === "billed" ? "billable" : timer.billingStatus === "billable" || timer.billingStatus === "non_billable" ? timer.billingStatus : null,
};
if (timer.phase !== "running") {
return {
...timer,
...normalizedTimer,
phase: "paused" as const,
pausedAt: timer.pausedAt ?? now,
pausedAt: normalizedTimer.pausedAt ?? now,
};
}
if (!runningSeen) {
runningSeen = true;
return {
...timer,
...normalizedTimer,
pausedAt: null,
};
}
return pauseEntry(timer, now);
return pauseEntry(normalizedTimer, now);
});
}
@@ -75,6 +96,77 @@ export function storageKeyForUser(userId: string) {
return `${storageKeyPrefix}.${userId}`;
}
function activityDraftStorageKeyForUser(userId: string) {
return `${activityDraftStorageKeyPrefix}.${userId}`;
}
type TimerActivityDraft = {
activity: string;
zammadArticleBody: string;
updatedAt: number;
};
function readTimerActivityDraftMap(userId: string) {
if (typeof window === "undefined") {
return {} as Record<string, TimerActivityDraft>;
}
const raw = sessionStorage.getItem(activityDraftStorageKeyForUser(userId));
if (!raw) {
return {} as Record<string, TimerActivityDraft>;
}
try {
const parsed = JSON.parse(raw) as Record<string, TimerActivityDraft>;
return Object.fromEntries(
Object.entries(parsed).filter(([, draft]) =>
typeof draft.activity === "string" &&
typeof draft.zammadArticleBody === "string" &&
typeof draft.updatedAt === "number"
)
);
} catch {
return {} as Record<string, TimerActivityDraft>;
}
}
function writeTimerActivityDraftMap(userId: string, drafts: Record<string, TimerActivityDraft>) {
if (typeof window === "undefined") {
return;
}
sessionStorage.setItem(activityDraftStorageKeyForUser(userId), JSON.stringify(drafts));
}
export function writeTimerActivityDraft(userId: string, timerId: string, draft: Omit<TimerActivityDraft, "updatedAt">) {
const drafts = readTimerActivityDraftMap(userId);
drafts[timerId] = { ...draft, updatedAt: Date.now() };
writeTimerActivityDraftMap(userId, drafts);
}
export function removeTimerActivityDraft(userId: string, timerId: string) {
const drafts = readTimerActivityDraftMap(userId);
delete drafts[timerId];
writeTimerActivityDraftMap(userId, drafts);
}
export function mergeTimerActivityDrafts(userId: string, timers: TimerEntry[]) {
const drafts = readTimerActivityDraftMap(userId);
const timerIds = new Set(timers.map((timer) => timer.id));
const keptDrafts = Object.fromEntries(Object.entries(drafts).filter(([timerId]) => timerIds.has(timerId)));
if (Object.keys(keptDrafts).length !== Object.keys(drafts).length) {
writeTimerActivityDraftMap(userId, keptDrafts);
}
return timers.map((timer) => {
const draft = keptDrafts[timer.id];
return draft ? { ...timer, activity: draft.activity, zammadArticleBody: draft.zammadArticleBody } : timer;
});
}
export function readStoredTimers(userId: string): TimerEntry[] {
if (typeof window === "undefined") {
return [];
@@ -98,13 +190,15 @@ export function readStoredTimers(userId: string): TimerEntry[] {
}
try {
const parsed = JSON.parse(legacy) as Omit<TimerEntry, "id">;
const parsed = JSON.parse(legacy) as Omit<TimerEntry, "id" | "activity" | "billingStatus"> & { activity?: string; billingStatus?: BillingStatus };
localStorage.removeItem(legacyStorageKey);
return normalizeTimers([
{
...parsed,
id: crypto.randomUUID(),
id: createClientId("timer"),
activity: typeof parsed.activity === "string" ? parsed.activity : "",
billingStatus: parsed.billingStatus === "billed" ? "billable" : parsed.billingStatus === "billable" || parsed.billingStatus === "non_billable" ? parsed.billingStatus : null,
},
]);
} catch {
+165 -4
View File
@@ -1,5 +1,5 @@
export type WorkType = "support" | "consulting";
export type BillingStatus = "billed" | "non_billable" | null;
export type BillingStatus = "billable" | "billed" | "non_billable" | null;
export type PeriodType = "month" | "day";
export type TicketDetailPeriodType = PeriodType | "all";
export type UserRole = "admin" | "user";
@@ -12,9 +12,24 @@ export type AuthUser = {
active: boolean;
zammad_user_id: string | null;
has_zammad_api_token: boolean;
teamspace_user_id: string | null;
has_teamspace_credentials: boolean;
zammad_email_session_webhook_enabled: boolean;
session_billing_prompt_enabled: boolean;
teamspace_time_tracking_enabled: boolean;
zammad_session_note_default_enabled: boolean;
zammad_time_unit_rounding_enabled: boolean;
zammad_time_unit_rounding_minutes: number;
zammad_atoss_email_sync_enabled: boolean;
zammad_article_type_id: number;
project_followup_enabled: boolean;
project_followup_weeks: number;
project_followup_second_enabled: boolean;
project_followup_second_weeks: number;
project_followup_complete_on_session: boolean;
};
export type DashboardWidgetType = "today" | "month" | "openRatings" | "projectBudgets" | "todos" | "teamspace" | "favorites" | "divider" | "statistic" | "notes";
export type DashboardWidgetType = "dayControl" | "today" | "month" | "openRatings" | "projectBudgets" | "todos" | "teamspace" | "favorites" | "divider" | "statistic" | "notes";
export type DashboardSortDirection = "asc" | "desc";
export type DashboardFavorite = {
@@ -40,11 +55,45 @@ export type DashboardPreference = {
favorites: DashboardFavorite[];
};
export type DashboardDayTicket = {
ticket_id: string;
ticket_number: string;
title: string | null;
organization_name: string | null;
work_type: WorkType | null;
zammad_priority_id: string | null;
zammad_state_id: string | null;
zammad_pending_time: string | null;
latest_started_at: string | null;
has_project: boolean;
own_session_count: number;
open_session_count: number;
open_todo_count: number;
due_todo_count: number;
};
export type AdminUser = AuthUser & {
created_at: string;
updated_at: string;
};
export type ZammadSessionArticleQueueItem = {
id: string;
session_id: string;
ticket_id: string;
ticket_number: string;
zammad_ticket_id: string | null;
activity: string;
time_unit: number;
zammad_article_type_id: number;
attempt_count: number;
last_error: string | null;
last_attempt_at: string | null;
created_at: string;
started_at: string;
rounded_minutes: number;
};
export type Organization = {
id: string;
zammad_id: string;
@@ -94,6 +143,11 @@ export type TicketMeta = {
zammad_priority_id?: string | null;
zammad_state_id?: string | null;
zammad_owner_id?: string | null;
zammad_owner_user_id?: string | null;
zammad_owner_display_name?: string | null;
zammad_owner_username?: string | null;
is_foreign_zammad_owner?: boolean;
can_edit_ticket_data?: boolean;
project_id?: string | null;
is_project?: boolean;
project_name?: string | null;
@@ -136,6 +190,14 @@ export type ProjectSummary = {
organization_name: string | null;
customer_name: string | null;
work_type: WorkType | null;
zammad_priority_id?: string | null;
zammad_state_id?: string | null;
zammad_ticket_id?: string | null;
zammad_owner_id?: string | null;
ticket_zammad_owner_id?: string | null;
zammad_pending_time?: string | null;
zammad_merged_from_ticket_id?: string | null;
zammad_merged_from_ticket_number?: string | null;
teamspace_project: string | null;
description: string;
goals: string;
@@ -159,20 +221,49 @@ export type ProjectSummary = {
teamspace_entry_count?: number;
teamspace_entries?: ProjectTeamspaceEntry[];
unassigned_teamspace_session_count?: number;
unassigned_teamspace_subentry_count?: number;
close_review_required?: boolean;
hidden_for_user?: boolean;
};
export type ProjectTeamspaceEntry = {
id: string;
project_id?: string;
teamspace_project: string | null;
teamspace_api_project_id?: string | null;
teamspace_api_project_url?: string | null;
teamspace_description?: string | null;
subentries?: ProjectTeamspaceSubentry[];
is_default: boolean;
hour_budget_minutes: number | null;
budget_sync_disabled?: boolean;
manual_consumption_minutes: number;
teamspace_consumption_minutes?: number;
consumption_minutes?: number;
display_order?: number;
};
export type ProjectTeamspaceSubentry = {
id: string;
project_teamspace_entry_id?: string;
teamspace_api_project_id: string;
teamspace_api_project_url: string | null;
teamspace_project_id: string | null;
billing_type: string | null;
name: string | null;
alias: string;
description: string;
progress: number | null;
planned_minutes: number | null;
sum_minutes: number | null;
planned_minutes_billable: number | null;
sum_minutes_billable: number | null;
planned_income: number | string | null;
sum_income: number | string | null;
consumption_minutes?: number;
display_order: number;
};
export type TodoPriority = "low" | "medium" | "high" | "urgent";
export type TodoStatus = "open" | "done";
@@ -206,10 +297,13 @@ export type TicketSummary = {
project_id: string | null;
session_count: number;
total_minutes: number;
crm_billed_minutes: number;
billable_minutes: number;
non_billable_minutes: number;
open_minutes: number;
open_count: number;
ticket_open_count: number;
billable_count: number;
billed_count: number;
non_billable_count: number;
recurring_session_count: number;
@@ -252,6 +346,7 @@ export type PeriodOverview = {
sessions: number;
minutes: number;
crmBilledMinutes: number;
billableMinutes: number;
nonBillableMinutes: number;
openMinutes: number;
openSessions: number;
@@ -263,6 +358,7 @@ export type PeriodOverview = {
export type TicketDayBilling = {
day: string;
project_teamspace_entry_id?: string | null;
billed_minutes: number;
};
@@ -277,6 +373,7 @@ export type SessionEntry = {
organization_name: string | null;
customer_name: string;
activity: string;
zammad_article_body?: string | null;
work_type: WorkType;
project_teamspace_entry_id?: string | null;
project_teamspace_project?: string | null;
@@ -290,6 +387,10 @@ export type SessionEntry = {
recurring_billing_id: string | null;
recurring_billing_slot_id: string | null;
recurring_occurrence_date: string | null;
zammad_source_article_id?: string | null;
zammad_article_status?: "pending" | "sent" | null;
zammad_article_id?: string | null;
zammad_article_type_id?: number;
};
export type TicketPeriod = {
@@ -299,7 +400,7 @@ export type TicketPeriod = {
closedAt: string | null;
filters?: {
month: string;
status: "all" | "open" | "billed" | "non_billable";
status: "all" | "open" | "billable" | "billed" | "non_billable";
source: "all" | "manual" | "recurring";
};
availableMonths?: TicketAvailableMonth[];
@@ -311,6 +412,16 @@ export type TicketPeriod = {
organization_name: string | null;
customer_name: string | null;
work_type: WorkType | null;
zammad_ticket_id?: string | null;
zammad_group_id?: string | null;
zammad_priority_id?: string | null;
zammad_state_id?: string | null;
zammad_owner_id?: string | null;
zammad_owner_user_id?: string | null;
zammad_owner_display_name?: string | null;
zammad_owner_username?: string | null;
is_foreign_zammad_owner?: boolean;
can_edit_ticket_data?: boolean;
closed_at: string | null;
requires_closure: boolean;
recurring_session_count: number;
@@ -334,9 +445,11 @@ export type StatisticsDailyBucket = {
sessions: number;
total_minutes: number;
billed_minutes: number;
billable_minutes: number;
non_billable_minutes: number;
open_minutes: number;
billed_sessions: number;
billable_sessions: number;
non_billable_sessions: number;
open_sessions: number;
crm_billed_minutes: number;
@@ -350,9 +463,11 @@ export type StatisticsGroup = {
sessions: number;
total_minutes: number;
billed_minutes: number;
billable_minutes: number;
non_billable_minutes: number;
open_minutes: number;
billed_sessions: number;
billable_sessions: number;
non_billable_sessions: number;
open_sessions: number;
crm_billed_minutes: number;
@@ -368,9 +483,11 @@ export type StatisticsTicket = {
sessions: number;
total_minutes: number;
billed_minutes: number;
billable_minutes: number;
non_billable_minutes: number;
open_minutes: number;
billed_sessions: number;
billable_sessions: number;
non_billable_sessions: number;
open_sessions: number;
crm_billed_minutes: number;
@@ -399,8 +516,49 @@ export type StatisticsCrmDay = {
acknowledged_at?: string | null;
};
export type StatisticsTeamspaceDay = {
ticket_id: string;
ticket_number: string;
organization_name: string;
day: string;
tracked_minutes: number;
crm_billed_minutes: number;
delta_minutes: number;
session_count: number;
project_teamspace_project: string | null;
};
export type StatisticsProjectFollowup = {
project_id: string;
ticket_id: string;
ticket_number: string;
title: string | null;
organization_name: string | null;
teamspace_project: string | null;
hour_budget_minutes: number | null;
consumption_minutes: number;
remaining_minutes: number | null;
latest_tt_update: string;
last_session_at: string | null;
project_updated_at: string;
open_followup_todo_id: string | null;
followup_state: "open" | "done" | "dismissed" | null;
open_todos: number;
overdue_todos: number;
};
export type StatisticsProjectFollowupOverview = {
enabled: boolean;
weeks: number;
secondEnabled: boolean;
secondWeeks: number;
createdTodos: number;
updatedTodos: number;
projects: StatisticsProjectFollowup[];
};
export type StatisticsOverview = {
periodType: "month";
periodType: "month" | "week";
period: string;
closed: boolean;
closedAt: string | null;
@@ -409,9 +567,11 @@ export type StatisticsOverview = {
sessions: number;
minutes: number;
billedMinutes: number;
billableMinutes: number;
nonBillableMinutes: number;
openMinutes: number;
billedSessions: number;
billableSessions: number;
nonBillableSessions: number;
openSessions: number;
recurringMinutes: number;
@@ -433,4 +593,5 @@ export type StatisticsOverview = {
acknowledgedMissingCrmDays: StatisticsCrmDay[];
crmMismatches: StatisticsCrmDay[];
};
teamspaceDays: StatisticsTeamspaceDay[];
};
+48 -2
View File
@@ -1,5 +1,5 @@
import { ChangeEvent, FormEvent, useEffect, useState } from "react";
import { CheckCircle2, DatabaseBackup, DatabaseZap, Save, Shield, Upload, UserPlus } from "lucide-react";
import { CheckCircle2, DatabaseBackup, DatabaseZap, Save, Shield, Unplug, Upload, UserPlus } from "lucide-react";
import { toast } from "sonner";
import { Alert, AlertDescription, AlertTitle } from "@/components/ui/alert";
@@ -14,9 +14,11 @@ import {
createAdminUser,
downloadDatabaseExport,
getAdminUsers,
getTeamspaceSettings,
getZammadSettings,
restoreDatabaseBackup,
saveZammadSettings,
saveTeamspaceSettings,
syncZammadOrganizations,
updateAdminUser,
validateDatabaseBackup,
@@ -54,8 +56,10 @@ export function AdminUsersPage({ currentUser }: { currentUser: AuthUser }) {
const [zammadBaseUrl, setZammadBaseUrl] = useState("");
const [zammadApiKey, setZammadApiKey] = useState("");
const [hasZammadApiKey, setHasZammadApiKey] = useState(false);
const [teamspaceBaseUrl, setTeamspaceBaseUrl] = useState("");
const [syncingOrganizations, setSyncingOrganizations] = useState(false);
const [savingZammadSettings, setSavingZammadSettings] = useState(false);
const [savingTeamspaceSettings, setSavingTeamspaceSettings] = useState(false);
const [exportingDatabase, setExportingDatabase] = useState(false);
const [restoreSql, setRestoreSql] = useState("");
const [restoreValidation, setRestoreValidation] = useState<RestoreValidationResult | null>(null);
@@ -68,12 +72,13 @@ export function AdminUsersPage({ currentUser }: { currentUser: AuthUser }) {
async function load(options: { preserveEdits?: boolean } = {}) {
setLoading(true);
try {
const [usersResult, zammadSettingsResult] = await Promise.all([getAdminUsers(), getZammadSettings()]);
const [usersResult, zammadSettingsResult, teamspaceSettingsResult] = await Promise.all([getAdminUsers(), getZammadSettings(), getTeamspaceSettings()]);
setUsers(usersResult.users);
if (!options.preserveEdits) {
setZammadBaseUrl(zammadSettingsResult.settings.baseUrl);
setHasZammadApiKey(zammadSettingsResult.settings.hasApiKey);
setTeamspaceBaseUrl(teamspaceSettingsResult.settings.baseUrl);
}
setForms((current) =>
@@ -212,6 +217,26 @@ export function AdminUsersPage({ currentUser }: { currentUser: AuthUser }) {
}
}
async function saveTeamspaceAccess() {
setSavingTeamspaceSettings(true);
try {
const result = await saveTeamspaceSettings({
baseUrl: teamspaceBaseUrl
});
setTeamspaceBaseUrl(result.settings.baseUrl);
toast.success("Teamspace-Zugang gespeichert", {
description: "URL ist hinterlegt."
});
} catch (error) {
toast.error("Teamspace-Zugang konnte nicht gespeichert werden", {
description: error instanceof Error ? error.message : "Unbekannter Fehler"
});
} finally {
setSavingTeamspaceSettings(false);
}
}
async function exportDatabase() {
setExportingDatabase(true);
@@ -370,6 +395,27 @@ export function AdminUsersPage({ currentUser }: { currentUser: AuthUser }) {
</Button>
</div>
</form>
<div className="mt-4 border-t pt-4">
<div className="mb-3 flex items-center gap-2">
<Unplug className="size-4 text-muted-foreground" />
<p className="text-sm font-medium">Teamspace API</p>
</div>
<div className="grid gap-3 xl:grid-cols-[minmax(220px,1fr)_auto] xl:items-end">
<div className="space-y-2">
<label className="text-sm font-medium" htmlFor="teamspace-base-url">Teamspace URL</label>
<Input
id="teamspace-base-url"
placeholder="https://app1.teamspace.de"
value={teamspaceBaseUrl}
onChange={(event) => setTeamspaceBaseUrl(event.currentTarget.value)}
/>
</div>
<Button type="button" variant="secondary" disabled={savingTeamspaceSettings} onClick={() => void saveTeamspaceAccess()}>
<Save className="size-4" />
{savingTeamspaceSettings ? "Speichert..." : "URL speichern"}
</Button>
</div>
</div>
</CardContent>
</Card>
+260 -168
View File
@@ -1,4 +1,4 @@
import { ChevronLeft, ChevronRight, Clock3, Download, ExternalLink, RotateCcw, SlidersHorizontal, Ticket, UserCheck, Users } from "lucide-react";
import { ArrowDown, ArrowUp, ChevronLeft, ChevronRight, Clock3, Download, ExternalLink, RotateCcw, SlidersHorizontal, Ticket, UserCheck, Users } from "lucide-react";
import type { LucideIcon } from "lucide-react";
import { Fragment, useEffect, useMemo, useRef, useState } from "react";
import { toast } from "sonner";
@@ -11,28 +11,28 @@ import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table";
import { CopyTicketButton } from "@/components/CopyTicketButton";
import { HelpLink } from "@/components/HelpLink";
import { MultiFilterDropdown, type MultiFilterOption } from "@/components/MultiFilterDropdown";
import { downloadMonthExport, getPeriodOverview } from "../api";
import { currentDay, currentMonth, formatDateTime, formatMinutes } from "../format";
import type { PeriodOverview, PeriodType, TicketSummary } from "../types";
import type { AuthUser, PeriodOverview, PeriodType, TicketSummary } from "../types";
type AnalysisPageProps = {
currentUser: AuthUser;
onNavigate: (to: string) => void;
};
type TicketGroupBy = "none" | "workType" | "organization" | "status";
type TicketSortBy = "ticket" | "workType" | "organization" | "status";
type TicketSortDirection = "asc" | "desc";
type TicketStatusFilter = "all" | "open" | "evaluated";
type TicketWorkTypeFilter = "all" | "support" | "consulting";
type TicketFilterOption = MultiFilterOption;
type AnalysisTicketViewSettings = {
groupBy: TicketGroupBy;
sortBy: TicketSortBy;
sortDirection: TicketSortDirection;
query: string;
workType: TicketWorkTypeFilter;
organization: string;
status: TicketStatusFilter;
filterValues: string[];
organizationValues: string[];
};
type TicketSection = {
@@ -51,11 +51,19 @@ const defaultTicketViewSettings: AnalysisTicketViewSettings = {
sortBy: "ticket",
sortDirection: "asc",
query: "",
workType: "all",
organization: "all",
status: "all"
filterValues: [],
organizationValues: []
};
const ticketStaticFilterOptions: TicketFilterOption[] = [
{ value: "workType:support", label: "Support" },
{ value: "workType:consulting", label: "Consulting" },
{ value: "status:open", label: "Offen" },
{ value: "status:evaluated", label: "Bewertet" }
];
const ticketStaticFilterValues = new Set(ticketStaticFilterOptions.map((option) => option.value));
const groupByOptions: Array<{ value: TicketGroupBy; label: string }> = [
{ value: "none", label: "Keine" },
{ value: "workType", label: "Typ" },
@@ -70,6 +78,56 @@ const sortByOptions: Array<{ value: TicketSortBy; label: string }> = [
{ value: "status", label: "Status" }
];
function isKnownTicketFilterValue(value: unknown): value is string {
if (typeof value !== "string") {
return false;
}
return ticketStaticFilterValues.has(value);
}
function normalizedTicketFilterValues(values: unknown) {
if (!Array.isArray(values)) {
return defaultTicketViewSettings.filterValues;
}
return Array.from(new Set(values.filter(isKnownTicketFilterValue)));
}
function normalizedTicketOrganizationValues(values: unknown) {
if (!Array.isArray(values)) {
return defaultTicketViewSettings.organizationValues;
}
return Array.from(new Set(values.filter((value): value is string => typeof value === "string" && value.trim() !== "")));
}
function legacyTicketFilterValues(parsed: Partial<AnalysisTicketViewSettings> & Record<string, unknown>) {
const filters: string[] = [];
if (parsed.workType === "support" || parsed.workType === "consulting") {
filters.push(`workType:${parsed.workType}`);
}
if (parsed.status === "open" || parsed.status === "evaluated") {
filters.push(`status:${parsed.status}`);
}
return filters;
}
function legacyTicketOrganizationValues(parsed: Partial<AnalysisTicketViewSettings> & Record<string, unknown>) {
if (Array.isArray(parsed.organizationValues)) {
return normalizedTicketOrganizationValues(parsed.organizationValues);
}
if (typeof parsed.organization === "string" && parsed.organization !== "all") {
return [parsed.organization];
}
return defaultTicketViewSettings.organizationValues;
}
function readStoredTicketViewSettings(): AnalysisTicketViewSettings {
if (typeof window === "undefined") {
return defaultTicketViewSettings;
@@ -83,15 +141,17 @@ function readStoredTicketViewSettings(): AnalysisTicketViewSettings {
}
const parsed = JSON.parse(raw) as Partial<AnalysisTicketViewSettings>;
const filterValues = Array.isArray(parsed.filterValues)
? normalizedTicketFilterValues(parsed.filterValues)
: legacyTicketFilterValues(parsed as Partial<AnalysisTicketViewSettings> & Record<string, unknown>);
return {
groupBy: groupByOptions.find((option) => option.value === parsed.groupBy)?.value ?? defaultTicketViewSettings.groupBy,
sortBy: sortByOptions.find((option) => option.value === parsed.sortBy)?.value ?? defaultTicketViewSettings.sortBy,
sortDirection: parsed.sortDirection === "desc" ? "desc" : defaultTicketViewSettings.sortDirection,
query: typeof parsed.query === "string" ? parsed.query : defaultTicketViewSettings.query,
workType: parsed.workType === "support" || parsed.workType === "consulting" ? parsed.workType : defaultTicketViewSettings.workType,
organization: typeof parsed.organization === "string" ? parsed.organization : defaultTicketViewSettings.organization,
status: parsed.status === "open" || parsed.status === "evaluated" ? parsed.status : defaultTicketViewSettings.status
filterValues,
organizationValues: legacyTicketOrganizationValues(parsed as Partial<AnalysisTicketViewSettings> & Record<string, unknown>)
};
} catch {
return defaultTicketViewSettings;
@@ -136,6 +196,57 @@ function organizationKey(ticket: TicketSummary) {
return ticket.organization_id ? `id:${ticket.organization_id}` : `name:${organizationLabel(ticket)}`;
}
function groupedTicketFilterMatch(filters: string[], groupForFilter: (filter: string) => string, matchesFilter: (filter: string) => boolean) {
if (filters.length === 0) {
return true;
}
const groups = new Map<string, string[]>();
for (const filter of filters) {
const group = groupForFilter(filter);
groups.set(group, [...(groups.get(group) ?? []), filter]);
}
return Array.from(groups.values()).every((groupFilters) => groupFilters.some((filter) => matchesFilter(filter)));
}
function ticketFilterGroup(filter: string) {
if (filter.startsWith("workType:")) {
return "workType";
}
if (filter.startsWith("status:")) {
return "status";
}
return "misc";
}
function matchesSingleTicketFilter(ticket: TicketSummary, filter: string) {
if (filter.startsWith("workType:")) {
const workType = filter.slice("workType:".length);
return ticket.work_type === workType;
}
if (filter.startsWith("status:")) {
const status = filter.slice("status:".length);
return ticketStatusKey(ticket) === status;
}
return true;
}
function matchesTicketFilters(ticket: TicketSummary, filters: string[], organizationValues: string[]) {
if (organizationValues.length > 0 && !organizationValues.includes(organizationKey(ticket))) {
return false;
}
return groupedTicketFilterMatch(filters, ticketFilterGroup, (filter) => matchesSingleTicketFilter(ticket, filter));
}
function compareText(left: string, right: string) {
return left.localeCompare(right, "de", { numeric: true, sensitivity: "base" });
}
@@ -217,7 +328,7 @@ function groupTicketSections(tickets: TicketSummary[], groupBy: TicketGroupBy):
});
}
export function AnalysisPage({ onNavigate }: AnalysisPageProps) {
export function AnalysisPage({ currentUser, onNavigate }: AnalysisPageProps) {
const [periodType, setPeriodType] = useState<PeriodType>("month");
const [period, setPeriod] = useState(currentMonth());
const [overview, setOverview] = useState<PeriodOverview | null>(null);
@@ -328,12 +439,18 @@ export function AnalysisPage({ onNavigate }: AnalysisPageProps) {
}
const totals = overview?.totals;
const teamspaceTimeTrackingEnabled = currentUser.teamspace_time_tracking_enabled ?? true;
const periodLabel = periodType === "month" ? "Monat" : "Tag";
const metricCards: Array<{ label: string; value: string | number; detail?: string; icon: LucideIcon }> = [
{ label: "Tickets", value: totals?.tickets ?? 0, icon: Ticket },
{ label: "Sessions", value: totals?.sessions ?? 0, icon: Users },
{ label: "Abgerechnet", value: formatMinutes(totals?.minutes ?? 0), detail: `Teamspace ${formatMinutes(totals?.crmBilledMinutes ?? 0)}`, icon: Clock3 },
{ label: "Nicht abrechenbar", value: formatMinutes(totals?.nonBillableMinutes ?? 0), icon: UserCheck },
{
label: "Abgerechnet",
value: formatMinutes(totals?.minutes ?? 0),
detail: teamspaceTimeTrackingEnabled ? `Teamspace ${formatMinutes(totals?.crmBilledMinutes ?? 0)}` : "Ist aus Teamspace",
icon: Clock3
},
{ label: "Abrechenbar", value: formatMinutes(totals?.billableMinutes ?? 0), icon: UserCheck },
{ label: "Offen", value: totals?.openSessions ?? 0, detail: formatMinutes(totals?.openMinutes ?? 0), icon: UserCheck }
];
const tickets = overview?.tickets ?? [];
@@ -356,24 +473,20 @@ export function AnalysisPage({ onNavigate }: AnalysisPageProps) {
ticket.ticket_number.toLocaleLowerCase("de").includes(normalizedQuery) ||
(ticket.title ?? "").toLocaleLowerCase("de").includes(normalizedQuery) ||
organizationLabel(ticket).toLocaleLowerCase("de").includes(normalizedQuery);
const matchesWorkType = ticketViewSettings.workType === "all" || ticket.work_type === ticketViewSettings.workType;
const matchesOrganization = ticketViewSettings.organization === "all" || organizationKey(ticket) === ticketViewSettings.organization;
const matchesStatus = ticketViewSettings.status === "all" || ticketStatusKey(ticket) === ticketViewSettings.status;
return matchesQuery && matchesWorkType && matchesOrganization && matchesStatus;
return matchesQuery && matchesTicketFilters(ticket, ticketViewSettings.filterValues, ticketViewSettings.organizationValues);
});
return sortTickets(filtered, ticketViewSettings.sortBy, ticketViewSettings.sortDirection);
}, [tickets, ticketViewSettings]);
const ticketSections = useMemo(() => groupTicketSections(visibleTickets, ticketViewSettings.groupBy), [visibleTickets, ticketViewSettings.groupBy]);
const activeFilterCount = [
ticketViewSettings.query.trim(),
ticketViewSettings.workType !== "all",
ticketViewSettings.organization !== "all",
ticketViewSettings.status !== "all",
ticketViewSettings.groupBy !== "none",
ticketViewSettings.sortBy !== "ticket",
ticketViewSettings.sortDirection !== "asc"
ticketViewSettings.query.trim() !== "",
JSON.stringify(ticketViewSettings.filterValues) !== JSON.stringify(defaultTicketViewSettings.filterValues),
ticketViewSettings.organizationValues.length > 0,
ticketViewSettings.groupBy !== defaultTicketViewSettings.groupBy,
ticketViewSettings.sortBy !== defaultTicketViewSettings.sortBy,
ticketViewSettings.sortDirection !== defaultTicketViewSettings.sortDirection
].filter(Boolean).length;
return (
<div className="space-y-5">
@@ -448,149 +561,130 @@ export function AnalysisPage({ onNavigate }: AnalysisPageProps) {
))}
</div>
<Card>
<CardHeader className="p-4">
<div className="flex items-start justify-between gap-3">
<div>
<CardTitle className="flex items-center gap-2 text-base">
<SlidersHorizontal className="size-4 text-muted-foreground" />
Filter und Sortierung
{activeFilterCount > 0 ? <Badge variant="secondary">{activeFilterCount}</Badge> : null}
</CardTitle>
<CardDescription>{visibleTickets.length} von {tickets.length} Ticket(s) sichtbar.</CardDescription>
</div>
<div className="flex items-center gap-2">
<HelpLink anchor="auswertung" label="Hilfe zu Filtern und Sortierung" />
<Button type="button" size="sm" variant="ghost" disabled={activeFilterCount === 0} onClick={() => setTicketViewSettings(defaultTicketViewSettings)}>
<RotateCcw className="size-4" />
Zurücksetzen
</Button>
</div>
</div>
</CardHeader>
<CardContent className="grid gap-3 px-4 pb-4 md:grid-cols-2 xl:grid-cols-3 2xl:grid-cols-5">
<div className="space-y-1.5">
<label className="text-xs font-medium text-muted-foreground" htmlFor="ticket-filter-query">
Suche
</label>
<Input
id="ticket-filter-query"
className="h-8"
value={ticketViewSettings.query}
placeholder="Ticket, Titel, Organisation..."
onChange={(event) => {
const query = event.currentTarget.value;
setTicketViewSettings((current) => ({ ...current, query }));
}}
/>
</div>
<div className="space-y-1.5">
<label className="text-xs font-medium text-muted-foreground">Filter</label>
<MultiFilterDropdown
values={ticketViewSettings.filterValues}
options={ticketStaticFilterOptions}
onChange={(filterValues) => setTicketViewSettings((current) => ({ ...current, filterValues }))}
/>
</div>
<div className="space-y-1.5">
<label className="text-xs font-medium text-muted-foreground">Organisationen</label>
<MultiFilterDropdown
values={ticketViewSettings.organizationValues}
options={organizationOptions}
onChange={(organizationValues) => setTicketViewSettings((current) => ({ ...current, organizationValues }))}
placeholder="Alle Org."
countLabel="Org."
emptyLabel="Keine Org."
/>
</div>
<div className="space-y-1.5">
<label className="text-xs font-medium text-muted-foreground">Gruppierung</label>
<Select value={ticketViewSettings.groupBy} onValueChange={(value) => setTicketViewSettings((current) => ({ ...current, groupBy: value as TicketGroupBy }))}>
<SelectTrigger size="sm" className="w-full">
<SelectValue />
</SelectTrigger>
<SelectContent>
{groupByOptions.map((option) => (
<SelectItem key={option.value} value={option.value}>
{option.label}
</SelectItem>
))}
</SelectContent>
</Select>
</div>
<div className="space-y-1.5">
<label className="text-xs font-medium text-muted-foreground">Sortierung</label>
<Select value={ticketViewSettings.sortBy} onValueChange={(value) => setTicketViewSettings((current) => ({ ...current, sortBy: value as TicketSortBy }))}>
<SelectTrigger size="sm" className="w-full">
<SelectValue />
</SelectTrigger>
<SelectContent>
{sortByOptions.map((option) => (
<SelectItem key={option.value} value={option.value}>
{option.label}
</SelectItem>
))}
</SelectContent>
</Select>
</div>
<div className="space-y-1.5">
<label className="text-xs font-medium text-muted-foreground">Richtung</label>
<div className="grid grid-cols-2 rounded-md border bg-background p-0.5">
<Button
type="button"
size="sm"
variant={ticketViewSettings.sortDirection === "asc" ? "secondary" : "ghost"}
className="h-7 px-2"
onClick={() => setTicketViewSettings((current) => ({ ...current, sortDirection: "asc" }))}
>
<ArrowUp className="size-3.5" />
Auf
</Button>
<Button
type="button"
size="sm"
variant={ticketViewSettings.sortDirection === "desc" ? "secondary" : "ghost"}
className="h-7 px-2"
onClick={() => setTicketViewSettings((current) => ({ ...current, sortDirection: "desc" }))}
>
<ArrowDown className="size-3.5" />
Ab
</Button>
</div>
</div>
</CardContent>
</Card>
<Card>
<CardHeader className="gap-3 p-4 sm:flex-row sm:items-center sm:justify-between sm:space-y-0">
<div>
<CardTitle>Tickets im Zeitraum</CardTitle>
<CardTitle>Sessions im Zeitraum</CardTitle>
<CardDescription>
{periodType === "month" ? "Sessions prüfen, bewerten und bei Bedarf Tickets öffnen." : "Tagesansicht ohne eigenen Abschluss."}
</CardDescription>
</div>
<HelpLink anchor="auswertung" label="Hilfe zu Tickets im Zeitraum" />
<HelpLink anchor="auswertung" label="Hilfe zu Sessions im Zeitraum" />
</CardHeader>
<CardContent className="px-4 pb-4">
<div className="mb-4 rounded-md border bg-muted/20 p-3">
<div className="mb-3 flex flex-col gap-2 sm:flex-row sm:items-center sm:justify-between">
<div className="flex items-center gap-2">
<SlidersHorizontal className="size-4 text-muted-foreground" />
<div>
<p className="text-sm font-medium">Ansicht</p>
<p className="text-xs text-muted-foreground">
{visibleTickets.length} von {tickets.length} Ticket(s)
</p>
</div>
{activeFilterCount > 0 ? <Badge variant="outline">{activeFilterCount} aktiv</Badge> : null}
<HelpLink anchor="auswertung" label="Hilfe zu Filtern und Sortierung" />
</div>
<Button
type="button"
size="sm"
variant="secondary"
disabled={activeFilterCount === 0}
onClick={() => setTicketViewSettings(defaultTicketViewSettings)}
>
<RotateCcw className="size-3.5" />
Zurücksetzen
</Button>
</div>
<div className="grid gap-2 md:grid-cols-2 xl:grid-cols-[minmax(180px,1fr)_150px_190px_140px_140px_140px_120px]">
<div className="space-y-1">
<label className="text-xs font-medium text-muted-foreground" htmlFor="ticket-filter-query">Suche</label>
<Input
id="ticket-filter-query"
className="h-8"
value={ticketViewSettings.query}
placeholder="Ticket oder Organisation"
onChange={(event) => {
const query = event.currentTarget.value;
setTicketViewSettings((current) => ({ ...current, query }));
}}
/>
</div>
<div className="space-y-1">
<label className="text-xs font-medium text-muted-foreground">Typ</label>
<Select value={ticketViewSettings.workType} onValueChange={(value) => setTicketViewSettings((current) => ({ ...current, workType: value as TicketWorkTypeFilter }))}>
<SelectTrigger size="sm" className="w-full">
<SelectValue />
</SelectTrigger>
<SelectContent>
<SelectItem value="all">Alle Typen</SelectItem>
<SelectItem value="support">Support</SelectItem>
<SelectItem value="consulting">Consulting</SelectItem>
</SelectContent>
</Select>
</div>
<div className="space-y-1">
<label className="text-xs font-medium text-muted-foreground">Organisation</label>
<Select value={ticketViewSettings.organization} onValueChange={(value) => setTicketViewSettings((current) => ({ ...current, organization: value }))}>
<SelectTrigger size="sm" className="w-full">
<SelectValue />
</SelectTrigger>
<SelectContent>
<SelectItem value="all">Alle Organisationen</SelectItem>
{organizationOptions.map((organization) => (
<SelectItem key={organization.value} value={organization.value}>
{organization.label}
</SelectItem>
))}
</SelectContent>
</Select>
</div>
<div className="space-y-1">
<label className="text-xs font-medium text-muted-foreground">Status</label>
<Select value={ticketViewSettings.status} onValueChange={(value) => setTicketViewSettings((current) => ({ ...current, status: value as TicketStatusFilter }))}>
<SelectTrigger size="sm" className="w-full">
<SelectValue />
</SelectTrigger>
<SelectContent>
<SelectItem value="all">Alle Status</SelectItem>
<SelectItem value="open">Offen</SelectItem>
<SelectItem value="evaluated">Bewertet</SelectItem>
</SelectContent>
</Select>
</div>
<div className="space-y-1">
<label className="text-xs font-medium text-muted-foreground">Gruppierung</label>
<Select value={ticketViewSettings.groupBy} onValueChange={(value) => setTicketViewSettings((current) => ({ ...current, groupBy: value as TicketGroupBy }))}>
<SelectTrigger size="sm" className="w-full">
<SelectValue />
</SelectTrigger>
<SelectContent>
{groupByOptions.map((option) => (
<SelectItem key={option.value} value={option.value}>
{option.label}
</SelectItem>
))}
</SelectContent>
</Select>
</div>
<div className="space-y-1">
<label className="text-xs font-medium text-muted-foreground">Sortierung</label>
<Select value={ticketViewSettings.sortBy} onValueChange={(value) => setTicketViewSettings((current) => ({ ...current, sortBy: value as TicketSortBy }))}>
<SelectTrigger size="sm" className="w-full">
<SelectValue />
</SelectTrigger>
<SelectContent>
{sortByOptions.map((option) => (
<SelectItem key={option.value} value={option.value}>
{option.label}
</SelectItem>
))}
</SelectContent>
</Select>
</div>
<div className="space-y-1">
<label className="text-xs font-medium text-muted-foreground">Richtung</label>
<Select value={ticketViewSettings.sortDirection} onValueChange={(value) => setTicketViewSettings((current) => ({ ...current, sortDirection: value as TicketSortDirection }))}>
<SelectTrigger size="sm" className="w-full">
<SelectValue />
</SelectTrigger>
<SelectContent>
<SelectItem value="asc">Aufsteigend</SelectItem>
<SelectItem value="desc">Absteigend</SelectItem>
</SelectContent>
</Select>
</div>
</div>
</div>
<div className="hidden md:block">
<Table>
<TableHeader>
@@ -600,7 +694,6 @@ export function AnalysisPage({ onNavigate }: AnalysisPageProps) {
<TableHead>Art</TableHead>
<TableHead>Sessions</TableHead>
<TableHead>Zeit abgerechnet</TableHead>
<TableHead>Sessions abgerechnet</TableHead>
<TableHead>Status</TableHead>
<TableHead />
</TableRow>
@@ -617,7 +710,7 @@ export function AnalysisPage({ onNavigate }: AnalysisPageProps) {
<span className="truncate text-base font-semibold">{section.label}</span>
</div>
<div className="flex flex-wrap items-center gap-2">
<Badge variant="outline">{section.ticketCount} Ticket(s)</Badge>
<Badge variant="outline">{section.ticketCount} Session(s)</Badge>
<Badge variant="outline">{formatMinutes(section.totalMinutes)}</Badge>
{section.openCount > 0 ? <Badge variant="warning">{section.openCount} offen</Badge> : <Badge variant="success">bewertet</Badge>}
</div>
@@ -641,7 +734,6 @@ export function AnalysisPage({ onNavigate }: AnalysisPageProps) {
<TableCell>{workTypeLabel(ticket.work_type)}</TableCell>
<TableCell>{ticket.session_count}</TableCell>
<TableCell>{formatMinutes(ticket.total_minutes)}</TableCell>
<TableCell>{ticket.billed_count}</TableCell>
<TableCell>
<TicketStatus ticket={ticket} />
</TableCell>
@@ -673,7 +765,7 @@ export function AnalysisPage({ onNavigate }: AnalysisPageProps) {
<span className="truncate text-base font-semibold">{section.label}</span>
</div>
<div className="flex flex-wrap items-center gap-2">
<Badge variant="outline">{section.ticketCount} Ticket(s)</Badge>
<Badge variant="outline">{section.ticketCount} Session(s)</Badge>
<Badge variant="outline">{formatMinutes(section.totalMinutes)}</Badge>
{section.openCount > 0 ? <Badge variant="warning">{section.openCount} offen</Badge> : <Badge variant="success">bewertet</Badge>}
</div>
@@ -701,8 +793,8 @@ export function AnalysisPage({ onNavigate }: AnalysisPageProps) {
<p className="font-medium">{formatMinutes(ticket.total_minutes)}</p>
</div>
<div className="rounded-md bg-muted/50 p-2">
<p className="text-muted-foreground">Sessions</p>
<p className="font-medium">{ticket.billed_count}</p>
<p className="text-muted-foreground">Abrechenbar</p>
<p className="font-medium">{ticket.billable_count}</p>
</div>
</div>
<Button
@@ -723,7 +815,7 @@ export function AnalysisPage({ onNavigate }: AnalysisPageProps) {
{tickets.length === 0 ? (
<p className="py-8 text-center text-sm text-muted-foreground">Für diesen Zeitraum sind noch keine Sessions vorhanden.</p>
) : visibleTickets.length === 0 ? (
<p className="py-8 text-center text-sm text-muted-foreground">Keine Tickets passend zu den aktuellen Filtern.</p>
<p className="py-8 text-center text-sm text-muted-foreground">Keine Sessions passend zu den aktuellen Filtern.</p>
) : null}
</CardContent>
</Card>
File diff suppressed because it is too large. Load diff
+1 -1
View File
@@ -21,7 +21,7 @@ export function LoginPage({ onLogin }: LoginPageProps) {
setLoading(true);
try {
const result = await login({ username, password });
const result = await login({ username: username.trim(), password });
onLogin(result.user);
} catch (error) {
toast.error("Login fehlgeschlagen", {
+175 -56
View File
@@ -12,6 +12,7 @@ import {
import { useEffect, useMemo, useRef, useState } from "react";
import { toast } from "sonner";
import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@/components/ui/accordion";
import { Alert } from "@/components/ui/alert";
import { Badge } from "@/components/ui/badge";
import { Button } from "@/components/ui/button";
@@ -21,8 +22,8 @@ import { Input } from "@/components/ui/input";
import { CopyTicketButton } from "@/components/CopyTicketButton";
import { HelpLink } from "@/components/HelpLink";
import { acknowledgeMissingTicketDayBilling, closePeriod, getStatisticsOverview, reopenPeriod } from "../api";
import { currentMonth, formatDate, formatDateTime, formatMinutes } from "../format";
import type { StatisticsCrmDay, StatisticsOpenSession, StatisticsOverview } from "../types";
import { currentMonth, currentWeek, formatDate, formatDateTime, formatMinutes } from "../format";
import type { StatisticsCrmDay, StatisticsOpenSession, StatisticsOverview, StatisticsTeamspaceDay } from "../types";
type MonthlyClosePageProps = {
onNavigate: (to: string) => void;
@@ -31,6 +32,17 @@ type MonthlyClosePageProps = {
const trackedTextClass = "text-sky-700 dark:text-sky-300";
const teamspaceTextClass = "text-emerald-700 dark:text-emerald-300";
const showAcknowledgedMissingCrmStorageKey = "tickettracker.monthlyClose.showAcknowledgedMissingCrm";
const monthlyCloseViewModeStorageKey = "tickettracker.monthlyClose.viewMode";
type MonthlyCloseViewMode = "month" | "week";
function readMonthlyCloseViewMode(): MonthlyCloseViewMode {
if (typeof window === "undefined") {
return "month";
}
return window.localStorage.getItem(monthlyCloseViewModeStorageKey) === "week" ? "week" : "month";
}
function formatSignedMinutes(minutes: number) {
if (minutes === 0) {
@@ -62,6 +74,7 @@ type OpenTicketGroup = {
ticketId: string;
ticketNumber: string;
organizationName: string;
month: string;
openCount: number;
totalMinutes: number;
};
@@ -82,6 +95,7 @@ function groupOpenSessions(sessions: StatisticsOpenSession[]) {
ticketId: session.ticket_id,
ticketNumber: session.ticket_number,
organizationName: session.organization_name,
month: session.started_at.slice(0, 7),
openCount: 1,
totalMinutes: session.rounded_minutes
});
@@ -90,20 +104,20 @@ function groupOpenSessions(sessions: StatisticsOpenSession[]) {
return Array.from(groups.values()).sort((left, right) => left.ticketNumber.localeCompare(right.ticketNumber, "de", { numeric: true, sensitivity: "base" }));
}
function OpenTicketItem({ group, month, onNavigate }: { group: OpenTicketGroup; month: string; onNavigate: (to: string) => void }) {
function OpenTicketItem({ group, onNavigate }: { group: OpenTicketGroup; onNavigate: (to: string) => void }) {
return (
<div className="flex min-h-36 flex-col justify-between gap-3 rounded-md border bg-background p-3">
<div className="min-w-0">
<div className="flex flex-wrap items-center gap-2">
<span className="font-medium">{group.ticketNumber}</span>
<CopyTicketButton ticketNumber={group.ticketNumber} />
<Badge variant="warning">{group.openCount} offen</Badge>
<div className="rounded-md border bg-background px-3 py-2">
<div className="flex items-start justify-between gap-3">
<div className="min-w-0 space-y-1">
<div className="flex flex-wrap items-center gap-2">
<span className="font-medium">{group.ticketNumber}</span>
<CopyTicketButton ticketNumber={group.ticketNumber} />
<Badge variant="warning">{group.openCount} offen</Badge>
</div>
<p className="truncate text-sm text-muted-foreground">{group.organizationName}</p>
<p className={`text-xs font-medium ${trackedTextClass}`}>{formatMinutes(group.totalMinutes)} offen zu bewerten</p>
</div>
<p className="truncate text-sm text-muted-foreground">{group.organizationName}</p>
<p className={`text-sm font-medium ${trackedTextClass}`}>{formatMinutes(group.totalMinutes)} offen zu bewerten</p>
</div>
<div className="flex justify-end">
<Button variant="secondary" size="sm" onClick={() => onNavigate(`/tickets/${group.ticketId}?month=${month}`)}>
<Button className="h-8 shrink-0" variant="secondary" size="sm" onClick={() => onNavigate(`/tickets/${group.ticketId}?month=${group.month}`)}>
Ticket öffnen
<ExternalLink className="size-4" />
</Button>
@@ -126,36 +140,67 @@ function CrmDayItem({
const isAcknowledged = Boolean(item.acknowledged);
return (
<div className={`flex min-h-36 flex-col justify-between gap-3 rounded-md border bg-background p-3 ${isAcknowledged ? "opacity-75" : ""}`}>
<div className="min-w-0">
<div className="flex flex-wrap items-center gap-2">
<span className="font-medium">{item.ticket_number}</span>
<div className={`rounded-md border bg-background px-3 py-2 ${isAcknowledged ? "opacity-75" : ""}`}>
<div className="flex items-start justify-between gap-3">
<div className="min-w-0 space-y-1">
<div className="flex flex-wrap items-center gap-2">
<span className="font-medium">{item.ticket_number}</span>
<CopyTicketButton ticketNumber={item.ticket_number} />
<Badge variant="outline">{formatDate(`${item.day}T00:00:00`)}</Badge>
<Badge variant={isAcknowledged ? "success" : "warning"}>{isAcknowledged ? "zur Kenntnis" : "offen"}</Badge>
</div>
<p className="truncate text-sm text-muted-foreground">{item.organization_name}</p>
<p className="flex flex-wrap gap-x-3 gap-y-1 text-xs">
<span className={trackedTextClass}>Abgerechnet {formatMinutes(item.tracked_minutes)}</span>
<span className={teamspaceTextClass}>Teamspace {formatMinutes(item.crm_billed_minutes)}</span>
{typeof item.delta_minutes === "number" ? <span className="text-muted-foreground">Differenz {formatTeamspaceDelta(item.delta_minutes)}</span> : null}
</p>
</div>
<div className="flex shrink-0 flex-wrap justify-end gap-2">
<Button className="h-8" variant={isAcknowledged ? "secondary" : "ghost"} size="sm" disabled={busy} onClick={() => onSetAcknowledgement(item, !isAcknowledged)}>
{isAcknowledged ? "Zurücknehmen" : "Zur Kenntnis"}
</Button>
<Button className="h-8" variant="secondary" size="sm" onClick={() => onNavigate(`/tickets/${item.ticket_id}?month=${item.day.slice(0, 7)}`)}>
Tag öffnen
<ExternalLink className="size-4" />
</Button>
</div>
</div>
</div>
);
}
function TeamspaceDayItem({ item, onNavigate }: { item: StatisticsTeamspaceDay; onNavigate: (to: string) => void }) {
return (
<div className="grid gap-3 rounded-md border bg-background px-3 py-2 lg:grid-cols-[minmax(8rem,0.75fr)_minmax(0,1.65fr)_minmax(8rem,0.6fr)] lg:items-center">
<div className="flex flex-wrap items-center gap-2">
<Badge variant="outline">{formatDate(`${item.day}T00:00:00`)}</Badge>
</div>
<div className="min-w-0 space-y-1">
<div className="flex min-w-0 flex-wrap items-center gap-2">
<button
type="button"
className="font-medium underline-offset-4 hover:underline"
onClick={() => onNavigate(`/tickets/${item.ticket_id}?month=${item.day.slice(0, 7)}`)}
>
{item.ticket_number}
</button>
<CopyTicketButton ticketNumber={item.ticket_number} />
<Badge variant="outline">{formatDate(`${item.day}T00:00:00`)}</Badge>
<Badge variant={isAcknowledged ? "success" : "warning"}>{isAcknowledged ? "zur Kenntnis" : "offen"}</Badge>
{item.project_teamspace_project ? <Badge variant="secondary">{item.project_teamspace_project}</Badge> : null}
</div>
<p className="truncate text-sm text-muted-foreground">{item.organization_name}</p>
<p className="flex flex-wrap gap-x-3 gap-y-1 text-xs">
<span className={trackedTextClass}>Abgerechnet {formatMinutes(item.tracked_minutes)}</span>
<span className={teamspaceTextClass}>Teamspace {formatMinutes(item.crm_billed_minutes)}</span>
{typeof item.delta_minutes === "number" ? <span className="text-muted-foreground">Differenz {formatTeamspaceDelta(item.delta_minutes)}</span> : null}
</p>
</div>
<div className="flex flex-wrap justify-end gap-2">
<Button variant={isAcknowledged ? "secondary" : "ghost"} size="sm" disabled={busy} onClick={() => onSetAcknowledgement(item, !isAcknowledged)}>
{isAcknowledged ? "Zurücknehmen" : "Zur Kenntnis"}
</Button>
<Button variant="secondary" size="sm" onClick={() => onNavigate(`/tickets/${item.ticket_id}?month=${item.day.slice(0, 7)}`)}>
Tag öffnen
<ExternalLink className="size-4" />
</Button>
<div className="text-sm">
<Badge variant="success">{formatMinutes(item.crm_billed_minutes)}</Badge>
</div>
</div>
);
}
export function MonthlyClosePage({ onNavigate }: MonthlyClosePageProps) {
const [viewMode, setViewMode] = useState<MonthlyCloseViewMode>(() => readMonthlyCloseViewMode());
const [month, setMonth] = useState(currentMonth());
const [week, setWeek] = useState(currentWeek());
const [stats, setStats] = useState<StatisticsOverview | null>(null);
const [loading, setLoading] = useState(false);
const [closing, setClosing] = useState(false);
@@ -164,6 +209,11 @@ export function MonthlyClosePage({ onNavigate }: MonthlyClosePageProps) {
const [showAcknowledgedMissingCrm, setShowAcknowledgedMissingCrm] = useState(false);
const [showAcknowledgedMissingCrmLoaded, setShowAcknowledgedMissingCrmLoaded] = useState(false);
const loadRequestId = useRef(0);
const period = viewMode === "month" ? month : week;
const periodLabel = viewMode === "month" ? "Monat" : "Woche";
const periodAttentionLabel = viewMode === "month" ? "diesen Monat" : "diese Woche";
const periodInLabel = viewMode === "month" ? "diesem Monat" : "dieser Woche";
const isMonthView = viewMode === "month";
async function load() {
const requestId = loadRequestId.current + 1;
@@ -171,14 +221,14 @@ export function MonthlyClosePage({ onNavigate }: MonthlyClosePageProps) {
setLoading(true);
try {
const result = await getStatisticsOverview(month);
const result = await getStatisticsOverview(period, viewMode);
if (requestId === loadRequestId.current) {
setStats(result);
}
} catch (error) {
if (requestId === loadRequestId.current) {
toast.error("Monatsabschluss konnte nicht geladen werden", {
toast.error("Abschlussansicht konnte nicht geladen werden", {
description: error instanceof Error ? error.message : "Unbekannter Fehler"
});
}
@@ -191,7 +241,11 @@ export function MonthlyClosePage({ onNavigate }: MonthlyClosePageProps) {
useEffect(() => {
void load();
}, [month]);
}, [period, viewMode]);
useEffect(() => {
window.localStorage.setItem(monthlyCloseViewModeStorageKey, viewMode);
}, [viewMode]);
useEffect(() => {
setShowAcknowledgedMissingCrm(window.localStorage.getItem(showAcknowledgedMissingCrmStorageKey) === "true");
@@ -211,6 +265,22 @@ export function MonthlyClosePage({ onNavigate }: MonthlyClosePageProps) {
setMonth(`${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}`);
}
function changeWeekBy(delta: number) {
const match = /^(\d{4})-W(\d{2})$/.exec(week);
const year = match ? Number(match[1]) : new Date().getFullYear();
const weekNumber = match ? Number(match[2]) : 1;
const jan4 = new Date(Date.UTC(year, 0, 4));
const jan4Weekday = jan4.getUTCDay() || 7;
const date = new Date(jan4);
date.setUTCDate(jan4.getUTCDate() - jan4Weekday + 1 + (weekNumber - 1 + delta) * 7);
const weekday = date.getUTCDay() || 7;
date.setUTCDate(date.getUTCDate() + 4 - weekday);
const yearStart = new Date(Date.UTC(date.getUTCFullYear(), 0, 1));
const nextWeek = Math.ceil(((date.getTime() - yearStart.getTime()) / 86_400_000 + 1) / 7);
setWeek(`${date.getUTCFullYear()}-W${String(nextWeek).padStart(2, "0")}`);
}
async function finishMonth() {
setClosing(true);
try {
@@ -272,19 +342,20 @@ export function MonthlyClosePage({ onNavigate }: MonthlyClosePageProps) {
const openSessions = stats?.attention.openSessions ?? [];
const missingCrmDays = stats?.attention.missingCrmDays ?? [];
const acknowledgedMissingCrmDays = stats?.attention.acknowledgedMissingCrmDays ?? [];
const teamspaceDays = stats?.teamspaceDays ?? [];
const openTicketGroups = useMemo(() => groupOpenSessions(openSessions), [openSessions]);
const visibleMissingCrmDays = useMemo(() => {
const days = showAcknowledgedMissingCrm ? [...missingCrmDays, ...acknowledgedMissingCrmDays] : [...missingCrmDays];
return days.sort((left, right) => left.day.localeCompare(right.day) || left.ticket_number.localeCompare(right.ticket_number, "de", { numeric: true, sensitivity: "base" }));
}, [acknowledgedMissingCrmDays, missingCrmDays, showAcknowledgedMissingCrm]);
const canClose = Boolean(stats && !stats.closed && stats.totals.sessions > 0 && openSessions.length === 0);
const canClose = Boolean(isMonthView && stats && !stats.closed && stats.totals.sessions > 0 && openSessions.length === 0);
const checklist = useMemo(
() => [
{
label: "Offene Bewertungen",
ok: openSessions.length === 0,
value: openSessions.length,
detail: openSessions.length === 0 ? "Alle Sessions sind bewertet." : `${openTicketGroups.length} Ticket(s) bearbeiten`
detail: openSessions.length === 0 ? "Keine offenen Bewertungen." : `${openTicketGroups.length} Ticket(s) bearbeiten`
},
{
label: "Teamspace geprüft",
@@ -293,13 +364,13 @@ export function MonthlyClosePage({ onNavigate }: MonthlyClosePageProps) {
detail: missingCrmDays.length === 0 ? "Keine offenen Teamspace-Prüfpunkte." : `${acknowledgedMissingCrmDays.length} zur Kenntnis genommen`
},
{
label: "Monat abschließbar",
ok: Boolean(stats?.closed || canClose),
value: stats?.closed ? "geschlossen" : canClose ? "bereit" : "offen",
detail: stats?.closed ? "Monat ist gesperrt." : canClose ? "Kann abgeschlossen werden." : "Bewertungen prüfen."
label: isMonthView ? "Monat abschließbar" : "Wochenansicht",
ok: isMonthView ? Boolean(stats?.closed || canClose) : true,
value: isMonthView ? (stats?.closed ? "geschlossen" : canClose ? "bereit" : "offen") : "Ansicht",
detail: isMonthView ? (stats?.closed ? "Monat ist gesperrt." : canClose ? "Kann abgeschlossen werden." : "Bewertungen prüfen.") : "Abschluss bleibt monatlich."
}
],
[acknowledgedMissingCrmDays.length, canClose, openSessions.length, openTicketGroups.length, missingCrmDays.length, stats?.closed]
[acknowledgedMissingCrmDays.length, canClose, isMonthView, openSessions.length, openTicketGroups.length, missingCrmDays.length, stats?.closed]
);
return (
@@ -307,25 +378,46 @@ export function MonthlyClosePage({ onNavigate }: MonthlyClosePageProps) {
<div className="flex flex-col gap-3 xl:flex-row xl:items-end xl:justify-between">
<div>
<h2 className="text-2xl font-semibold tracking-normal">Monatsabschluss</h2>
<p className="text-sm text-muted-foreground">Offene Bewertungen, Teamspace-Abgleich und der eigentliche Monatsabschluss.</p>
<p className="text-sm text-muted-foreground">Offene Bewertungen und Teamspace-Abgleich für {periodAttentionLabel}; der Abschluss selbst bleibt monatlich.</p>
</div>
<div className="grid gap-2 sm:grid-cols-[minmax(220px,300px)_auto] sm:items-end">
<div className="grid gap-2 sm:grid-cols-[auto_minmax(220px,300px)_auto] sm:items-end">
<div className="space-y-1">
<span className="text-xs font-medium text-muted-foreground">Ansicht</span>
<div className="inline-flex h-9 rounded-md border bg-muted/20 p-1">
<Button type="button" size="sm" variant={viewMode === "week" ? "default" : "ghost"} className="h-7 px-3" onClick={() => setViewMode("week")}>
Woche
</Button>
<Button type="button" size="sm" variant={viewMode === "month" ? "default" : "ghost"} className="h-7 px-3" onClick={() => setViewMode("month")}>
Monat
</Button>
</div>
</div>
<div className="space-y-1">
<div className="flex items-center justify-between gap-2">
<label className="text-xs font-medium text-muted-foreground" htmlFor="close-month">Monat</label>
<label className="text-xs font-medium text-muted-foreground" htmlFor="close-period">{periodLabel}</label>
{loading ? <span className="text-xs text-muted-foreground">lädt...</span> : null}
</div>
<div className="grid grid-cols-[2.25rem_minmax(0,1fr)_2.25rem] gap-1">
<Button type="button" size="icon" variant="secondary" className="h-9 w-9" onClick={() => changeMonthBy(-1)} aria-label="Monat zurück">
<Button type="button" size="icon" variant="secondary" className="h-9 w-9" onClick={() => (isMonthView ? changeMonthBy(-1) : changeWeekBy(-1))} aria-label={`${periodLabel} zurück`}>
<ChevronLeft className="size-4" />
</Button>
<Input id="close-month" className="h-9" type="month" value={month} onChange={(event) => setMonth(event.currentTarget.value)} />
<Button type="button" size="icon" variant="secondary" className="h-9 w-9" onClick={() => changeMonthBy(1)} aria-label="Monat vor">
<Input
id="close-period"
className="h-9"
type={isMonthView ? "month" : "week"}
value={period}
onChange={(event) => (isMonthView ? setMonth(event.currentTarget.value) : setWeek(event.currentTarget.value))}
/>
<Button type="button" size="icon" variant="secondary" className="h-9 w-9" onClick={() => (isMonthView ? changeMonthBy(1) : changeWeekBy(1))} aria-label={`${periodLabel} vor`}>
<ChevronRight className="size-4" />
</Button>
</div>
</div>
{stats?.closed ? (
{!isMonthView ? (
<Badge variant="outline" className="h-9 justify-center px-3">
Abschluss nur monatlich
</Badge>
) : stats?.closed ? (
<Button size="sm" variant="secondary" disabled={reopening} onClick={reopenMonth}>
<LockOpen className="size-4" />
{reopening ? "Öffnet..." : "Monat öffnen"}
@@ -339,7 +431,7 @@ export function MonthlyClosePage({ onNavigate }: MonthlyClosePageProps) {
</div>
</div>
{stats?.closed ? (
{isMonthView && stats?.closed ? (
<Alert variant="success" className="flex items-center gap-2 py-3">
<CheckCircle2 className="size-4 shrink-0" />
<span>Dieser Monat wurde am {formatDateTime(stats.closedAt!)} abgeschlossen.</span>
@@ -351,7 +443,12 @@ export function MonthlyClosePage({ onNavigate }: MonthlyClosePageProps) {
<StatusCard label="Teamspace" value={formatMinutes(stats?.totals.crmBilledMinutes ?? 0)} detail={`Differenz ${formatTeamspaceDelta(stats?.totals.crmDeltaMinutes ?? 0)}`} />
<StatusCard label="Offene Bewertungen" value={openSessions.length} detail={`${openTicketGroups.length} Ticket(s)`} tone={openSessions.length > 0 ? "warn" : "ok"} />
<StatusCard label="Ohne Teamspace" value={missingCrmDays.length} detail={`${acknowledgedMissingCrmDays.length} zur Kenntnis genommen`} tone={missingCrmDays.length > 0 ? "warn" : "ok"} />
<StatusCard label="Status" value={stats?.closed ? "geschlossen" : canClose ? "bereit" : "offen"} detail={stats?.closed ? "Monat ist gesperrt" : canClose ? "kann abgeschlossen werden" : "Prüfpunkte bearbeiten"} tone={stats?.closed || canClose ? "ok" : "warn"} />
<StatusCard
label="Status"
value={isMonthView ? (stats?.closed ? "geschlossen" : canClose ? "bereit" : "offen") : "Ansicht"}
detail={isMonthView ? (stats?.closed ? "Monat ist gesperrt" : canClose ? "kann abgeschlossen werden" : "Prüfpunkte bearbeiten") : "Abschluss bleibt monatlich"}
tone={isMonthView ? (stats?.closed || canClose ? "ok" : "warn") : "neutral"}
/>
</div>
<Card>
@@ -382,7 +479,7 @@ export function MonthlyClosePage({ onNavigate }: MonthlyClosePageProps) {
<div className="flex flex-col gap-3 sm:flex-row sm:items-start sm:justify-between">
<div>
<CardTitle>Aufräumen</CardTitle>
<CardDescription>Alles, was für diesen Monat noch Aufmerksamkeit braucht.</CardDescription>
<CardDescription>Alles, was für {periodAttentionLabel} noch Aufmerksamkeit braucht.</CardDescription>
</div>
<div className="flex flex-wrap items-center gap-2">
<div className="inline-flex h-8 items-center gap-2 rounded-md border bg-background px-3 text-sm">
@@ -404,7 +501,7 @@ export function MonthlyClosePage({ onNavigate }: MonthlyClosePageProps) {
Offene Bewertungen
</div>
{openTicketGroups.map((group) => (
<OpenTicketItem key={group.ticketId} group={group} month={month} onNavigate={onNavigate} />
<OpenTicketItem key={group.ticketId} group={group} onNavigate={onNavigate} />
))}
{openTicketGroups.length === 0 ? <p className="rounded-md border bg-muted/20 p-3 text-sm text-muted-foreground">Keine offenen Bewertungen.</p> : null}
</section>
@@ -432,13 +529,35 @@ export function MonthlyClosePage({ onNavigate }: MonthlyClosePageProps) {
</CardContent>
</Card>
<Accordion type="single" collapsible className="rounded-md border bg-card px-4">
<AccordionItem value="teamspace-entries" className="border-b-0">
<AccordionTrigger className="py-3 hover:no-underline">
<span className="flex min-w-0 flex-wrap items-center gap-2">
<span>Teamspace-Einträge</span>
<Badge variant="outline">{teamspaceDays.length} Eintrag(e)</Badge>
</span>
</AccordionTrigger>
<AccordionContent className="space-y-2 pb-4">
{teamspaceDays.length > 0 ? (
<div className="max-h-[28rem] space-y-2 overflow-y-auto pr-1">
{teamspaceDays.map((item) => (
<TeamspaceDayItem key={`${item.ticket_id}-${item.day}`} item={item} onNavigate={onNavigate} />
))}
</div>
) : (
<p className="rounded-md border bg-muted/20 p-3 text-sm text-muted-foreground">Für {periodAttentionLabel} sind noch keine Teamspace-Werte zu abgerechneten Ticket-Tagen vorhanden.</p>
)}
</AccordionContent>
</AccordionItem>
</Accordion>
{stats && stats.totals.sessions === 0 ? (
<Card>
<CardContent className="grid place-items-center gap-2 p-8 text-center">
<Clock3 className="size-8 text-muted-foreground" />
<div>
<p className="font-medium">Keine Sessions in diesem Monat</p>
<p className="text-sm text-muted-foreground">Ein Monatsabschluss ist erst sinnvoll, wenn Sessions vorhanden sind.</p>
<p className="font-medium">Keine Sessions in {periodInLabel}</p>
<p className="text-sm text-muted-foreground">Die Kontrollansicht ist erst sinnvoll, wenn Sessions vorhanden sind.</p>
</div>
</CardContent>
</Card>
+444 -5
View File
@@ -1,12 +1,15 @@
import { FormEvent, useEffect, useState } from "react";
import { KeyRound, Save, Unplug, UserCircle, X } from "lucide-react";
import { Clock3, ClipboardCheck, FileText, KeyRound, MailPlus, RefreshCw, Save, Send, Unplug, UserCircle, X } from "lucide-react";
import { toast } from "sonner";
import { Button } from "@/components/ui/button";
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card";
import { Input } from "@/components/ui/input";
import { Switch } from "@/components/ui/switch";
import { HelpLink } from "@/components/HelpLink";
import { updateCurrentUser } from "../api";
import type { AuthUser } from "../types";
import { getZammadSessionArticleQueue, retryZammadSessionArticleQueue, updateCurrentUser } from "../api";
import { formatDateTime, formatMinutes } from "../format";
import type { AuthUser, ZammadSessionArticleQueueItem } from "../types";
import { zammadArticleTypeFromValue, zammadArticleTypeLabel, zammadArticleTypeOptions, zammadArticleTypeValue, type ZammadArticleTypeId } from "../zammad-article-types";
type ProfilePageProps = {
currentUser: AuthUser;
@@ -21,6 +24,25 @@ export function ProfilePage({ currentUser, onUserUpdated }: ProfilePageProps) {
const [confirmPassword, setConfirmPassword] = useState("");
const [zammadApiToken, setZammadApiToken] = useState("");
const [zammadTokenDirty, setZammadTokenDirty] = useState(false);
const [teamspaceDeviceId, setTeamspaceDeviceId] = useState("");
const [teamspaceDevicePassword, setTeamspaceDevicePassword] = useState("");
const [teamspaceCredentialsDirty, setTeamspaceCredentialsDirty] = useState(false);
const [zammadEmailSessionWebhookEnabled, setZammadEmailSessionWebhookEnabled] = useState(currentUser.zammad_email_session_webhook_enabled);
const [zammadAtossEmailSyncEnabled, setZammadAtossEmailSyncEnabled] = useState(currentUser.zammad_atoss_email_sync_enabled);
const [sessionBillingPromptEnabled, setSessionBillingPromptEnabled] = useState(currentUser.session_billing_prompt_enabled);
const [teamspaceTimeTrackingEnabled, setTeamspaceTimeTrackingEnabled] = useState(currentUser.teamspace_time_tracking_enabled ?? true);
const [zammadSessionNoteDefaultEnabled, setZammadSessionNoteDefaultEnabled] = useState(currentUser.zammad_session_note_default_enabled);
const [zammadTimeUnitRoundingEnabled, setZammadTimeUnitRoundingEnabled] = useState(currentUser.zammad_time_unit_rounding_enabled);
const [zammadTimeUnitRoundingMinutes, setZammadTimeUnitRoundingMinutes] = useState(currentUser.zammad_time_unit_rounding_minutes);
const [zammadArticleTypeId, setZammadArticleTypeId] = useState<ZammadArticleTypeId>(currentUser.zammad_article_type_id ?? 6);
const [projectFollowupEnabled, setProjectFollowupEnabled] = useState(currentUser.project_followup_enabled ?? true);
const [projectFollowupWeeks, setProjectFollowupWeeks] = useState(currentUser.project_followup_weeks ?? 4);
const [projectFollowupSecondEnabled, setProjectFollowupSecondEnabled] = useState(currentUser.project_followup_second_enabled ?? true);
const [projectFollowupSecondWeeks, setProjectFollowupSecondWeeks] = useState(currentUser.project_followup_second_weeks ?? 2);
const [projectFollowupCompleteOnSession, setProjectFollowupCompleteOnSession] = useState(currentUser.project_followup_complete_on_session ?? true);
const [zammadQueue, setZammadQueue] = useState<ZammadSessionArticleQueueItem[]>([]);
const [loadingZammadQueue, setLoadingZammadQueue] = useState(false);
const [retryingZammadQueue, setRetryingZammadQueue] = useState(false);
const [saving, setSaving] = useState(false);
useEffect(() => {
@@ -28,8 +50,73 @@ export function ProfilePage({ currentUser, onUserUpdated }: ProfilePageProps) {
setDisplayName(currentUser.display_name);
setZammadApiToken("");
setZammadTokenDirty(false);
setTeamspaceDeviceId("");
setTeamspaceDevicePassword("");
setTeamspaceCredentialsDirty(false);
setZammadEmailSessionWebhookEnabled(currentUser.zammad_email_session_webhook_enabled);
setZammadAtossEmailSyncEnabled(currentUser.zammad_atoss_email_sync_enabled);
setSessionBillingPromptEnabled(currentUser.session_billing_prompt_enabled);
setTeamspaceTimeTrackingEnabled(currentUser.teamspace_time_tracking_enabled ?? true);
setZammadSessionNoteDefaultEnabled(currentUser.zammad_session_note_default_enabled);
setZammadTimeUnitRoundingEnabled(currentUser.zammad_time_unit_rounding_enabled);
setZammadTimeUnitRoundingMinutes(currentUser.zammad_time_unit_rounding_minutes);
setZammadArticleTypeId(currentUser.zammad_article_type_id ?? 6);
setProjectFollowupEnabled(currentUser.project_followup_enabled ?? true);
setProjectFollowupWeeks(currentUser.project_followup_weeks ?? 4);
setProjectFollowupSecondEnabled(currentUser.project_followup_second_enabled ?? true);
setProjectFollowupSecondWeeks(currentUser.project_followup_second_weeks ?? 2);
setProjectFollowupCompleteOnSession(currentUser.project_followup_complete_on_session ?? true);
}, [currentUser]);
async function loadZammadQueue() {
if (currentUser.role !== "user") {
setZammadQueue([]);
return;
}
setLoadingZammadQueue(true);
try {
const result = await getZammadSessionArticleQueue();
setZammadQueue(result.queue);
} catch (error) {
toast.error("Zammad-Parktabelle konnte nicht geladen werden", {
description: error instanceof Error ? error.message : "Unbekannter Fehler"
});
} finally {
setLoadingZammadQueue(false);
}
}
useEffect(() => {
void loadZammadQueue();
}, [currentUser.role]);
async function retryZammadQueue() {
setRetryingZammadQueue(true);
try {
const result = await retryZammadSessionArticleQueue();
setZammadQueue(result.queue);
if (result.failed > 0) {
toast.warning("Zammad-Notizen teilweise gesendet", {
description: `${result.sent} gesendet, ${result.failed} weiter geparkt.`
});
} else {
toast.success("Zammad-Notizen gesendet", {
description: `${result.sent} Eintrag/Einträge erfolgreich übertragen.`
});
}
} catch (error) {
toast.error("Zammad-Notizen konnten nicht gesendet werden", {
description: error instanceof Error ? error.message : "Unbekannter Fehler"
});
} finally {
setRetryingZammadQueue(false);
}
}
async function submit(event: FormEvent) {
event.preventDefault();
@@ -54,7 +141,25 @@ export function ProfilePage({ currentUser, onUserUpdated }: ProfilePageProps) {
displayName,
currentPassword: wantsPasswordChange ? currentPassword : undefined,
newPassword: wantsPasswordChange ? newPassword : undefined,
...(currentUser.role === "user" && zammadTokenDirty ? { zammadApiToken } : {})
...(currentUser.role === "user" && zammadTokenDirty ? { zammadApiToken } : {}),
...(currentUser.role === "user" && teamspaceCredentialsDirty ? { teamspaceDeviceId, teamspaceDevicePassword } : {}),
...(currentUser.role === "user"
? {
zammadEmailSessionWebhookEnabled,
zammadAtossEmailSyncEnabled,
sessionBillingPromptEnabled,
teamspaceTimeTrackingEnabled,
zammadSessionNoteDefaultEnabled,
zammadTimeUnitRoundingEnabled,
zammadTimeUnitRoundingMinutes,
zammadArticleTypeId,
projectFollowupEnabled,
projectFollowupWeeks,
projectFollowupSecondEnabled,
projectFollowupSecondWeeks,
projectFollowupCompleteOnSession
}
: {})
};
try {
@@ -65,6 +170,9 @@ export function ProfilePage({ currentUser, onUserUpdated }: ProfilePageProps) {
setConfirmPassword("");
setZammadApiToken("");
setZammadTokenDirty(false);
setTeamspaceDeviceId("");
setTeamspaceDevicePassword("");
setTeamspaceCredentialsDirty(false);
toast.success("Profil gespeichert");
} catch (error) {
toast.error("Profil konnte nicht gespeichert werden", {
@@ -181,7 +289,7 @@ export function ProfilePage({ currentUser, onUserUpdated }: ProfilePageProps) {
}}
/>
<p className="text-xs text-muted-foreground">
Die Zammad-User-ID wird nur geprüft, wenn du hier einen neuen Token speicherst.
Die Zammad-ID wird nur geprüft, wenn du hier einen neuen Token speicherst.
</p>
</div>
<div className="space-y-2">
@@ -206,6 +314,337 @@ export function ProfilePage({ currentUser, onUserUpdated }: ProfilePageProps) {
) : null}
</div>
</div>
<div className="mt-4 rounded-md border bg-background p-3">
<div className="mb-3 flex items-center gap-2">
<Unplug className="size-4 text-muted-foreground" />
<p className="text-sm font-medium">Teamspace API</p>
</div>
<div className="grid gap-3 md:grid-cols-[minmax(180px,220px)_minmax(220px,1fr)_180px]">
<div className="space-y-2">
<label className="text-sm font-medium" htmlFor="profile-teamspace-device-id">
Geräte-ID
</label>
<Input
id="profile-teamspace-device-id"
value={teamspaceDeviceId}
placeholder={currentUser.has_teamspace_credentials ? "hinterlegt" : "Geräte-ID"}
autoComplete="off"
onChange={(event) => {
setTeamspaceDeviceId(event.currentTarget.value);
setTeamspaceCredentialsDirty(true);
}}
/>
</div>
<div className="space-y-2">
<label className="text-sm font-medium" htmlFor="profile-teamspace-device-password">
Gerätepasswort
</label>
<Input
id="profile-teamspace-device-password"
type="password"
value={teamspaceDevicePassword}
placeholder={currentUser.has_teamspace_credentials ? "••••••••••••••••" : "Token aus Teamspace einfügen"}
autoComplete="off"
onChange={(event) => {
setTeamspaceDevicePassword(event.currentTarget.value);
setTeamspaceCredentialsDirty(true);
}}
/>
<p className="text-xs text-muted-foreground">Die Teamspace-ID wird nur geprüft, wenn du neue Zugangsdaten speicherst.</p>
</div>
<div className="space-y-2">
<label className="text-sm font-medium" htmlFor="profile-teamspace-user-id">
Teamspace User-ID
</label>
<Input id="profile-teamspace-user-id" value={currentUser.teamspace_user_id ?? "nicht verknüpft"} readOnly />
{currentUser.has_teamspace_credentials ? (
<Button
type="button"
size="sm"
variant="secondary"
className="w-full"
onClick={() => {
setTeamspaceDeviceId("");
setTeamspaceDevicePassword("");
setTeamspaceCredentialsDirty(true);
}}
>
<X className="size-4" />
Zugang entfernen
</Button>
) : null}
</div>
</div>
</div>
<div className="mt-3 flex items-center justify-between gap-3 rounded-md border bg-background p-3">
<div className="flex items-center gap-2">
<Clock3 className="size-4 text-muted-foreground" />
<div>
<label className="text-sm font-medium" htmlFor="profile-teamspace-time-tracking">
Teamspace-Zeiten in TT erfassen
</label>
<p className="text-xs text-muted-foreground">
Wenn aus, werden keine Teamspace-Tageswerte in TT erfasst; Monatsprüfung und Abschluss laufen nur über Session-Status.
</p>
</div>
</div>
<Switch
id="profile-teamspace-time-tracking"
checked={teamspaceTimeTrackingEnabled}
onCheckedChange={setTeamspaceTimeTrackingEnabled}
/>
</div>
<div className="mt-4 flex items-center justify-between gap-3 rounded-md border bg-background p-3">
<div className="flex items-center gap-2">
<MailPlus className="size-4 text-muted-foreground" />
<div>
<label className="text-sm font-medium" htmlFor="profile-zammad-email-session-webhook">
eMail-Sessions aus Zammad
</label>
<p className="text-xs text-muted-foreground">Ausgehende Zammad-eMails automatisch als Session übernehmen.</p>
</div>
</div>
<Switch
id="profile-zammad-email-session-webhook"
checked={zammadEmailSessionWebhookEnabled}
onCheckedChange={setZammadEmailSessionWebhookEnabled}
/>
</div>
<div className="mt-3 flex items-center justify-between gap-3 rounded-md border bg-background p-3">
<div className="flex items-center gap-2">
<MailPlus className="size-4 text-muted-foreground" />
<div>
<label className="text-sm font-medium" htmlFor="profile-zammad-atoss-email-sync">
ATOSS eMails syncen
</label>
<p className="text-xs text-muted-foreground">Wenn aus, werden eMails an support.atc@atoss.com nicht übernommen.</p>
</div>
</div>
<Switch
id="profile-zammad-atoss-email-sync"
checked={zammadAtossEmailSyncEnabled}
onCheckedChange={setZammadAtossEmailSyncEnabled}
/>
</div>
<div className="mt-3 flex items-center justify-between gap-3 rounded-md border bg-background p-3">
<div className="flex items-center gap-2">
<ClipboardCheck className="size-4 text-muted-foreground" />
<div>
<label className="text-sm font-medium" htmlFor="profile-session-billing-prompt">
Bewertungsabfrage beim Timerabschluss
</label>
<p className="text-xs text-muted-foreground">Bei Bewertung --- vor dem Speichern noch einmal nachfragen.</p>
</div>
</div>
<Switch
id="profile-session-billing-prompt"
checked={sessionBillingPromptEnabled}
onCheckedChange={setSessionBillingPromptEnabled}
/>
</div>
<div className="mt-3 space-y-3 rounded-md border bg-background p-3">
<div className="flex items-center justify-between gap-3">
<div>
<label className="text-sm font-medium" htmlFor="profile-project-followup-enabled">
Automatische Wiedervorlagen
</label>
<p className="text-xs text-muted-foreground">Consulting-Projekte automatisch auf Wiedervorlage setzen.</p>
</div>
<Switch
id="profile-project-followup-enabled"
checked={projectFollowupEnabled}
onCheckedChange={setProjectFollowupEnabled}
/>
</div>
{projectFollowupEnabled ? (
<div className="space-y-3 border-t pt-3">
<div>
<p className="text-sm font-medium">1. Wiedervorlage aktiv</p>
<p className="text-xs text-muted-foreground">Wenn automatische Wiedervorlagen aktiv sind, wird die erste WVL immer geprüft.</p>
</div>
<div className="grid gap-2 sm:max-w-xs">
<label className="text-sm font-medium" htmlFor="profile-project-followup-weeks">
1. Wiedervorlage nach Wochen
</label>
<Input
id="profile-project-followup-weeks"
type="number"
min={1}
max={52}
value={projectFollowupWeeks}
onChange={(event) => setProjectFollowupWeeks(Math.max(1, Math.min(52, Number(event.currentTarget.value) || 1)))}
/>
</div>
<div className="flex items-center justify-between gap-3">
<div>
<label className="text-sm font-medium" htmlFor="profile-project-followup-second-enabled">
2. Wiedervorlage
</label>
<p className="text-xs text-muted-foreground">Nur anlegen, wenn die erste WVL erledigt oder gelöscht wurde und keine Session entstanden ist.</p>
</div>
<Switch
id="profile-project-followup-second-enabled"
checked={projectFollowupSecondEnabled}
onCheckedChange={setProjectFollowupSecondEnabled}
/>
</div>
{projectFollowupSecondEnabled ? (
<div className="grid gap-2 sm:max-w-xs">
<label className="text-sm font-medium" htmlFor="profile-project-followup-second-weeks">
2. Wiedervorlage nach weiteren Wochen
</label>
<Input
id="profile-project-followup-second-weeks"
type="number"
min={1}
max={52}
value={projectFollowupSecondWeeks}
onChange={(event) => setProjectFollowupSecondWeeks(Math.max(1, Math.min(52, Number(event.currentTarget.value) || 1)))}
/>
</div>
) : null}
</div>
) : null}
<div className="flex items-center justify-between gap-3">
<div>
<label className="text-sm font-medium" htmlFor="profile-project-followup-complete-on-session">
Automatische Wiedervorlagen durch Session erledigen
</label>
<p className="text-xs text-muted-foreground">Gilt für beide Zeiträume. Betrifft nur automatisch erzeugte Wiedervorlagen, niemals manuelle ToDos.</p>
</div>
<Switch
id="profile-project-followup-complete-on-session"
checked={projectFollowupCompleteOnSession}
onCheckedChange={setProjectFollowupCompleteOnSession}
/>
</div>
</div>
<div className="mt-3 flex items-center justify-between gap-3 rounded-md border bg-background p-3">
<div className="flex items-center gap-2">
<FileText className="size-4 text-muted-foreground" />
<div>
<label className="text-sm font-medium" htmlFor="profile-zammad-session-note">
Interne Zammad-Notiz beim Timerabschluss
</label>
<p className="text-xs text-muted-foreground">Checkbox im Speichern-Dialog standardmäßig aktivieren.</p>
</div>
</div>
<Switch
id="profile-zammad-session-note"
checked={zammadSessionNoteDefaultEnabled}
onCheckedChange={(checked) => {
setZammadSessionNoteDefaultEnabled(checked);
if (!checked) {
setZammadTimeUnitRoundingEnabled(false);
}
}}
/>
</div>
{zammadSessionNoteDefaultEnabled ? (
<div className="mt-3 space-y-3">
<div className="rounded-md border bg-background p-3">
<div className="grid gap-2 sm:max-w-lg">
<label className="text-sm font-medium" htmlFor="profile-zammad-article-type">
Standard-Typ
</label>
<select
id="profile-zammad-article-type"
className="h-9 rounded-md border border-input bg-background px-3 text-sm focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
value={zammadArticleTypeValue(zammadArticleTypeId)}
onChange={(event) => setZammadArticleTypeId(zammadArticleTypeFromValue(event.currentTarget.value))}
>
{zammadArticleTypeOptions.map((option) => (
<option key={option.value || "empty"} value={option.value}>
{option.label}
</option>
))}
</select>
<p className="text-xs text-muted-foreground">Wird beim Erstellen interner Zammad-Notizen vorbelegt.</p>
</div>
</div>
<div className="rounded-md border bg-background p-3">
<div className="flex items-center justify-between gap-3">
<div className="flex items-center gap-2">
<Clock3 className="size-4 text-muted-foreground" />
<div>
<label className="text-sm font-medium" htmlFor="profile-zammad-time-rounding">
Zammad-Zeit aufrunden
</label>
<p className="text-xs text-muted-foreground">Ohne Rundung wird die konkrete Zeit als Stundenwert mit 2 Nachkommastellen gesendet.</p>
</div>
</div>
<Switch
id="profile-zammad-time-rounding"
checked={zammadTimeUnitRoundingEnabled}
onCheckedChange={setZammadTimeUnitRoundingEnabled}
/>
</div>
{zammadTimeUnitRoundingEnabled ? (
<div className="mt-3 grid gap-2 sm:w-56">
<label className="text-xs font-medium text-muted-foreground" htmlFor="profile-zammad-rounding-minutes">
Rundungsintervall
</label>
<select
id="profile-zammad-rounding-minutes"
className="h-9 rounded-md border border-input bg-background px-3 text-sm focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
value={zammadTimeUnitRoundingMinutes}
onChange={(event) => setZammadTimeUnitRoundingMinutes(Number(event.currentTarget.value))}
>
<option value={5}>5 Minuten</option>
<option value={10}>10 Minuten</option>
<option value={15}>15 Minuten</option>
<option value={30}>30 Minuten</option>
</select>
</div>
) : null}
</div>
</div>
) : null}
<div className="mt-3 rounded-md border bg-background p-3">
<div className="flex flex-col gap-3 sm:flex-row sm:items-start sm:justify-between">
<div className="flex items-start gap-2">
<Send className="mt-0.5 size-4 text-muted-foreground" />
<div>
<p className="text-sm font-medium">Geparkte Zammad-Notizen</p>
<p className="text-xs text-muted-foreground">Nicht übertragene interne Notizen nachträglich senden.</p>
</div>
</div>
<div className="flex gap-2">
<Button type="button" size="sm" variant="secondary" disabled={loadingZammadQueue} onClick={() => void loadZammadQueue()}>
<RefreshCw className="size-3.5" />
Prüfen
</Button>
<Button type="button" size="sm" disabled={zammadQueue.length === 0 || retryingZammadQueue} onClick={() => void retryZammadQueue()}>
<Send className="size-3.5" />
{retryingZammadQueue ? "Sendet..." : "Senden"}
</Button>
</div>
</div>
<div className="mt-3 space-y-2">
{loadingZammadQueue ? <p className="text-xs text-muted-foreground">Lädt...</p> : null}
{!loadingZammadQueue && zammadQueue.length === 0 ? <p className="text-xs text-muted-foreground">Keine geparkten Zammad-Notizen.</p> : null}
{zammadQueue.slice(0, 5).map((item) => (
<div key={item.id} className="rounded-md border bg-muted/30 p-2 text-xs">
<div className="flex flex-wrap items-center gap-x-2 gap-y-1">
<span className="font-medium">{item.ticket_number}</span>
<span className="text-muted-foreground">{formatDateTime(item.started_at)}</span>
<span className="text-muted-foreground">{formatMinutes(item.rounded_minutes)}</span>
<span className="text-muted-foreground">time_unit {item.time_unit}</span>
<span className="text-muted-foreground">{zammadArticleTypeLabel(item.zammad_article_type_id)}</span>
</div>
{item.last_error ? <p className="mt-1 line-clamp-2 text-destructive">{item.last_error}</p> : null}
</div>
))}
{zammadQueue.length > 5 ? <p className="text-xs text-muted-foreground">Weitere {zammadQueue.length - 5} Einträge werden beim Senden ebenfalls berücksichtigt.</p> : null}
</div>
</div>
</div>
) : null}
File diff suppressed because it is too large. Load diff
+296 -58
View File
@@ -1,12 +1,15 @@
import {
ChevronLeft,
ChevronRight,
BellPlus,
CircleAlert,
Clock3,
ExternalLink,
ListChecks,
RotateCcw,
Ticket,
TrendingUp,
UserCheck,
} from "lucide-react";
import type { LucideIcon } from "lucide-react";
import { useEffect, useMemo, useRef, useState } from "react";
@@ -19,13 +22,15 @@ import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/com
import { Input } from "@/components/ui/input";
import { Pagination, PaginationContent, PaginationItem, PaginationNext, PaginationPrevious } from "@/components/ui/pagination";
import { Progress } from "@/components/ui/progress";
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table";
import { HelpLink } from "@/components/HelpLink";
import { getStatisticsOverview } from "../api";
import { currentMonth, formatDate, formatMinutes } from "../format";
import type { StatisticsDailyBucket, StatisticsGroup, StatisticsOverview, StatisticsTicket, WorkType } from "../types";
import { getProjectFollowups, getStatisticsOverview } from "../api";
import { currentMonth, formatDate, formatDateTime, formatMinutes } from "../format";
import type { AuthUser, StatisticsDailyBucket, StatisticsGroup, StatisticsOverview, StatisticsProjectFollowup, StatisticsProjectFollowupOverview, StatisticsTicket, WorkType } from "../types";
type StatisticsPageProps = {
currentUser: AuthUser;
onNavigate: (to: string) => void;
};
@@ -36,6 +41,7 @@ const teamspaceStrokeClass = "text-fuchsia-600 dark:text-fuchsia-300";
const trackedDotClass = "bg-sky-500 dark:bg-sky-400";
const teamspaceDotClass = "bg-fuchsia-500 dark:bg-fuchsia-400";
const openTextClass = "text-amber-700 dark:text-amber-300";
const nonBillableTextClass = "text-indigo-700 dark:text-indigo-300";
const organizationPageSize = 8;
function workTypeLabel(workType: WorkType | undefined) {
@@ -104,7 +110,7 @@ function TimeComparison({ trackedMinutes, crmMinutes, sessions }: { trackedMinut
);
}
function ColorLegend() {
function ColorLegend({ showDifference = true }: { showDifference?: boolean }) {
return (
<div className="flex flex-wrap gap-x-4 gap-y-2 rounded-md border bg-muted/20 p-3 text-xs text-muted-foreground">
<span className="inline-flex items-center gap-1.5">
@@ -116,13 +122,25 @@ function ColorLegend() {
<span className={teamspaceTextClass}>Teamspace</span>
</span>
<span className="inline-flex items-center gap-1.5">
<span className="size-2 rounded-full bg-emerald-500 dark:bg-emerald-400" />
<span className="text-emerald-700 dark:text-emerald-300">Differenz plus oder ausgeglichen</span>
<span className="size-2 rounded-sm bg-slate-500 dark:bg-slate-400" />
<span>Abrechenbar</span>
</span>
<span className="inline-flex items-center gap-1.5">
<span className="size-2 rounded-full bg-red-500 dark:bg-red-400" />
<span className="text-red-700 dark:text-red-300">Differenz minus</span>
<span className="size-2 rounded-sm bg-indigo-500 dark:bg-indigo-400" />
<span className={nonBillableTextClass}>Nicht abrechenbar</span>
</span>
{showDifference ? (
<>
<span className="inline-flex items-center gap-1.5">
<span className="size-2 rounded-full bg-emerald-500 dark:bg-emerald-400" />
<span className="text-emerald-700 dark:text-emerald-300">Differenz plus oder ausgeglichen</span>
</span>
<span className="inline-flex items-center gap-1.5">
<span className="size-2 rounded-full bg-red-500 dark:bg-red-400" />
<span className="text-red-700 dark:text-red-300">Differenz minus</span>
</span>
</>
) : null}
<span className="inline-flex items-center gap-1.5">
<span className="size-2 rounded-full bg-amber-500 dark:bg-amber-400" />
<span className={openTextClass}>offen</span>
@@ -197,14 +215,14 @@ function buildMonthSeries(month: string, buckets: StatisticsDailyBucket[]) {
});
}
function DailyEffortChart({ month, buckets }: { month: string; buckets: StatisticsDailyBucket[] }) {
function DailyEffortChart({ month, buckets, showTeamspaceLine = true }: { month: string; buckets: StatisticsDailyBucket[]; showTeamspaceLine?: boolean }) {
const series = buildMonthSeries(month, buckets);
const width = 900;
const height = 220;
const padding = { top: 18, right: 20, bottom: 36, left: 64 };
const innerWidth = width - padding.left - padding.right;
const innerHeight = height - padding.top - padding.bottom;
const maxMinutes = niceCeilMinutes(Math.max(...series.map((bucket) => Math.max(bucket.totalMinutes, bucket.crmBilledMinutes)), 1));
const maxMinutes = niceCeilMinutes(Math.max(...series.map((bucket) => Math.max(bucket.totalMinutes, showTeamspaceLine ? bucket.crmBilledMinutes : 0)), 1));
const ticks = Array.from({ length: 5 }).map((_, index) => maxMinutes - (index * maxMinutes) / 4);
const labelStep = Math.max(1, Math.ceil(series.length / 9));
const barWidth = Math.max(5, Math.min(16, innerWidth / Math.max(series.length, 1) / 2));
@@ -218,11 +236,11 @@ function DailyEffortChart({ month, buckets }: { month: string; buckets: Statisti
crmY: padding.top + (1 - bucket.crmBilledMinutes / maxMinutes) * innerHeight
};
});
const crmPath = buildChartPath(points.filter((point) => point.bucket.crmBilledMinutes > 0).map((point) => ({ x: point.x, y: point.crmY })));
const crmPath = showTeamspaceLine ? buildChartPath(points.filter((point) => point.bucket.crmBilledMinutes > 0).map((point) => ({ x: point.x, y: point.crmY }))) : "";
return (
<div className="h-56 w-full overflow-hidden rounded-md border bg-background">
{series.some((bucket) => bucket.totalMinutes > 0 || bucket.crmBilledMinutes > 0) ? (
{series.some((bucket) => bucket.totalMinutes > 0 || (showTeamspaceLine && bucket.crmBilledMinutes > 0)) ? (
<svg viewBox={`0 0 ${width} ${height}`} className="h-full w-full">
{ticks.map((tick) => {
const y = padding.top + (1 - tick / maxMinutes) * innerHeight;
@@ -245,11 +263,11 @@ function DailyEffortChart({ month, buckets }: { month: string; buckets: Statisti
) : null;
})}
{crmPath ? <path d={crmPath} fill="none" stroke="currentColor" strokeWidth="2.5" className={teamspaceStrokeClass} /> : null}
{points
.filter((point) => point.bucket.crmBilledMinutes > 0)
.map((point) => (
<circle key={`${point.bucket.day}-crm`} cx={point.x} cy={point.crmY} r="3" className={`fill-background ${teamspaceStrokeClass}`} stroke="currentColor" strokeWidth="2" />
))}
{showTeamspaceLine ? points
.filter((point) => point.bucket.crmBilledMinutes > 0)
.map((point) => (
<circle key={`${point.bucket.day}-crm`} cx={point.x} cy={point.crmY} r="3" className={`fill-background ${teamspaceStrokeClass}`} stroke="currentColor" strokeWidth="2" />
)) : null}
{points.map((point, index) =>
index % labelStep === 0 || index === points.length - 1 ? (
<text key={`${point.bucket.day}-label`} x={point.x} y={height - 11} textAnchor="middle" className="fill-muted-foreground text-[11px]">
@@ -299,7 +317,17 @@ function MetricCard({
);
}
function OrganizationRow({ organization, maxMinutes, totalMinutes }: { organization: StatisticsGroup; maxMinutes: number; totalMinutes: number }) {
function OrganizationRow({
organization,
maxMinutes,
totalMinutes,
showDifference = true
}: {
organization: StatisticsGroup;
maxMinutes: number;
totalMinutes: number;
showDifference?: boolean;
}) {
const monthlyShare = percentage(organization.total_minutes, totalMinutes);
return (
@@ -307,16 +335,18 @@ function OrganizationRow({ organization, maxMinutes, totalMinutes }: { organizat
<TableCell className="max-w-[320px] whitespace-normal">
<div className="font-medium">{organization.organization_name ?? "Keine Organisation"}</div>
<div className="text-xs text-muted-foreground">
{organization.tickets} Ticket(s) · {organization.billed_sessions} abgerechnet
{organization.tickets} Ticket(s) · {organization.billed_sessions} abgerechnet · {organization.billable_sessions} abrechenbar
</div>
</TableCell>
<TableCell>{organization.billed_sessions}</TableCell>
<TableCell>
<TimeComparison trackedMinutes={organization.total_minutes} crmMinutes={organization.crm_billed_minutes} />
</TableCell>
<TableCell>
<DeltaBadge minutes={organization.crm_delta_minutes} />
</TableCell>
{showDifference ? (
<TableCell>
<DeltaBadge minutes={organization.crm_delta_minutes} />
</TableCell>
) : null}
<TableCell className="min-w-[150px]">
<Progress value={percentage(organization.total_minutes, maxMinutes)} />
<div className="mt-1 text-xs text-muted-foreground">{monthlyShare}% vom Monat</div>
@@ -325,7 +355,17 @@ function OrganizationRow({ organization, maxMinutes, totalMinutes }: { organizat
);
}
function TicketHotspot({ ticket, month, onNavigate }: { ticket: StatisticsTicket; month: string; onNavigate: (to: string) => void }) {
function TicketHotspot({
ticket,
month,
showDifference = true,
onNavigate
}: {
ticket: StatisticsTicket;
month: string;
showDifference?: boolean;
onNavigate: (to: string) => void;
}) {
return (
<div className="grid gap-2 rounded-md border bg-background p-3 sm:grid-cols-[1fr_auto] sm:items-center">
<div className="min-w-0">
@@ -338,8 +378,9 @@ function TicketHotspot({ ticket, month, onNavigate }: { ticket: StatisticsTicket
<span className={trackedTextClass}>Abgerechnet {formatMinutes(ticket.total_minutes)}</span>
<span className={teamspaceTextClass}>Teamspace {formatMinutes(ticket.crm_billed_minutes)}</span>
<span className="text-muted-foreground">{ticket.billed_sessions} abgerechnet</span>
<span className="text-muted-foreground">{ticket.billable_sessions} abrechenbar</span>
<span>{ticket.active_days} Tag(e)</span>
<span className={deltaTextClass(ticket.crm_delta_minutes)}>{formatTeamspaceDelta(ticket.crm_delta_minutes)}</span>
{showDifference ? <span className={deltaTextClass(ticket.crm_delta_minutes)}>{formatTeamspaceDelta(ticket.crm_delta_minutes)}</span> : null}
</div>
</div>
<Button variant="secondary" size="sm" onClick={() => onNavigate(`/tickets/${ticket.ticket_id}?month=${month}`)}>
@@ -350,12 +391,72 @@ function TicketHotspot({ ticket, month, onNavigate }: { ticket: StatisticsTicket
);
}
export function StatisticsPage({ onNavigate }: StatisticsPageProps) {
function daysSince(value: string) {
const then = new Date(value).getTime();
if (!Number.isFinite(then)) {
return null;
}
return Math.max(0, Math.floor((Date.now() - then) / 86_400_000));
}
function ProjectFollowupRow({ project, onNavigate }: { project: StatisticsProjectFollowup; onNavigate: (to: string) => void }) {
const inactiveDays = daysSince(project.latest_tt_update);
const hasBudget = project.hour_budget_minutes !== null;
return (
<div className="grid gap-3 rounded-md border bg-background p-3 lg:grid-cols-[minmax(0,1fr)_auto] lg:items-center">
<div className="min-w-0 space-y-2">
<div className="flex flex-wrap items-center gap-2">
<span className="font-semibold">{project.ticket_number}</span>
{hasBudget ? (
<Badge variant={project.remaining_minutes !== null && project.remaining_minutes > 0 ? "warning" : "secondary"}>
{project.remaining_minutes !== null && project.remaining_minutes > 0 ? `${formatMinutes(project.remaining_minutes)} offen` : "Budget verbraucht"}
</Badge>
) : (
<Badge variant="info">ohne Budget</Badge>
)}
{project.open_followup_todo_id ? <Badge variant="secondary">ToDo erstellt</Badge> : null}
{project.followup_state === "done" ? <Badge variant="success">erledigt</Badge> : null}
{project.followup_state === "dismissed" ? <Badge variant="outline">gelöscht</Badge> : null}
{project.overdue_todos > 0 ? <Badge variant="destructive">{project.overdue_todos} überfällig</Badge> : null}
</div>
<div className="min-w-0">
<p className="truncate text-sm">{project.title ?? project.teamspace_project ?? "Projekt ohne Titel"}</p>
<p className="truncate text-xs text-muted-foreground">{project.organization_name ?? "Keine Organisation"}</p>
</div>
<div className="flex flex-wrap gap-x-3 gap-y-1 text-xs text-muted-foreground">
<span>Letztes TT-Update {formatDateTime(project.latest_tt_update)}</span>
{inactiveDays !== null ? <span>{inactiveDays} Tag(e) inaktiv</span> : null}
<span>Budget {hasBudget ? formatMinutes(project.hour_budget_minutes!) : "nicht gesetzt"}</span>
<span>Verbraucht {formatMinutes(project.consumption_minutes)}</span>
<span>{project.open_todos} offene ToDo(s)</span>
</div>
</div>
<div className="flex flex-wrap gap-2 lg:justify-end">
<Button variant="secondary" size="sm" onClick={() => onNavigate(`/tickets/${project.ticket_id}?month=${currentMonth()}`)}>
Ticket
<ExternalLink className="size-4" />
</Button>
<Button variant="secondary" size="sm" onClick={() => onNavigate("/projects")}>
Projekte
<ExternalLink className="size-4" />
</Button>
</div>
</div>
);
}
export function StatisticsPage({ currentUser, onNavigate }: StatisticsPageProps) {
const [month, setMonth] = useState(currentMonth());
const [stats, setStats] = useState<StatisticsOverview | null>(null);
const [followups, setFollowups] = useState<StatisticsProjectFollowupOverview | null>(null);
const [loading, setLoading] = useState(false);
const [loadingFollowups, setLoadingFollowups] = useState(false);
const [organizationPage, setOrganizationPage] = useState(1);
const loadRequestId = useRef(0);
const followupRequestId = useRef(0);
async function load() {
const requestId = loadRequestId.current + 1;
@@ -385,6 +486,44 @@ export function StatisticsPage({ onNavigate }: StatisticsPageProps) {
void load();
}, [month]);
async function loadFollowups() {
const requestId = followupRequestId.current + 1;
followupRequestId.current = requestId;
setLoadingFollowups(true);
try {
const result = await getProjectFollowups();
if (requestId === followupRequestId.current) {
setFollowups(result);
if (result.createdTodos > 0 || result.updatedTodos > 0) {
window.dispatchEvent(new Event("tickettracker:todos-changed"));
}
if (result.createdTodos > 0) {
toast.success("Wiedervorlagen erstellt", {
description: `${result.createdTodos} ToDo(s) automatisch angelegt.`
});
}
}
} catch (error) {
if (requestId === followupRequestId.current) {
toast.error("Wiedervorlagen konnten nicht geladen werden", {
description: error instanceof Error ? error.message : "Unbekannter Fehler"
});
}
} finally {
if (requestId === followupRequestId.current) {
setLoadingFollowups(false);
}
}
}
useEffect(() => {
void loadFollowups();
}, []);
useEffect(() => {
function refreshVisible() {
if (document.visibilityState === "visible") {
@@ -411,10 +550,16 @@ export function StatisticsPage({ onNavigate }: StatisticsPageProps) {
}
const totals = stats?.totals;
const teamspaceTimeTrackingEnabled = currentUser.teamspace_time_tracking_enabled ?? true;
const billedSessions = totals?.billedSessions ?? 0;
const billedMinutes = totals?.billedMinutes ?? 0;
const billableSessions = totals?.billableSessions ?? 0;
const billableMinutes = totals?.billableMinutes ?? 0;
const nonBillableSessions = totals?.nonBillableSessions ?? 0;
const nonBillableMinutes = totals?.nonBillableMinutes ?? 0;
const openSessions = totals?.openSessions ?? 0;
const openMinutes = totals?.openMinutes ?? 0;
const evaluatedSessions = billedSessions + nonBillableSessions;
const crmCoverage = percentage(totals?.crmBilledMinutes ?? 0, totals?.minutes ?? 0);
const maxOrganizationMinutes = Math.max(...(stats?.organizations ?? []).map((organization) => organization.total_minutes), 1);
const topOrganization = stats?.organizations[0] ?? null;
@@ -441,7 +586,11 @@ export function StatisticsPage({ onNavigate }: StatisticsPageProps) {
<div className="flex flex-col gap-3 xl:flex-row xl:items-end xl:justify-between">
<div>
<h2 className="text-2xl font-semibold tracking-normal">Statistiken</h2>
<p className="text-sm text-muted-foreground">Monatswerte, Teamspace-Abgleich, Organisationen und offene Nacharbeit.</p>
<p className="text-sm text-muted-foreground">
{teamspaceTimeTrackingEnabled
? "Monatswerte, Teamspace-Abgleich, Organisationen und offene Nacharbeit."
: "Monatswerte, Session-Status, Organisationen und Teamspace-Istwerte."}
</p>
</div>
<div className="grid gap-1 sm:w-[300px]">
<div className="flex items-center justify-between gap-2">
@@ -460,7 +609,16 @@ export function StatisticsPage({ onNavigate }: StatisticsPageProps) {
</div>
</div>
<div className="grid gap-3 sm:grid-cols-2 xl:grid-cols-3">
<Tabs defaultValue="overview" className="space-y-5">
<TabsList className="grid h-auto w-full grid-cols-2 gap-1 sm:grid-cols-4">
<TabsTrigger value="overview">Überblick</TabsTrigger>
<TabsTrigger value="groups">Kunden & Typen</TabsTrigger>
<TabsTrigger value="tickets">Tickets</TabsTrigger>
<TabsTrigger value="followups">Wiedervorlagen</TabsTrigger>
</TabsList>
<TabsContent value="overview" className="space-y-5">
<div className="grid gap-3 sm:grid-cols-2 xl:grid-cols-4">
<MetricCard
label="Abgerechnet"
value={formatMinutes(totals?.minutes ?? 0)}
@@ -470,10 +628,20 @@ export function StatisticsPage({ onNavigate }: StatisticsPageProps) {
helpAnchor="statistik-getrackt"
helpLabel="Hilfe zur Kennzahl Abgerechnet"
/>
<MetricCard
label="Abrechenbar"
value={formatMinutes(billableMinutes)}
detail={`${billableSessions} Session(s)`}
icon={UserCheck}
helpAnchor="bewertungen"
helpLabel="Hilfe zu Bewertungen"
/>
<MetricCard
label="Teamspace"
value={formatMinutes(totals?.crmBilledMinutes ?? 0)}
detail={<span className={deltaTextClass(totals?.crmDeltaMinutes ?? 0)}>Differenz {formatTeamspaceDelta(totals?.crmDeltaMinutes ?? 0)}</span>}
detail={teamspaceTimeTrackingEnabled
? <span className={deltaTextClass(totals?.crmDeltaMinutes ?? 0)}>Differenz {formatTeamspaceDelta(totals?.crmDeltaMinutes ?? 0)}</span>
: "Ist-Werte aus Teamspace"}
icon={TrendingUp}
valueClassName={teamspaceTextClass}
helpAnchor="statistik-teamspace"
@@ -499,43 +667,59 @@ export function StatisticsPage({ onNavigate }: StatisticsPageProps) {
<CardHeader className="gap-3 p-4 sm:flex-row sm:items-start sm:justify-between sm:space-y-0">
<div>
<CardTitle>Monatsverlauf und Abrechnungsqualität</CardTitle>
<CardDescription>Abgerechnete Zeit pro Tag, Teamspace-Linie und Bewertungsstand in einem Überblick.</CardDescription>
<CardDescription>
{teamspaceTimeTrackingEnabled
? "Abgerechnete Zeit pro Tag, Teamspace-Linie und Bewertungsstand in einem Überblick."
: "Abgerechnete Zeit pro Tag und Bewertungsstand in einem Überblick."}
</CardDescription>
</div>
<div className="flex items-center gap-2">
<Badge variant="outline">{crmCoverage}% Teamspace-Abdeckung</Badge>
{teamspaceTimeTrackingEnabled ? <Badge variant="outline">{crmCoverage}% Teamspace-Abdeckung</Badge> : <Badge variant="outline">Teamspace als Ist-Quelle</Badge>}
<HelpLink anchor="statistik-verlauf" label="Hilfe zu Monatsverlauf und Abrechnungsqualität" />
</div>
</CardHeader>
<CardContent className="grid gap-4 px-4 pb-4 xl:grid-cols-[1.55fr_1fr]">
<div className="space-y-3">
<DailyEffortChart month={month} buckets={stats?.dailySeries ?? []} />
<ColorLegend />
{strongestDay ? <p className="text-xs text-muted-foreground">Stärkster abrechenbarer Tag: {formatDate(`${strongestDay.day}T00:00:00`)} mit {formatMinutes(strongestDay.total_minutes)}</p> : null}
<DailyEffortChart month={month} buckets={stats?.dailySeries ?? []} showTeamspaceLine={teamspaceTimeTrackingEnabled} />
<ColorLegend showDifference={teamspaceTimeTrackingEnabled} />
{strongestDay ? <p className="text-xs text-muted-foreground">Stärkster abgerechneter Tag: {formatDate(`${strongestDay.day}T00:00:00`)} mit {formatMinutes(strongestDay.total_minutes)}</p> : null}
</div>
<div className="space-y-4">
<div className="space-y-2 rounded-md border bg-muted/20 p-3">
<div className="flex items-center justify-between gap-3 text-sm">
<span className="text-muted-foreground">Bewertungsstand</span>
<span className="font-medium">{billedSessions} abrechenbar</span>
<span className="font-medium">{evaluatedSessions} bewertet</span>
</div>
<div className="grid gap-2 text-xs sm:grid-cols-2 xl:grid-cols-1 2xl:grid-cols-2">
<div className={trackedTextClass}>Abgerechnet: {billedSessions} Session(s), {formatMinutes(billedMinutes)}</div>
<div className="text-muted-foreground">Abrechenbar: {billableSessions} Session(s), {formatMinutes(billableMinutes)}</div>
<div className={nonBillableTextClass}>Nicht abrechenbar: {nonBillableSessions} Session(s), {formatMinutes(nonBillableMinutes)}</div>
<div className={openTextClass}>Offen: {openSessions} Session(s), {formatMinutes(openMinutes)}</div>
</div>
</div>
<div className="space-y-2 rounded-md border bg-muted/20 p-3">
<div className="flex items-start justify-between gap-3">
<div>
<p className="text-sm font-medium">Teamspace-Abgleich</p>
<p className="text-xs text-muted-foreground">{deltaDescription(totals?.crmDeltaMinutes ?? 0)}</p>
</div>
<DeltaBadge minutes={totals?.crmDeltaMinutes ?? 0} />
</div>
<TimeComparison trackedMinutes={totals?.minutes ?? 0} crmMinutes={totals?.crmBilledMinutes ?? 0} sessions={totals?.billedSessions ?? 0} />
<div className="text-xs text-muted-foreground">Teamspace-Abdeckung: {crmCoverage}% der abgerechneten Zeit</div>
</div>
{teamspaceTimeTrackingEnabled ? (
<div className="space-y-2 rounded-md border bg-muted/20 p-3">
<div className="flex items-start justify-between gap-3">
<div>
<p className="text-sm font-medium">Teamspace-Abgleich</p>
<p className="text-xs text-muted-foreground">{deltaDescription(totals?.crmDeltaMinutes ?? 0)}</p>
</div>
<DeltaBadge minutes={totals?.crmDeltaMinutes ?? 0} />
</div>
<TimeComparison trackedMinutes={totals?.minutes ?? 0} crmMinutes={totals?.crmBilledMinutes ?? 0} sessions={totals?.billedSessions ?? 0} />
<div className="text-xs text-muted-foreground">Teamspace-Abdeckung: {crmCoverage}% der abgerechneten Zeit</div>
</div>
) : (
<div className="space-y-2 rounded-md border bg-muted/20 p-3">
<p className="text-sm font-medium">Teamspace als Ist-Quelle</p>
<p className="text-xs text-muted-foreground">
Für diesen Nutzer werden keine Teamspace-Zeiten in TT erfasst. Die Monatsprüfung bewertet nur den Session-Status.
</p>
<TimeComparison trackedMinutes={totals?.minutes ?? 0} crmMinutes={totals?.crmBilledMinutes ?? 0} sessions={totals?.billedSessions ?? 0} />
</div>
)}
<div className="grid grid-cols-2 gap-2 text-sm">
<div className="rounded-md border bg-muted/20 p-3">
@@ -571,12 +755,19 @@ export function StatisticsPage({ onNavigate }: StatisticsPageProps) {
</CardContent>
</Card>
</TabsContent>
<TabsContent value="groups" className="space-y-5">
<div className="grid gap-3 xl:grid-cols-[1.45fr_0.8fr]">
<Card>
<CardHeader className="gap-3 p-4 sm:flex-row sm:items-start sm:justify-between sm:space-y-0">
<div>
<CardTitle>Statistik pro Organisation</CardTitle>
<CardDescription>Kundenaufwand inklusive Teamspace-Differenz und Anteil an der abgerechneten Monatszeit.</CardDescription>
<CardDescription>
{teamspaceTimeTrackingEnabled
? "Kundenaufwand inklusive Teamspace-Differenz und Anteil an der abgerechneten Monatszeit."
: "Kundenaufwand und Anteil an der abgerechneten Monatszeit."}
</CardDescription>
</div>
<div className="flex items-center gap-2">
<Badge variant="outline">
@@ -593,7 +784,7 @@ export function StatisticsPage({ onNavigate }: StatisticsPageProps) {
<TableHead>Organisation</TableHead>
<TableHead>Abgerechnet</TableHead>
<TableHead>Zeiten</TableHead>
<TableHead>Differenz</TableHead>
{teamspaceTimeTrackingEnabled ? <TableHead>Differenz</TableHead> : null}
<TableHead>Anteil abgerechnet</TableHead>
</TableRow>
</TableHeader>
@@ -601,10 +792,11 @@ export function StatisticsPage({ onNavigate }: StatisticsPageProps) {
{visibleOrganizations.map((organization) => (
<OrganizationRow
key={organization.organization_id ?? organization.organization_name}
organization={organization}
maxMinutes={maxOrganizationMinutes}
totalMinutes={totals?.minutes ?? 0}
/>
organization={organization}
maxMinutes={maxOrganizationMinutes}
totalMinutes={totals?.minutes ?? 0}
showDifference={teamspaceTimeTrackingEnabled}
/>
))}
</TableBody>
</Table>
@@ -615,16 +807,16 @@ export function StatisticsPage({ onNavigate }: StatisticsPageProps) {
<div className="flex items-start justify-between gap-2">
<div className="min-w-0">
<p className="truncate font-medium">{organization.organization_name ?? "Keine Organisation"}</p>
<p className="text-xs text-muted-foreground">{organization.tickets} Ticket(s) · {organization.billed_sessions} abgerechnet</p>
<p className="text-xs text-muted-foreground">{organization.tickets} Ticket(s) · {organization.billed_sessions} abgerechnet · {organization.billable_sessions} abrechenbar</p>
</div>
<DeltaBadge minutes={organization.crm_delta_minutes} />
{teamspaceTimeTrackingEnabled ? <DeltaBadge minutes={organization.crm_delta_minutes} /> : null}
</div>
<Progress value={percentage(organization.total_minutes, maxOrganizationMinutes)} />
<div className="flex flex-wrap gap-x-3 gap-y-1 text-xs">
<span className={trackedTextClass}>Abgerechnet {formatMinutes(organization.total_minutes)}</span>
<span className={teamspaceTextClass}>Teamspace {formatMinutes(organization.crm_billed_minutes)}</span>
<span className="text-muted-foreground">{percentage(organization.total_minutes, totals?.minutes ?? 0)}% vom Monat</span>
<span className={deltaTextClass(organization.crm_delta_minutes)}>{formatTeamspaceDelta(organization.crm_delta_minutes)}</span>
{teamspaceTimeTrackingEnabled ? <span className={deltaTextClass(organization.crm_delta_minutes)}>{formatTeamspaceDelta(organization.crm_delta_minutes)}</span> : null}
</div>
</div>
))}
@@ -684,17 +876,18 @@ export function StatisticsPage({ onNavigate }: StatisticsPageProps) {
<div className="flex items-center justify-between gap-3">
<div>
<p className="font-semibold">{workTypeLabel(group.work_type)}</p>
<p className="text-xs text-muted-foreground">{group.tickets} Ticket(s), {group.billed_sessions} abgerechnet</p>
<p className="text-xs text-muted-foreground">{group.tickets} Ticket(s), {group.billed_sessions} abgerechnet, {group.billable_sessions} abrechenbar</p>
</div>
<DeltaBadge minutes={group.crm_delta_minutes} />
{teamspaceTimeTrackingEnabled ? <DeltaBadge minutes={group.crm_delta_minutes} /> : null}
</div>
<Progress value={percentage(group.total_minutes, totals?.minutes ?? 0)} />
<div className="flex flex-wrap gap-x-3 gap-y-1 text-xs">
<span className={trackedTextClass}>Abgerechnet {formatMinutes(group.total_minutes)}</span>
<span className={teamspaceTextClass}>Teamspace {formatMinutes(group.crm_billed_minutes)}</span>
</div>
<div className="grid grid-cols-2 gap-2 text-xs text-muted-foreground">
<div className="grid gap-2 text-xs text-muted-foreground sm:grid-cols-3">
<span>Abr. {group.billed_sessions} / {formatMinutes(group.billed_minutes)}</span>
<span>Abrechb. {group.billable_sessions} / {formatMinutes(group.billable_minutes)}</span>
<span>Offen {group.open_sessions} / {formatMinutes(group.open_minutes)}</span>
</div>
</div>
@@ -704,6 +897,9 @@ export function StatisticsPage({ onNavigate }: StatisticsPageProps) {
</Card>
</div>
</TabsContent>
<TabsContent value="tickets" className="space-y-5">
<Card>
<CardHeader className="gap-3 p-4 sm:flex-row sm:items-start sm:justify-between sm:space-y-0">
<div>
@@ -720,7 +916,7 @@ export function StatisticsPage({ onNavigate }: StatisticsPageProps) {
</CardHeader>
<CardContent className="space-y-2 px-4 pb-4">
{(stats?.tickets ?? []).map((ticket) => (
<TicketHotspot key={ticket.ticket_id} ticket={ticket} month={month} onNavigate={onNavigate} />
<TicketHotspot key={ticket.ticket_id} ticket={ticket} month={month} showDifference={teamspaceTimeTrackingEnabled} onNavigate={onNavigate} />
))}
{stats && stats.tickets.length === 0 ? <p className="py-8 text-center text-sm text-muted-foreground">Keine Tickets im gewählten Monat.</p> : null}
</CardContent>
@@ -741,6 +937,48 @@ export function StatisticsPage({ onNavigate }: StatisticsPageProps) {
</CardContent>
</Card>
) : null}
</TabsContent>
<TabsContent value="followups" className="space-y-5">
<Card>
<CardHeader className="gap-3 p-4 sm:flex-row sm:items-start sm:justify-between sm:space-y-0">
<div>
<CardTitle>Automatische Wiedervorlagen</CardTitle>
<CardDescription>
{followups?.enabled === false
? "Automatische Wiedervorlagen sind im Profil deaktiviert."
: followups?.secondEnabled === false
? `Erste Wiedervorlage nach ${followups?.weeks ?? "-"} Woche(n).`
: `Erste Wiedervorlage nach ${followups?.weeks ?? "-"} Woche(n), zweite nach weiteren ${followups?.secondWeeks ?? "-"} Woche(n) ohne Session.`}
</CardDescription>
</div>
<div className="flex items-center gap-2">
<Badge variant="outline">{followups?.projects.length ?? 0} Projekt(e)</Badge>
{loadingFollowups ? <Badge variant="secondary">lädt...</Badge> : null}
<Button type="button" size="sm" variant="secondary" onClick={() => void loadFollowups()} disabled={loadingFollowups}>
<BellPlus className="size-4" />
Prüfen
</Button>
</div>
</CardHeader>
<CardContent className="space-y-3 px-4 pb-4">
{(followups?.projects ?? []).map((project) => (
<ProjectFollowupRow key={project.project_id} project={project} onNavigate={onNavigate} />
))}
{!loadingFollowups && followups && followups.projects.length === 0 ? (
<div className="grid place-items-center gap-2 rounded-md border bg-muted/20 p-8 text-center">
<ListChecks className="size-8 text-muted-foreground" />
<div>
<p className="font-medium">Keine Wiedervorlagen nötig</p>
<p className="text-sm text-muted-foreground">Alle offenen Projektbudgets wurden innerhalb des eingestellten Zeitraums aktualisiert.</p>
</div>
</div>
) : null}
{loadingFollowups && !followups ? <p className="py-8 text-center text-sm text-muted-foreground">Wiedervorlagen werden geprüft...</p> : null}
</CardContent>
</Card>
</TabsContent>
</Tabs>
</div>
);
}
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
+58 -35
View File
@@ -21,6 +21,7 @@ type TodosPageProps = {
type TodoSortMode = "custom" | "priority" | "title" | "ticket" | "organization" | "date" | "updated";
type TodoGroupMode = "ticket" | "priority" | "organization" | "status";
type CalendarDayMode = "current";
type TodoPreferences = {
status: TodoStatus | "all";
@@ -277,6 +278,23 @@ function sortTodos(todos: TicketTodo[], sortMode: TodoSortMode) {
return [...todos].sort((left, right) => compareTodos(left, right, sortMode));
}
function uniqueTodos(todos: TicketTodo[]) {
return todos.filter((todo, index, list) => list.findIndex((item) => item.id === todo.id) === index);
}
function sortCurrentTodos(todos: TicketTodo[], today: string) {
return [...todos].sort((left, right) => {
const leftOverdue = isTodoOverdue(left, today);
const rightOverdue = isTodoOverdue(right, today);
if (leftOverdue !== rightOverdue) {
return leftOverdue ? -1 : 1;
}
return priorityOrder[left.priority] - priorityOrder[right.priority] || left.sort_order - right.sort_order || compareText(left.title, right.title);
});
}
function matchesTicketSearch(todo: TicketTodo, search: string) {
const normalizedSearch = normalizeSearch(search);
@@ -400,9 +418,9 @@ export function TodosPage({ onNavigate }: TodosPageProps) {
const [modalEndsOn, setModalEndsOn] = useState("");
const [modalBusy, setModalBusy] = useState(false);
const [selectedCalendarDay, setSelectedCalendarDay] = useState<string | null>(null);
const [selectedCalendarDayMode, setSelectedCalendarDayMode] = useState<"summarized" | "overdue">("summarized");
const [selectedCalendarDayMode, setSelectedCalendarDayMode] = useState<CalendarDayMode>("current");
const [returnCalendarDay, setReturnCalendarDay] = useState<string | null>(null);
const [returnCalendarDayMode, setReturnCalendarDayMode] = useState<"summarized" | "overdue">("summarized");
const [returnCalendarDayMode, setReturnCalendarDayMode] = useState<CalendarDayMode>("current");
async function load() {
setLoading(true);
@@ -422,6 +440,13 @@ export function TodosPage({ onNavigate }: TodosPageProps) {
void load();
}, []);
useEffect(() => {
const onTodosChanged = () => void load();
window.addEventListener("tickettracker:todos-changed", onTodosChanged);
return () => window.removeEventListener("tickettracker:todos-changed", onTodosChanged);
}, []);
useEffect(() => {
window.localStorage.setItem(todoPreferencesKey, JSON.stringify(preferences));
}, [preferences]);
@@ -432,7 +457,7 @@ export function TodosPage({ onNavigate }: TodosPageProps) {
if (selectedTodoId && !selectedTodo) {
setSelectedTodoId(null);
setReturnCalendarDay(null);
setReturnCalendarDayMode("summarized");
setReturnCalendarDayMode("current");
}
}, [selectedTodo, selectedTodoId]);
@@ -473,7 +498,19 @@ export function TodosPage({ onNavigate }: TodosPageProps) {
return entries;
}, [calendarDays, todos]);
const selectedCalendarDayTodos = selectedCalendarDay ? calendarTodosByDay.get(selectedCalendarDay)?.[selectedCalendarDayMode] ?? [] : [];
const selectedCalendarDayTodos = useMemo(() => {
if (!selectedCalendarDay) {
return [];
}
const dayTodos = calendarTodosByDay.get(selectedCalendarDay);
if (!dayTodos) {
return [];
}
return sortCurrentTodos(uniqueTodos([...dayTodos.overdue, ...dayTodos.single, ...dayTodos.summarized]), currentDay());
}, [calendarTodosByDay, selectedCalendarDay]);
const counts = useMemo(
() => ({
open: todos.filter((todo) => todo.status === "open").length,
@@ -531,7 +568,7 @@ export function TodosPage({ onNavigate }: TodosPageProps) {
});
}
function openTodoModal(todo: TicketTodo, returnToDay: string | null = null, returnToDayMode: "summarized" | "overdue" = "summarized") {
function openTodoModal(todo: TicketTodo, returnToDay: string | null = null, returnToDayMode: CalendarDayMode = "current") {
setReturnCalendarDay(returnToDay);
setReturnCalendarDayMode(returnToDayMode);
setSelectedTodoId(todo.id);
@@ -545,7 +582,7 @@ export function TodosPage({ onNavigate }: TodosPageProps) {
function closeTodoModal() {
setSelectedTodoId(null);
setReturnCalendarDay(null);
setReturnCalendarDayMode("summarized");
setReturnCalendarDayMode("current");
}
function backToCalendarDay() {
@@ -557,7 +594,7 @@ export function TodosPage({ onNavigate }: TodosPageProps) {
const mode = returnCalendarDayMode;
setSelectedTodoId(null);
setReturnCalendarDay(null);
setReturnCalendarDayMode("summarized");
setReturnCalendarDayMode("current");
setSelectedCalendarDayMode(mode);
setSelectedCalendarDay(day);
}
@@ -784,7 +821,7 @@ export function TodosPage({ onNavigate }: TodosPageProps) {
</div>
<HelpLink anchor="todos" label="Hilfe zu ToDos" />
</div>
<div className="grid gap-3 pt-2 text-sm lg:grid-cols-[minmax(180px,1fr)_150px_190px_auto] lg:items-end">
<div className="grid gap-3 pt-2 text-sm md:grid-cols-2 xl:grid-cols-[minmax(180px,1fr)_150px_190px_140px] xl:items-end">
<div className="space-y-1.5">
<label className="text-xs font-medium text-muted-foreground" htmlFor="todo-ticket-search">
Ticket
@@ -904,6 +941,9 @@ export function TodosPage({ onNavigate }: TodosPageProps) {
const summarizedTodos = dayTodos.summarized;
const overdueTodos = dayTodos.overdue;
const totalTodos = singleTodos.length + summarizedTodos.length + overdueTodos.length;
const currentTodos = sortCurrentTodos(uniqueTodos([...overdueTodos, ...singleTodos, ...summarizedTodos]), currentDay());
const visibleCalendarTodos = currentTodos.slice(0, 2);
const additionalTodosCount = Math.max(0, currentTodos.length - visibleCalendarTodos.length);
return (
<div
@@ -918,7 +958,7 @@ export function TodosPage({ onNavigate }: TodosPageProps) {
</div>
{!day.workingDay ? <div className="text-[10px] leading-tight text-muted-foreground">{day.holidayName ?? "Wochenende"}</div> : null}
<div className="space-y-1">
{singleTodos.slice(0, 3).map((todo) => (
{visibleCalendarTodos.map((todo) => (
<button
key={todo.id}
type="button"
@@ -929,31 +969,18 @@ export function TodosPage({ onNavigate }: TodosPageProps) {
<span className="block truncate text-muted-foreground">{todo.ticket_number ?? "Ticket"}</span>
</button>
))}
{singleTodos.length > 3 ? <span className="block px-1 text-[11px] text-muted-foreground">+{singleTodos.length - 3} weitere fixe</span> : null}
</div>
<div className="mt-auto flex flex-wrap gap-1 pt-1">
{summarizedTodos.length > 0 ? (
<div className="mt-auto pt-1">
{additionalTodosCount > 0 ? (
<button
type="button"
className="min-w-0 flex-1 rounded-md border border-muted-foreground/20 bg-background/60 px-2 py-1 text-left text-[11px] leading-tight text-muted-foreground hover:bg-muted"
className="block w-full rounded-md border border-muted-foreground/20 bg-background/60 px-2 py-1 text-left text-[11px] leading-tight text-muted-foreground hover:bg-muted"
onClick={() => {
setSelectedCalendarDayMode("summarized");
setSelectedCalendarDayMode("current");
setSelectedCalendarDay(day.iso);
}}
>
+{summarizedTodos.length} ToDo{summarizedTodos.length === 1 ? "" : "s"}
</button>
) : null}
{overdueTodos.length > 0 ? (
<button
type="button"
className="shrink-0 rounded-md border border-red-500/50 bg-red-500/10 px-2 py-1 text-left text-[11px] font-semibold leading-tight text-red-200 hover:bg-red-500/20"
onClick={() => {
setSelectedCalendarDayMode("overdue");
setSelectedCalendarDay(day.iso);
}}
>
+{overdueTodos.length} üf
+{additionalTodosCount} weitere ToDo{additionalTodosCount === 1 ? "" : "s"}
</button>
) : null}
</div>
@@ -1073,13 +1100,11 @@ export function TodosPage({ onNavigate }: TodosPageProps) {
<Dialog open={Boolean(selectedCalendarDay)} onOpenChange={(open) => !open && setSelectedCalendarDay(null)}>
<DialogContent className="max-h-[calc(100dvh-2rem)] overflow-y-auto sm:max-w-xl">
<DialogHeader>
<DialogTitle>{selectedCalendarDayMode === "overdue" ? "Überfällige ToDos" : "ToDos am Tag"}</DialogTitle>
<DialogTitle>Aktuelle ToDos</DialogTitle>
<DialogDescription>
{selectedCalendarDay
? `${formatTodoDate(selectedCalendarDay)} · ${selectedCalendarDayTodos.length} ${selectedCalendarDayMode === "overdue" ? "überfällige" : "laufende"} ToDo(s)`
: selectedCalendarDayMode === "overdue"
? "Überfällige ToDos dieses Tages"
: "Laufende ToDos dieses Tages"}
? `${formatTodoDate(selectedCalendarDay)} · ${selectedCalendarDayTodos.length} aktuelle ToDo(s)`
: "Aktuelle ToDos dieses Tages"}
</DialogDescription>
</DialogHeader>
<div className="space-y-2">
@@ -1142,9 +1167,7 @@ export function TodosPage({ onNavigate }: TodosPageProps) {
</div>
))}
{selectedCalendarDayTodos.length === 0 ? (
<p className="rounded-md border bg-muted/20 p-4 text-center text-sm text-muted-foreground">
{selectedCalendarDayMode === "overdue" ? "Keine überfälligen ToDos an diesem Tag." : "Keine laufenden ToDos an diesem Tag."}
</p>
<p className="rounded-md border bg-muted/20 p-4 text-center text-sm text-muted-foreground">Keine aktuellen ToDos an diesem Tag.</p>
) : null}
</div>
</DialogContent>
File diff suppressed because it is too large. Load diff
+24
View File
@@ -0,0 +1,24 @@
export const zammadArticleTypeOptions = [
{ value: "4", label: "Dienstleistung" },
{ value: "1", label: "Koordination, Kommunikation und Dokumentation" },
{ value: "6", label: "Nicht kategorisiert" },
{ value: "2", label: "Schulungen, Workshops und Meetings" },
{ value: "5", label: "Support" },
{ value: "3", label: "Vor- und Nacharbeiten" }
] as const;
export type ZammadArticleTypeId = number;
export function zammadArticleTypeValue(typeId: ZammadArticleTypeId | null | undefined) {
return String(typeId ?? 6);
}
export function zammadArticleTypeFromValue(value: string): ZammadArticleTypeId {
return Number(value || 6);
}
export function zammadArticleTypeLabel(typeId: ZammadArticleTypeId | null | undefined) {
const value = zammadArticleTypeValue(typeId);
return zammadArticleTypeOptions.find((option) => option.value === value)?.label ?? "Nicht kategorisiert";
}
+154
View File
@@ -0,0 +1,154 @@
import { AlertTriangle, ArrowDown, ArrowUp, CheckCircle2, CircleDot, CirclePause, Flag, Minus } from "lucide-react";
import { Badge } from "@/components/ui/badge";
import { cn } from "@/lib/utils";
export type ZammadStateFilter = "all" | "none" | "2" | "3" | "4" | "7";
export type ZammadPriorityFilter = "all" | "none" | "1" | "2" | "3";
export const zammadStateFilterOptions: Array<{ value: ZammadStateFilter; label: string }> = [
{ value: "all", label: "Alle Zammad-Status" },
{ value: "2", label: "Offen" },
{ value: "3", label: "Wartend" },
{ value: "4", label: "Geschlossen" },
{ value: "7", label: "Abschluss" },
{ value: "none", label: "Ohne Zammad-Status" }
];
export const zammadPriorityFilterOptions: Array<{ value: ZammadPriorityFilter; label: string }> = [
{ value: "all", label: "Alle Prioritäten" },
{ value: "1", label: "Niedrig" },
{ value: "2", label: "Normal" },
{ value: "3", label: "Hoch" },
{ value: "none", label: "Ohne Priorität" }
];
const zammadStateMeta = {
"2": {
label: "Offen",
order: 10,
className: "border-emerald-500/30 bg-emerald-500/10 text-emerald-700 dark:text-emerald-300",
Icon: CircleDot
},
"3": {
label: "Wartend",
order: 20,
className: "border-blue-500/30 bg-blue-500/10 text-blue-700 dark:text-blue-300",
Icon: CirclePause
},
"7": {
label: "Abschluss",
order: 30,
className: "border-amber-500/30 bg-amber-500/10 text-amber-700 dark:text-amber-300",
Icon: Flag
},
"4": {
label: "Geschlossen",
order: 40,
className: "border-slate-500/30 bg-slate-500/10 text-slate-700 dark:text-slate-300",
Icon: CheckCircle2
}
};
const zammadPriorityMeta = {
"1": {
label: "Niedrig",
order: 10,
className: "border-blue-500/30 bg-blue-500/10 text-blue-700 dark:text-blue-300",
Icon: ArrowDown
},
"2": {
label: "Normal",
order: 20,
className: "border-emerald-500/30 bg-emerald-500/10 text-emerald-700 dark:text-emerald-300",
Icon: Minus
},
"3": {
label: "Hoch",
order: 30,
className: "border-red-500/30 bg-red-500/10 text-red-700 dark:text-red-300",
Icon: ArrowUp
}
};
export function zammadId(value: unknown) {
if (value === null || value === undefined || value === "") {
return null;
}
const normalized = String(value).trim();
return /^\d+$/.test(normalized) ? normalized.replace(/^0+(?=\d)/, "") : normalized || null;
}
export function zammadStateId(value: unknown) {
const id = zammadId(value);
return id === "1" ? "2" : id;
}
export function zammadStateLabel(value: unknown) {
const id = zammadStateId(value);
return id ? zammadStateMeta[id as keyof typeof zammadStateMeta]?.label ?? `Status ${id}` : "-";
}
export function zammadPriorityLabel(value: unknown) {
const id = zammadId(value);
return id ? zammadPriorityMeta[id as keyof typeof zammadPriorityMeta]?.label ?? `Priorität ${id}` : "-";
}
export function zammadStateSortRank(value: unknown) {
const id = zammadStateId(value);
const fallback = id ? Number(id) : Number.NaN;
return id ? zammadStateMeta[id as keyof typeof zammadStateMeta]?.order ?? (Number.isFinite(fallback) ? 900 + fallback : 999) : 999;
}
export function zammadPrioritySortRank(value: unknown) {
const id = zammadId(value);
const fallback = id ? Number(id) : Number.NaN;
return id ? zammadPriorityMeta[id as keyof typeof zammadPriorityMeta]?.order ?? (Number.isFinite(fallback) ? 900 + fallback : 999) : 999;
}
export function matchesZammadStateFilter(value: unknown, filter: ZammadStateFilter) {
const id = zammadStateId(value);
return filter === "all" || (filter === "none" ? !id : id === filter);
}
export function matchesZammadPriorityFilter(value: unknown, filter: ZammadPriorityFilter) {
const id = zammadId(value);
return filter === "all" || (filter === "none" ? !id : id === filter);
}
export function ZammadStateBadge({ stateId, className }: { stateId: unknown; className?: string }) {
const id = zammadStateId(stateId);
if (!id) {
return null;
}
const meta = zammadStateMeta[id as keyof typeof zammadStateMeta];
const Icon = meta?.Icon ?? AlertTriangle;
return (
<Badge variant="outline" className={cn(meta?.className ?? "border-border bg-muted/40 text-muted-foreground", className)}>
<Icon className="size-3" />
{meta?.label ?? `Status ${id}`}
</Badge>
);
}
export function ZammadPriorityBadge({ priorityId, className }: { priorityId: unknown; className?: string }) {
const id = zammadId(priorityId);
if (!id) {
return null;
}
const meta = zammadPriorityMeta[id as keyof typeof zammadPriorityMeta];
const Icon = meta?.Icon ?? AlertTriangle;
return (
<Badge variant="outline" className={cn(meta?.className ?? "border-border bg-muted/40 text-muted-foreground", className)}>
<Icon className="size-3" />
{meta?.label ?? `Priorität ${id}`}
</Badge>
);
}
Executable
+91
View File
@@ -0,0 +1,91 @@
#!/usr/bin/env bash
# Holt alle Zammad-Articles der letzten X Tage, gefiltert nach type_id und created_by_id.
#
# Aufruf: ZAMMAD_TOKEN=xxx ./zammad_articles.sh [TAGE] [CREATED_BY_ID] [TYPE_ID]
# Beispiel: ZAMMAD_TOKEN=xxx ./zammad_articles.sh 2 1764 1 > mails.json
#
# Voraussetzungen: curl, jq, API-Token mit Admin-Rechten (für /ticket_articles)
set -euo pipefail
BASE_URL="${ZAMMAD_URL:-https://aikava.zammad.com}"
TOKEN="${ZAMMAD_TOKEN:?Bitte ZAMMAD_TOKEN setzen}"
DAYS="${1:-2}"
CREATED_BY="${2:-1764}"
TYPE_ID="${3:-1}"
PER_PAGE=1000
MAX_PAGE=1000000 # Schutz gegen Endlosschleifen
# Call-Zähler über eine Temp-Datei, da fetch_page oft in $(...) läuft
CALLS_FILE=$(mktemp)
trap 'rm -f "$CALLS_FILE"' EXIT
calls() { wc -l < "$CALLS_FILE" | tr -d ' '; }
# Stichtag in UTC (GNU date oder BSD/macOS date)
# CALENDAR=1: ab lokaler Mitternacht vor (TAGE-1) Tagen, also TAGE=2 -> gestern 00:00 bis jetzt
# sonst: rollierend, jetzt minus TAGE*24h
if date -u -d "now" >/dev/null 2>&1; then
if [ "${CALENDAR:-0}" = "1" ]; then
TS=$(date -d "$((DAYS - 1)) days ago 00:00" +%s)
else
TS=$(date -d "${DAYS} days ago" +%s)
fi
CUTOFF=$(date -u -d "@${TS}" +%Y-%m-%dT%H:%M:%S)
else
if [ "${CALENDAR:-0}" = "1" ]; then
TS=$(date -v-"$((DAYS - 1))"d -v0H -v0M -v0S +%s)
else
TS=$(date -v-"${DAYS}"d +%s)
fi
CUTOFF=$(date -u -r "${TS}" +%Y-%m-%dT%H:%M:%S)
fi
log() { echo "$*" >&2; }
fetch_page() {
echo "$1" >> "$CALLS_FILE"
curl -sf -H "Authorization: Token token=${TOKEN}" \
"${BASE_URL}/api/v1/ticket_articles?page=$1&per_page=${PER_PAGE}"
}
page_len() { fetch_page "$1" | jq 'length'; }
log "Stichtag: ${CUTOFF}Z | created_by_id=${CREATED_BY} | type_id=${TYPE_ID}"
# 1) Letzte nicht-leere Seite per Binärsuche finden
if [ "$(page_len 1)" -eq 0 ]; then
log "Keine Articles gefunden. (API-Calls: $(calls))"
echo "[]"
exit 0
fi
lo=1; hi=2
while [ "$hi" -le "$MAX_PAGE" ] && [ "$(page_len "$hi")" -gt 0 ]; do
lo=$hi; hi=$((hi * 2))
done
while [ $((hi - lo)) -gt 1 ]; do
mid=$(( (lo + hi) / 2 ))
if [ "$(page_len "$mid")" -gt 0 ]; then lo=$mid; else hi=$mid; fi
done
SEARCH_CALLS=$(calls)
log "Letzte Seite: ${lo} (Binärsuche: ${SEARCH_CALLS} Calls)"
# 2) Rückwärts lesen bis zum Stichtag und filtern
results="[]"
p=$lo
while [ "$p" -ge 1 ]; do
batch=$(fetch_page "$p")
matches=$(jq --arg c "$CUTOFF" --argjson u "$CREATED_BY" --argjson t "$TYPE_ID" \
'[.[] | select(.created_at >= $c and .type_id == $t and .created_by_id == $u)]' <<<"$batch")
results=$(jq -s 'add' <(echo "$results") <(echo "$matches"))
oldest=$(jq -r '.[0].created_at // empty' <<<"$batch")
log "Seite ${p}: $(jq 'length' <<<"$matches") Treffer (ältester Article: ${oldest})"
[[ -z "$oldest" || "$oldest" < "$CUTOFF" ]] && break
p=$((p - 1))
done
TOTAL_CALLS=$(calls)
log "Gesamt: $(jq 'length' <<<"$results") Articles"
log "API-Calls: ${TOTAL_CALLS} (Binärsuche: ${SEARCH_CALLS}, Rückwärts lesen: $((TOTAL_CALLS - SEARCH_CALLS)))"
jq 'sort_by(.id)' <<<"$results"
+37
View File
@@ -0,0 +1,37 @@
[
{
"id": 66368,
"ticket_id": 3122,
"type_id": 1,
"sender_id": 1,
"from": "XX",
"to": "XX",
"cc": "XX",
"subject": "XX",
"reply_to": null,
"message_id": "XX",
"message_id_md5": "XX",
"in_reply_to": "XX",
"content_type": "text/html",
"body": "",
"internal": false,
"preferences": {
"subtype": "reply",
"email_address_id": 7,
"delivery_retry": 1,
"delivery_channel_id": 24,
"delivery_status_message": null,
"delivery_status": "success",
"delivery_status_date": "2026-09-25T10:55:51.214Z"
},
"updated_by_id": 77,
"created_by_id": 77,
"origin_by_id": null,
"created_at": "2026-09-25T10:55:48.201Z",
"updated_at": "2026-09-25T10:55:51.215Z",
"detected_language": null,
"ai_stored_result_ids": [],
"attachments": [],
"body_rendering_error": false
}
]
+679
View File
@@ -0,0 +1,679 @@
Richtung out
URL
http://192.168.42.169:3911/api/zammad/email-session-webhook
Methode
POST
Status
0
Anfrage
accept-encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3
accept: */*
user-agent: Zammad User Agent
host: 192.168.42.169:3911
x-zammad-trigger: Tickettracker Test
x-zammad-delivery: ef364583-36b3-40f3-bacb-967a09e7ddae
content-type: application/json; charset=utf-8
Authorization: Bearer [FILTERED]@ySW3uTFKjGFMrti8BcDkNv8mN2g71...[TRUNCATED]
{
"ticket": {
"abgerechnet": "",
"ai_agent_running": false,
"ai_stored_result_ids": [],
"ai_stored_results": [],
"article_count": 13,
"article_ids": [
66138,
66151,
66152,
66139,
66141,
66145,
66144,
66146,
66130,
66149,
66131,
66150,
66133
],
"atc_version": "-",
"bemerkung": "",
"bestellnummer": "",
"checklist_id": null,
"close_at": null,
"close_diff_in_min": null,
"close_escalation_at": null,
"close_in_min": null,
"create_article_sender": "Customer",
"create_article_sender_id": 2,
"create_article_type": "phone",
"create_article_type_id": 5,
"created_at": "2026-09-22T14:56:23.929Z",
"created_by": {
"active": true,
"address": "",
"city": "",
"country": "",
"created_at": "2025-03-31T08:14:45.514Z",
"created_by": "marco.christener@aikava.de",
"created_by_id": 3,
"department": "Senior Software Consultant",
"email": "michael.boehmlaender@aikava.de",
"fax": "",
"firstname": "Michael",
"id": 1764,
"image": "facb8844175ddeb0a0fab286b9b68fbd",
"image_source": null,
"lastname": "Böhmländer",
"login": "michael.boehmlaender@aikava.de",
"mobile": "",
"mobile_2": "",
"note": "Geplante Abwesenheiten:",
"organization": "AIKAVA GmbH",
"organization_id": 2,
"organization_ids": [],
"organizations": [],
"out_of_office": true,
"out_of_office_end_at": "2026-08-28",
"out_of_office_replacement": "marco.dirscherl@aikava.de",
"out_of_office_replacement_id": 77,
"out_of_office_start_at": "2026-08-17",
"overview_sorting_ids": [
301,
302,
303,
304,
305,
306,
307,
308,
309,
310,
311,
312,
313,
314,
315,
316,
317,
318,
319,
320
],
"phone": "",
"role_ids": [
2,
1
],
"roles": [
"Admin",
"Agent"
],
"source": null,
"street": "",
"two_factor_preference_ids": [],
"two_factor_preferences": [],
"updated_at": "2026-09-21T05:56:12.741Z",
"updated_by": "michael.boehmlaender@aikava.de",
"updated_by_id": 1764,
"verified": false,
"vip": false,
"web": "",
"zip": ""
},
"created_by_id": 1764,
"customer": {
"active": true,
"address": "testadresse",
"city": "",
"country": "",
"created_at": "2023-01-10T13:07:40.366Z",
"created_by": "thomas.roider@aikava.de",
"created_by_id": 4,
"department": "",
"email": "test@test.de",
"fax": "",
"firstname": "Testkundenbesitzer",
"id": 6,
"image": null,
"image_source": null,
"lastname": "Testnachname",
"login": "test@test.de",
"mobile": "",
"mobile_2": null,
"note": "testkunde",
"organization": "AIKAVA GmbH",
"organization_id": 2,
"organization_ids": [],
"organizations": [],
"out_of_office": false,
"out_of_office_end_at": null,
"out_of_office_replacement_id": null,
"out_of_office_start_at": null,
"overview_sorting_ids": [],
"overview_sortings": [],
"phone": "+49123456789",
"role_ids": [],
"roles": [],
"source": null,
"street": "",
"two_factor_preference_ids": [],
"two_factor_preferences": [],
"updated_at": "2026-09-22T14:56:23.989Z",
"updated_by": "thomas.roider@aikava.de",
"updated_by_id": 4,
"verified": false,
"vip": false,
"web": "",
"zip": ""
},
"customer_id": 6,
"daily_event_lock_ids": [],
"daily_event_locks": [],
"escalation_at": null,
"first_response_at": "2026-09-22T15:00:35.799Z",
"first_response_diff_in_min": null,
"first_response_escalation_at": null,
"first_response_in_min": null,
"gesamtbudget": "",
"group": {
"active": true,
"assignment_timeout": null,
"created_at": "2023-01-10T12:33:22.977Z",
"created_by": "thomas.roider@aikava.de",
"created_by_id": 4,
"email_address": "Zammad Helpdesk Support",
"email_address_id": 6,
"follow_up_assignment": true,
"follow_up_possible": "yes",
"id": 3,
"name": "Support",
"name_last": "Support",
"note": "Support AIKAVA",
"parent_id": null,
"reopen_time_in_days": null,
"shared_drafts": true,
"signature": "AIKAVA - Abteilung als Berufsbezeichnung (Gruppe Support)",
"signature_id": 2,
"summary_generation": "global_default",
"updated_at": "2026-07-30T09:34:01.249Z",
"updated_by": "thomas.roider@aikava.de",
"updated_by_id": 4,
"user_ids": [
6,
2308,
2309,
251,
77,
4,
3
],
"users": [
"test@test.de",
"apiuser@aikava.de",
"hung.nguyen@aikava.de",
"corinna.breu@aikava.de",
"marco.dirscherl@aikava.de",
"thomas.roider@aikava.de",
"marco.christener@aikava.de"
]
},
"group_id": 3,
"id": 7035,
"last_close_at": null,
"last_contact_agent_at": "2026-09-23T06:47:38.553Z",
"last_contact_at": "2026-09-23T06:47:38.553Z",
"last_contact_customer_at": "2026-09-22T14:56:24.008Z",
"last_owner_update_at": "2026-09-23T06:47:38.566Z",
"netzwerkpfad": "",
"note": null,
"number": "947021",
"organization": {
"active": true,
"country": "",
"created_at": "2023-01-06T11:06:22.976Z",
"created_by": "-",
"created_by_id": 1,
"customer_owner": null,
"dauerticket_bestellnummer": "",
"dauerticket_url": "",
"domain": "aikava.de",
"domain_assignment": false,
"hardware": null,
"hosting_adress": null,
"hostingkunde": false,
"hotline_contract": null,
"id": 2,
"member_ids": [
297,
295,
251,
301,
6,
2309,
982,
479,
78,
1764,
77,
3,
4
],
"members": [
"auto-feb98421-3344-4f54-a650-dc54b010ba90",
"auto-b4d24e63-db3e-44c2-9fb9-b8f3b6a1a675",
"corinna.breu@aikava.de",
"auto-27ce025f-f458-4a90-b320-df18812c150b",
"test@test.de",
"hung.nguyen@aikava.de",
"marcel.reisch@aikava.de",
"cristian.dimcia@aikava.de",
"heidi.schmaderer@aikava.de",
"michael.boehmlaender@aikava.de",
"marco.dirscherl@aikava.de",
"marco.christener@aikava.de",
"thomas.roider@aikava.de"
],
"name": "AIKAVA GmbH",
"note": "",
"ort": "Cham",
"plz": "93413",
"rechnungsadresse": "",
"secondary_member_ids": [],
"shared": true,
"stock_customer": false,
"strasse": "Galgenfeld 7",
"support_project": null,
"updated_at": "2026-09-22T14:56:23.997Z",
"updated_by": "corinna.breu@aikava.de",
"updated_by_id": 251,
"vertrieb_atoss": [],
"vip": false
},
"organization_id": 2,
"owner": {
"active": true,
"address": "",
"city": "",
"country": "",
"created_at": "2025-03-31T08:14:45.514Z",
"created_by": "marco.christener@aikava.de",
"created_by_id": 3,
"department": "Senior Software Consultant",
"email": "michael.boehmlaender@aikava.de",
"fax": "",
"firstname": "Michael",
"id": 1764,
"image": "facb8844175ddeb0a0fab286b9b68fbd",
"image_source": null,
"lastname": "Böhmländer",
"login": "michael.boehmlaender@aikava.de",
"mobile": "",
"mobile_2": "",
"note": "Geplante Abwesenheiten:",
"organization": "AIKAVA GmbH",
"organization_id": 2,
"organization_ids": [],
"organizations": [],
"out_of_office": true,
"out_of_office_end_at": "2026-08-28",
"out_of_office_replacement": "marco.dirscherl@aikava.de",
"out_of_office_replacement_id": 77,
"out_of_office_start_at": "2026-08-17",
"overview_sorting_ids": [
301,
302,
303,
304,
305,
306,
307,
308,
309,
310,
311,
312,
313,
314,
315,
316,
317,
318,
319,
320
],
"phone": "",
"role_ids": [
2,
1
],
"roles": [
"Admin",
"Agent"
],
"source": null,
"street": "",
"two_factor_preference_ids": [],
"two_factor_preferences": [],
"updated_at": "2026-09-21T05:56:12.741Z",
"updated_by": "michael.boehmlaender@aikava.de",
"updated_by_id": 1764,
"verified": false,
"vip": false,
"web": "",
"zip": ""
},
"owner_id": 1764,
"pending_time": null,
"preferences": {},
"priority": {
"active": true,
"created_at": "2023-01-06T10:59:49.163Z",
"created_by": "-",
"created_by_id": 1,
"default_create": true,
"id": 2,
"name": "2 normal",
"note": null,
"ui_color": null,
"ui_icon": null,
"updated_at": "2023-01-06T10:59:49.163Z",
"updated_by": "-",
"updated_by_id": 1
},
"priority_id": 2,
"project": "",
"referencing_checklist_ids": [],
"referencing_checklists": [],
"state": "open",
"state_id": 2,
"ticket_time_accounting_ids": [
16133,
16135,
16137,
16138,
16139,
16140,
16141,
16142,
16144,
16145,
16146,
16147
],
"time_unit": "2.75",
"title": "Bla",
"type": null,
"update_diff_in_min": null,
"update_escalation_at": null,
"update_in_min": null,
"updated_at": "2026-09-23T06:47:42.937Z",
"updated_by": {
"active": true,
"address": "",
"city": "",
"country": "",
"created_at": "2025-03-31T08:14:45.514Z",
"created_by": "marco.christener@aikava.de",
"created_by_id": 3,
"department": "Senior Software Consultant",
"email": "michael.boehmlaender@aikava.de",
"fax": "",
"firstname": "Michael",
"id": 1764,
"image": "facb8844175ddeb0a0fab286b9b68fbd",
"image_source": null,
"lastname": "Böhmländer",
"login": "michael.boehmlaender@aikava.de",
"mobile": "",
"mobile_2": "",
"note": "Geplante Abwesenheiten:",
"organization": "AIKAVA GmbH",
"organization_id": 2,
"organization_ids": [],
"organizations": [],
"out_of_office": true,
"out_of_office_end_at": "2026-08-28",
"out_of_office_replacement": "marco.dirscherl@aikava.de",
"out_of_office_replacement_id": 77,
"out_of_office_start_at": "2026-08-17",
"overview_sorting_ids": [
301,
302,
303,
304,
305,
306,
307,
308,
309,
310,
311,
312,
313,
314,
315,
316,
317,
318,
319,
320
],
"phone": "",
"role_ids": [
2,
1
],
"roles": [
"Admin",
"Agent"
],
"source": null,
"street": "",
"two_factor_preference_ids": [],
"two_factor_preferences": [],
"updated_at": "2026-09-21T05:56:12.741Z",
"updated_by": "michael.boehmlaender@aikava.de",
"updated_by_id": 1764,
"verified": false,
"vip": false,
"web": "",
"zip": ""
},
"updated_by_id": 1764
},
"article": {
"ai_stored_result_ids": [],
"ai_stored_results": [],
"attachments": [],
"body": "test<br><br><div data-signature=\"true\" data-signature-id=\"2\"><div>
<div><b>Michael Böhmländer</b></div>
<div>Senior Software Consultant<br>Geplante Abwesenheiten:</div>
</div><div><br></div><div><b>AIKAVA GmbH</b></div><div>Galgenfeld 7 | 93413 Cham</div><div><b><br></b></div><div>T: +49 9971 88999 40</div><div>
<a href=\"mailto:support.atoss@aikava.de\" title=\"mailto:support.atoss@aikava.de\">support@aikava.de</a><br>
</div><div>
<a href=\"https://aikava.de/\" rel=\"nofollow noreferrer noopener\" target=\"_blank\">aikava.de</a><br>
</div><div><br></div><div><p>Amtsgericht Regensburg HRB 19554<br></p></div><div>Geschäftsführung Marco Christener</div><div><i><br></i></div><div><i>This e-mail may contain confidential and/or privileged information. If you are not the intended recipient or have received this e-mail in error please notify the sender immediately and delete this e-mail.</i></div></div>",
"body_rendering_error": false,
"cc": "",
"content_type": "text/html",
"created_at": "2026-09-23T06:47:38.553Z",
"created_by": {
"active": true,
"address": "",
"city": "",
"country": "",
"created_at": "2025-03-31T08:14:45.514Z",
"created_by": "marco.christener@aikava.de",
"created_by_id": 3,
"department": "Senior Software Consultant",
"email": "michael.boehmlaender@aikava.de",
"fax": "",
"firstname": "Michael",
"id": 1764,
"image": "facb8844175ddeb0a0fab286b9b68fbd",
"image_source": null,
"lastname": "Böhmländer",
"login": "michael.boehmlaender@aikava.de",
"mobile": "",
"mobile_2": "",
"note": "Geplante Abwesenheiten:",
"organization": "AIKAVA GmbH",
"organization_id": 2,
"organization_ids": [],
"organizations": [],
"out_of_office": true,
"out_of_office_end_at": "2026-08-28",
"out_of_office_replacement": "marco.dirscherl@aikava.de",
"out_of_office_replacement_id": 77,
"out_of_office_start_at": "2026-08-17",
"overview_sorting_ids": [
301,
302,
303,
304,
305,
306,
307,
308,
309,
310,
311,
312,
313,
314,
315,
316,
317,
318,
319,
320
],
"phone": "",
"role_ids": [
2,
1
],
"roles": [
"Admin",
"Agent"
],
"source": null,
"street": "",
"two_factor_preference_ids": [],
"two_factor_preferences": [],
"updated_at": "2026-09-21T05:56:12.741Z",
"updated_by": "michael.boehmlaender@aikava.de",
"updated_by_id": 1764,
"verified": false,
"vip": false,
"web": "",
"zip": ""
},
"created_by_id": 1764,
"detected_language": null,
"from": "\"Michael Böhmländer via Zammad Helpdesk Support\" <support@aikava.de>",
"id": 66152,
"in_reply_to": "",
"internal": false,
"message_id": "<20260923064738.7035.8a97ff10-62fc-4d7a-9d91-2d968ea53002@aikava.zammad.com>",
"message_id_md5": "4d6a39f57fc20c1834cc2e7b8c6e94cd",
"origin_by_id": null,
"preferences": {
"email_address_id": 6,
"delivery_retry": 1,
"delivery_channel_id": 23,
"delivery_status_message": null,
"delivery_status": "success",
"delivery_status_date": "2026-09-23T06:47:42.903Z"
},
"reply_to": null,
"sender": "Agent",
"sender_id": 1,
"subject": "test",
"ticket_id": 7035,
"time_unit": "0.0",
"to": "michael.boehmlaender@aikava.de",
"type": "email",
"type_id": 1,
"updated_at": "2026-09-23T06:47:42.905Z",
"updated_by": {
"active": true,
"address": "",
"city": "",
"country": "",
"created_at": "2025-03-31T08:14:45.514Z",
"created_by": "marco.christener@aikava.de",
"created_by_id": 3,
"department": "Senior Software Consultant",
"email": "michael.boehmlaender@aikava.de",
"fax": "",
"firstname": "Michael",
"id": 1764,
"image": "facb8844175ddeb0a0fab286b9b68fbd",
"image_source": null,
"lastname": "Böhmländer",
"login": "michael.boehmlaender@aikava.de",
"mobile": "",
"mobile_2": "",
"note": "Geplante Abwesenheiten:",
"organization": "AIKAVA GmbH",
"organization_id": 2,
"organization_ids": [],
"organizations": [],
"out_of_office": true,
"out_of_office_end_at": "2026-08-28",
"out_of_office_replacement": "marco.dirscherl@aikava.de",
"out_of_office_replacement_id": 77,
"out_of_office_start_at": "2026-08-17",
"overview_sorting_ids": [
301,
302,
303,
304,
305,
306,
307,
308,
309,
310,
311,
312,
313,
314,
315,
316,
317,
318,
319,
320
],
"phone": "",
"role_ids": [
2,
1
],
"roles": [
"Admin",
"Agent"
],
"source": null,
"street": "",
"two_factor_preference_ids": [],
"two_factor_preferences": [],
"updated_at": "2026-09-21T05:56:12.741Z",
"updated_by": "michael.boehmlaender@aikava.de",
"updated_by_id": 1764,
"verified": false,
"vip": false,
"web": "",
"zip": ""
},
"updated_by_id": 1764,
"accounted_time": 0
}
}
Antwort
Erstellt am 2026-09-23 08:48:13
+24
View File
@@ -0,0 +1,24 @@
#!/usr/bin/env bash
set -euo pipefail
APP_NAME="${APP_NAME:-tickettracker}"
GITEA_REGISTRY="${GITEA_REGISTRY:-git.d-razz.de}"
GITEA_OWNER="${GITEA_OWNER:-michael}"
IMAGE_TAG="${IMAGE_TAG:-latest}"
PLATFORM="${PLATFORM:-linux/amd64}"
IMAGE="${IMAGE:-${GITEA_REGISTRY}/${GITEA_OWNER}/${APP_NAME}:${IMAGE_TAG}}"
echo "Baue ${IMAGE} fuer ${PLATFORM}"
docker buildx build \
--platform "${PLATFORM}" \
--tag "${IMAGE}" \
--push \
.
echo
echo "Image gepusht: ${IMAGE}"
echo "Auf dem Docker-Server:"
echo " export TICKETTRACKER_IMAGE='${IMAGE}'"
echo " docker compose --env-file .env.docker-external -f compose.yml up -d"
echo "oder mit PostgreSQL 17 im Stack:"
echo " docker compose --env-file .env.docker-postgres -f compose.postgres.yml up -d"
+1
View File
@@ -10,6 +10,7 @@ IMAGE="${IMAGE:-${GITEA_REGISTRY}/${GITEA_OWNER}/${APP_NAME}:${IMAGE_TAG}}"
echo "Baue ${IMAGE} fuer ${PLATFORM}"
docker buildx build \
--builder tickettracker-builder \
--platform "${PLATFORM}" \
--tag "${IMAGE}" \
--push \
+39
View File
@@ -3,10 +3,22 @@ set -euo pipefail
NODE_MAJOR_REQUIRED=22
NODESOURCE_SETUP_URL="https://deb.nodesource.com/setup_${NODE_MAJOR_REQUIRED}.x"
MIN_DISK_MB=2048
MIN_MEMORY_MB=768
SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
REPO_ROOT="$(cd -- "${SCRIPT_DIR}/.." && pwd)"
if [[ "${1:-}" != "--run" ]]; then
echo "Dieses Setup-Script macht ohne explizites --run nichts."
echo
echo "So startest du es bewusst:"
echo " bash scripts/install-local-dependencies.sh --run"
echo
echo "Es installiert nur Webapp-Abhaengigkeiten, keine DB und kein Docker."
exit 0
fi
if [[ ! -f "${REPO_ROOT}/package.json" ]]; then
echo "Repo-Root nicht gefunden. Erwartet: ${REPO_ROOT}/package.json"
exit 1
@@ -46,6 +58,33 @@ node_major() {
node -p 'Number(process.versions.node.split(".")[0])' 2>/dev/null || echo 0
}
available_memory_mb() {
awk '/MemAvailable:/ { print int($2 / 1024) }' /proc/meminfo 2>/dev/null || echo 0
}
available_disk_mb() {
df -Pm "${REPO_ROOT}" | awk 'NR == 2 { print $4 }'
}
if [[ "${SKIP_RESOURCE_CHECK:-false}" != "true" ]]; then
AVAILABLE_DISK_MB="$(available_disk_mb)"
AVAILABLE_MEMORY_MB="$(available_memory_mb)"
if [[ "${AVAILABLE_DISK_MB}" -lt "${MIN_DISK_MB}" ]]; then
echo "Zu wenig freier Speicherplatz fuer npm-Abhaengigkeiten."
echo "Frei: ${AVAILABLE_DISK_MB} MB, benoetigt empfohlen: mindestens ${MIN_DISK_MB} MB."
echo "Falls du das bewusst trotzdem starten willst: SKIP_RESOURCE_CHECK=true bash scripts/install-local-dependencies.sh --run"
exit 1
fi
if [[ "${AVAILABLE_MEMORY_MB}" -gt 0 && "${AVAILABLE_MEMORY_MB}" -lt "${MIN_MEMORY_MB}" ]]; then
echo "Zu wenig freier Arbeitsspeicher fuer eine stabile npm-Installation."
echo "Frei: ${AVAILABLE_MEMORY_MB} MB, benoetigt empfohlen: mindestens ${MIN_MEMORY_MB} MB."
echo "Falls Swap vorhanden ist und du das bewusst trotzdem starten willst: SKIP_RESOURCE_CHECK=true bash scripts/install-local-dependencies.sh --run"
exit 1
fi
fi
echo "Installiere Basiswerkzeuge fuer die lokale Webapp..."
run_apt update
run_apt install -y ca-certificates curl gnupg git bash build-essential
+59
View File
@@ -0,0 +1,59 @@
#!/usr/bin/env bash
set -euo pipefail
if [[ -f ".env_dev" ]]; then
set -a
source .env_dev
set +a
fi
APP_PORT="${APP_PORT:-3911}"
BACKEND_PORT="${BACKEND_PORT:-3002}"
API_PROXY_TARGET="${API_PROXY_TARGET:-http://127.0.0.1:${BACKEND_PORT}}"
export APP_PORT BACKEND_PORT API_PROXY_TARGET
export NEXT_TELEMETRY_DISABLED=1
kill_port_processes() {
local port="$1"
local pids=""
if command -v lsof >/dev/null 2>&1; then
pids="${pids}"$'\n'"$(lsof -tiTCP:"${port}" -sTCP:LISTEN 2>/dev/null || true)"
fi
if command -v fuser >/dev/null 2>&1; then
pids="${pids}"$'\n'"$(fuser -n tcp "${port}" 2>/dev/null | tr ' ' '\n' || true)"
fi
if command -v ss >/dev/null 2>&1; then
pids="${pids}"$'\n'"$(ss -ltnp "sport = :${port}" 2>/dev/null | grep -o 'pid=[0-9]*' | cut -d= -f2 || true)"
fi
pids="$(printf '%s\n' "${pids}" | sed '/^$/d' | sort -u)"
if [[ -z "${pids}" ]]; then
echo "Port ${port} ist frei."
return
fi
echo "Beende Prozess(e) auf Port ${port}: ${pids//$'\n'/ }"
kill ${pids} 2>/dev/null || true
sleep 1
local remaining=""
for pid in ${pids}; do
if kill -0 "${pid}" 2>/dev/null; then
remaining="${remaining} ${pid}"
fi
done
if [[ -n "${remaining}" ]]; then
echo "Erzwinge Stop für:${remaining}"
kill -9 ${remaining} 2>/dev/null || true
fi
}
kill_port_processes "${BACKEND_PORT}"
if [[ "${APP_PORT}" != "${BACKEND_PORT}" ]]; then
kill_port_processes "${APP_PORT}"
fi
+107 -6
View File
@@ -1,23 +1,100 @@
#!/usr/bin/env bash
set -euo pipefail
APP_PORT="${APP_PORT:-3910}"
BACKEND_PORT="${BACKEND_PORT:-3001}"
export API_PROXY_TARGET="${API_PROXY_TARGET:-http://127.0.0.1:${BACKEND_PORT}}"
export NEXT_TELEMETRY_DISABLED=1
if [[ -f ".env_dev" ]]; then
set -a
source .env_dev
set +a
fi
APP_PORT="${APP_PORT:-3911}"
BACKEND_PORT="${BACKEND_PORT:-3002}"
API_PROXY_TARGET="${API_PROXY_TARGET:-http://127.0.0.1:${BACKEND_PORT}}"
export APP_PORT BACKEND_PORT API_PROXY_TARGET
export NEXT_TELEMETRY_DISABLED=1
kill_port_processes() {
local port="$1"
local pids=""
if command -v lsof >/dev/null 2>&1; then
pids="${pids}"$'\n'"$(lsof -tiTCP:"${port}" -sTCP:LISTEN 2>/dev/null || true)"
fi
if command -v fuser >/dev/null 2>&1; then
pids="${pids}"$'\n'"$(fuser -n tcp "${port}" 2>/dev/null | tr ' ' '\n' || true)"
fi
if command -v ss >/dev/null 2>&1; then
pids="${pids}"$'\n'"$(ss -ltnp "sport = :${port}" 2>/dev/null | grep -o 'pid=[0-9]*' | cut -d= -f2 || true)"
fi
pids="$(printf '%s\n' "${pids}" | sed '/^$/d' | sort -u)"
if [[ -z "${pids}" ]]; then
echo "Port ${port} ist frei."
return
fi
echo "Beende Prozess(e) auf Port ${port}: ${pids//$'\n'/ }"
kill ${pids} 2>/dev/null || true
sleep 1
local remaining=""
for pid in ${pids}; do
if kill -0 "${pid}" 2>/dev/null; then
remaining="${remaining} ${pid}"
fi
done
if [[ -n "${remaining}" ]]; then
echo "Erzwinge Stop für:${remaining}"
kill -9 ${remaining} 2>/dev/null || true
fi
}
kill_port_processes "${BACKEND_PORT}"
if [[ "${APP_PORT}" != "${BACKEND_PORT}" ]]; then
kill_port_processes "${APP_PORT}"
fi
if [[ -z "${DATABASE_URL:-}" ]]; then
echo "DATABASE_URL fehlt. Beispiel:"
echo " export DATABASE_URL='postgresql://user:pass@localhost:5432/tickettracker'"
exit 1
fi
if [[ -z "${SECRET_ENCRYPTION_KEY:-}" && -z "${TICKETTRACKER_SECRET_KEY:-}" ]]; then
export SECRET_ENCRYPTION_KEY="${DATABASE_URL}"
fi
DATABASE_HOST="$(node -e 'const url = new URL(process.env.DATABASE_URL); process.stdout.write(url.hostname)' 2>/dev/null || true)"
DATABASE_PORT="$(node -e 'const url = new URL(process.env.DATABASE_URL); process.stdout.write(url.port || "5432")' 2>/dev/null || echo 5432)"
POSTGRES_CONTAINER="${POSTGRES_CONTAINER:-tickettracker-postgres}"
if command -v docker >/dev/null 2>&1 && docker inspect "${POSTGRES_CONTAINER}" >/dev/null 2>&1; then
POSTGRES_CONTAINER_IP="$(docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' "${POSTGRES_CONTAINER}")"
if [[ -n "${POSTGRES_CONTAINER_IP}" ]]; then
SHOULD_USE_CONTAINER_IP=false
if [[ "${DATABASE_HOST}" == "postgres" || "${DATABASE_HOST}" == "postgres-tickettracker" ]]; then
if ! getent hosts "${DATABASE_HOST}" >/dev/null 2>&1; then
SHOULD_USE_CONTAINER_IP=true
fi
elif [[ "${DATABASE_HOST}" =~ ^172\. ]] && [[ "${DATABASE_HOST}" != "${POSTGRES_CONTAINER_IP}" ]]; then
SHOULD_USE_CONTAINER_IP=true
fi
if [[ "${SHOULD_USE_CONTAINER_IP}" == "true" ]]; then
export DATABASE_URL="$(
DATABASE_HOST="${POSTGRES_CONTAINER_IP}" node -e 'const url = new URL(process.env.DATABASE_URL); url.hostname = process.env.DATABASE_HOST; process.stdout.write(url.toString())'
)"
echo "Nutze Docker-Postgres ${POSTGRES_CONTAINER} unter ${POSTGRES_CONTAINER_IP}:${DATABASE_PORT} für den lokalen Start."
fi
fi
fi
NODE_MAJOR="$(node -p 'Number(process.versions.node.split(".")[0])' 2>/dev/null || echo 0)"
if [[ "${NODE_MAJOR}" -lt 20 ]]; then
@@ -37,8 +114,32 @@ cleanup() {
trap cleanup EXIT INT TERM
echo "Starte Backend auf Port ${BACKEND_PORT}"
SERVE_FRONTEND=false PORT="${BACKEND_PORT}" npm run start --workspace backend &
BACKEND_LOG="${TMPDIR:-/tmp}/tickettracker-backend-local.log"
rm -f "${BACKEND_LOG}"
SERVE_FRONTEND=false PORT="${BACKEND_PORT}" npm run start --workspace backend >"${BACKEND_LOG}" 2>&1 &
BACKEND_PID=$!
echo "Warte auf Backend ${API_PROXY_TARGET}"
for _ in $(seq 1 50); do
if ! kill -0 "${BACKEND_PID}" 2>/dev/null; then
echo "Backend konnte nicht gestartet werden:"
cat "${BACKEND_LOG}"
exit 1
fi
if curl -fsS "${API_PROXY_TARGET}/api/debug/status" >/dev/null 2>&1; then
break
fi
sleep 0.2
done
if ! curl -fsS "${API_PROXY_TARGET}/api/debug/status" >/dev/null 2>&1; then
echo "Backend antwortet nicht unter ${API_PROXY_TARGET}."
echo "Letzte Backend-Ausgabe:"
tail -n 80 "${BACKEND_LOG}" 2>/dev/null || true
exit 1
fi
echo "Starte Frontend auf http://localhost:${APP_PORT}"
PORT="${APP_PORT}" npm run start --workspace frontend
+48
View File
@@ -0,0 +1,48 @@
{
"_url": "https://app1.teamspace.de/api/project;limit=1000;depth=2;sort=projectId?parent=32700722&isActive=true&isTemplate=false",
"_links": [
{
"caption": "Self",
"href": "https://app1.teamspace.de/api/project;limit=1000;depth=2;sort=projectId?parent=32700722&isActive=true&isTemplate=false",
"rel": "self"
},
{
"caption": "|< firstPage",
"href": "https://app1.teamspace.de/api/project;offset=0;limit=1000;sort=projectId?parent=32700722&isActive=true&isTemplate=false",
"rel": "first",
"title": "First page of projects of this CollectionResource"
},
{
"caption": ">| lastPage",
"href": "https://app1.teamspace.de/api/project;offset=0;limit=1000;sort=projectId?parent=32700722&isActive=true&isTemplate=false",
"rel": "last",
"title": "Last page of projects of this CollectionResource"
}
],
"_etag": {
"value": "2cdf79c35612fb82487eed3923af2e43",
"weak": false
},
"size": 5,
"offset": 0,
"limit": 100,
"items": [
{
"data": {
"contractPositions": [
{
"billingType": {
"caption": "Fix price",
"href": "https://app1.teamspace.de/api/enum/financepositionbillingtype/INVOICEABLE_FIX",
"value": "INVOICEABLE_FIX",
"optionsUrl": "https://app1.teamspace.de/api/enum/financepositionbillingtype"
}
}
]
}
}
]
}