WP-03: employee records and contracts on real data

Replaces the demo module behind the team directory and the employee
record with scoped queries, and adds contracts, amendments, work
permits and the forfait-jours fields.

Writing the end-to-end test exposed a modelling error worth naming:
first and last names lived only on User, so an employee without an
application account had no name at all — the directory rendered
"— Salarié E0007". Most sales staff never sign in, and the personnel
register requires their name, so the name belongs to the record, not
to the login. Moved to EmployeeProfile with a data migration that
carries the existing names down from User.

Contract rules are pure functions tested at the boundaries. The case
that matters is an open-ended contract: a CDI with no end date overlaps
every later period, which a naive comparison of two date pairs misses,
and two overlapping active contracts would count one employee twice in
payroll. The check runs inside the transaction, not only in the form.

Forfait jours is refused without a written individual agreement and a
dated employee consent: without them the arrangement is unenforceable,
and enabling it would also switch off every weekly-duration control.

Salary and bank details are not merely hidden when the capability is
missing — they are never loaded. A field absent from the response
cannot leak through HTML, a log or an error message.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cr9dkEHwbDgkWPnyGj1Rjv

src/server/crypto.ts

@@ -38,7 +38,13 @@ export function encrypt(plaintext: string): Buffer {
   return Buffer.concat([iv, cipher.getAuthTag(), encrypted]);
 }
 
