@nuxt-customer-portal/timesheets 0.3.0

package/server/utils/timesheet-validation.ts

@@ -0,0 +1,231 @@
+import { z } from 'zod'
+
+const isoDate = z.string().regex(/^\d{4}-\d{2}-\d{2}$/)
+const id = z.string().min(1).max(128)
+const moneyMinor = z.number().int().min(0).max(2_000_000_000)
+const listBase = {
+  search: z.string().trim().max(200).optional(),
+  page: z.coerce.number().int().min(1).default(1),
+  pageSize: z.coerce.number().int().min(1).max(100).default(20),
+  sortDir: z.enum(['asc', 'desc']).default('asc')
+}
+
+export const projectListQuerySchema = z.object({
+  ...listBase,
+  clientOrganizationId: id.optional(),
+  status: z.enum(['ALL', 'ACTIVE', 'ARCHIVED']).optional(),
+  sortBy: z.enum(['name', 'clientName', 'startsOn']).default('name')
+})
+export const clientListQuerySchema = z.object({
+  ...listBase,
+  configured: z.enum(['configured', 'incomplete']).optional(),
+  sortBy: z.enum(['name']).default('name')
+})
+export const activityListQuerySchema = z.object({
+  ...listBase,
+  active: z.enum(['true', 'false']).optional(),
+  billable: z.enum(['true', 'false']).optional(),
+  sortBy: z.enum(['name', 'active', 'billable']).default('name')
+})
+export const clientApprovalListQuerySchema = z.object({
+  ...listBase,
+  userId: id.optional(),
+  workspaceClientId: id.optional(),
+  status: z.enum(['PENDING', 'APPROVED', 'DISPUTED']).optional(),
+  sortBy: z.enum(['weekStartsOn', 'supplierName', 'person', 'status', 'totalMinutes']).default('weekStartsOn'),
+  sortDir: z.enum(['asc', 'desc']).default('desc')
+})
+export const internalApprovalListQuerySchema = z.object({
+  ...listBase,
+  userId: id.optional(),
+  status: z.enum(['SUBMITTED', 'APPROVED', 'REJECTED']).optional(),
+  sortBy: z.enum(['weekStartsOn', 'userName', 'status', 'totalMinutes']).default('weekStartsOn'),
+  sortDir: z.enum(['asc', 'desc']).default('desc')
+})
+export type InternalApprovalListQuery = z.infer<typeof internalApprovalListQuerySchema>
+export const clientSupplierTimesheetListQuerySchema = z.object({
+  ...listBase,
+  workspaceClientId: id.optional(),
+  sortBy: z.enum(['weekStartsOn', 'supplierName', 'person', 'totalMinutes']).default('weekStartsOn'),
+  sortDir: z.enum(['asc', 'desc']).default('desc')
+})
+
+export type ProjectListQuery = z.infer<typeof projectListQuerySchema>
+export type ClientListQuery = z.infer<typeof clientListQuerySchema>
+export type ActivityListQuery = z.infer<typeof activityListQuerySchema>
+export type ClientApprovalListQuery = z.infer<typeof clientApprovalListQuerySchema>
+export type ClientSupplierTimesheetListQuery = z.infer<typeof clientSupplierTimesheetListQuerySchema>
+
+export const weekQuerySchema = z.object({
+  week: isoDate.optional()
+})
+
+export const entryCreateSchema = z.object({
+  projectId: id,
+  activityTypeId: id,
+  entryDate: isoDate,
+  durationMinutes: z
+    .number()
+    .int()
+    .min(1)
+    .max(24 * 60),
+  note: z.string().trim().max(2000).nullable().optional()
+})
+
+export const entryUpdateSchema = entryCreateSchema
+  .partial()
+  .refine((value) => Object.keys(value).length > 0, 'At least one field is required')
+
+export const timerStartSchema = z.object({
+  projectId: id,
+  activityTypeId: id,
+  entryDate: isoDate,
+  note: z.string().trim().max(2000).nullable().optional()
+})
+
+export const clientCreateSchema = z.discriminatedUnion('mode', [
+  z.object({ mode: z.literal('link'), organizationId: id }),
+  z.object({
+    mode: z.literal('create'),
+    name: z.string().trim().min(2).max(160),
+    slug: z
+      .string()
+      .trim()
+      .min(1)
+      .max(160)
+      .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/)
+  })
+])
+
+export const clientDeleteSchema = z.object({ clientName: z.string().min(1).max(160) })
+export const clientAccessUpdateSchema = z.object({ accessMode: z.enum(['DISABLED', 'VIEW', 'REVIEW']) })
+export const organizationCapabilitiesUpdateSchema = z.object({
+  workspaceEnabled: z.boolean()
+})
+export const clientReviewerUpdateSchema = z.object({ userId: id, assigned: z.boolean() })
+export const clientReviewSchema = z
+  .object({
+    action: z.enum(['APPROVE', 'DISPUTE']),
+    expectedVersion: z.number().int().min(1),
+    comment: z.string().trim().max(2000).nullable().optional()
+  })
+  .superRefine((value, context) => {
+    if (value.action === 'DISPUTE' && !value.comment) {
+      context.addIssue({ code: 'custom', path: ['comment'], message: 'A dispute comment is required' })
+    }
+  })
+
+export const activityCreateSchema = z.object({
+  name: z.string().trim().min(2).max(120),
+  billable: z.boolean().default(true)
+})
+
+export const activityUpdateSchema = activityCreateSchema.partial().extend({
+  active: z.boolean().optional()
+})
+
+export const activityDeleteSchema = z.object({
+  activityName: z.string().min(1).max(120)
+})
+
+const projectSchema = z.object({
+  clientOrganizationId: id,
+  name: z.string().trim().min(2).max(160),
+  code: z.string().trim().max(40).nullable().optional(),
+  startsOn: isoDate.nullable().optional(),
+  endsOn: isoDate.nullable().optional(),
+  budgetMinutes: z.number().int().positive().nullable().optional(),
+  budgetMinor: moneyMinor.positive().nullable().optional(),
+  activityTypeIds: z.array(id).min(1)
+})
+
+export const projectCreateSchema = projectSchema.refine((v) => !v.startsOn || !v.endsOn || v.endsOn >= v.startsOn, {
+  message: 'End date must not precede start date',
+  path: ['endsOn']
+})
+
+export const projectUpdateSchema = projectSchema
+  .partial()
+  .extend({
+    status: z.enum(['ACTIVE', 'ARCHIVED']).optional(),
+    personRates: z.record(id, moneyMinor).optional()
+  })
+  .refine((v) => !v.startsOn || !v.endsOn || v.endsOn >= v.startsOn, {
+    message: 'End date must not precede start date',
+    path: ['endsOn']
+  })
+
+export const hasInvalidProjectActivityAssignments = (
+  requestedIds: string[],
+  activities: Array<{ id: string; active: boolean }>,
+  existingIds: string[] = []
+) => {
+  const existing = new Set(existingIds)
+  return requestedIds.some((id) => {
+    const activity = activities.find((item) => item.id === id)
+    return !activity || (!activity.active && !existing.has(id))
+  })
+}
+
+export const projectDeleteSchema = z.object({
+  projectName: z.string().min(1).max(160)
+})
+
+export const tariffUpdateSchema = z.object({
+  userId: id,
+  hourlyRateMinor: moneyMinor
+})
+
+export const teamMemberSettingsUpdateSchema = z.object({
+  canEnterTime: z.boolean(),
+  defaultHourlyRateMinor: moneyMinor.nullable()
+})
+
+export const internalApprovalWorkspaceUpdateSchema = z.object({ enabled: z.boolean() })
+
+export const internalApprovalMemberUpdateSchema = z.object({
+  required: z.boolean(),
+  approverUserIds: z.array(id).max(100)
+})
+
+export const settingsUpdateSchema = z.object({
+  timerRoundingMinutes: z.number().int().min(1).max(60).optional(),
+  currency: z
+    .string()
+    .length(3)
+    .transform((v) => v.toUpperCase())
+    .optional(),
+  timezone: z.string().min(3).max(100).optional()
+})
+
+export const reviewSchema = z
+  .object({
+    action: z.enum(['APPROVE', 'REJECT', 'REOPEN']),
+    comment: z.string().trim().max(2000).nullable().optional()
+  })
+  .superRefine((value, context) => {
+    if (value.action === 'REJECT' && !value.comment) {
+      context.addIssue({ code: 'custom', path: ['comment'], message: 'A rejection comment is required' })
+    }
+  })
+
+export const submissionCreateSchema = z.object({
+  cutoffDate: isoDate,
+  comment: z.string().trim().max(2000).optional()
+})
+
+export const reportQuerySchema = z.object({
+  from: isoDate.optional(),
+  to: isoDate.optional(),
+  clientOrganizationId: id.optional(),
+  projectId: id.optional(),
+  userId: id.optional(),
+  activityTypeId: id.optional(),
+  billable: z
+    .enum(['true', 'false'])
+    .transform((v) => v === 'true')
+    .optional(),
+  status: z.enum(['DRAFT', 'SUBMITTED', 'APPROVED', 'REJECTED']).optional()
+})
+
+export type ReportQuery = z.infer<typeof reportQuerySchema>

