Reorganize repo structure and standards references

This commit is contained in:
david committed 2026-06-29 05:03:42 +02:00
1 parent 3cb93a81be
commit be2054274d
5885 files changed
+2588 -195

No files matched your search

@@ -0,0 +1,54 @@
import { getDbClient } from "@toolctrl/db/client.server";
import type { Prisma } from "@toolctrl/db/prisma-browser";
import type { LogActivityInput } from "./types.js";
/**
* Minimal write surface `logActivity` needs. Satisfied by the full Prisma client
* AND by interactive-transaction clients, so callers can append an activity inside
* the same transaction as the action that triggered it.
*/
export type ActivityWriteClient = {
activity: {
create: (args: { data: Prisma.ActivityUncheckedCreateInput }) => Promise<{ id: string }>;
};
};
export type LogActivityOptions = {
/** Transaction/client to write through. Defaults to the shared db singleton. */
client?: ActivityWriteClient;
};
/**
* Append a user-facing activity to the central `Activity` stream (M045 / DoD #14).
*
* This is NOT the audit log — the tamper-evident `AuditEvent` (M001) is written
* separately (auto via Prisma middleware). `logActivity` records the human-readable,
* per-entity timeline shown to tenant users.
*/
export async function logActivity(input: LogActivityInput, options: LogActivityOptions = {}): Promise<{ id: string }> {
if (!input.tenantId) {
throw new Error("logActivity: tenantId is required");
}
if (!input.subjectId) {
throw new Error("logActivity: subjectId is required");
}
if (!input.summaryText || input.summaryText.trim().length === 0) {
throw new Error("logActivity: summaryText (Klartext-Zusammenfassung) is required");
}
const client = options.client ?? (getDbClient() as unknown as ActivityWriteClient);
return client.activity.create({
data: {
tenantId: input.tenantId,
actorUserId: input.actorUserId ?? null,
actorKind: input.actorKind,
activityType: input.activityType,
subjectType: input.subjectType,
subjectId: input.subjectId,
summaryText: input.summaryText,
relatedEntityRefs: input.relatedEntityRefs ? (input.relatedEntityRefs as unknown as Prisma.InputJsonValue) : undefined,
metadata: input.metadata ? (input.metadata as Prisma.InputJsonValue) : undefined,
},
});
}