-export function decrypt(payload: Buffer): string {
+export function decrypt(payload: Uint8Array): string {
+  // Prisma 7 renvoie les colonnes `Bytes` en Uint8Array, pas en Buffer.
+  const buffer = Buffer.from(payload.buffer, payload.byteOffset, payload.byteLength);
+  return decryptBuffer(buffer);
+}
+
+function decryptBuffer(payload: Buffer): string {
   if (payload.length < IV_LENGTH + TAG_LENGTH) {
     throw new Error('Chiffré invalide : trop court pour contenir iv et tag');
   }
@@ -60,7 +66,9 @@ export function encryptOptional(value: string | null | undefined): Buffer | null
   return value ? encrypt(value) : null;
 }
 
-export function decryptOptional(payload: Buffer | null | undefined): string | null {
+export function decryptOptional(
+  payload: Uint8Array | null | undefined,
+): string | null {
   return payload ? decrypt(payload) : null;
 }
 

src/server/employees/actions.ts

@@ -0,0 +1,331 @@
+'use server';
+
+import { revalidatePath } from 'next/cache';
+import { z } from 'zod';
+
+import { AuthorizationError } from '@/domain/access/authorize';
+import { findOverlaps, validateContract } from '@/domain/contracts/rules';
+import { recordAudit } from '@/server/audit';
+import { mutate } from '@/server/context';
+
+export interface ActionState {
+  error?: string;
+  ok?: boolean;
+}
+
+const CONTRACT_TYPES = [
+  'APPRENTISSAGE',
+  'CDD',
+  'CDI',
+  'DIRIGEANT_ASSIMILE_SALARIE',
+  'DIRIGEANT_NON_SALARIE',
+  'EXTRA',
+  'INTERIM',
+  'STAGIAIRE',
+  'SAISONNIER',
+] as const;
+
+const employeeInput = z.object({
+  firstName: z.string().trim().min(1, 'Prénom requis').max(80),
+  lastName: z.string().trim().min(1, 'Nom requis').max(80),
+  employeeNumber: z.string().trim().min(1, 'Matricule requis').max(40),
+  /** Vide = salarié géré sans accès applicatif. */
+  email: z.string().trim().email('Adresse invalide').or(z.literal('')),
+});
+
+/**
+ * Crée un salarié.
+ *
+ * Un salarié **sans compte utilisateur** doit rester créable : la plupart des
+ * équipes de vente ne se connectent jamais à l'outil, et exiger une adresse
+ * électronique les rendrait impossibles à planifier ou à déclarer.
+ */
+export async function createEmployeeAction(
+  _previous: ActionState,
+  formData: FormData,
+): Promise<ActionState> {
+  const parsed = employeeInput.safeParse({
+    firstName: formData.get('firstName'),
+    lastName: formData.get('lastName'),
+    employeeNumber: formData.get('employeeNumber'),
+    email: formData.get('email') ?? '',
+  });
+
+  if (!parsed.success) {
+    return { error: parsed.error.issues[0]?.message ?? 'Formulaire invalide' };
+  }
+
+  try {
+    await mutate('members.create', async (db, actor) => {
+      const role = await db.role.findFirst({ where: { key: 'employee' } });
+      if (!role) throw new Error('Rôle « employee » introuvable.');
+
+      const existing = await db.membership.findFirst({
+        where: { employeeNumber: parsed.data.employeeNumber },
+      });
+      if (existing) {
+        throw new ValidationError('Ce matricule est déjà utilisé.');
+      }
+
+      const created = await db.membership.create({
+        data: {
+          roleId: role.id,
+          employeeNumber: parsed.data.employeeNumber,
+          status: parsed.data.email ? 'INVITED' : 'ACTIVE',
+        } as never,
+      });
+
+      await db.employeeProfile.create({
+        data: {
+          membershipId: created.id,
+          firstName: parsed.data.firstName,
+          lastName: parsed.data.lastName,
+          personalEmail: parsed.data.email || null,
+        } as never,
+      });
+
+      await recordAudit(db, {
+        actorMembershipId: actor.membershipId,
+        action: 'membership.create',
+        entityType: 'Membership',
+        entityId: created.id,
+        after: {
+          employeeNumber: created.employeeNumber,
+          hasAccount: Boolean(parsed.data.email),
+        },
+      });
+    });
+  } catch (error) {
+    if (error instanceof ValidationError) return { error: error.message };
+    if (error instanceof AuthorizationError) {
+      return { error: "Vous n'avez pas le droit de créer un salarié." };
+    }
+    throw error;
+  }
+
+  revalidatePath('/equipe');
+  return { ok: true };
+}
+
+class ValidationError extends Error {}
+
+const contractInput = z.object({
+  membershipId: z.string().min(1),
+  locationId: z.string().min(1),
+  contractType: z.enum(CONTRACT_TYPES),
+  startDate: z.coerce.date(),
+  endDate: z.string().trim().optional(),
+  workTimeArrangement: z.enum(['HOURLY', 'FORFAIT_JOURS']),
+  weeklyHours: z.coerce.number().min(0).max(60),
+  forfaitDaysPerYear: z.coerce.number().min(0).max(400).optional(),
+  forfaitAgreementRef: z.string().trim().optional(),
+  forfaitAgreedAt: z.string().trim().optional(),
+});
+
+export async function createContractAction(
+  _previous: ActionState,
+  formData: FormData,
+): Promise<ActionState> {
+  const parsed = contractInput.safeParse({
+    membershipId: formData.get('membershipId'),
+    locationId: formData.get('locationId'),
+    contractType: formData.get('contractType'),
+    startDate: formData.get('startDate'),
+    endDate: formData.get('endDate') ?? '',
+    workTimeArrangement: formData.get('workTimeArrangement') ?? 'HOURLY',
+    weeklyHours: formData.get('weeklyHours') ?? 35,
+    forfaitDaysPerYear: formData.get('forfaitDaysPerYear') || undefined,
+    forfaitAgreementRef: formData.get('forfaitAgreementRef') ?? '',
+    forfaitAgreedAt: formData.get('forfaitAgreedAt') ?? '',
+  });
+
+  if (!parsed.success) {
+    return { error: parsed.error.issues[0]?.message ?? 'Formulaire invalide' };
+  }
+
+  const endDate = parsed.data.endDate ? new Date(parsed.data.endDate) : null;
+  const forfaitAgreedAt = parsed.data.forfaitAgreedAt
+    ? new Date(parsed.data.forfaitAgreedAt)
+    : null;
+
+  const issues = validateContract({
+    startDate: parsed.data.startDate,
+    endDate,
+    workTimeArrangement: parsed.data.workTimeArrangement,
+    weeklyHours: parsed.data.weeklyHours,
+    forfaitDaysPerYear: parsed.data.forfaitDaysPerYear ?? null,
+    forfaitAgreementRef: parsed.data.forfaitAgreementRef ?? null,
+    forfaitAgreedAt,
+  });
+
+  if (issues.length > 0) {
+    return { error: issues[0]?.message ?? 'Contrat invalide' };
+  }
+
+  try {
+    await mutate(
+      'members.contract.create',
+      async (db, actor) => {
+        const location = await db.location.findUnique({
+          where: { id: parsed.data.locationId },
+        });
+        if (!location) throw new AuthorizationError('members.contract.create');
+
+        const existing = await db.userContract.findMany({
+          where: {
+            membershipId: parsed.data.membershipId,
+            status: { in: ['ACTIVE', 'DRAFT'] },
+          },
+          select: { id: true, startDate: true, endDate: true },
+        });
+
+        // Deux contrats actifs qui se chevauchent produiraient un salarié
+        // compté deux fois en paie. Le contrôle est fait ici, en transaction,
+        // et pas seulement dans le formulaire.
+        const overlaps = findOverlaps(
+          { startDate: parsed.data.startDate, endDate },
+          existing,
+        );
+        if (overlaps.length > 0) {
+          throw new ValidationError(
+            'Un contrat actif couvre déjà cette période pour ce salarié.',
+          );
+        }
+
+        const created = await db.userContract.create({
+          data: {
+            membershipId: parsed.data.membershipId,
+            locationId: location.id,
+            contractType: parsed.data.contractType,
+            startDate: parsed.data.startDate,
+            endDate,
+            workTimeArrangement: parsed.data.workTimeArrangement,
+            weeklyHours: parsed.data.weeklyHours,
+            forfaitDaysPerYear: parsed.data.forfaitDaysPerYear ?? null,
+            forfaitAgreementRef: parsed.data.forfaitAgreementRef || null,
+            forfaitAgreedAt,
+          } as never,
+        });
+
+        await recordAudit(db, {
+          actorMembershipId: actor.membershipId,
+          action: 'contract.create',
+          entityType: 'UserContract',
+          entityId: created.id,
+          after: {
+            contractType: created.contractType,
+            startDate: created.startDate.toISOString(),
+            workTimeArrangement: created.workTimeArrangement,
+          },
+        });
+      },
+      { locationId: parsed.data.locationId },
+    );
+  } catch (error) {
+    if (error instanceof ValidationError) return { error: error.message };
+    if (error instanceof AuthorizationError) {
+      return { error: "Vous n'avez pas le droit de créer un contrat." };
+    }
+    throw error;
+  }
+
+  revalidatePath(`/equipe/${parsed.data.membershipId}`);
+  revalidatePath('/equipe');
+  return { ok: true };
+}
+
+const amendmentInput = z.object({
+  contractId: z.string().min(1),
+  effectiveDate: z.coerce.date(),
+  reason: z.string().trim().min(1, 'Motif requis').max(300),
+  weeklyHours: z.coerce.number().min(0).max(60).optional(),
+});
+
+/**
+ * Enregistre un avenant.
+ *
+ * L'avenant **s'ajoute**, il ne remplace pas : un contrôle demande l'état du
+ * contrat au moment des faits, pas son état actuel. Le contrat porte la valeur
+ * courante, l'avenant garde la trace du passage.
+ */
+export async function createAmendmentAction(
+  _previous: ActionState,
+  formData: FormData,
+): Promise<ActionState> {
+  const parsed = amendmentInput.safeParse({
+    contractId: formData.get('contractId'),
+    effectiveDate: formData.get('effectiveDate'),
+    reason: formData.get('reason'),
+    weeklyHours: formData.get('weeklyHours') || undefined,
+  });
+
+  if (!parsed.success) {
+    return { error: parsed.error.issues[0]?.message ?? 'Formulaire invalide' };
+  }
+
+  let membershipId = '';
+
+  try {
+    await mutate('members.contract.edit', async (db, actor) => {
+      const contract = await db.userContract.findUnique({
+        where: { id: parsed.data.contractId },
+      });
+      if (!contract) throw new AuthorizationError('members.contract.edit');
+      membershipId = contract.membershipId;
+
+      const changes: Record<string, { before: unknown; after: unknown }> = {};
+      if (
+        parsed.data.weeklyHours !== undefined &&
+        Number(contract.weeklyHours) !== parsed.data.weeklyHours
+      ) {
+        changes.weeklyHours = {
+          before: contract.weeklyHours.toString(),
+          after: parsed.data.weeklyHours,
+        };
+      }
+
+      if (Object.keys(changes).length === 0) {
+        throw new ValidationError('Aucune modification à enregistrer.');
+      }
+
+      const amendment = await db.amendment.create({
+        data: {
+          userContractId: contract.id,
+          effectiveDate: parsed.data.effectiveDate,
+          changes,
+          reason: parsed.data.reason,
+          createdBy: actor.membershipId,
+        } as never,
+      });
+
+      if (parsed.data.weeklyHours !== undefined) {
+        await db.userContract.update({
+          where: { id: contract.id },
+          data: {
+            weeklyHours: parsed.data.weeklyHours,
+            version: { increment: 1 },
+          },
+        });
+      }
+
+      await recordAudit(db, {
+        actorMembershipId: actor.membershipId,
+        action: 'contract.amend',
+        entityType: 'UserContract',
+        entityId: contract.id,
+        before: { weeklyHours: contract.weeklyHours.toString() },
+        after: { amendmentId: amendment.id, changes },
+        reason: parsed.data.reason,
+      });
+    });
+  } catch (error) {
+    if (error instanceof ValidationError) return { error: error.message };
+    if (error instanceof AuthorizationError) {
+      return { error: "Vous n'avez pas le droit de modifier un contrat." };
+    }
+    throw error;
+  }
+
+  if (membershipId) revalidatePath(`/equipe/${membershipId}`);
+  return { ok: true };
+}

src/server/employees/queries.ts

@@ -0,0 +1,222 @@
+import { can } from '@/domain/access/authorize';
+import { decryptOptional } from '@/server/crypto';
+import { query } from '@/server/context';
+
+/**
+ * Lecture des dossiers salariés.
+ *
+ * `members.salary.view` ne masque pas seulement l'affichage : la rémunération
+ * n'est **pas chargée** quand la capacité manque. Un champ absent de la réponse
+ * ne peut pas fuiter par le HTML, un journal ou une erreur — contrairement à un
+ * champ chargé puis caché à l'écran.
+ */
+
+export interface EmployeeListRow {
+  id: string;
+  employeeNumber: string;
+  firstName: string;
+  lastName: string;
+  email: string | null;
+  status: string;
+  hasAccount: boolean;
+  roleName: string;
+  contract: {
+    type: string;
+    label: string;
+    since: Date;
+    trialEndDate: Date | null;
+    forfaitJours: boolean;
+  } | null;
+  locationName: string | null;
+}
+
+const CONTRACT_LABELS: Record<string, string> = {
+  APPRENTISSAGE: 'Apprentissage',
+  CDD: 'CDD',
+  CDI: 'CDI',
+  DIRIGEANT_ASSIMILE_SALARIE: 'Dirigeant assimilé salarié',
+  DIRIGEANT_NON_SALARIE: 'Dirigeant non salarié',
+  EXTRA: 'Extra',
+  INTERIM: 'Intérim',
+  STAGIAIRE: 'Stagiaire',
+  SAISONNIER: 'Saisonnier',
+};
+
+export function contractLabel(type: string): string {
+  return CONTRACT_LABELS[type] ?? type;
+}
+
+export async function listEmployees(): Promise<EmployeeListRow[]> {
+  return query('members.view', async (db) => {
+    const memberships = await db.membership.findMany({
+      where: { archivedAt: null },
+      include: {
+        profile: { select: { firstName: true, lastName: true } },
+        user: { select: { email: true } },
+        role: { select: { name: true } },
+        contracts: {
+          where: { status: 'ACTIVE' },
+          orderBy: { startDate: 'desc' },
+          take: 1,
+        },
+      },
+      orderBy: { employeeNumber: 'asc' },
+    });
+
+    const locationIds = [
+      ...new Set(
+        memberships
+          .flatMap((membership) => membership.contracts)
+          .map((contract) => contract.locationId),
+      ),
+    ];
+    const locations = await db.location.findMany({
+      where: { id: { in: locationIds } },
+      select: { id: true, name: true },
+    });
+    const locationNames = new Map(locations.map((l) => [l.id, l.name]));
+
+    return memberships.map((membership) => {
+      const contract = membership.contracts[0];
+      return {
+        id: membership.id,
+        employeeNumber: membership.employeeNumber,
+        firstName: membership.profile?.firstName ?? '',
+        lastName: membership.profile?.lastName ?? membership.employeeNumber,
+        email: membership.user?.email ?? null,
+        status: membership.status,
+        hasAccount: membership.userId !== null,
+        roleName: membership.role.name,
+        contract: contract
+          ? {
+              type: contract.contractType,
+              label: contractLabel(contract.contractType),
+              since: contract.startDate,
+              trialEndDate: contract.trialEndDate,
+              forfaitJours: contract.workTimeArrangement === 'FORFAIT_JOURS',
+            }
+          : null,
+        locationName: contract
+          ? (locationNames.get(contract.locationId) ?? null)
+          : null,
+      };
+    });
+  });
+}
+
+export interface EmployeeDetail extends EmployeeListRow {
+  profile: {
+    birthDate: Date | null;
+    city: string | null;
+    phone: string | null;
+    personalEmail: string | null;
+    /** Chiffré au repos, déchiffré seulement pour qui a le droit de le lire. */
+    socialSecurityNumber: string | null;
+    iban: string | null;
+  } | null;
+  contracts: Array<{
+    id: string;
+    type: string;
+    label: string;
+    startDate: Date;
+    endDate: Date | null;
+    weeklyHours: string;
+    forfaitJours: boolean;
+    forfaitDaysPerYear: string | null;
+    status: string;
+    /** Absent quand `members.salary.view` manque. */
+    monthlySalary: string | null;
+    amendments: Array<{ id: string; effectiveDate: Date; reason: string | null }>;
+  }>;
+  canSeeSalary: boolean;
+}
+
+export async function getEmployee(id: string): Promise<EmployeeDetail | null> {
+  return query('members.view', async (db, actor) => {
+    const canSeeSalary = can(actor, 'members.salary.view');
+    const canSeeDocuments = can(actor, 'members.documents.view');
+
+    const membership = await db.membership.findUnique({
+      where: { id },
+      include: {
+        user: { select: { email: true } },
+        role: { select: { name: true } },
+        profile: true,
+        contracts: {
+          orderBy: { startDate: 'desc' },
+          include: {
+            amendments: { orderBy: { effectiveDate: 'desc' } },
+          },
+        },
+      },
+    });
+
+    if (!membership) return null;
+
+    const active = membership.contracts.find(
+      (contract) => contract.status === 'ACTIVE',
+    );
+    const location = active
+      ? await db.location.findUnique({
+          where: { id: active.locationId },
+          select: { name: true },
+        })
+      : null;
+
+    return {
+      id: membership.id,
+      employeeNumber: membership.employeeNumber,
+      firstName: membership.profile?.firstName ?? '',
+      lastName: membership.profile?.lastName ?? membership.employeeNumber,
+      email: membership.user?.email ?? null,
+      status: membership.status,
+      hasAccount: membership.userId !== null,
+      roleName: membership.role.name,
+      locationName: location?.name ?? null,
+      contract: active
+        ? {
+            type: active.contractType,
+            label: contractLabel(active.contractType),
+            since: active.startDate,
+            trialEndDate: active.trialEndDate,
+            forfaitJours: active.workTimeArrangement === 'FORFAIT_JOURS',
+          }
+        : null,
+      profile: membership.profile
+        ? {
+            birthDate: membership.profile.birthDate,
+            city: membership.profile.city,
+            phone: membership.profile.phone,
+            personalEmail: membership.profile.personalEmail,
+            // Le NIR et l'IBAN ne sont déchiffrés que pour un profil habilité.
+            socialSecurityNumber: canSeeDocuments
+              ? decryptOptional(membership.profile.socialSecurityNumberEnc)
+              : null,
+            iban: canSeeDocuments
+              ? decryptOptional(membership.profile.ibanEnc)
+              : null,
+          }
+        : null,
+      contracts: membership.contracts.map((contract) => ({
+        id: contract.id,
+        type: contract.contractType,
+        label: contractLabel(contract.contractType),
+        startDate: contract.startDate,
+        endDate: contract.endDate,
+        weeklyHours: contract.weeklyHours.toString(),
+        forfaitJours: contract.workTimeArrangement === 'FORFAIT_JOURS',
+        forfaitDaysPerYear: contract.forfaitDaysPerYear?.toString() ?? null,
+        status: contract.status,
+        monthlySalary: canSeeSalary
+          ? (contract.monthlySalary?.toString() ?? null)
+          : null,
+        amendments: contract.amendments.map((amendment) => ({
+          id: amendment.id,
+          effectiveDate: amendment.effectiveDate,
+          reason: amendment.reason,
+        })),
+      })),
+      canSeeSalary,
+    };
+  });
+}