package/shared/client-approval-dashboard.ts

@@ -0,0 +1,17 @@
+import type { ClientApprovalItemDto } from './types/timesheet'
+
+type DashboardApproval = Pick<
+  ClientApprovalItemDto,
+  'id' | 'status' | 'canAct' | 'periodEndsOn' | 'reviewerUserId' | 'reviewedAt'
+>
+
+export const selectClientDashboardApprovals = <Item extends DashboardApproval>(items: Item[], userId: string) => {
+  const pending = items
+    .filter((item) => item.status === 'PENDING' && item.canAct)
+    .sort((a, b) => b.periodEndsOn.localeCompare(a.periodEndsOn) || a.id.localeCompare(b.id))
+  const history = items
+    .filter((item) => item.status === 'APPROVED' && item.reviewerUserId === userId)
+    .sort((a, b) => (b.reviewedAt ?? '').localeCompare(a.reviewedAt ?? '') || a.id.localeCompare(b.id))
+    .slice(0, 5)
+  return { pendingCount: pending.length, hasHistory: history.length > 0, items: [...pending, ...history] }
+}

package/shared/emails.ts

@@ -0,0 +1,403 @@
+import type { PortalEmailDefinition } from '@nuxt-customer-portal/core/shared/types/feature'
+
+export const timesheetEmails: PortalEmailDefinition[] = [
+  {
+    id: 'internal-requested',
+    labelKey: 'features.timesheets.email.messages.internal-requested',
+    defaults: {
+      en: {
+        subject: 'Internal approval requested — {{person_name}} ({{period}})',
+        body: 'Dear {{recipient_name}},<br><br>Please review the timesheet.<br><br>{{organization_name}}<br>{{person_name}}: {{period}}<br>{{client_name}}<br>{{comment}}<br><br><a href="{{action_url}}" class="button">Open timesheets</a>'
+      },
+      nl: {
+        subject: 'Interne goedkeuring gevraagd — {{person_name}} ({{period}})',
+        body: 'Beste {{recipient_name}},<br><br>Beoordeel de urenstaat.<br><br>{{organization_name}}<br>{{person_name}}: {{period}}<br>{{client_name}}<br>{{comment}}<br><br><a href="{{action_url}}" class="button">Urenstaten openen</a>'
+      }
+    },
+    placeholders: [
+      {
+        key: 'recipient_name',
+        labelKey: 'features.timesheets.email.placeholders.recipient_name',
+        example: 'Alex Example'
+      },
+      { key: 'period', labelKey: 'features.timesheets.email.placeholders.period', example: 'do 3 – vr 4 sep 2026' },
+      {
+        key: 'person_name',
+        labelKey: 'features.timesheets.email.placeholders.person_name',
+        example: 'Alex Example'
+      },
+      {
+        key: 'organization_name',
+        labelKey: 'features.timesheets.email.placeholders.organization_name',
+        example: 'Example Company'
+      },
+      {
+        key: 'period_start',
+        labelKey: 'features.timesheets.email.placeholders.period_start',
+        example: '2026-09-01'
+      },
+      {
+        key: 'period_end',
+        labelKey: 'features.timesheets.email.placeholders.period_end',
+        example: '2026-09-03'
+      },
+      {
+        key: 'client_name',
+        labelKey: 'features.timesheets.email.placeholders.client_name',
+        example: 'Example Client'
+      },
+      {
+        key: 'comment',
+        labelKey: 'features.timesheets.email.placeholders.comment',
+        example: ''
+      },
+      {
+        key: 'action_url',
+        labelKey: 'features.timesheets.email.placeholders.action_url',
+        example: 'https://portal.example.com/timesheets'
+      }
+    ]
+  },
+  {
+    id: 'internal-approved',
+    labelKey: 'features.timesheets.email.messages.internal-approved',
+    defaults: {
+      en: {
+        subject: 'Timesheet approved internally — {{person_name}} ({{period}})',
+        body: 'Dear {{recipient_name}},<br><br>Your timesheet has been approved internally.<br><br>{{organization_name}}<br>{{person_name}}: {{period}}<br>{{client_name}}<br>{{comment}}<br><br><a href="{{action_url}}" class="button">Open timesheets</a>'
+      },
+      nl: {
+        subject: 'Urenstaat intern goedgekeurd — {{person_name}} ({{period}})',
+        body: 'Beste {{recipient_name}},<br><br>Uw urenstaat is intern goedgekeurd.<br><br>{{organization_name}}<br>{{person_name}}: {{period}}<br>{{client_name}}<br>{{comment}}<br><br><a href="{{action_url}}" class="button">Urenstaten openen</a>'
+      }
+    },
+    placeholders: [
+      {
+        key: 'recipient_name',
+        labelKey: 'features.timesheets.email.placeholders.recipient_name',
+        example: 'Alex Example'
+      },
+      { key: 'period', labelKey: 'features.timesheets.email.placeholders.period', example: 'do 3 – vr 4 sep 2026' },
+      {
+        key: 'person_name',
+        labelKey: 'features.timesheets.email.placeholders.person_name',
+        example: 'Alex Example'
+      },
+      {
+        key: 'organization_name',
+        labelKey: 'features.timesheets.email.placeholders.organization_name',
+        example: 'Example Company'
+      },
+      {
+        key: 'period_start',
+        labelKey: 'features.timesheets.email.placeholders.period_start',
+        example: '2026-09-01'
+      },
+      {
+        key: 'period_end',
+        labelKey: 'features.timesheets.email.placeholders.period_end',
+        example: '2026-09-03'
+      },
+      {
+        key: 'client_name',
+        labelKey: 'features.timesheets.email.placeholders.client_name',
+        example: 'Example Client'
+      },
+      {
+        key: 'comment',
+        labelKey: 'features.timesheets.email.placeholders.comment',
+        example: ''
+      },
+      {
+        key: 'action_url',
+        labelKey: 'features.timesheets.email.placeholders.action_url',
+        example: 'https://portal.example.com/timesheets'
+      }
+    ]
+  },
+  {
+    id: 'internal-rejected',
+    labelKey: 'features.timesheets.email.messages.internal-rejected',
+    defaults: {
+      en: {
+        subject: 'Timesheet rejected internally — {{person_name}} ({{period}})',
+        body: 'Dear {{recipient_name}},<br><br>Your timesheet has been rejected internally.<br><br>{{organization_name}}<br>{{person_name}}: {{period}}<br>{{client_name}}<br>{{comment}}<br><br><a href="{{action_url}}" class="button">Open timesheets</a>'
+      },
+      nl: {
+        subject: 'Urenstaat intern afgewezen — {{person_name}} ({{period}})',
+        body: 'Beste {{recipient_name}},<br><br>Uw urenstaat is intern afgewezen.<br><br>{{organization_name}}<br>{{person_name}}: {{period}}<br>{{client_name}}<br>{{comment}}<br><br><a href="{{action_url}}" class="button">Urenstaten openen</a>'
+      }
+    },
+    placeholders: [
+      {
+        key: 'recipient_name',
+        labelKey: 'features.timesheets.email.placeholders.recipient_name',
+        example: 'Alex Example'
+      },
+      { key: 'period', labelKey: 'features.timesheets.email.placeholders.period', example: 'do 3 – vr 4 sep 2026' },
+      {
+        key: 'person_name',
+        labelKey: 'features.timesheets.email.placeholders.person_name',
+        example: 'Alex Example'
+      },
+      {
+        key: 'organization_name',
+        labelKey: 'features.timesheets.email.placeholders.organization_name',
+        example: 'Example Company'
+      },
+      {
+        key: 'period_start',
+        labelKey: 'features.timesheets.email.placeholders.period_start',
+        example: '2026-09-01'
+      },
+      {
+        key: 'period_end',
+        labelKey: 'features.timesheets.email.placeholders.period_end',
+        example: '2026-09-03'
+      },
+      {
+        key: 'client_name',
+        labelKey: 'features.timesheets.email.placeholders.client_name',
+        example: 'Example Client'
+      },
+      {
+        key: 'comment',
+        labelKey: 'features.timesheets.email.placeholders.comment',
+        example: ''
+      },
+      {
+        key: 'action_url',
+        labelKey: 'features.timesheets.email.placeholders.action_url',
+        example: 'https://portal.example.com/timesheets'
+      }
+    ]
+  },
+  {
+    id: 'internal-reopened',
+    labelKey: 'features.timesheets.email.messages.internal-reopened',
+    defaults: {
+      en: {
+        subject: 'Timesheet reopened — {{person_name}} ({{period}})',
+        body: 'Dear {{recipient_name}},<br><br>Your timesheet has been reopened for editing.<br><br>{{organization_name}}<br>{{person_name}}: {{period}}<br>{{client_name}}<br>{{comment}}<br><br><a href="{{action_url}}" class="button">Open timesheets</a>'
+      },
+      nl: {
+        subject: 'Urenstaat heropend — {{person_name}} ({{period}})',
+        body: 'Beste {{recipient_name}},<br><br>Uw urenstaat is heropend voor wijzigingen.<br><br>{{organization_name}}<br>{{person_name}}: {{period}}<br>{{client_name}}<br>{{comment}}<br><br><a href="{{action_url}}" class="button">Urenstaten openen</a>'
+      }
+    },
+    placeholders: [
+      {
+        key: 'recipient_name',
+        labelKey: 'features.timesheets.email.placeholders.recipient_name',
+        example: 'Alex Example'
+      },
+      { key: 'period', labelKey: 'features.timesheets.email.placeholders.period', example: 'do 3 – vr 4 sep 2026' },
+      {
+        key: 'person_name',
+        labelKey: 'features.timesheets.email.placeholders.person_name',
+        example: 'Alex Example'
+      },
+      {
+        key: 'organization_name',
+        labelKey: 'features.timesheets.email.placeholders.organization_name',
+        example: 'Example Company'
+      },
+      {
+        key: 'period_start',
+        labelKey: 'features.timesheets.email.placeholders.period_start',
+        example: '2026-09-01'
+      },
+      {
+        key: 'period_end',
+        labelKey: 'features.timesheets.email.placeholders.period_end',
+        example: '2026-09-03'
+      },
+      {
+        key: 'client_name',
+        labelKey: 'features.timesheets.email.placeholders.client_name',
+        example: 'Example Client'
+      },
+      {
+        key: 'comment',
+        labelKey: 'features.timesheets.email.placeholders.comment',
+        example: ''
+      },
+      {
+        key: 'action_url',
+        labelKey: 'features.timesheets.email.placeholders.action_url',
+        example: 'https://portal.example.com/timesheets'
+      }
+    ]
+  },
+  {
+    id: 'client-requested',
+    labelKey: 'features.timesheets.email.messages.client-requested',
+    defaults: {
+      en: {
+        subject: 'Client approval requested — {{person_name}} ({{period}})',
+        body: 'Dear {{recipient_name}},<br><br>Please review the timesheet for your organization.<br><br>{{organization_name}}<br>{{person_name}}: {{period}}<br>{{client_name}}<br>{{comment}}<br><br><a href="{{action_url}}" class="button">Open timesheets</a>'
+      },
+      nl: {
+        subject: 'Klantgoedkeuring gevraagd — {{person_name}} ({{period}})',
+        body: 'Beste {{recipient_name}},<br><br>Beoordeel de urenstaat voor uw organisatie.<br><br>{{organization_name}}<br>{{person_name}}: {{period}}<br>{{client_name}}<br>{{comment}}<br><br><a href="{{action_url}}" class="button">Urenstaten openen</a>'
+      }
+    },
+    placeholders: [
+      {
+        key: 'recipient_name',
+        labelKey: 'features.timesheets.email.placeholders.recipient_name',
+        example: 'Alex Example'
+      },
+      { key: 'period', labelKey: 'features.timesheets.email.placeholders.period', example: 'do 3 – vr 4 sep 2026' },
+      {
+        key: 'person_name',
+        labelKey: 'features.timesheets.email.placeholders.person_name',
+        example: 'Alex Example'
+      },
+      {
+        key: 'organization_name',
+        labelKey: 'features.timesheets.email.placeholders.organization_name',
+        example: 'Example Company'
+      },
+      {
+        key: 'period_start',
+        labelKey: 'features.timesheets.email.placeholders.period_start',
+        example: '2026-09-01'
+      },
+      {
+        key: 'period_end',
+        labelKey: 'features.timesheets.email.placeholders.period_end',
+        example: '2026-09-03'
+      },
+      {
+        key: 'client_name',
+        labelKey: 'features.timesheets.email.placeholders.client_name',
+        example: 'Example Client'
+      },
+      {
+        key: 'comment',
+        labelKey: 'features.timesheets.email.placeholders.comment',
+        example: ''
+      },
+      {
+        key: 'action_url',
+        labelKey: 'features.timesheets.email.placeholders.action_url',
+        example: 'https://portal.example.com/timesheets'
+      }
+    ]
+  },
+  {
+    id: 'client-approved',
+    labelKey: 'features.timesheets.email.messages.client-approved',
+    defaults: {
+      en: {
+        subject: 'Timesheet approved by client — {{person_name}} ({{period}})',
+        body: 'Dear {{recipient_name}},<br><br>The client has approved your timesheet.<br><br>{{organization_name}}<br>{{person_name}}: {{period}}<br>{{client_name}}<br>{{comment}}<br><br><a href="{{action_url}}" class="button">Open timesheets</a>'
+      },
+      nl: {
+        subject: 'Urenstaat goedgekeurd door klant — {{person_name}} ({{period}})',
+        body: 'Beste {{recipient_name}},<br><br>De klant heeft uw urenstaat goedgekeurd.<br><br>{{organization_name}}<br>{{person_name}}: {{period}}<br>{{client_name}}<br>{{comment}}<br><br><a href="{{action_url}}" class="button">Urenstaten openen</a>'
+      }
+    },
+    placeholders: [
+      {
+        key: 'recipient_name',
+        labelKey: 'features.timesheets.email.placeholders.recipient_name',
+        example: 'Alex Example'
+      },
+      { key: 'period', labelKey: 'features.timesheets.email.placeholders.period', example: 'do 3 – vr 4 sep 2026' },
+      {
+        key: 'person_name',
+        labelKey: 'features.timesheets.email.placeholders.person_name',
+        example: 'Alex Example'
+      },
+      {
+        key: 'organization_name',
+        labelKey: 'features.timesheets.email.placeholders.organization_name',
+        example: 'Example Company'
+      },
+      {
+        key: 'period_start',
+        labelKey: 'features.timesheets.email.placeholders.period_start',
+        example: '2026-09-01'
+      },
+      {
+        key: 'period_end',
+        labelKey: 'features.timesheets.email.placeholders.period_end',
+        example: '2026-09-03'
+      },
+      {
+        key: 'client_name',
+        labelKey: 'features.timesheets.email.placeholders.client_name',
+        example: 'Example Client'
+      },
+      {
+        key: 'comment',
+        labelKey: 'features.timesheets.email.placeholders.comment',
+        example: ''
+      },
+      {
+        key: 'action_url',
+        labelKey: 'features.timesheets.email.placeholders.action_url',
+        example: 'https://portal.example.com/timesheets'
+      }
+    ]
+  },
+  {
+    id: 'client-disputed',
+    labelKey: 'features.timesheets.email.messages.client-disputed',
+    defaults: {
+      en: {
+        subject: 'Timesheet disputed by client — {{person_name}} ({{period}})',
+        body: 'Dear {{recipient_name}},<br><br>The client has disputed your timesheet.<br><br>{{organization_name}}<br>{{person_name}}: {{period}}<br>{{client_name}}<br>{{comment}}<br><br><a href="{{action_url}}" class="button">Open timesheets</a>'
+      },
+      nl: {
+        subject: 'Urenstaat betwist door klant — {{person_name}} ({{period}})',
+        body: 'Beste {{recipient_name}},<br><br>De klant heeft uw urenstaat betwist.<br><br>{{organization_name}}<br>{{person_name}}: {{period}}<br>{{client_name}}<br>{{comment}}<br><br><a href="{{action_url}}" class="button">Urenstaten openen</a>'
+      }
+    },
+    placeholders: [
+      {
+        key: 'recipient_name',
+        labelKey: 'features.timesheets.email.placeholders.recipient_name',
+        example: 'Alex Example'
+      },
+      { key: 'period', labelKey: 'features.timesheets.email.placeholders.period', example: 'do 3 – vr 4 sep 2026' },
+      {
+        key: 'person_name',
+        labelKey: 'features.timesheets.email.placeholders.person_name',
+        example: 'Alex Example'
+      },
+      {
+        key: 'organization_name',
+        labelKey: 'features.timesheets.email.placeholders.organization_name',
+        example: 'Example Company'
+      },
+      {
+        key: 'period_start',
+        labelKey: 'features.timesheets.email.placeholders.period_start',
+        example: '2026-09-01'
+      },
+      {
+        key: 'period_end',
+        labelKey: 'features.timesheets.email.placeholders.period_end',
+        example: '2026-09-03'
+      },
+      {
+        key: 'client_name',
+        labelKey: 'features.timesheets.email.placeholders.client_name',
+        example: 'Example Client'
+      },
+      {
+        key: 'comment',
+        labelKey: 'features.timesheets.email.placeholders.comment',
+        example: ''
+      },
+      {
+        key: 'action_url',
+        labelKey: 'features.timesheets.email.placeholders.action_url',
+        example: 'https://portal.example.com/timesheets'
+      }
+    ]
+  }
+]