feat: dashboard overhaul, chargeability reports, dispo import enhancements, UI polish

Dashboard: expanded chargeability widget, resource/project table widgets
with sorting and filters, stat cards with formatMoney integration.

Chargeability: new report client with filtering, chargeability-bookings
use case, updated dashboard overview logic.

Dispo import: TBD project handling, parse-dispo-matrix improvements,
stage-dispo-projects resource value scores, new tests.

Estimates: CommercialTermsEditor component, commercial-terms engine
module, expanded estimate schemas and types.

UI: AppShell navigation updates, timeline filter/toolbar enhancements,
role management improvements, signin page redesign, Tailwind/globals
polish, SystemSettings SMTP section, anonymization support.

Tests: new router tests (anonymization, chargeability, effort-rule,
entitlement, estimate, experience-multiplier, notification, resource,
staffing, vacation).

Co-Authored-By: claude-flow <ruv@ruv.net>
This commit is contained in:
2026-03-14 23:29:07 +01:00
parent ad0855902b
commit 625a842d89
74 changed files with 11680 additions and 1583 deletions
@@ -0,0 +1,129 @@
import { describe, expect, it, vi } from "vitest";
import { getAnonymizationDirectory } from "../lib/anonymization.js";
describe("anonymization directory", () => {
it("persists aliases so existing resources keep the same identity when new resources appear", async () => {
let storedAliases: Record<string, { displayName: string; eid: string }> = {
resource_a: {
displayName: "Iron Man",
eid: "iron.man",
},
};
const resourcesRoundOne = [
{
id: "resource_a",
eid: "alice",
displayName: "Alice",
email: "alice@example.com",
lcrCents: 14000,
},
{
id: "resource_b",
eid: "bob",
displayName: "Bob",
email: "bob@example.com",
lcrCents: 11000,
},
];
const resourcesRoundTwo = [
...resourcesRoundOne,
{
id: "resource_c",
eid: "carol",
displayName: "Carol",
email: "carol@example.com",
lcrCents: 12500,
},
];
const db = {
systemSettings: {
findUnique: vi.fn(async () => ({
anonymizationEnabled: true,
anonymizationDomain: "superhartmut.de",
anonymizationSeed: "stable-seed",
anonymizationMode: "global",
anonymizationAliases: storedAliases,
})),
update: vi.fn(async ({ data }: { data: { anonymizationAliases: typeof storedAliases } }) => {
storedAliases = data.anonymizationAliases;
return {};
}),
},
resource: {
findMany: vi
.fn()
.mockResolvedValueOnce(resourcesRoundOne)
.mockResolvedValueOnce(resourcesRoundTwo),
},
};
const firstDirectory = await getAnonymizationDirectory(db as never);
const secondDirectory = await getAnonymizationDirectory(db as never);
expect(firstDirectory?.byResourceId.get("resource_a")).toMatchObject({
displayName: "Iron Man",
eid: "iron.man",
email: "iron.man@superhartmut.de",
});
expect(firstDirectory?.byResourceId.get("resource_b")).toBeDefined();
expect(secondDirectory?.byResourceId.get("resource_a")).toMatchObject({
displayName: "Iron Man",
eid: "iron.man",
email: "iron.man@superhartmut.de",
});
expect(secondDirectory?.byResourceId.get("resource_b")).toEqual(
firstDirectory?.byResourceId.get("resource_b"),
);
expect(secondDirectory?.byResourceId.get("resource_c")).toBeDefined();
expect(db.systemSettings.update).toHaveBeenCalledTimes(2);
});
it("regenerates legacy aliases with digits into stable aliases without numeric characters", async () => {
let storedAliases: Record<string, { displayName: string; eid: string }> = {
resource_a: {
displayName: "Baloo 16",
eid: "baloo.16",
},
};
const db = {
systemSettings: {
findUnique: vi.fn(async () => ({
anonymizationEnabled: true,
anonymizationDomain: "superhartmut.de",
anonymizationSeed: "stable-seed",
anonymizationMode: "global",
anonymizationAliases: storedAliases,
})),
update: vi.fn(async ({ data }: { data: { anonymizationAliases: typeof storedAliases } }) => {
storedAliases = data.anonymizationAliases;
return {};
}),
},
resource: {
findMany: vi.fn().mockResolvedValue([
{
id: "resource_a",
eid: "alice",
displayName: "Alice",
email: "alice@example.com",
lcrCents: 6000,
},
]),
},
};
const directory = await getAnonymizationDirectory(db as never);
const alias = directory?.byResourceId.get("resource_a");
expect(alias).toBeDefined();
expect(alias?.displayName).not.toContain("16");
expect(alias?.eid).not.toContain("16");
expect(alias?.displayName).toMatch(/^[A-Za-z]+(?: [A-Za-z]+)*$/);
expect(alias?.eid).toMatch(/^[a-z]+(?:\.[a-z]+)*$/);
expect(db.systemSettings.update).toHaveBeenCalledTimes(1);
});
});
@@ -0,0 +1,207 @@
import { SystemRole } from "@planarchy/shared";
import { beforeEach, describe, expect, it, vi } from "vitest";
vi.mock("@planarchy/application", async (importOriginal) => {
const actual = await importOriginal<typeof import("@planarchy/application")>();
return {
...actual,
isChargeabilityActualBooking: actual.isChargeabilityActualBooking,
listAssignmentBookings: vi.fn(),
};
});
import { listAssignmentBookings } from "@planarchy/application";
import { chargeabilityReportRouter } from "../router/chargeability-report.js";
import { createCallerFactory } from "../trpc.js";
const createCaller = createCallerFactory(chargeabilityReportRouter);
function createControllerCaller(db: Record<string, unknown>) {
return createCaller({
session: {
user: { email: "controller@example.com", name: "Controller", image: null },
expires: "2026-03-14T00:00:00.000Z",
},
db: db as never,
dbUser: {
id: "user_controller",
systemRole: SystemRole.CONTROLLER,
permissionOverrides: null,
},
});
}
describe("chargeability report router", () => {
beforeEach(() => {
vi.clearAllMocks();
});
it("excludes proposed bookings by default but includes them when requested", async () => {
const db = {
resource: {
findMany: vi.fn().mockResolvedValue([
{
id: "resource_1",
eid: "E-001",
displayName: "Alice",
fte: 1,
chargeabilityTarget: 80,
country: {
id: "country_es",
code: "ES",
dailyWorkingHours: 8,
scheduleRules: null,
},
orgUnit: { id: "org_1", name: "CGI" },
managementLevelGroup: { id: "mgmt_1", name: "Senior", targetPercentage: 0.8 },
managementLevel: { id: "level_1", name: "L7" },
metroCity: { id: "city_1", name: "Barcelona" },
},
]),
},
project: {
findMany: vi.fn().mockResolvedValue([
{ id: "project_confirmed", utilizationCategory: { code: "Chg" } },
{ id: "project_proposed", utilizationCategory: { code: "Chg" } },
]),
},
vacation: {
findMany: vi.fn().mockResolvedValue([]),
},
};
vi.mocked(listAssignmentBookings).mockResolvedValue([
{
id: "assignment_confirmed",
projectId: "project_confirmed",
resourceId: "resource_1",
startDate: new Date("2026-03-02T00:00:00.000Z"),
endDate: new Date("2026-03-06T00:00:00.000Z"),
hoursPerDay: 4,
dailyCostCents: 0,
status: "CONFIRMED",
project: {
id: "project_confirmed",
name: "Confirmed Project",
shortCode: "CP",
status: "ACTIVE",
orderType: "CLIENT",
dynamicFields: null,
},
resource: { id: "resource_1", displayName: "Alice", chapter: "CGI" },
},
{
id: "assignment_proposed",
projectId: "project_proposed",
resourceId: "resource_1",
startDate: new Date("2026-03-02T00:00:00.000Z"),
endDate: new Date("2026-03-06T00:00:00.000Z"),
hoursPerDay: 4,
dailyCostCents: 0,
status: "PROPOSED",
project: {
id: "project_proposed",
name: "Proposed Project",
shortCode: "PP",
status: "ACTIVE",
orderType: "CLIENT",
dynamicFields: null,
},
resource: { id: "resource_1", displayName: "Alice", chapter: "CGI" },
},
]);
const caller = createControllerCaller(db);
const strict = await caller.getReport({
startMonth: "2026-03",
endMonth: "2026-03",
});
const withProposed = await caller.getReport({
startMonth: "2026-03",
endMonth: "2026-03",
includeProposed: true,
});
const strictMonth = strict.resources[0]?.months[0];
const proposedMonth = withProposed.resources[0]?.months[0];
expect(strictMonth).toBeDefined();
expect(proposedMonth).toBeDefined();
expect(strictMonth?.chg).toBeGreaterThan(0);
expect(proposedMonth?.chg).toBeGreaterThan(strictMonth?.chg ?? 0);
expect(proposedMonth?.chg).toBeCloseTo((strictMonth?.chg ?? 0) * 2, 5);
expect(withProposed.groupTotals[0]?.chg).toBeGreaterThan(strict.groupTotals[0]?.chg ?? 0);
});
it("includes imported TBD draft work only when proposed bookings are enabled", async () => {
const db = {
resource: {
findMany: vi.fn().mockResolvedValue([
{
id: "resource_1",
eid: "E-001",
displayName: "Alice",
fte: 1,
chargeabilityTarget: 80,
country: {
id: "country_es",
code: "ES",
dailyWorkingHours: 8,
scheduleRules: null,
},
orgUnit: { id: "org_1", name: "CGI" },
managementLevelGroup: { id: "mgmt_1", name: "Senior", targetPercentage: 0.8 },
managementLevel: { id: "level_1", name: "L7" },
metroCity: { id: "city_1", name: "Barcelona" },
},
]),
},
project: {
findMany: vi.fn().mockResolvedValue([
{ id: "project_tbd", utilizationCategory: { code: "Chg" } },
]),
},
vacation: {
findMany: vi.fn().mockResolvedValue([]),
},
};
vi.mocked(listAssignmentBookings).mockResolvedValue([
{
id: "assignment_tbd",
projectId: "project_tbd",
resourceId: "resource_1",
startDate: new Date("2026-03-02T00:00:00.000Z"),
endDate: new Date("2026-03-06T00:00:00.000Z"),
hoursPerDay: 4,
dailyCostCents: 0,
status: "PROPOSED",
project: {
id: "project_tbd",
name: "TBD Project",
shortCode: "TBD-P1",
status: "DRAFT",
orderType: "CLIENT",
dynamicFields: { dispoImport: { isTbd: true } },
},
resource: { id: "resource_1", displayName: "Alice", chapter: "CGI" },
},
]);
const caller = createControllerCaller(db);
const strict = await caller.getReport({
startMonth: "2026-03",
endMonth: "2026-03",
});
const withProposed = await caller.getReport({
startMonth: "2026-03",
endMonth: "2026-03",
includeProposed: true,
});
expect(strict.resources[0]?.months[0]?.chg).toBe(0);
expect(withProposed.resources[0]?.months[0]?.chg).toBeGreaterThan(0);
expect(withProposed.groupTotals[0]?.chg).toBeGreaterThan(strict.groupTotals[0]?.chg ?? 0);
});
});
@@ -0,0 +1,540 @@
import { SystemRole } from "@planarchy/shared";
import { describe, expect, it, vi } from "vitest";
import { effortRuleRouter } from "../router/effort-rule.js";
import { createCallerFactory } from "../trpc.js";
// Mock the engine — we focus on the router/DB layer, not the pure engine logic
vi.mock("@planarchy/engine", () => ({
expandScopeToEffort: vi.fn().mockReturnValue({
lines: [
{
scopeItemName: "Shot_001",
scopeType: "shot",
discipline: "Compositing",
chapter: null,
hours: 16,
unitMode: "per_frame" as const,
unitCount: 200,
hoursPerUnit: 0.08,
},
],
warnings: [],
unmatchedScopeItems: [],
}),
aggregateByDiscipline: vi.fn().mockReturnValue({
Compositing: { totalHours: 16, lineCount: 1 },
}),
}));
const createCaller = createCallerFactory(effortRuleRouter);
function createControllerCaller(db: Record<string, unknown>) {
return createCaller({
session: {
user: { email: "ctrl@example.com", name: "Controller", image: null },
expires: "2099-01-01T00:00:00.000Z",
},
db: db as never,
dbUser: {
id: "user_ctrl",
systemRole: SystemRole.CONTROLLER,
permissionOverrides: null,
},
});
}
function createManagerCaller(db: Record<string, unknown>) {
return createCaller({
session: {
user: { email: "mgr@example.com", name: "Manager", image: null },
expires: "2099-01-01T00:00:00.000Z",
},
db: db as never,
dbUser: {
id: "user_mgr",
systemRole: SystemRole.MANAGER,
permissionOverrides: null,
},
});
}
// ── Sample data factories ────────────────────────────────────────────────────
function sampleRuleSet(overrides: Record<string, unknown> = {}) {
return {
id: "ers_1",
name: "VFX Standard",
description: null,
isDefault: true,
createdAt: new Date(),
updatedAt: new Date(),
rules: [
{
id: "er_1",
ruleSetId: "ers_1",
scopeType: "shot",
discipline: "Compositing",
chapter: null,
unitMode: "per_frame",
hoursPerUnit: 0.08,
description: null,
sortOrder: 0,
createdAt: new Date(),
updatedAt: new Date(),
},
],
...overrides,
};
}
// ─── list ────────────────────────────────────────────────────────────────────
describe("effortRule.list", () => {
it("returns rule sets ordered by isDefault desc, name asc", async () => {
const sets = [sampleRuleSet(), sampleRuleSet({ id: "ers_2", name: "Animation", isDefault: false })];
const db = {
effortRuleSet: {
findMany: vi.fn().mockResolvedValue(sets),
},
};
const caller = createControllerCaller(db);
const result = await caller.list();
expect(result).toHaveLength(2);
expect(db.effortRuleSet.findMany).toHaveBeenCalledWith(
expect.objectContaining({
orderBy: [{ isDefault: "desc" }, { name: "asc" }],
}),
);
});
});
// ─── getById ─────────────────────────────────────────────────────────────────
describe("effortRule.getById", () => {
it("returns the rule set when found", async () => {
const set = sampleRuleSet();
const db = {
effortRuleSet: {
findUnique: vi.fn().mockResolvedValue(set),
},
};
const caller = createControllerCaller(db);
const result = await caller.getById({ id: "ers_1" });
expect(result.id).toBe("ers_1");
expect(result.rules).toHaveLength(1);
});
it("throws NOT_FOUND when rule set does not exist", async () => {
const db = {
effortRuleSet: {
findUnique: vi.fn().mockResolvedValue(null),
},
};
const caller = createControllerCaller(db);
await expect(caller.getById({ id: "nonexistent" })).rejects.toThrow("Effort rule set not found");
});
});
// ─── create ──────────────────────────────────────────────────────────────────
describe("effortRule.create", () => {
it("creates a rule set with rules", async () => {
const created = sampleRuleSet();
const db = {
effortRuleSet: {
updateMany: vi.fn().mockResolvedValue({ count: 0 }),
create: vi.fn().mockResolvedValue(created),
},
};
const caller = createManagerCaller(db);
const result = await caller.create({
name: "VFX Standard",
isDefault: false,
rules: [
{
scopeType: "shot",
discipline: "Compositing",
unitMode: "per_frame",
hoursPerUnit: 0.08,
sortOrder: 0,
},
],
});
expect(result.id).toBe("ers_1");
expect(db.effortRuleSet.create).toHaveBeenCalledTimes(1);
// isDefault was false, so updateMany should NOT have been called
expect(db.effortRuleSet.updateMany).not.toHaveBeenCalled();
});
it("unsets other defaults when creating a new default rule set", async () => {
const created = sampleRuleSet({ isDefault: true });
const db = {
effortRuleSet: {
updateMany: vi.fn().mockResolvedValue({ count: 1 }),
create: vi.fn().mockResolvedValue(created),
},
};
const caller = createManagerCaller(db);
await caller.create({
name: "VFX Standard",
isDefault: true,
rules: [],
});
expect(db.effortRuleSet.updateMany).toHaveBeenCalledWith({
where: { isDefault: true },
data: { isDefault: false },
});
});
});
// ─── update ──────────────────────────────────────────────────────────────────
describe("effortRule.update", () => {
it("updates name and description without touching rules", async () => {
const existing = sampleRuleSet();
const updated = { ...existing, name: "VFX Updated" };
const db = {
effortRuleSet: {
findUnique: vi.fn().mockResolvedValue(existing),
updateMany: vi.fn().mockResolvedValue({ count: 0 }),
update: vi.fn().mockResolvedValue(updated),
},
effortRule: {
deleteMany: vi.fn(),
createMany: vi.fn(),
},
};
const caller = createManagerCaller(db);
const result = await caller.update({ id: "ers_1", name: "VFX Updated" });
expect(result.name).toBe("VFX Updated");
// No rules provided, so rule replacement should not happen
expect(db.effortRule.deleteMany).not.toHaveBeenCalled();
expect(db.effortRule.createMany).not.toHaveBeenCalled();
});
it("replaces rules when rules array is provided", async () => {
const existing = sampleRuleSet();
const updated = sampleRuleSet({ name: "Updated" });
const db = {
effortRuleSet: {
findUnique: vi.fn().mockResolvedValue(existing),
updateMany: vi.fn().mockResolvedValue({ count: 0 }),
update: vi.fn().mockResolvedValue(updated),
},
effortRule: {
deleteMany: vi.fn().mockResolvedValue({ count: 1 }),
createMany: vi.fn().mockResolvedValue({ count: 2 }),
},
};
const caller = createManagerCaller(db);
await caller.update({
id: "ers_1",
rules: [
{ scopeType: "shot", discipline: "Lighting", unitMode: "per_frame", hoursPerUnit: 0.1, sortOrder: 0 },
{ scopeType: "asset", discipline: "Modeling", unitMode: "per_item", hoursPerUnit: 8, sortOrder: 1 },
],
});
expect(db.effortRule.deleteMany).toHaveBeenCalledWith({ where: { ruleSetId: "ers_1" } });
expect(db.effortRule.createMany).toHaveBeenCalledWith({
data: expect.arrayContaining([
expect.objectContaining({ ruleSetId: "ers_1", discipline: "Lighting" }),
expect.objectContaining({ ruleSetId: "ers_1", discipline: "Modeling" }),
]),
});
});
it("throws NOT_FOUND when rule set does not exist", async () => {
const db = {
effortRuleSet: {
findUnique: vi.fn().mockResolvedValue(null),
updateMany: vi.fn(),
update: vi.fn(),
},
effortRule: { deleteMany: vi.fn(), createMany: vi.fn() },
};
const caller = createManagerCaller(db);
await expect(caller.update({ id: "nonexistent", name: "X" })).rejects.toThrow("Effort rule set not found");
});
});
// ─── delete ──────────────────────────────────────────────────────────────────
describe("effortRule.delete", () => {
it("deletes the rule set and returns its id", async () => {
const existing = sampleRuleSet();
const db = {
effortRuleSet: {
findUnique: vi.fn().mockResolvedValue(existing),
delete: vi.fn().mockResolvedValue(existing),
},
};
const caller = createManagerCaller(db);
const result = await caller.delete({ id: "ers_1" });
expect(result).toEqual({ id: "ers_1" });
expect(db.effortRuleSet.delete).toHaveBeenCalledWith({ where: { id: "ers_1" } });
});
it("throws NOT_FOUND when rule set does not exist", async () => {
const db = {
effortRuleSet: {
findUnique: vi.fn().mockResolvedValue(null),
delete: vi.fn(),
},
};
const caller = createManagerCaller(db);
await expect(caller.delete({ id: "nonexistent" })).rejects.toThrow("Effort rule set not found");
});
});
// ─── preview ─────────────────────────────────────────────────────────────────
describe("effortRule.preview", () => {
it("returns expansion result with aggregation", async () => {
const estimate = {
id: "est_1",
baseCurrency: "EUR",
versions: [
{
id: "v_1",
versionNumber: 1,
status: "WORKING",
scopeItems: [
{
id: "si_1",
name: "Shot_001",
scopeType: "shot",
frameCount: 200,
itemCount: null,
unitMode: "per_frame",
sortOrder: 0,
},
],
},
],
};
const ruleSet = sampleRuleSet();
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
effortRuleSet: { findUnique: vi.fn().mockResolvedValue(ruleSet) },
};
const caller = createControllerCaller(db);
const result = await caller.preview({ estimateId: "est_1", ruleSetId: "ers_1" });
expect(result.lines).toHaveLength(1);
expect(result.scopeItemCount).toBe(1);
expect(result.ruleCount).toBe(1);
expect(result.aggregated).toBeDefined();
});
it("throws NOT_FOUND when estimate does not exist", async () => {
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(null) },
effortRuleSet: { findUnique: vi.fn().mockResolvedValue(sampleRuleSet()) },
};
const caller = createControllerCaller(db);
await expect(caller.preview({ estimateId: "nope", ruleSetId: "ers_1" })).rejects.toThrow("Estimate not found");
});
it("throws NOT_FOUND when rule set does not exist", async () => {
const estimate = { id: "est_1", versions: [{ id: "v_1", scopeItems: [] }] };
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
effortRuleSet: { findUnique: vi.fn().mockResolvedValue(null) },
};
const caller = createControllerCaller(db);
await expect(caller.preview({ estimateId: "est_1", ruleSetId: "nope" })).rejects.toThrow("Effort rule set not found");
});
it("throws NOT_FOUND when estimate has no versions", async () => {
const estimate = { id: "est_1", versions: [] };
const ruleSet = sampleRuleSet();
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
effortRuleSet: { findUnique: vi.fn().mockResolvedValue(ruleSet) },
};
const caller = createControllerCaller(db);
await expect(caller.preview({ estimateId: "est_1", ruleSetId: "ers_1" })).rejects.toThrow("Estimate has no versions");
});
});
// ─── applyRules ──────────────────────────────────────────────────────────────
describe("effortRule.applyRules", () => {
function makeEstimate(versionStatus: string, demandLines: unknown[] = []) {
return {
id: "est_1",
baseCurrency: "EUR",
versions: [
{
id: "v_1",
versionNumber: 1,
status: versionStatus,
scopeItems: [
{
id: "si_1",
name: "Shot_001",
scopeType: "shot",
frameCount: 200,
itemCount: null,
unitMode: "per_frame",
sortOrder: 0,
},
],
demandLines,
},
],
};
}
it("replaces existing demand lines in replace mode", async () => {
const estimate = makeEstimate("WORKING", [{ id: "dl_old" }]);
const ruleSet = sampleRuleSet();
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
effortRuleSet: { findUnique: vi.fn().mockResolvedValue(ruleSet) },
estimateDemandLine: {
deleteMany: vi.fn().mockResolvedValue({ count: 1 }),
createMany: vi.fn().mockResolvedValue({ count: 1 }),
},
auditLog: { create: vi.fn().mockResolvedValue({}) },
};
const caller = createManagerCaller(db);
const result = await caller.applyRules({
estimateId: "est_1",
ruleSetId: "ers_1",
mode: "replace",
});
expect(result.linesGenerated).toBe(1);
expect(db.estimateDemandLine.deleteMany).toHaveBeenCalledWith({
where: { estimateVersionId: "v_1" },
});
expect(db.estimateDemandLine.createMany).toHaveBeenCalledTimes(1);
expect(db.auditLog.create).toHaveBeenCalledTimes(1);
});
it("does not delete existing lines in append mode", async () => {
const estimate = makeEstimate("WORKING", [{ id: "dl_old" }]);
const ruleSet = sampleRuleSet();
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
effortRuleSet: { findUnique: vi.fn().mockResolvedValue(ruleSet) },
estimateDemandLine: {
deleteMany: vi.fn(),
createMany: vi.fn().mockResolvedValue({ count: 1 }),
},
auditLog: { create: vi.fn().mockResolvedValue({}) },
};
const caller = createManagerCaller(db);
const result = await caller.applyRules({
estimateId: "est_1",
ruleSetId: "ers_1",
mode: "append",
});
expect(result.linesGenerated).toBe(1);
expect(db.estimateDemandLine.deleteMany).not.toHaveBeenCalled();
});
it("rejects applying to a non-WORKING version", async () => {
const estimate = makeEstimate("SUBMITTED");
const ruleSet = sampleRuleSet();
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
effortRuleSet: { findUnique: vi.fn().mockResolvedValue(ruleSet) },
estimateDemandLine: { deleteMany: vi.fn(), createMany: vi.fn() },
auditLog: { create: vi.fn() },
};
const caller = createManagerCaller(db);
await expect(
caller.applyRules({ estimateId: "est_1", ruleSetId: "ers_1", mode: "replace" }),
).rejects.toThrow("Can only apply rules to a WORKING version");
});
it("throws NOT_FOUND when estimate does not exist", async () => {
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(null) },
effortRuleSet: { findUnique: vi.fn().mockResolvedValue(sampleRuleSet()) },
estimateDemandLine: { deleteMany: vi.fn(), createMany: vi.fn() },
auditLog: { create: vi.fn() },
};
const caller = createManagerCaller(db);
await expect(
caller.applyRules({ estimateId: "nope", ruleSetId: "ers_1", mode: "replace" }),
).rejects.toThrow("Estimate not found");
});
it("throws NOT_FOUND when estimate has no versions", async () => {
const estimate = { id: "est_1", baseCurrency: "EUR", versions: [] };
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
effortRuleSet: { findUnique: vi.fn().mockResolvedValue(sampleRuleSet()) },
estimateDemandLine: { deleteMany: vi.fn(), createMany: vi.fn() },
auditLog: { create: vi.fn() },
};
const caller = createManagerCaller(db);
await expect(
caller.applyRules({ estimateId: "est_1", ruleSetId: "ers_1", mode: "replace" }),
).rejects.toThrow("Estimate has no versions");
});
it("creates demand lines with correct metadata shape", async () => {
const estimate = makeEstimate("WORKING");
const ruleSet = sampleRuleSet();
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
effortRuleSet: { findUnique: vi.fn().mockResolvedValue(ruleSet) },
estimateDemandLine: {
deleteMany: vi.fn().mockResolvedValue({ count: 0 }),
createMany: vi.fn().mockResolvedValue({ count: 1 }),
},
auditLog: { create: vi.fn().mockResolvedValue({}) },
};
const caller = createManagerCaller(db);
await caller.applyRules({ estimateId: "est_1", ruleSetId: "ers_1", mode: "replace" });
const createManyArg = db.estimateDemandLine.createMany.mock.calls[0][0];
const firstLine = createManyArg.data[0];
expect(firstLine.estimateVersionId).toBe("v_1");
expect(firstLine.lineType).toBe("LABOR");
expect(firstLine.currency).toBe("EUR");
expect(firstLine.costRateCents).toBe(0);
expect(firstLine.billRateCents).toBe(0);
expect(firstLine.metadata).toEqual(
expect.objectContaining({
effortRule: expect.objectContaining({
ruleSetId: "ers_1",
ruleSetName: "VFX Standard",
}),
}),
);
});
});
@@ -0,0 +1,443 @@
import { SystemRole } from "@planarchy/shared";
import { describe, expect, it, vi } from "vitest";
import { entitlementRouter } from "../router/entitlement.js";
import { createCallerFactory } from "../trpc.js";
// Mock @planarchy/db to provide the enums used in the router
vi.mock("@planarchy/db", () => ({
VacationType: { ANNUAL: "ANNUAL", SICK: "SICK", OTHER: "OTHER", PUBLIC_HOLIDAY: "PUBLIC_HOLIDAY" },
VacationStatus: { APPROVED: "APPROVED", PENDING: "PENDING", REJECTED: "REJECTED" },
}));
const createCaller = createCallerFactory(entitlementRouter);
// ── Caller factories ─────────────────────────────────────────────────────────
function createProtectedCaller(db: Record<string, unknown>) {
return createCaller({
session: {
user: { email: "user@example.com", name: "User", image: null },
expires: "2099-01-01T00:00:00.000Z",
},
db: db as never,
dbUser: {
id: "user_1",
systemRole: SystemRole.USER,
permissionOverrides: null,
},
});
}
function createManagerCaller(db: Record<string, unknown>) {
return createCaller({
session: {
user: { email: "mgr@example.com", name: "Manager", image: null },
expires: "2099-01-01T00:00:00.000Z",
},
db: db as never,
dbUser: {
id: "user_mgr",
systemRole: SystemRole.MANAGER,
permissionOverrides: null,
},
});
}
function createAdminCaller(db: Record<string, unknown>) {
return createCaller({
session: {
user: { email: "admin@example.com", name: "Admin", image: null },
expires: "2099-01-01T00:00:00.000Z",
},
db: db as never,
dbUser: {
id: "user_admin",
systemRole: SystemRole.ADMIN,
permissionOverrides: null,
},
});
}
// ── Sample data ──────────────────────────────────────────────────────────────
function sampleEntitlement(overrides: Record<string, unknown> = {}) {
return {
id: "ent_1",
resourceId: "res_1",
year: 2026,
entitledDays: 30,
carryoverDays: 2,
usedDays: 5,
pendingDays: 3,
createdAt: new Date(),
updatedAt: new Date(),
...overrides,
};
}
// ─── getBalance ──────────────────────────────────────────────────────────────
describe("entitlement.getBalance", () => {
it("returns vacation balance for a resource and year", async () => {
const entitlement = sampleEntitlement();
const db = {
systemSettings: {
findUnique: vi.fn().mockResolvedValue({ id: "singleton", vacationDefaultDays: 28 }),
},
vacationEntitlement: {
findUnique: vi.fn().mockResolvedValue(entitlement),
update: vi.fn().mockResolvedValue(entitlement),
},
vacation: {
findMany: vi.fn().mockResolvedValue([]),
},
};
const caller = createProtectedCaller(db);
const result = await caller.getBalance({ resourceId: "res_1", year: 2026 });
expect(result.year).toBe(2026);
expect(result.resourceId).toBe("res_1");
expect(result.entitledDays).toBe(30);
expect(result.remainingDays).toBe(22); // 30 - 5 - 3
expect(result).toHaveProperty("sickDays");
});
it("creates entitlement with carryover when none exists", async () => {
const prevEntitlement = sampleEntitlement({
id: "ent_prev",
year: 2025,
entitledDays: 28,
usedDays: 20,
pendingDays: 0,
});
const createdEntitlement = sampleEntitlement({
year: 2026,
entitledDays: 36, // 28 default + 8 carryover
carryoverDays: 8,
usedDays: 0,
pendingDays: 0,
});
const db = {
systemSettings: {
findUnique: vi.fn().mockResolvedValue({ id: "singleton", vacationDefaultDays: 28 }),
},
vacationEntitlement: {
findUnique: vi
.fn()
.mockResolvedValueOnce(null) // current year not found
.mockResolvedValueOnce(prevEntitlement), // previous year found
create: vi.fn().mockResolvedValue(createdEntitlement),
update: vi.fn().mockResolvedValue(createdEntitlement),
},
vacation: {
findMany: vi.fn().mockResolvedValue([]),
},
};
const caller = createProtectedCaller(db);
const result = await caller.getBalance({ resourceId: "res_1", year: 2026 });
expect(result.entitledDays).toBe(36);
expect(result.carryoverDays).toBe(8);
expect(db.vacationEntitlement.create).toHaveBeenCalledWith(
expect.objectContaining({
data: expect.objectContaining({
resourceId: "res_1",
year: 2026,
carryoverDays: 8,
}),
}),
);
});
it("uses default of 28 days when no system settings exist", async () => {
const entitlement = sampleEntitlement({ entitledDays: 28, carryoverDays: 0 });
const db = {
systemSettings: {
findUnique: vi.fn().mockResolvedValue(null),
},
vacationEntitlement: {
findUnique: vi.fn().mockResolvedValue(entitlement),
update: vi.fn().mockResolvedValue(entitlement),
},
vacation: {
findMany: vi.fn().mockResolvedValue([]),
},
};
const caller = createProtectedCaller(db);
const result = await caller.getBalance({ resourceId: "res_1", year: 2026 });
expect(result.entitledDays).toBe(28);
});
it("counts sick days separately", async () => {
const entitlement = sampleEntitlement({ usedDays: 0, pendingDays: 0 });
const db = {
systemSettings: {
findUnique: vi.fn().mockResolvedValue(null),
},
vacationEntitlement: {
findUnique: vi.fn().mockResolvedValue(entitlement),
update: vi.fn().mockResolvedValue(entitlement),
},
vacation: {
findMany: vi
.fn()
// First call: balance-type vacations (for syncEntitlement)
.mockResolvedValueOnce([])
// Second call: sick days
.mockResolvedValueOnce([
{
startDate: new Date("2026-03-10"),
endDate: new Date("2026-03-12"),
isHalfDay: false,
},
]),
},
};
const caller = createProtectedCaller(db);
const result = await caller.getBalance({ resourceId: "res_1", year: 2026 });
expect(result.sickDays).toBe(3);
});
});
// ─── get ─────────────────────────────────────────────────────────────────────
describe("entitlement.get", () => {
it("returns existing entitlement (manager role)", async () => {
const entitlement = sampleEntitlement();
const db = {
systemSettings: {
findUnique: vi.fn().mockResolvedValue(null),
},
vacationEntitlement: {
findUnique: vi.fn().mockResolvedValue(entitlement),
},
};
const caller = createManagerCaller(db);
const result = await caller.get({ resourceId: "res_1", year: 2026 });
expect(result.id).toBe("ent_1");
expect(result.entitledDays).toBe(30);
});
it("rejects access by a regular user (FORBIDDEN)", async () => {
const db = {
systemSettings: {
findUnique: vi.fn(),
},
vacationEntitlement: {
findUnique: vi.fn(),
},
};
const caller = createProtectedCaller(db);
await expect(caller.get({ resourceId: "res_1", year: 2026 })).rejects.toThrow();
});
});
// ─── set ─────────────────────────────────────────────────────────────────────
describe("entitlement.set", () => {
it("updates existing entitlement", async () => {
const existing = sampleEntitlement();
const updated = { ...existing, entitledDays: 35 };
const db = {
vacationEntitlement: {
findUnique: vi.fn().mockResolvedValue(existing),
update: vi.fn().mockResolvedValue(updated),
create: vi.fn(),
},
};
const caller = createManagerCaller(db);
const result = await caller.set({
resourceId: "res_1",
year: 2026,
entitledDays: 35,
});
expect(result.entitledDays).toBe(35);
expect(db.vacationEntitlement.update).toHaveBeenCalledWith(
expect.objectContaining({
where: { id: "ent_1" },
data: { entitledDays: 35 },
}),
);
expect(db.vacationEntitlement.create).not.toHaveBeenCalled();
});
it("creates new entitlement when none exists", async () => {
const created = sampleEntitlement({ entitledDays: 30, carryoverDays: 0 });
const db = {
vacationEntitlement: {
findUnique: vi.fn().mockResolvedValue(null),
update: vi.fn(),
create: vi.fn().mockResolvedValue(created),
},
};
const caller = createManagerCaller(db);
const result = await caller.set({
resourceId: "res_1",
year: 2026,
entitledDays: 30,
});
expect(result.entitledDays).toBe(30);
expect(db.vacationEntitlement.create).toHaveBeenCalledWith(
expect.objectContaining({
data: expect.objectContaining({
resourceId: "res_1",
year: 2026,
entitledDays: 30,
carryoverDays: 0,
usedDays: 0,
pendingDays: 0,
}),
}),
);
expect(db.vacationEntitlement.update).not.toHaveBeenCalled();
});
});
// ─── bulkSet ─────────────────────────────────────────────────────────────────
describe("entitlement.bulkSet", () => {
it("upserts entitlements for all active resources (admin role)", async () => {
const resources = [{ id: "res_1" }, { id: "res_2" }, { id: "res_3" }];
const db = {
resource: {
findMany: vi.fn().mockResolvedValue(resources),
},
vacationEntitlement: {
upsert: vi.fn().mockResolvedValue(sampleEntitlement()),
},
};
const caller = createAdminCaller(db);
const result = await caller.bulkSet({
year: 2026,
entitledDays: 30,
});
expect(result.updated).toBe(3);
expect(db.vacationEntitlement.upsert).toHaveBeenCalledTimes(3);
expect(db.resource.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: expect.objectContaining({ isActive: true }),
}),
);
});
it("filters by resourceIds when provided", async () => {
const resources = [{ id: "res_1" }];
const db = {
resource: {
findMany: vi.fn().mockResolvedValue(resources),
},
vacationEntitlement: {
upsert: vi.fn().mockResolvedValue(sampleEntitlement()),
},
};
const caller = createAdminCaller(db);
await caller.bulkSet({
year: 2026,
entitledDays: 30,
resourceIds: ["res_1"],
});
expect(db.resource.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: expect.objectContaining({
isActive: true,
id: { in: ["res_1"] },
}),
}),
);
});
it("rejects bulk set by a manager (admin only)", async () => {
const db = {
resource: { findMany: vi.fn() },
vacationEntitlement: { upsert: vi.fn() },
};
const caller = createManagerCaller(db);
await expect(
caller.bulkSet({ year: 2026, entitledDays: 30 }),
).rejects.toThrow();
});
});
// ─── getYearSummary ──────────────────────────────────────────────────────────
describe("entitlement.getYearSummary", () => {
it("returns summary for all active resources (manager role)", async () => {
const resources = [
{ id: "res_1", displayName: "Alice", eid: "alice", chapter: "VFX" },
{ id: "res_2", displayName: "Bob", eid: "bob", chapter: "Animation" },
];
const entitlement = sampleEntitlement({ usedDays: 5, pendingDays: 2 });
const db = {
systemSettings: {
findUnique: vi.fn().mockResolvedValue({ id: "singleton", vacationDefaultDays: 28 }),
},
resource: {
findMany: vi.fn().mockResolvedValue(resources),
},
vacationEntitlement: {
findUnique: vi.fn().mockResolvedValue(entitlement),
update: vi.fn().mockResolvedValue(entitlement),
},
vacation: {
findMany: vi.fn().mockResolvedValue([]),
},
};
const caller = createManagerCaller(db);
const result = await caller.getYearSummary({ year: 2026 });
expect(result).toHaveLength(2);
expect(result[0]).toHaveProperty("resourceId");
expect(result[0]).toHaveProperty("displayName");
expect(result[0]).toHaveProperty("remainingDays");
});
it("filters by chapter when provided", async () => {
const db = {
systemSettings: {
findUnique: vi.fn().mockResolvedValue(null),
},
resource: {
findMany: vi.fn().mockResolvedValue([]),
},
vacationEntitlement: {
findUnique: vi.fn(),
update: vi.fn(),
},
vacation: {
findMany: vi.fn(),
},
};
const caller = createManagerCaller(db);
await caller.getYearSummary({ year: 2026, chapter: "VFX" });
expect(db.resource.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: expect.objectContaining({
isActive: true,
chapter: "VFX",
}),
}),
);
});
});
File diff suppressed because it is too large Load Diff
@@ -0,0 +1,629 @@
import { SystemRole } from "@planarchy/shared";
import { describe, expect, it, vi } from "vitest";
import { experienceMultiplierRouter } from "../router/experience-multiplier.js";
import { createCallerFactory } from "../trpc.js";
// Mock the engine — we focus on the router/DB layer, not the pure engine logic
vi.mock("@planarchy/engine", () => ({
applyExperienceMultipliers: vi.fn().mockReturnValue({
adjustedCostRateCents: 12000,
adjustedBillRateCents: 18000,
adjustedHours: 110,
appliedRules: ["Rate multiplied (chapter=VFX): cost x1.2, bill x1.2"],
}),
applyExperienceMultipliersBatch: vi.fn().mockReturnValue({
results: [
{
adjustedCostRateCents: 12000,
adjustedBillRateCents: 18000,
adjustedHours: 110,
appliedRules: ["Rate multiplied (chapter=VFX): cost x1.2, bill x1.2"],
},
],
totalOriginalHours: 100,
totalAdjustedHours: 110,
linesAdjusted: 1,
}),
}));
const createCaller = createCallerFactory(experienceMultiplierRouter);
function createControllerCaller(db: Record<string, unknown>) {
return createCaller({
session: {
user: { email: "ctrl@example.com", name: "Controller", image: null },
expires: "2099-01-01T00:00:00.000Z",
},
db: db as never,
dbUser: {
id: "user_ctrl",
systemRole: SystemRole.CONTROLLER,
permissionOverrides: null,
},
});
}
function createManagerCaller(db: Record<string, unknown>) {
return createCaller({
session: {
user: { email: "mgr@example.com", name: "Manager", image: null },
expires: "2099-01-01T00:00:00.000Z",
},
db: db as never,
dbUser: {
id: "user_mgr",
systemRole: SystemRole.MANAGER,
permissionOverrides: null,
},
});
}
// ── Sample data factories ────────────────────────────────────────────────────
function sampleMultiplierSet(overrides: Record<string, unknown> = {}) {
return {
id: "ems_1",
name: "Standard Multipliers",
description: null,
isDefault: true,
createdAt: new Date(),
updatedAt: new Date(),
rules: [
{
id: "emr_1",
multiplierSetId: "ems_1",
chapter: "VFX",
location: null,
level: null,
costMultiplier: 1.2,
billMultiplier: 1.2,
shoringRatio: null,
additionalEffortRatio: null,
description: null,
sortOrder: 0,
createdAt: new Date(),
updatedAt: new Date(),
},
],
...overrides,
};
}
function sampleDemandLine(overrides: Record<string, unknown> = {}) {
return {
id: "dl_1",
name: "Compositing Senior",
chapter: "VFX",
costRateCents: 10000,
billRateCents: 15000,
hours: 100,
costTotalCents: 1000000,
priceTotalCents: 1500000,
metadata: null,
staffingAttributes: null,
createdAt: new Date(),
...overrides,
};
}
// ─── list ────────────────────────────────────────────────────────────────────
describe("experienceMultiplier.list", () => {
it("returns sets ordered by isDefault desc, name asc", async () => {
const sets = [
sampleMultiplierSet(),
sampleMultiplierSet({ id: "ems_2", name: "Custom", isDefault: false }),
];
const db = {
experienceMultiplierSet: {
findMany: vi.fn().mockResolvedValue(sets),
},
};
const caller = createControllerCaller(db);
const result = await caller.list();
expect(result).toHaveLength(2);
expect(db.experienceMultiplierSet.findMany).toHaveBeenCalledWith(
expect.objectContaining({
orderBy: [{ isDefault: "desc" }, { name: "asc" }],
}),
);
});
});
// ─── getById ─────────────────────────────────────────────────────────────────
describe("experienceMultiplier.getById", () => {
it("returns the multiplier set when found", async () => {
const set = sampleMultiplierSet();
const db = {
experienceMultiplierSet: {
findUnique: vi.fn().mockResolvedValue(set),
},
};
const caller = createControllerCaller(db);
const result = await caller.getById({ id: "ems_1" });
expect(result.id).toBe("ems_1");
expect(result.rules).toHaveLength(1);
});
it("throws NOT_FOUND when set does not exist", async () => {
const db = {
experienceMultiplierSet: {
findUnique: vi.fn().mockResolvedValue(null),
},
};
const caller = createControllerCaller(db);
await expect(caller.getById({ id: "nonexistent" })).rejects.toThrow(
"Experience multiplier set not found",
);
});
});
// ─── create ──────────────────────────────────────────────────────────────────
describe("experienceMultiplier.create", () => {
it("creates a set with rules", async () => {
const created = sampleMultiplierSet();
const db = {
experienceMultiplierSet: {
updateMany: vi.fn().mockResolvedValue({ count: 0 }),
create: vi.fn().mockResolvedValue(created),
},
};
const caller = createManagerCaller(db);
const result = await caller.create({
name: "Standard Multipliers",
isDefault: false,
rules: [
{
chapter: "VFX",
costMultiplier: 1.2,
billMultiplier: 1.2,
sortOrder: 0,
},
],
});
expect(result.id).toBe("ems_1");
expect(db.experienceMultiplierSet.create).toHaveBeenCalledTimes(1);
// isDefault was false, so updateMany should NOT have been called
expect(db.experienceMultiplierSet.updateMany).not.toHaveBeenCalled();
});
it("unsets other defaults when creating a new default set", async () => {
const created = sampleMultiplierSet({ isDefault: true });
const db = {
experienceMultiplierSet: {
updateMany: vi.fn().mockResolvedValue({ count: 1 }),
create: vi.fn().mockResolvedValue(created),
},
};
const caller = createManagerCaller(db);
await caller.create({
name: "Standard Multipliers",
isDefault: true,
rules: [],
});
expect(db.experienceMultiplierSet.updateMany).toHaveBeenCalledWith({
where: { isDefault: true },
data: { isDefault: false },
});
});
});
// ─── update ──────────────────────────────────────────────────────────────────
describe("experienceMultiplier.update", () => {
it("updates name and description without touching rules", async () => {
const existing = sampleMultiplierSet();
const updated = { ...existing, name: "Updated Name" };
const db = {
experienceMultiplierSet: {
findUnique: vi.fn().mockResolvedValue(existing),
updateMany: vi.fn().mockResolvedValue({ count: 0 }),
update: vi.fn().mockResolvedValue(updated),
},
experienceMultiplierRule: {
deleteMany: vi.fn(),
createMany: vi.fn(),
},
};
const caller = createManagerCaller(db);
const result = await caller.update({ id: "ems_1", name: "Updated Name" });
expect(result.name).toBe("Updated Name");
// No rules provided, so rule replacement should not happen
expect(db.experienceMultiplierRule.deleteMany).not.toHaveBeenCalled();
expect(db.experienceMultiplierRule.createMany).not.toHaveBeenCalled();
});
it("replaces rules when rules array is provided", async () => {
const existing = sampleMultiplierSet();
const updated = sampleMultiplierSet({ name: "Updated" });
const db = {
experienceMultiplierSet: {
findUnique: vi.fn().mockResolvedValue(existing),
updateMany: vi.fn().mockResolvedValue({ count: 0 }),
update: vi.fn().mockResolvedValue(updated),
},
experienceMultiplierRule: {
deleteMany: vi.fn().mockResolvedValue({ count: 1 }),
createMany: vi.fn().mockResolvedValue({ count: 2 }),
},
};
const caller = createManagerCaller(db);
await caller.update({
id: "ems_1",
rules: [
{ chapter: "VFX", costMultiplier: 1.3, billMultiplier: 1.3, sortOrder: 0 },
{ location: "India", costMultiplier: 0.7, billMultiplier: 0.9, shoringRatio: 0.5, sortOrder: 1 },
],
});
expect(db.experienceMultiplierRule.deleteMany).toHaveBeenCalledWith({
where: { multiplierSetId: "ems_1" },
});
expect(db.experienceMultiplierRule.createMany).toHaveBeenCalledWith({
data: expect.arrayContaining([
expect.objectContaining({ multiplierSetId: "ems_1", chapter: "VFX" }),
expect.objectContaining({ multiplierSetId: "ems_1", location: "India" }),
]),
});
});
it("throws NOT_FOUND when set does not exist", async () => {
const db = {
experienceMultiplierSet: {
findUnique: vi.fn().mockResolvedValue(null),
updateMany: vi.fn(),
update: vi.fn(),
},
experienceMultiplierRule: { deleteMany: vi.fn(), createMany: vi.fn() },
};
const caller = createManagerCaller(db);
await expect(caller.update({ id: "nonexistent", name: "X" })).rejects.toThrow(
"Experience multiplier set not found",
);
});
});
// ─── delete ──────────────────────────────────────────────────────────────────
describe("experienceMultiplier.delete", () => {
it("deletes the set and returns its id", async () => {
const existing = sampleMultiplierSet();
const db = {
experienceMultiplierSet: {
findUnique: vi.fn().mockResolvedValue(existing),
delete: vi.fn().mockResolvedValue(existing),
},
};
const caller = createManagerCaller(db);
const result = await caller.delete({ id: "ems_1" });
expect(result).toEqual({ id: "ems_1" });
expect(db.experienceMultiplierSet.delete).toHaveBeenCalledWith({ where: { id: "ems_1" } });
});
it("throws NOT_FOUND when set does not exist", async () => {
const db = {
experienceMultiplierSet: {
findUnique: vi.fn().mockResolvedValue(null),
delete: vi.fn(),
},
};
const caller = createManagerCaller(db);
await expect(caller.delete({ id: "nonexistent" })).rejects.toThrow(
"Experience multiplier set not found",
);
});
});
// ─── preview ─────────────────────────────────────────────────────────────────
describe("experienceMultiplier.preview", () => {
function makeEstimate(demandLines: unknown[] = [sampleDemandLine()]) {
return {
id: "est_1",
versions: [
{
id: "v_1",
versionNumber: 1,
status: "WORKING",
demandLines,
},
],
};
}
it("returns preview results with summary stats", async () => {
const estimate = makeEstimate();
const multiplierSet = sampleMultiplierSet();
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
experienceMultiplierSet: { findUnique: vi.fn().mockResolvedValue(multiplierSet) },
};
const caller = createControllerCaller(db);
const result = await caller.preview({ estimateId: "est_1", multiplierSetId: "ems_1" });
expect(result.previews).toHaveLength(1);
expect(result.demandLineCount).toBe(1);
expect(result.multiplierSetName).toBe("Standard Multipliers");
expect(result.ruleCount).toBe(1);
// The mock returns adjusted values different from original, so hasChanges = true
expect(result.previews[0].hasChanges).toBe(true);
expect(result.previews[0].originalCostRateCents).toBe(10000);
expect(result.previews[0].adjustedCostRateCents).toBe(12000);
expect(result.linesChanged).toBe(1);
});
it("throws NOT_FOUND when estimate does not exist", async () => {
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(null) },
experienceMultiplierSet: { findUnique: vi.fn().mockResolvedValue(sampleMultiplierSet()) },
};
const caller = createControllerCaller(db);
await expect(caller.preview({ estimateId: "nope", multiplierSetId: "ems_1" })).rejects.toThrow(
"Estimate not found",
);
});
it("throws NOT_FOUND when multiplier set does not exist", async () => {
const estimate = makeEstimate();
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
experienceMultiplierSet: { findUnique: vi.fn().mockResolvedValue(null) },
};
const caller = createControllerCaller(db);
await expect(caller.preview({ estimateId: "est_1", multiplierSetId: "nope" })).rejects.toThrow(
"Experience multiplier set not found",
);
});
it("throws NOT_FOUND when estimate has no versions", async () => {
const estimate = { id: "est_1", versions: [] };
const multiplierSet = sampleMultiplierSet();
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
experienceMultiplierSet: { findUnique: vi.fn().mockResolvedValue(multiplierSet) },
};
const caller = createControllerCaller(db);
await expect(caller.preview({ estimateId: "est_1", multiplierSetId: "ems_1" })).rejects.toThrow(
"Estimate has no versions",
);
});
it("reports no changes when rates are unchanged", async () => {
// Import the mock to override for this test
const { applyExperienceMultipliers } = await import("@planarchy/engine");
const mockFn = applyExperienceMultipliers as ReturnType<typeof vi.fn>;
mockFn.mockReturnValueOnce({
adjustedCostRateCents: 10000,
adjustedBillRateCents: 15000,
adjustedHours: 100,
appliedRules: ["No matching rule found -- values unchanged."],
});
const estimate = makeEstimate();
const multiplierSet = sampleMultiplierSet();
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
experienceMultiplierSet: { findUnique: vi.fn().mockResolvedValue(multiplierSet) },
};
const caller = createControllerCaller(db);
const result = await caller.preview({ estimateId: "est_1", multiplierSetId: "ems_1" });
expect(result.linesChanged).toBe(0);
expect(result.previews[0].hasChanges).toBe(false);
});
});
// ─── applyRules ──────────────────────────────────────────────────────────────
describe("experienceMultiplier.applyRules", () => {
function makeEstimate(versionStatus: string, demandLines: unknown[] = [sampleDemandLine()]) {
return {
id: "est_1",
versions: [
{
id: "v_1",
versionNumber: 1,
status: versionStatus,
demandLines,
},
],
};
}
it("updates demand lines with adjusted rates and creates audit log", async () => {
const estimate = makeEstimate("WORKING");
const multiplierSet = sampleMultiplierSet();
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
experienceMultiplierSet: { findUnique: vi.fn().mockResolvedValue(multiplierSet) },
estimateDemandLine: {
update: vi.fn().mockResolvedValue({}),
},
auditLog: { create: vi.fn().mockResolvedValue({}) },
};
const caller = createManagerCaller(db);
const result = await caller.applyRules({
estimateId: "est_1",
multiplierSetId: "ems_1",
});
expect(result.linesUpdated).toBe(1);
expect(result.totalOriginalHours).toBe(100);
expect(result.totalAdjustedHours).toBe(110);
expect(db.estimateDemandLine.update).toHaveBeenCalledTimes(1);
// Verify the update call contains the adjusted rates and metadata
const updateCall = db.estimateDemandLine.update.mock.calls[0][0];
expect(updateCall.where).toEqual({ id: "dl_1" });
expect(updateCall.data.costRateCents).toBe(12000);
expect(updateCall.data.billRateCents).toBe(18000);
expect(updateCall.data.hours).toBe(110);
expect(updateCall.data.costTotalCents).toBe(Math.round(12000 * 110));
expect(updateCall.data.priceTotalCents).toBe(Math.round(18000 * 110));
expect(updateCall.data.metadata.experienceMultiplier).toEqual(
expect.objectContaining({
setId: "ems_1",
setName: "Standard Multipliers",
originalCostRateCents: 10000,
originalBillRateCents: 15000,
originalHours: 100,
}),
);
// Audit log should be created
expect(db.auditLog.create).toHaveBeenCalledTimes(1);
const auditCall = db.auditLog.create.mock.calls[0][0];
expect(auditCall.data.entityType).toBe("Estimate");
expect(auditCall.data.entityId).toBe("est_1");
expect(auditCall.data.action).toBe("UPDATE");
expect(auditCall.data.userId).toBe("user_mgr");
});
it("skips unchanged lines (no update call)", async () => {
const { applyExperienceMultipliersBatch } = await import("@planarchy/engine");
const mockFn = applyExperienceMultipliersBatch as ReturnType<typeof vi.fn>;
mockFn.mockReturnValueOnce({
results: [
{
adjustedCostRateCents: 10000,
adjustedBillRateCents: 15000,
adjustedHours: 100,
appliedRules: ["No matching rule found."],
},
],
totalOriginalHours: 100,
totalAdjustedHours: 100,
linesAdjusted: 0,
});
const estimate = makeEstimate("WORKING");
const multiplierSet = sampleMultiplierSet();
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
experienceMultiplierSet: { findUnique: vi.fn().mockResolvedValue(multiplierSet) },
estimateDemandLine: {
update: vi.fn(),
},
auditLog: { create: vi.fn().mockResolvedValue({}) },
};
const caller = createManagerCaller(db);
const result = await caller.applyRules({
estimateId: "est_1",
multiplierSetId: "ems_1",
});
expect(result.linesUpdated).toBe(0);
expect(db.estimateDemandLine.update).not.toHaveBeenCalled();
});
it("rejects applying to a non-WORKING version", async () => {
const estimate = makeEstimate("SUBMITTED");
const multiplierSet = sampleMultiplierSet();
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
experienceMultiplierSet: { findUnique: vi.fn().mockResolvedValue(multiplierSet) },
estimateDemandLine: { update: vi.fn() },
auditLog: { create: vi.fn() },
};
const caller = createManagerCaller(db);
await expect(
caller.applyRules({ estimateId: "est_1", multiplierSetId: "ems_1" }),
).rejects.toThrow("Can only apply multipliers to a WORKING version");
});
it("throws NOT_FOUND when estimate does not exist", async () => {
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(null) },
experienceMultiplierSet: { findUnique: vi.fn().mockResolvedValue(sampleMultiplierSet()) },
estimateDemandLine: { update: vi.fn() },
auditLog: { create: vi.fn() },
};
const caller = createManagerCaller(db);
await expect(
caller.applyRules({ estimateId: "nope", multiplierSetId: "ems_1" }),
).rejects.toThrow("Estimate not found");
});
it("throws NOT_FOUND when multiplier set does not exist", async () => {
const estimate = makeEstimate("WORKING");
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
experienceMultiplierSet: { findUnique: vi.fn().mockResolvedValue(null) },
estimateDemandLine: { update: vi.fn() },
auditLog: { create: vi.fn() },
};
const caller = createManagerCaller(db);
await expect(
caller.applyRules({ estimateId: "est_1", multiplierSetId: "nope" }),
).rejects.toThrow("Experience multiplier set not found");
});
it("throws NOT_FOUND when estimate has no versions", async () => {
const estimate = { id: "est_1", versions: [] };
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
experienceMultiplierSet: { findUnique: vi.fn().mockResolvedValue(sampleMultiplierSet()) },
estimateDemandLine: { update: vi.fn() },
auditLog: { create: vi.fn() },
};
const caller = createManagerCaller(db);
await expect(
caller.applyRules({ estimateId: "est_1", multiplierSetId: "ems_1" }),
).rejects.toThrow("Estimate has no versions");
});
it("preserves existing metadata when updating demand lines", async () => {
const lineWithMetadata = sampleDemandLine({
metadata: { someField: "existing-value", anotherField: 42 },
});
const estimate = makeEstimate("WORKING", [lineWithMetadata]);
const multiplierSet = sampleMultiplierSet();
const db = {
estimate: { findUnique: vi.fn().mockResolvedValue(estimate) },
experienceMultiplierSet: { findUnique: vi.fn().mockResolvedValue(multiplierSet) },
estimateDemandLine: {
update: vi.fn().mockResolvedValue({}),
},
auditLog: { create: vi.fn().mockResolvedValue({}) },
};
const caller = createManagerCaller(db);
await caller.applyRules({ estimateId: "est_1", multiplierSetId: "ems_1" });
const updateCall = db.estimateDemandLine.update.mock.calls[0][0];
// Existing metadata fields should be preserved alongside experienceMultiplier
expect(updateCall.data.metadata.someField).toBe("existing-value");
expect(updateCall.data.metadata.anotherField).toBe(42);
expect(updateCall.data.metadata.experienceMultiplier).toBeDefined();
});
});
@@ -0,0 +1,263 @@
import { SystemRole } from "@planarchy/shared";
import { describe, expect, it, vi } from "vitest";
import { notificationRouter } from "../router/notification.js";
import { createCallerFactory } from "../trpc.js";
// Mock the SSE event bus — we don't test real event emission here
vi.mock("../sse/event-bus.js", () => ({
emitNotificationCreated: vi.fn(),
}));
const createCaller = createCallerFactory(notificationRouter);
// ── Caller factories ─────────────────────────────────────────────────────────
function createProtectedCaller(db: Record<string, unknown>) {
return createCaller({
session: {
user: { email: "user@example.com", name: "User", image: null },
expires: "2099-01-01T00:00:00.000Z",
},
db: db as never,
dbUser: {
id: "user_1",
systemRole: SystemRole.USER,
permissionOverrides: null,
},
});
}
function createManagerCaller(db: Record<string, unknown>) {
return createCaller({
session: {
user: { email: "mgr@example.com", name: "Manager", image: null },
expires: "2099-01-01T00:00:00.000Z",
},
db: db as never,
dbUser: {
id: "user_mgr",
systemRole: SystemRole.MANAGER,
permissionOverrides: null,
},
});
}
// ── Sample data ──────────────────────────────────────────────────────────────
function sampleNotification(overrides: Record<string, unknown> = {}) {
return {
id: "notif_1",
userId: "user_1",
type: "VACATION_APPROVED",
title: "Vacation approved",
body: null,
entityId: null,
entityType: null,
readAt: null,
createdAt: new Date("2026-01-15T10:00:00Z"),
...overrides,
};
}
/** DB mock that resolves the session user for resolveUserId */
function withUserLookup(db: Record<string, unknown>, userId = "user_1") {
return {
user: {
findUnique: vi.fn().mockResolvedValue({ id: userId }),
},
...db,
};
}
// ─── list ────────────────────────────────────────────────────────────────────
describe("notification.list", () => {
it("returns notifications for the current user", async () => {
const notifications = [sampleNotification(), sampleNotification({ id: "notif_2" })];
const db = withUserLookup({
notification: {
findMany: vi.fn().mockResolvedValue(notifications),
},
});
const caller = createProtectedCaller(db);
const result = await caller.list({ limit: 50 });
expect(result).toHaveLength(2);
expect(db.notification.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: expect.objectContaining({ userId: "user_1" }),
orderBy: { createdAt: "desc" },
take: 50,
}),
);
});
it("filters to unread only when unreadOnly is true", async () => {
const db = withUserLookup({
notification: {
findMany: vi.fn().mockResolvedValue([]),
},
});
const caller = createProtectedCaller(db);
await caller.list({ unreadOnly: true, limit: 10 });
expect(db.notification.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: expect.objectContaining({ userId: "user_1", readAt: null }),
take: 10,
}),
);
});
});
// ─── unreadCount ─────────────────────────────────────────────────────────────
describe("notification.unreadCount", () => {
it("returns count of unread notifications", async () => {
const db = withUserLookup({
notification: {
count: vi.fn().mockResolvedValue(5),
},
});
const caller = createProtectedCaller(db);
const result = await caller.unreadCount();
expect(result).toBe(5);
expect(db.notification.count).toHaveBeenCalledWith(
expect.objectContaining({
where: { userId: "user_1", readAt: null },
}),
);
});
});
// ─── markRead ────────────────────────────────────────────────────────────────
describe("notification.markRead", () => {
it("marks a single notification as read when id is provided", async () => {
const db = withUserLookup({
notification: {
update: vi.fn().mockResolvedValue(sampleNotification({ readAt: new Date() })),
updateMany: vi.fn(),
},
});
const caller = createProtectedCaller(db);
await caller.markRead({ id: "notif_1" });
expect(db.notification.update).toHaveBeenCalledWith(
expect.objectContaining({
where: { id: "notif_1", userId: "user_1" },
data: expect.objectContaining({ readAt: expect.any(Date) }),
}),
);
expect(db.notification.updateMany).not.toHaveBeenCalled();
});
it("marks all unread notifications as read when no id is provided", async () => {
const db = withUserLookup({
notification: {
update: vi.fn(),
updateMany: vi.fn().mockResolvedValue({ count: 3 }),
},
});
const caller = createProtectedCaller(db);
await caller.markRead({});
expect(db.notification.updateMany).toHaveBeenCalledWith(
expect.objectContaining({
where: { userId: "user_1", readAt: null },
data: expect.objectContaining({ readAt: expect.any(Date) }),
}),
);
expect(db.notification.update).not.toHaveBeenCalled();
});
});
// ─── create ──────────────────────────────────────────────────────────────────
describe("notification.create", () => {
it("creates a notification (manager role)", async () => {
const created = sampleNotification({ userId: "target_user" });
const db = withUserLookup(
{
notification: {
create: vi.fn().mockResolvedValue(created),
},
},
"user_mgr",
);
const caller = createManagerCaller(db);
const result = await caller.create({
userId: "target_user",
type: "INFO",
title: "Test notification",
});
expect(result.id).toBe("notif_1");
expect(db.notification.create).toHaveBeenCalledWith(
expect.objectContaining({
data: expect.objectContaining({
userId: "target_user",
type: "INFO",
title: "Test notification",
}),
}),
);
});
it("creates a notification with optional fields", async () => {
const created = sampleNotification({
userId: "target_user",
body: "Details here",
entityId: "proj_1",
entityType: "PROJECT",
});
const db = withUserLookup(
{
notification: {
create: vi.fn().mockResolvedValue(created),
},
},
"user_mgr",
);
const caller = createManagerCaller(db);
await caller.create({
userId: "target_user",
type: "INFO",
title: "Test",
body: "Details here",
entityId: "proj_1",
entityType: "PROJECT",
});
expect(db.notification.create).toHaveBeenCalledWith(
expect.objectContaining({
data: expect.objectContaining({
body: "Details here",
entityId: "proj_1",
entityType: "PROJECT",
}),
}),
);
});
it("rejects creation by a regular user (FORBIDDEN)", async () => {
const db = withUserLookup({
notification: {
create: vi.fn(),
},
});
const caller = createProtectedCaller(db);
await expect(
caller.create({ userId: "target", type: "INFO", title: "Nope" }),
).rejects.toThrow();
});
});
@@ -0,0 +1,523 @@
import { SystemRole } from "@planarchy/shared";
import { ResourceType } from "@planarchy/shared";
import { beforeEach, describe, expect, it, vi } from "vitest";
vi.mock("@planarchy/application", async (importOriginal) => {
const actual = await importOriginal<typeof import("@planarchy/application")>();
return {
...actual,
isChargeabilityActualBooking: actual.isChargeabilityActualBooking,
isChargeabilityRelevantProject: actual.isChargeabilityRelevantProject,
listAssignmentBookings: vi.fn(),
recomputeResourceValueScores: vi.fn(),
};
});
import { listAssignmentBookings } from "@planarchy/application";
import { resourceRouter } from "../router/resource.js";
import { createCallerFactory } from "../trpc.js";
const createCaller = createCallerFactory(resourceRouter);
function createControllerCaller(db: Record<string, unknown>) {
return createCaller({
session: {
user: { email: "controller@example.com", name: "Controller", image: null, role: "CONTROLLER" },
expires: "2026-03-14T00:00:00.000Z",
},
db: db as never,
dbUser: {
id: "user_controller",
systemRole: SystemRole.CONTROLLER,
permissionOverrides: null,
},
});
}
function createProtectedCaller(db: Record<string, unknown>) {
return createCaller({
session: {
user: { email: "user@example.com", name: "User", image: null, role: "USER" },
expires: "2026-03-14T00:00:00.000Z",
},
db: db as never,
dbUser: {
id: "user_1",
systemRole: SystemRole.USER,
permissionOverrides: null,
},
});
}
describe("resource router", () => {
beforeEach(() => {
vi.clearAllMocks();
});
it("filters proposed utilization rows unless explicitly requested", async () => {
const resource = {
id: "resource_1",
eid: "E-001",
displayName: "Alice",
email: "alice@example.com",
chapter: "CGI",
lcrCents: 5000,
ucrCents: 9000,
currency: "EUR",
chargeabilityTarget: 80,
availability: {
monday: 8,
tuesday: 8,
wednesday: 8,
thursday: 8,
friday: 8,
},
skills: [],
dynamicFields: {},
blueprintId: null,
isActive: true,
createdAt: new Date("2026-03-01"),
updatedAt: new Date("2026-03-01"),
roleId: null,
portfolioUrl: null,
postalCode: null,
federalState: null,
valueScore: null,
valueScoreBreakdown: null,
valueScoreUpdatedAt: null,
userId: null,
};
const db = {
resource: {
findMany: vi.fn().mockResolvedValue([resource]),
},
};
vi.mocked(listAssignmentBookings).mockResolvedValue([
{
id: "assignment_confirmed",
projectId: "project_1",
resourceId: "resource_1",
startDate: new Date("2026-03-02T00:00:00.000Z"),
endDate: new Date("2026-03-06T00:00:00.000Z"),
hoursPerDay: 4,
dailyCostCents: 0,
status: "CONFIRMED",
project: {
id: "project_1",
name: "Project 1",
shortCode: "P1",
status: "ACTIVE",
orderType: "CLIENT",
dynamicFields: null,
},
resource: { id: "resource_1", displayName: "Alice", chapter: "CGI" },
},
{
id: "assignment_proposed",
projectId: "project_2",
resourceId: "resource_1",
startDate: new Date("2026-03-02T00:00:00.000Z"),
endDate: new Date("2026-03-06T00:00:00.000Z"),
hoursPerDay: 4,
dailyCostCents: 0,
status: "PROPOSED",
project: {
id: "project_2",
name: "Project 2",
shortCode: "P2",
status: "ACTIVE",
orderType: "CLIENT",
dynamicFields: null,
},
resource: { id: "resource_1", displayName: "Alice", chapter: "CGI" },
},
]);
const caller = createControllerCaller(db);
const strict = await caller.listWithUtilization({
startDate: "2026-03-02T00:00:00.000Z",
endDate: "2026-03-08T00:00:00.000Z",
});
const withProposed = await caller.listWithUtilization({
startDate: "2026-03-02T00:00:00.000Z",
endDate: "2026-03-08T00:00:00.000Z",
includeProposed: true,
});
expect(strict[0]).toMatchObject({
bookingCount: 1,
bookedHours: 20,
utilizationPercent: 50,
});
expect(withProposed[0]).toMatchObject({
bookingCount: 2,
bookedHours: 40,
utilizationPercent: 100,
});
});
it("uses a composite displayName/id cursor for stable pagination", async () => {
const db = {
resource: {
findMany: vi.fn().mockResolvedValue([
{ id: "2", displayName: "Alex", eid: "E-002", email: "alex2@example.com" },
{ id: "3", displayName: "Bea", eid: "E-003", email: "bea@example.com" },
]),
count: vi.fn().mockResolvedValue(3),
},
};
const caller = createProtectedCaller(db);
const result = await caller.list({
limit: 1,
cursor: JSON.stringify({ displayName: "Alex", id: "1" }),
});
expect(db.resource.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: expect.objectContaining({
AND: expect.arrayContaining([
{
OR: [
{ displayName: { gt: "Alex" } },
{ displayName: "Alex", id: { gt: "1" } },
],
},
]),
}),
orderBy: [{ displayName: "asc" }, { id: "asc" }],
take: 2,
}),
);
expect(result.nextCursor).toBe(JSON.stringify({ displayName: "Alex", id: "2" }));
});
it("resolves resource ownership server-side without exposing linked user email", async () => {
const db = {
resource: {
findUnique: vi.fn().mockResolvedValue({
id: "resource_1",
eid: "E-001",
displayName: "Alice",
email: "alice@example.com",
chapter: "CGI",
lcrCents: 5000,
ucrCents: 9000,
currency: "EUR",
chargeabilityTarget: 80,
availability: {
monday: 8,
tuesday: 8,
wednesday: 8,
thursday: 8,
friday: 8,
},
skills: [],
dynamicFields: {},
blueprint: null,
blueprintId: null,
isActive: true,
createdAt: new Date("2026-03-01"),
updatedAt: new Date("2026-03-01"),
resourceRoles: [],
areaRole: null,
portfolioUrl: null,
roleId: null,
aiSummary: null,
aiSummaryUpdatedAt: null,
skillMatrixUpdatedAt: null,
valueScore: null,
valueScoreBreakdown: null,
valueScoreUpdatedAt: null,
userId: "user_1",
}),
findMany: vi.fn().mockResolvedValue([]),
},
systemSettings: {
findUnique: vi.fn().mockResolvedValue(null),
},
};
const caller = createProtectedCaller(db);
const result = await caller.getById({ id: "resource_1" });
expect(result).toMatchObject({
id: "resource_1",
displayName: "Alice",
eid: "E-001",
email: "alice@example.com",
isOwnedByCurrentUser: true,
});
expect(result).not.toHaveProperty("user");
expect(db.resource.findUnique).toHaveBeenCalledWith(
expect.objectContaining({
include: expect.not.objectContaining({
user: expect.anything(),
}),
}),
);
});
it("counts imported TBD draft projects in chargeability stats only when proposed work is enabled", async () => {
const db = {
resource: {
findMany: vi.fn().mockResolvedValue([
{
id: "resource_1",
eid: "E-001",
displayName: "Alice",
chapter: "CGI",
chargeabilityTarget: 80,
availability: {
monday: 8,
tuesday: 8,
wednesday: 8,
thursday: 8,
friday: 8,
},
},
]),
},
};
vi.mocked(listAssignmentBookings).mockResolvedValue([
{
id: "assignment_tbd",
projectId: "project_tbd",
resourceId: "resource_1",
startDate: new Date("2026-03-02T00:00:00.000Z"),
endDate: new Date("2026-03-06T00:00:00.000Z"),
hoursPerDay: 4,
dailyCostCents: 0,
status: "PROPOSED",
project: {
id: "project_tbd",
name: "TBD Project",
shortCode: "TBD-P1",
status: "DRAFT",
orderType: "CLIENT",
dynamicFields: { dispoImport: { isTbd: true } },
},
resource: { id: "resource_1", displayName: "Alice", chapter: "CGI" },
},
]);
const caller = createControllerCaller(db);
const strict = await caller.getChargeabilityStats({});
const withProposed = await caller.getChargeabilityStats({ includeProposed: true });
expect(strict[0]?.actualChargeability).toBe(0);
expect(strict[0]?.expectedChargeability).toBeGreaterThan(0);
expect(withProposed[0]?.actualChargeability).toBeGreaterThan(strict[0]?.actualChargeability ?? 0);
expect(withProposed[0]?.expectedChargeability).toBe(strict[0]?.expectedChargeability);
});
it("applies country filters including explicit no-country toggle", async () => {
const db = {
resource: {
findMany: vi.fn().mockResolvedValue([]),
count: vi.fn().mockResolvedValue(0),
},
};
const caller = createProtectedCaller(db);
await caller.list({
countryIds: ["country_de", "country_us"],
includeWithoutCountry: false,
});
expect(db.resource.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: {
AND: expect.arrayContaining([
{ isActive: true },
{ countryId: { in: ["country_de", "country_us"] } },
]),
},
}),
);
});
it("excludes disabled countries while leaving all others visible", async () => {
const db = {
resource: {
findMany: vi.fn().mockResolvedValue([]),
count: vi.fn().mockResolvedValue(0),
},
};
const caller = createProtectedCaller(db);
await caller.list({
excludedCountryIds: ["country_fr"],
includeWithoutCountry: true,
});
expect(db.resource.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: {
AND: expect.arrayContaining([
{ isActive: true },
{ NOT: { countryId: { in: ["country_fr"] } } },
]),
},
}),
);
});
it("applies resource type filters while keeping unspecified rows when requested", async () => {
const db = {
resource: {
findMany: vi.fn().mockResolvedValue([]),
count: vi.fn().mockResolvedValue(0),
},
};
const caller = createProtectedCaller(db);
await caller.list({
resourceTypes: [ResourceType.EMPLOYEE, ResourceType.INTERN],
includeWithoutResourceType: true,
});
expect(db.resource.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: {
AND: expect.arrayContaining([
{ isActive: true },
{
OR: [
{ resourceType: { in: [ResourceType.EMPLOYEE, ResourceType.INTERN] } },
{ resourceType: null },
],
},
]),
},
}),
);
});
it("excludes disabled resource types while leaving all others visible", async () => {
const db = {
resource: {
findMany: vi.fn().mockResolvedValue([]),
count: vi.fn().mockResolvedValue(0),
},
};
const caller = createProtectedCaller(db);
await caller.list({
excludedResourceTypes: [ResourceType.FREELANCER],
includeWithoutResourceType: true,
});
expect(db.resource.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: {
AND: expect.arrayContaining([
{ isActive: true },
{ NOT: { resourceType: { in: [ResourceType.FREELANCER] } } },
]),
},
}),
);
});
it("applies rolled-off and departed filters", async () => {
const db = {
resource: {
findMany: vi.fn().mockResolvedValue([]),
count: vi.fn().mockResolvedValue(0),
},
};
const caller = createProtectedCaller(db);
await caller.list({
rolledOff: true,
departed: false,
});
expect(db.resource.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: {
AND: expect.arrayContaining([
{ isActive: true },
{ rolledOff: true },
{ departed: false },
]),
},
}),
);
});
it("applies multi-select chapter filters", async () => {
const db = {
resource: {
findMany: vi.fn().mockResolvedValue([]),
count: vi.fn().mockResolvedValue(0),
},
};
const caller = createProtectedCaller(db);
await caller.list({
chapters: ["Art Direction", "Project Management"],
});
expect(db.resource.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: {
AND: expect.arrayContaining([
{ isActive: true },
{ chapter: { in: ["Art Direction", "Project Management"] } },
]),
},
}),
);
});
it("supports stable anonymized identities and alias-based filtering", async () => {
const resource = {
id: "resource_anon_1",
eid: "h.noerenberg",
displayName: "Hartmut Noerenberg",
email: "h.noerenberg@accenture.com",
chapter: "Art Direction",
lcrCents: 15000,
isActive: true,
createdAt: new Date("2026-03-01"),
updatedAt: new Date("2026-03-01"),
};
const db = {
systemSettings: {
findUnique: vi.fn().mockResolvedValue({
anonymizationEnabled: true,
anonymizationDomain: "superhartmut.de",
anonymizationSeed: null,
anonymizationMode: "global",
}),
},
resource: {
findMany: vi.fn().mockResolvedValue([resource]),
count: vi.fn(),
},
};
const caller = createProtectedCaller(db);
const first = await caller.list({ limit: 10 });
const alias = first.resources[0];
expect(alias).toBeDefined();
expect(alias?.displayName).not.toBe(resource.displayName);
expect(alias?.eid).not.toBe(resource.eid);
expect(alias?.email).toBe(`${alias?.eid}@superhartmut.de`);
const byAlias = await caller.list({ eids: [alias!.eid], limit: 10 });
const byAliasSearch = await caller.list({ search: alias!.displayName.slice(0, 4), limit: 10 });
expect(byAlias.resources).toHaveLength(1);
expect(byAlias.resources[0]?.id).toBe(resource.id);
expect(byAliasSearch.resources).toHaveLength(1);
expect(byAliasSearch.resources[0]?.id).toBe(resource.id);
});
});
@@ -0,0 +1,297 @@
import { SystemRole } from "@planarchy/shared";
import { describe, expect, it, vi } from "vitest";
import { staffingRouter } from "../router/staffing.js";
import { createCallerFactory } from "../trpc.js";
// Mock the pure-logic packages — we focus on the router/DB layer
vi.mock("@planarchy/staffing", () => ({
rankResources: vi.fn().mockImplementation((input: { resources: { id: string }[] }) =>
input.resources.map((r: { id: string }, i: number) => ({
resourceId: r.id,
score: 80 - i * 10,
breakdown: {
skillScore: 70,
availabilityScore: 90,
costScore: 80,
utilizationScore: 75,
},
})),
),
analyzeUtilization: vi.fn().mockReturnValue({
resourceId: "res_1",
displayName: "Alice",
totalDays: 20,
allocatedDays: 15,
utilizationPercent: 75,
chargeablePercent: 60,
overallocatedDays: 0,
dailyBreakdown: [],
}),
findCapacityWindows: vi.fn().mockReturnValue([
{
startDate: new Date("2026-04-01"),
endDate: new Date("2026-04-10"),
availableHoursPerDay: 6,
},
]),
}));
vi.mock("@planarchy/application", () => ({
listAssignmentBookings: vi.fn().mockResolvedValue([]),
}));
const createCaller = createCallerFactory(staffingRouter);
// ── Caller factories ─────────────────────────────────────────────────────────
function createProtectedCaller(db: Record<string, unknown>) {
return createCaller({
session: {
user: { email: "user@example.com", name: "User", image: null },
expires: "2099-01-01T00:00:00.000Z",
},
db: db as never,
dbUser: {
id: "user_1",
systemRole: SystemRole.USER,
permissionOverrides: null,
},
});
}
// ── Sample data ──────────────────────────────────────────────────────────────
function sampleResource(overrides: Record<string, unknown> = {}) {
return {
id: "res_1",
displayName: "Alice",
eid: "alice",
lcrCents: 7500,
chargeabilityTarget: 80,
availability: { monday: 8, tuesday: 8, wednesday: 8, thursday: 8, friday: 8 },
skills: [
{ skill: "Compositing", proficiency: 4, isMainSkill: true },
{ skill: "Nuke", proficiency: 3, isMainSkill: false, category: "Software" },
],
isActive: true,
valueScore: 85,
chapter: "VFX",
...overrides,
};
}
// ─── getSuggestions ──────────────────────────────────────────────────────────
describe("staffing.getSuggestions", () => {
it("returns ranked suggestions for a staffing demand", async () => {
const resources = [
sampleResource(),
sampleResource({ id: "res_2", displayName: "Bob", eid: "bob", valueScore: 70 }),
];
const db = {
resource: {
findMany: vi.fn().mockResolvedValue(resources),
},
};
const caller = createProtectedCaller(db);
const result = await caller.getSuggestions({
requiredSkills: ["Compositing"],
startDate: new Date("2026-04-01"),
endDate: new Date("2026-04-30"),
hoursPerDay: 8,
});
expect(result).toHaveLength(2);
expect(result[0]).toHaveProperty("resourceId");
expect(result[0]).toHaveProperty("score");
});
it("filters resources by chapter when provided", async () => {
const db = {
resource: {
findMany: vi.fn().mockResolvedValue([]),
},
};
const caller = createProtectedCaller(db);
await caller.getSuggestions({
requiredSkills: ["Compositing"],
startDate: new Date("2026-04-01"),
endDate: new Date("2026-04-30"),
hoursPerDay: 8,
chapter: "VFX",
});
expect(db.resource.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: expect.objectContaining({
isActive: true,
chapter: "VFX",
}),
}),
);
});
it("returns empty array when no resources match", async () => {
const db = {
resource: {
findMany: vi.fn().mockResolvedValue([]),
},
};
const caller = createProtectedCaller(db);
const result = await caller.getSuggestions({
requiredSkills: ["Compositing"],
startDate: new Date("2026-04-01"),
endDate: new Date("2026-04-30"),
hoursPerDay: 8,
});
expect(result).toHaveLength(0);
});
it("passes budget constraint to ranking", async () => {
const resources = [sampleResource()];
const db = {
resource: {
findMany: vi.fn().mockResolvedValue(resources),
},
};
const { rankResources } = await import("@planarchy/staffing");
const caller = createProtectedCaller(db);
await caller.getSuggestions({
requiredSkills: ["Compositing"],
startDate: new Date("2026-04-01"),
endDate: new Date("2026-04-30"),
hoursPerDay: 8,
budgetLcrCentsPerHour: 10000,
});
expect(rankResources).toHaveBeenCalledWith(
expect.objectContaining({
budgetLcrCentsPerHour: 10000,
}),
);
});
});
// ─── analyzeUtilization ──────────────────────────────────────────────────────
describe("staffing.analyzeUtilization", () => {
it("returns utilization analysis for an existing resource", async () => {
const resource = {
id: "res_1",
displayName: "Alice",
chargeabilityTarget: 80,
availability: { monday: 8, tuesday: 8, wednesday: 8, thursday: 8, friday: 8 },
};
const db = {
resource: {
findUnique: vi.fn().mockResolvedValue(resource),
},
};
const caller = createProtectedCaller(db);
const result = await caller.analyzeUtilization({
resourceId: "res_1",
startDate: new Date("2026-04-01"),
endDate: new Date("2026-04-30"),
});
expect(result).toHaveProperty("utilizationPercent");
expect(result.resourceId).toBe("res_1");
});
it("throws NOT_FOUND when resource does not exist", async () => {
const db = {
resource: {
findUnique: vi.fn().mockResolvedValue(null),
},
};
const caller = createProtectedCaller(db);
await expect(
caller.analyzeUtilization({
resourceId: "nonexistent",
startDate: new Date("2026-04-01"),
endDate: new Date("2026-04-30"),
}),
).rejects.toThrow("Resource not found");
});
});
// ─── findCapacity ────────────────────────────────────────────────────────────
describe("staffing.findCapacity", () => {
it("returns capacity windows for an existing resource", async () => {
const resource = {
id: "res_1",
displayName: "Alice",
availability: { monday: 8, tuesday: 8, wednesday: 8, thursday: 8, friday: 8 },
};
const db = {
resource: {
findUnique: vi.fn().mockResolvedValue(resource),
},
};
const caller = createProtectedCaller(db);
const result = await caller.findCapacity({
resourceId: "res_1",
startDate: new Date("2026-04-01"),
endDate: new Date("2026-04-30"),
});
expect(result).toHaveLength(1);
expect(result[0]).toHaveProperty("availableHoursPerDay");
});
it("throws NOT_FOUND when resource does not exist", async () => {
const db = {
resource: {
findUnique: vi.fn().mockResolvedValue(null),
},
};
const caller = createProtectedCaller(db);
await expect(
caller.findCapacity({
resourceId: "nonexistent",
startDate: new Date("2026-04-01"),
endDate: new Date("2026-04-30"),
}),
).rejects.toThrow("Resource not found");
});
it("passes minAvailableHoursPerDay to engine", async () => {
const resource = {
id: "res_1",
displayName: "Alice",
availability: { monday: 8, tuesday: 8, wednesday: 8, thursday: 8, friday: 8 },
};
const db = {
resource: {
findUnique: vi.fn().mockResolvedValue(resource),
},
};
const { findCapacityWindows } = await import("@planarchy/staffing");
const caller = createProtectedCaller(db);
await caller.findCapacity({
resourceId: "res_1",
startDate: new Date("2026-04-01"),
endDate: new Date("2026-04-30"),
minAvailableHoursPerDay: 6,
});
expect(findCapacityWindows).toHaveBeenCalledWith(
expect.anything(),
expect.anything(),
expect.any(Date),
expect.any(Date),
6,
);
});
});
@@ -0,0 +1,854 @@
import { SystemRole } from "@planarchy/shared";
import { VacationStatus, VacationType } from "@planarchy/db";
import { describe, expect, it, vi, beforeEach } from "vitest";
import { vacationRouter } from "../router/vacation.js";
import { createCallerFactory } from "../trpc.js";
vi.mock("../sse/event-bus.js", () => ({
emitVacationCreated: vi.fn(),
emitVacationUpdated: vi.fn(),
emitVacationDeleted: vi.fn(),
emitNotificationCreated: vi.fn(),
}));
vi.mock("../lib/email.js", () => ({
sendEmail: vi.fn(),
}));
const createCaller = createCallerFactory(vacationRouter);
function createProtectedCaller(db: Record<string, unknown>) {
return createCaller({
session: {
user: { email: "user@example.com", name: "User", image: null },
expires: "2026-12-31T00:00:00.000Z",
},
db: db as never,
dbUser: {
id: "user_1",
systemRole: SystemRole.USER,
permissionOverrides: null,
},
});
}
function createManagerCaller(db: Record<string, unknown>) {
return createCaller({
session: {
user: { email: "manager@example.com", name: "Manager", image: null },
expires: "2026-12-31T00:00:00.000Z",
},
db: db as never,
dbUser: {
id: "mgr_1",
systemRole: SystemRole.MANAGER,
permissionOverrides: null,
},
});
}
function createAdminCaller(db: Record<string, unknown>) {
return createCaller({
session: {
user: { email: "admin@example.com", name: "Admin", image: null },
expires: "2026-12-31T00:00:00.000Z",
},
db: db as never,
dbUser: {
id: "admin_1",
systemRole: SystemRole.ADMIN,
permissionOverrides: null,
},
});
}
function createUnauthenticatedCaller(db: Record<string, unknown>) {
return createCaller({
session: null,
db: db as never,
dbUser: null,
});
}
const sampleVacation = {
id: "vac_1",
resourceId: "res_1",
type: VacationType.ANNUAL,
status: VacationStatus.PENDING,
startDate: new Date("2026-06-01"),
endDate: new Date("2026-06-05"),
note: "Summer vacation",
isHalfDay: false,
halfDayPart: null,
requestedById: "user_1",
approvedById: null,
approvedAt: null,
rejectionReason: null,
createdAt: new Date("2026-03-01"),
updatedAt: new Date("2026-03-01"),
resource: { id: "res_1", displayName: "Alice", eid: "E-001" },
requestedBy: { id: "user_1", name: "User", email: "user@example.com" },
approvedBy: null,
};
describe("vacation router", () => {
describe("list", () => {
it("returns vacations with default filters", async () => {
const db = {
vacation: {
findMany: vi.fn().mockResolvedValue([sampleVacation]),
},
};
const caller = createProtectedCaller(db);
const result = await caller.list({});
expect(result).toHaveLength(1);
expect(result[0].id).toBe("vac_1");
expect(db.vacation.findMany).toHaveBeenCalledWith(
expect.objectContaining({
orderBy: { startDate: "asc" },
take: 100,
}),
);
});
it("applies resourceId filter", async () => {
const db = {
vacation: {
findMany: vi.fn().mockResolvedValue([]),
},
};
const caller = createProtectedCaller(db);
await caller.list({ resourceId: "res_1" });
expect(db.vacation.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: expect.objectContaining({ resourceId: "res_1" }),
}),
);
});
it("applies status and type filters", async () => {
const db = {
vacation: {
findMany: vi.fn().mockResolvedValue([]),
},
};
const caller = createProtectedCaller(db);
await caller.list({
status: VacationStatus.APPROVED,
type: VacationType.SICK,
});
expect(db.vacation.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: expect.objectContaining({
status: VacationStatus.APPROVED,
type: VacationType.SICK,
}),
}),
);
});
it("rejects unauthenticated users", async () => {
const db = { vacation: { findMany: vi.fn() } };
const caller = createUnauthenticatedCaller(db);
await expect(caller.list({})).rejects.toThrow("Authentication required");
});
});
describe("getById", () => {
it("returns vacation by id", async () => {
const db = {
vacation: {
findUnique: vi.fn().mockResolvedValue(sampleVacation),
},
};
const caller = createProtectedCaller(db);
const result = await caller.getById({ id: "vac_1" });
expect(result.id).toBe("vac_1");
expect(db.vacation.findUnique).toHaveBeenCalledWith(
expect.objectContaining({
where: { id: "vac_1" },
}),
);
});
it("throws NOT_FOUND for missing vacation", async () => {
const db = {
vacation: {
findUnique: vi.fn().mockResolvedValue(null),
},
};
const caller = createProtectedCaller(db);
await expect(caller.getById({ id: "missing" })).rejects.toThrow("Vacation not found");
});
});
describe("create", () => {
it("creates vacation as PENDING for regular user", async () => {
const createdVacation = {
...sampleVacation,
status: VacationStatus.PENDING,
};
const db = {
user: {
findUnique: vi.fn().mockResolvedValue({ id: "user_1", systemRole: "USER" }),
},
vacation: {
findFirst: vi.fn().mockResolvedValue(null),
create: vi.fn().mockResolvedValue(createdVacation),
},
};
const caller = createProtectedCaller(db);
const result = await caller.create({
resourceId: "res_1",
type: VacationType.ANNUAL,
startDate: new Date("2026-06-01"),
endDate: new Date("2026-06-05"),
});
expect(result.status).toBe(VacationStatus.PENDING);
expect(db.vacation.create).toHaveBeenCalledWith(
expect.objectContaining({
data: expect.objectContaining({
status: VacationStatus.PENDING,
resourceId: "res_1",
type: VacationType.ANNUAL,
}),
}),
);
});
it("creates vacation as APPROVED for manager", async () => {
const createdVacation = {
...sampleVacation,
status: VacationStatus.APPROVED,
approvedById: "mgr_1",
};
const db = {
user: {
findUnique: vi.fn().mockResolvedValue({ id: "mgr_1", systemRole: "MANAGER" }),
},
vacation: {
findFirst: vi.fn().mockResolvedValue(null),
create: vi.fn().mockResolvedValue(createdVacation),
},
};
const caller = createManagerCaller(db);
const result = await caller.create({
resourceId: "res_1",
type: VacationType.ANNUAL,
startDate: new Date("2026-06-01"),
endDate: new Date("2026-06-05"),
});
expect(result.status).toBe(VacationStatus.APPROVED);
expect(db.vacation.create).toHaveBeenCalledWith(
expect.objectContaining({
data: expect.objectContaining({
status: VacationStatus.APPROVED,
approvedById: "mgr_1",
}),
}),
);
});
it("rejects overlapping vacation", async () => {
const db = {
user: {
findUnique: vi.fn().mockResolvedValue({ id: "user_1", systemRole: "USER" }),
},
vacation: {
findFirst: vi.fn().mockResolvedValue({ id: "existing_vac" }),
},
};
const caller = createProtectedCaller(db);
await expect(
caller.create({
resourceId: "res_1",
type: VacationType.ANNUAL,
startDate: new Date("2026-06-01"),
endDate: new Date("2026-06-05"),
}),
).rejects.toThrow("Overlapping vacation already exists");
});
it("rejects when end date is before start date", async () => {
const db = {
user: { findUnique: vi.fn() },
vacation: { findFirst: vi.fn() },
};
const caller = createProtectedCaller(db);
await expect(
caller.create({
resourceId: "res_1",
type: VacationType.ANNUAL,
startDate: new Date("2026-06-05"),
endDate: new Date("2026-06-01"),
}),
).rejects.toThrow();
});
it("supports half-day vacations", async () => {
const createdVacation = {
...sampleVacation,
isHalfDay: true,
halfDayPart: "MORNING",
};
const db = {
user: {
findUnique: vi.fn().mockResolvedValue({ id: "user_1", systemRole: "USER" }),
},
vacation: {
findFirst: vi.fn().mockResolvedValue(null),
create: vi.fn().mockResolvedValue(createdVacation),
},
};
const caller = createProtectedCaller(db);
const result = await caller.create({
resourceId: "res_1",
type: VacationType.ANNUAL,
startDate: new Date("2026-06-01"),
endDate: new Date("2026-06-01"),
isHalfDay: true,
halfDayPart: "MORNING",
});
expect(result.isHalfDay).toBe(true);
expect(db.vacation.create).toHaveBeenCalledWith(
expect.objectContaining({
data: expect.objectContaining({
isHalfDay: true,
halfDayPart: "MORNING",
}),
}),
);
});
});
describe("approve", () => {
it("approves a PENDING vacation", async () => {
const updatedVacation = {
...sampleVacation,
status: VacationStatus.APPROVED,
approvedById: "mgr_1",
};
const db = {
vacation: {
findUnique: vi.fn().mockResolvedValue(sampleVacation),
update: vi.fn().mockResolvedValue(updatedVacation),
},
user: {
findUnique: vi.fn().mockResolvedValue({ id: "mgr_1" }),
},
resource: {
findUnique: vi.fn().mockResolvedValue(null),
},
};
const caller = createManagerCaller(db);
const result = await caller.approve({ id: "vac_1" });
expect(result.status).toBe(VacationStatus.APPROVED);
expect(db.vacation.update).toHaveBeenCalledWith(
expect.objectContaining({
where: { id: "vac_1" },
data: expect.objectContaining({
status: VacationStatus.APPROVED,
rejectionReason: null,
}),
}),
);
});
it("throws NOT_FOUND for missing vacation", async () => {
const db = {
vacation: {
findUnique: vi.fn().mockResolvedValue(null),
},
};
const caller = createManagerCaller(db);
await expect(caller.approve({ id: "missing" })).rejects.toThrow("Vacation not found");
});
it("rejects approving an already APPROVED vacation", async () => {
const db = {
vacation: {
findUnique: vi.fn().mockResolvedValue({
...sampleVacation,
status: VacationStatus.APPROVED,
}),
},
};
const caller = createManagerCaller(db);
await expect(caller.approve({ id: "vac_1" })).rejects.toThrow(
"Only PENDING, CANCELLED, or REJECTED vacations can be approved",
);
});
it("forbids regular users from approving", async () => {
const db = {};
const caller = createProtectedCaller(db);
await expect(caller.approve({ id: "vac_1" })).rejects.toThrow();
});
});
describe("reject", () => {
it("rejects a PENDING vacation", async () => {
const updatedVacation = {
...sampleVacation,
status: VacationStatus.REJECTED,
rejectionReason: "Team conflict",
};
const db = {
vacation: {
findUnique: vi.fn().mockResolvedValue(sampleVacation),
update: vi.fn().mockResolvedValue(updatedVacation),
},
resource: {
findUnique: vi.fn().mockResolvedValue(null),
},
};
const caller = createManagerCaller(db);
const result = await caller.reject({ id: "vac_1", rejectionReason: "Team conflict" });
expect(result.status).toBe(VacationStatus.REJECTED);
expect(db.vacation.update).toHaveBeenCalledWith(
expect.objectContaining({
data: expect.objectContaining({
status: VacationStatus.REJECTED,
rejectionReason: "Team conflict",
}),
}),
);
});
it("throws when rejecting non-PENDING vacation", async () => {
const db = {
vacation: {
findUnique: vi.fn().mockResolvedValue({
...sampleVacation,
status: VacationStatus.APPROVED,
}),
},
};
const caller = createManagerCaller(db);
await expect(caller.reject({ id: "vac_1" })).rejects.toThrow(
"Only PENDING vacations can be rejected",
);
});
});
describe("cancel", () => {
it("cancels an existing vacation", async () => {
const updatedVacation = {
...sampleVacation,
status: VacationStatus.CANCELLED,
};
const db = {
vacation: {
findUnique: vi.fn().mockResolvedValue(sampleVacation),
update: vi.fn().mockResolvedValue(updatedVacation),
},
};
const caller = createProtectedCaller(db);
const result = await caller.cancel({ id: "vac_1" });
expect(result.status).toBe(VacationStatus.CANCELLED);
});
it("throws NOT_FOUND for missing vacation", async () => {
const db = {
vacation: {
findUnique: vi.fn().mockResolvedValue(null),
},
};
const caller = createProtectedCaller(db);
await expect(caller.cancel({ id: "missing" })).rejects.toThrow("Vacation not found");
});
it("throws when already cancelled", async () => {
const db = {
vacation: {
findUnique: vi.fn().mockResolvedValue({
...sampleVacation,
status: VacationStatus.CANCELLED,
}),
},
};
const caller = createProtectedCaller(db);
await expect(caller.cancel({ id: "vac_1" })).rejects.toThrow("Already cancelled");
});
});
describe("batchApprove", () => {
it("approves multiple pending vacations", async () => {
const db = {
user: {
findUnique: vi.fn().mockResolvedValue({ id: "mgr_1" }),
},
vacation: {
findMany: vi.fn().mockResolvedValue([
{ id: "vac_1", resourceId: "res_1" },
{ id: "vac_2", resourceId: "res_2" },
]),
updateMany: vi.fn().mockResolvedValue({ count: 2 }),
},
resource: {
findUnique: vi.fn().mockResolvedValue(null),
},
};
const caller = createManagerCaller(db);
const result = await caller.batchApprove({ ids: ["vac_1", "vac_2"] });
expect(result.approved).toBe(2);
expect(db.vacation.updateMany).toHaveBeenCalledWith(
expect.objectContaining({
where: { id: { in: ["vac_1", "vac_2"] } },
data: expect.objectContaining({
status: VacationStatus.APPROVED,
}),
}),
);
});
it("only approves PENDING vacations from the requested set", async () => {
const db = {
user: {
findUnique: vi.fn().mockResolvedValue({ id: "mgr_1" }),
},
vacation: {
findMany: vi.fn().mockResolvedValue([
{ id: "vac_1", resourceId: "res_1" },
]),
updateMany: vi.fn().mockResolvedValue({ count: 1 }),
},
resource: {
findUnique: vi.fn().mockResolvedValue(null),
},
};
const caller = createManagerCaller(db);
const result = await caller.batchApprove({ ids: ["vac_1", "vac_already_approved"] });
expect(result.approved).toBe(1);
expect(db.vacation.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: { id: { in: ["vac_1", "vac_already_approved"] }, status: VacationStatus.PENDING },
}),
);
});
});
describe("batchReject", () => {
it("rejects multiple pending vacations with optional reason", async () => {
const db = {
vacation: {
findMany: vi.fn().mockResolvedValue([
{ id: "vac_1", resourceId: "res_1" },
]),
updateMany: vi.fn().mockResolvedValue({ count: 1 }),
},
resource: {
findUnique: vi.fn().mockResolvedValue(null),
},
};
const caller = createManagerCaller(db);
const result = await caller.batchReject({
ids: ["vac_1"],
rejectionReason: "Budget freeze",
});
expect(result.rejected).toBe(1);
expect(db.vacation.updateMany).toHaveBeenCalledWith(
expect.objectContaining({
data: expect.objectContaining({
status: VacationStatus.REJECTED,
rejectionReason: "Budget freeze",
}),
}),
);
});
});
describe("getForResource", () => {
it("returns approved vacations in date range", async () => {
const db = {
vacation: {
findMany: vi.fn().mockResolvedValue([
{
id: "vac_1",
startDate: new Date("2026-06-01"),
endDate: new Date("2026-06-05"),
type: VacationType.ANNUAL,
status: VacationStatus.APPROVED,
},
]),
},
};
const caller = createProtectedCaller(db);
const result = await caller.getForResource({
resourceId: "res_1",
startDate: new Date("2026-01-01"),
endDate: new Date("2026-12-31"),
});
expect(result).toHaveLength(1);
expect(db.vacation.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: expect.objectContaining({
resourceId: "res_1",
status: VacationStatus.APPROVED,
}),
}),
);
});
});
describe("getPendingApprovals", () => {
it("returns all pending vacations for managers", async () => {
const db = {
vacation: {
findMany: vi.fn().mockResolvedValue([sampleVacation]),
},
};
const caller = createManagerCaller(db);
const result = await caller.getPendingApprovals();
expect(result).toHaveLength(1);
expect(db.vacation.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: { status: VacationStatus.PENDING },
}),
);
});
it("forbids regular users from viewing pending approvals", async () => {
const db = {};
const caller = createProtectedCaller(db);
await expect(caller.getPendingApprovals()).rejects.toThrow();
});
});
describe("getTeamOverlap", () => {
it("returns overlapping vacations for the same chapter", async () => {
const db = {
resource: {
findUnique: vi.fn().mockResolvedValue({ chapter: "Animation" }),
},
vacation: {
findMany: vi.fn().mockResolvedValue([
{
...sampleVacation,
id: "vac_other",
resourceId: "res_2",
resource: { id: "res_2", displayName: "Bob", eid: "E-002" },
},
]),
},
};
const caller = createProtectedCaller(db);
const result = await caller.getTeamOverlap({
resourceId: "res_1",
startDate: new Date("2026-06-01"),
endDate: new Date("2026-06-05"),
});
expect(result).toHaveLength(1);
expect(db.vacation.findMany).toHaveBeenCalledWith(
expect.objectContaining({
where: expect.objectContaining({
resource: { chapter: "Animation" },
resourceId: { not: "res_1" },
}),
}),
);
});
it("returns empty array when resource has no chapter", async () => {
const db = {
resource: {
findUnique: vi.fn().mockResolvedValue({ chapter: null }),
},
};
const caller = createProtectedCaller(db);
const result = await caller.getTeamOverlap({
resourceId: "res_1",
startDate: new Date("2026-06-01"),
endDate: new Date("2026-06-05"),
});
expect(result).toEqual([]);
});
});
describe("batchCreatePublicHolidays", () => {
it("creates public holidays for all active resources (admin only)", async () => {
const db = {
resource: {
findMany: vi.fn().mockResolvedValue([
{ id: "res_1" },
{ id: "res_2" },
]),
},
user: {
findUnique: vi.fn().mockResolvedValue({ id: "admin_1" }),
},
vacation: {
deleteMany: vi.fn().mockResolvedValue({ count: 0 }),
findFirst: vi.fn().mockResolvedValue(null),
create: vi.fn().mockResolvedValue({}),
},
};
const caller = createAdminCaller(db);
const result = await caller.batchCreatePublicHolidays({
year: 2026,
federalState: "BY",
});
expect(result.created).toBeGreaterThan(0);
expect(result.resources).toBe(2);
expect(db.vacation.create).toHaveBeenCalled();
});
it("skips already existing holidays", async () => {
const db = {
resource: {
findMany: vi.fn().mockResolvedValue([{ id: "res_1" }]),
},
user: {
findUnique: vi.fn().mockResolvedValue({ id: "admin_1" }),
},
vacation: {
findFirst: vi.fn().mockResolvedValue({ id: "existing" }),
create: vi.fn(),
},
};
const caller = createAdminCaller(db);
const result = await caller.batchCreatePublicHolidays({
year: 2026,
federalState: "BY",
});
expect(result.created).toBe(0);
expect(db.vacation.create).not.toHaveBeenCalled();
});
it("forbids non-admin users", async () => {
const db = {};
const caller = createManagerCaller(db);
await expect(
caller.batchCreatePublicHolidays({ year: 2026 }),
).rejects.toThrow("Admin role required");
});
});
describe("updateStatus", () => {
it("allows manager to approve via updateStatus", async () => {
const updatedVacation = {
...sampleVacation,
status: VacationStatus.APPROVED,
};
const db = {
vacation: {
findUnique: vi.fn().mockResolvedValue(sampleVacation),
update: vi.fn().mockResolvedValue(updatedVacation),
},
user: {
findUnique: vi.fn().mockResolvedValue({ id: "mgr_1", systemRole: "MANAGER" }),
},
};
const caller = createManagerCaller(db);
const result = await caller.updateStatus({ id: "vac_1", status: "APPROVED" });
expect(result.status).toBe(VacationStatus.APPROVED);
});
it("allows any user to cancel via updateStatus", async () => {
const updatedVacation = {
...sampleVacation,
status: VacationStatus.CANCELLED,
};
const db = {
vacation: {
findUnique: vi.fn().mockResolvedValue(sampleVacation),
update: vi.fn().mockResolvedValue(updatedVacation),
},
user: {
findUnique: vi.fn().mockResolvedValue({ id: "user_1", systemRole: "USER" }),
},
};
const caller = createProtectedCaller(db);
const result = await caller.updateStatus({ id: "vac_1", status: "CANCELLED" });
expect(result.status).toBe(VacationStatus.CANCELLED);
});
it("forbids non-manager from approving via updateStatus", async () => {
const db = {
vacation: {
findUnique: vi.fn().mockResolvedValue(sampleVacation),
},
user: {
findUnique: vi.fn().mockResolvedValue({ id: "user_1", systemRole: "USER" }),
},
};
const caller = createProtectedCaller(db);
await expect(
caller.updateStatus({ id: "vac_1", status: "APPROVED" }),
).rejects.toThrow("Manager role required to approve/reject");
});
it("throws NOT_FOUND when vacation does not exist", async () => {
const db = {
vacation: {
findUnique: vi.fn().mockResolvedValue(null),
},
};
const caller = createProtectedCaller(db);
await expect(
caller.updateStatus({ id: "missing", status: "CANCELLED" }),
).rejects.toThrow("Vacation not found");
});
});
});