R40: 完成档案编辑扩展与员工导出

server/src/routes/employees.js

@@ -14,6 +14,7 @@ const PROFILE_PATCH_SCHEMA = z
     departmentId: UUID_SCHEMA.optional(),
     directManagerId: UUID_SCHEMA.nullable().optional(),
     title: z.string().trim().min(1).max(100).optional(),
+    hireDate: DATE_SCHEMA.nullable().optional(),
     probationEndDate: DATE_SCHEMA.nullable().optional(),
     lastWorkingDate: DATE_SCHEMA.nullable().optional(),
     workLocation: z.string().trim().max(100).nullable().optional(),
@@ -370,7 +371,11 @@ async function employeesRoutes(fastify) {
     const body = parseBody(PROFILE_PATCH_SCHEMA, request.body);
     const managerMode = canManageLifecycle(fastify, request);
     const selfEditableKeys = ["workLocation", "emergencyContactName", "emergencyContactPhone", "notes"];
-    if (!managerMode && request.employee.id === employeeId) {
+    if (!managerMode) {
+      if (request.employee.id !== employeeId) {
+        throw new AppError({ code: "PERM_001", message: "无权限", statusCode: 403, details: { permission: "employee.profile.write" } });
+      }
+
       const invalidKeys = Object.keys(body).filter((key) => !selfEditableKeys.includes(key));
       if (invalidKeys.length) {
         throw buildValidationError({ body: `self_profile_fields_forbidden:${invalidKeys.join(",")}` }, 403);
@@ -384,6 +389,7 @@ async function employeesRoutes(fastify) {
         ...(body.departmentId !== undefined ? { department_id: body.departmentId } : {}),
         ...(body.directManagerId !== undefined ? { direct_manager_id: body.directManagerId } : {}),
         ...(body.title !== undefined ? { title: body.title } : {}),
+        ...(body.hireDate !== undefined ? { hire_date: body.hireDate ? new Date(`${body.hireDate}T00:00:00.000Z`) : null } : {}),
         ...(body.probationEndDate !== undefined ? { probation_end_date: body.probationEndDate ? new Date(`${body.probationEndDate}T00:00:00.000Z`) : null } : {}),
         ...(body.lastWorkingDate !== undefined ? { last_working_date: body.lastWorkingDate ? new Date(`${body.lastWorkingDate}T00:00:00.000Z`) : null } : {}),
         ...(body.workLocation !== undefined ? { work_location: body.workLocation ?? null } : {}),

server/src/routes/exports.js

@@ -49,6 +49,14 @@ const DASHBOARD_EXPORT_QUERY_SCHEMA = z.object({
   limit: z.coerce.number().int().min(1).max(20000).optional(),
 });
 
+const EMPLOYEE_EXPORT_QUERY_SCHEMA = z.object({
+  format: EXPORT_FORMAT_SCHEMA.optional(),
+  status: z.enum(["active", "archived"]).optional(),
+  departmentId: z.string().uuid().optional(),
+  q: z.string().max(100).optional(),
+  limit: z.coerce.number().int().min(1).max(20000).optional(),
+});
+
 function csvCell(value) {
   if (value == null) return "";
 
@@ -168,6 +176,25 @@ function buildDashboardWhere(request, query) {
   };
 }
 
+function buildEmployeeExportWhere(query) {
+  const q = query.q?.trim() ?? "";
+
+  return {
+    ...(query.status ? { status: query.status } : {}),
+    ...(query.departmentId ? { department_id: query.departmentId } : {}),
+    ...(q
+      ? {
+          OR: [
+            { employee_no: { contains: q, mode: "insensitive" } },
+            { name: { contains: q, mode: "insensitive" } },
+            { phone: { contains: q, mode: "insensitive" } },
+            { email: { contains: q, mode: "insensitive" } },
+          ],
+        }
+      : {}),
+  };
+}
+
 async function* streamDashboardReimbursementsCsv(prisma, where, limit) {
   yield "\ufeff";
   yield csvRow([
@@ -663,7 +690,159 @@ async function buildAuditLogsXlsx(prisma, where, limit) {
   return workbook.xlsx.writeBuffer();
 }
 
+async function* streamEmployeesCsv(prisma, where, limit) {
+  yield "\ufeff";
+  yield csvRow(["工号", "姓名", "部门", "职位", "手机", "邮箱", "账号状态", "入职日期"]);
+
+  const batchSize = 500;
+  let remaining = limit;
+  let cursorCreatedAt = null;
+  let cursorId = null;
+
+  while (remaining > 0) {
+    const take = Math.min(batchSize, remaining);
+    const rows = await prisma.employee.findMany({
+      where: {
+        ...where,
+        ...(cursorCreatedAt
+          ? {
+              OR: [
+                { created_at: { lt: cursorCreatedAt } },
+                { created_at: cursorCreatedAt, id: { lt: cursorId } },
+              ],
+            }
+          : {}),
+      },
+      orderBy: [{ created_at: "desc" }, { id: "desc" }],
+      take,
+      select: {
+        id: true,
+        employee_no: true,
+        name: true,
+        phone: true,
+        email: true,
+        status: true,
+        title: true,
+        hire_date: true,
+        created_at: true,
+        department: { select: { name: true } },
+      },
+    });
+
+    if (!rows.length) {
+      break;
+    }
+
+    for (const item of rows) {
+      yield csvRow([
+        item.employee_no,
+        item.name,
+        item.department?.name ?? "",
+        item.title ?? "",
+        item.phone ?? "",
+        item.email ?? "",
+        item.status,
+        item.hire_date?.toISOString?.()?.slice(0, 10) ?? "",
+      ]);
+      remaining -= 1;
+      if (remaining <= 0) break;
+    }
+
+    const last = rows[rows.length - 1];
+    cursorCreatedAt = last.created_at;
+    cursorId = last.id;
+  }
+}
+
+async function buildEmployeesXlsx(prisma, where, limit) {
+  const workbook = new ExcelJS.Workbook();
+  const sheet = workbook.addWorksheet("employees");
+
+  sheet.columns = [
+    { header: "工号", key: "employeeNo", width: 16 },
+    { header: "姓名", key: "name", width: 14 },
+    { header: "部门", key: "departmentName", width: 16 },
+    { header: "职位", key: "title", width: 16 },
+    { header: "手机", key: "phone", width: 16 },
+    { header: "邮箱", key: "email", width: 24 },
+    { header: "账号状态", key: "status", width: 12 },
+    { header: "入职日期", key: "hireDate", width: 14 },
+  ];
+
+  const rows = await prisma.employee.findMany({
+    where,
+    orderBy: [{ created_at: "desc" }, { id: "desc" }],
+    take: limit,
+    select: {
+      employee_no: true,
+      name: true,
+      phone: true,
+      email: true,
+      status: true,
+      title: true,
+      hire_date: true,
+      department: { select: { name: true } },
+    },
+  });
+
+  for (const item of rows) {
+    sheet.addRow({
+      employeeNo: item.employee_no,
+      name: item.name,
+      departmentName: item.department?.name ?? "",
+      title: item.title ?? "",
+      phone: item.phone ?? "",
+      email: item.email ?? "",
+      status: item.status,
+      hireDate: item.hire_date?.toISOString?.()?.slice(0, 10) ?? "",
+    });
+  }
+
+  return workbook.xlsx.writeBuffer();
+}
+
 async function exportsRoutes(fastify) {
+  fastify.get(
+    "/exports/employees",
+    {
+      preHandler: fastify.requirePermission("system.users"),
+    },
+    async (request, reply) => {
+      const query = parseQuery(EMPLOYEE_EXPORT_QUERY_SCHEMA, request.query);
+      const where = buildEmployeeExportWhere(query);
+      const format = resolveExportFormat(query);
+      const limit = query.limit ?? 5000;
+      const total = await fastify.prisma.employee.count({ where });
+
+      await fastify.prisma.auditLog.create({
+        data: buildAuditLogData(request, {
+          actorId: request.employee.id,
+          action: "EXPORT_EMPLOYEES",
+          targetType: "export",
+          extra: {
+            format,
+            status: query.status ?? null,
+            departmentId: query.departmentId ?? null,
+            q: query.q?.trim() || null,
+            limit,
+            matchedTotal: total,
+          },
+        }),
+      });
+
+      const filename = exportFilename("employees", format);
+      setExportHeaders(reply, format, filename);
+
+      if (format === "xlsx") {
+        const buffer = await buildEmployeesXlsx(fastify.prisma, where, limit);
+        return reply.send(Buffer.from(buffer));
+      }
+
+      const stream = Readable.from(streamEmployeesCsv(fastify.prisma, where, limit));
+      return reply.send(stream);
+    },
+  );
+
   fastify.get(
     "/exports/reimbursements",
     {

server/tests/unit/routes/employees.patch.test.js

@@ -0,0 +1,173 @@
+const Fastify = require("fastify");
+
+const employeesRoutes = require("../../../src/routes/employees");
+const { AppError } = require("../../../src/utils/AppError");
+
+const TARGET_EMPLOYEE_ID = "11111111-1111-4111-8111-111111111111";
+const DEPARTMENT_ID = "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa";
+
+function buildProfileRow(overrides = {}) {
+  return {
+    id: TARGET_EMPLOYEE_ID,
+    employee_no: "E001",
+    name: "Alice",
+    phone: "13800000000",
+    email: "[email protected]",
+    status: "active",
+    employment_status: "active",
+    department_id: DEPARTMENT_ID,
+    title: "员工",
+    direct_manager_id: null,
+    hire_date: new Date("2026-01-10T00:00:00.000Z"),
+    probation_end_date: new Date("2026-04-10T00:00:00.000Z"),
+    last_working_date: null,
+    work_location: "上海",
+    emergency_contact_name: "联系人",
+    emergency_contact_phone: "13900000000",
+    notes: "none",
+    archived_at: null,
+    roles: [{ role_code: "employee" }],
+    department: { id: DEPARTMENT_ID, name: "行政部" },
+    direct_manager: null,
+    ...overrides,
+  };
+}
+
+async function buildApp(actor) {
+  const app = Fastify();
+  let storedEmployee = buildProfileRow();
+
+  const employeeFindUnique = vi.fn(async ({ where }) => {
+    if (where.id === TARGET_EMPLOYEE_ID) {
+      return storedEmployee;
+    }
+    return null;
+  });
+
+  const employeeUpdate = vi.fn(async ({ data }) => {
+    storedEmployee = {
+      ...storedEmployee,
+      ...(data.title !== undefined ? { title: data.title } : {}),
+      ...(data.hire_date !== undefined ? { hire_date: data.hire_date } : {}),
+      ...(data.probation_end_date !== undefined ? { probation_end_date: data.probation_end_date } : {}),
+      ...(data.last_working_date !== undefined ? { last_working_date: data.last_working_date } : {}),
+      ...(data.work_location !== undefined ? { work_location: data.work_location } : {}),
+      ...(data.emergency_contact_name !== undefined ? { emergency_contact_name: data.emergency_contact_name } : {}),
+      ...(data.emergency_contact_phone !== undefined ? { emergency_contact_phone: data.emergency_contact_phone } : {}),
+      ...(data.notes !== undefined ? { notes: data.notes } : {}),
+    };
+    return storedEmployee;
+  });
+
+  app.decorate("config", { employeeLifecycleEnabled: true });
+  app.decorate("authenticate", async (request) => {
+    request.employee = actor;
+  });
+  app.decorate("requirePermission", (permissionCode) => async (request) => {
+    request.employee = actor;
+    const permissionCodes = actor.permissionCodes ?? [];
+    if (!permissionCodes.includes("*") && !permissionCodes.includes(permissionCode)) {
+      throw new AppError({ code: "PERM_001", message: "无权限", statusCode: 403 });
+    }
+  });
+  app.decorate("hasPermission", (employee, permissionCode) => {
+    const permissionCodes = employee.permissionCodes ?? [];
+    return permissionCodes.includes("*") || permissionCodes.includes(permissionCode);
+  });
+  app.decorate("prisma", {
+    featureFlag: {
+      findUnique: vi.fn().mockResolvedValue({
+        id: "flag-1",
+        flag_key: "employee_lifecycle_v1",
+        override_mode: "force_on",
+        rollout_type: "global",
+        department_ids: [],
+        note: "",
+        version: 1,
+        created_at: new Date("2026-03-28T00:00:00.000Z"),
+        created_by: null,
+        updated_at: new Date("2026-03-28T00:00:00.000Z"),
+        updated_by: null,
+      }),
+    },
+    employee: {
+      findUnique: employeeFindUnique,
+      update: employeeUpdate,
+      findMany: vi.fn().mockResolvedValue([]),
+      count: vi.fn().mockResolvedValue(0),
+    },
+    employeeChecklistTask: {
+      findMany: vi.fn().mockResolvedValue([]),
+    },
+    employeeLifecycleEvent: {
+      findMany: vi.fn().mockResolvedValue([]),
+    },
+    assetCard: {
+      findMany: vi.fn().mockResolvedValue([]),
+      count: vi.fn().mockResolvedValue(0),
+    },
+    workflowTask: {
+      count: vi.fn().mockResolvedValue(0),
+    },
+    auditLog: {
+      create: vi.fn().mockResolvedValue({}),
+    },
+  });
+
+  await app.register(employeesRoutes, { prefix: "/api" });
+  return { app, employeeUpdate };
+}
+
+describe("employees profile patch", () => {
+  it("allows system.users to patch hireDate and other extended profile fields", async () => {
+    const { app, employeeUpdate } = await buildApp({
+      id: "actor-1",
+      department_id: DEPARTMENT_ID,
+      permissionCodes: ["system.users"],
+    });
+
+    const response = await app.inject({
+      method: "PATCH",
+      url: `/api/employees/${TARGET_EMPLOYEE_ID}/profile`,
+      payload: {
+        title: "经理",
+        hireDate: "2026-02-01",
+        probationEndDate: "2026-05-01",
+        lastWorkingDate: null,
+      },
+    });
+
+    expect(response.statusCode).toBe(200);
+    expect(employeeUpdate).toHaveBeenCalledWith(
+      expect.objectContaining({
+        where: { id: TARGET_EMPLOYEE_ID },
+        data: expect.objectContaining({
+          title: "经理",
+          hire_date: new Date("2026-02-01T00:00:00.000Z"),
+          probation_end_date: new Date("2026-05-01T00:00:00.000Z"),
+          last_working_date: null,
+        }),
+      }),
+    );
+
+    await app.close();
+  });
+
+  it("rejects report.dashboard.view users patching other employee profiles", async () => {
+    const { app } = await buildApp({
+      id: "actor-2",
+      department_id: DEPARTMENT_ID,
+      permissionCodes: ["report.dashboard.view"],
+    });
+
+    const response = await app.inject({
+      method: "PATCH",
+      url: `/api/employees/${TARGET_EMPLOYEE_ID}/profile`,
+      payload: { notes: "should fail" },
+    });
+
+    expect(response.statusCode).toBe(403);
+
+    await app.close();
+  });
+});

server/tests/unit/routes/exports.employees.test.js

@@ -0,0 +1,116 @@
+const Fastify = require("fastify");
+
+const exportsRoutes = require("../../../src/routes/exports");
+const { AppError } = require("../../../src/utils/AppError");
+
+const DEPARTMENT_ID = "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa";
+
+async function buildApp(actor) {
+  const app = Fastify();
+  const findMany = vi.fn().mockResolvedValue([
+    {
+      id: "11111111-1111-4111-8111-111111111111",
+      employee_no: "E001",
+      name: "Alice",
+      phone: "13800000000",
+      email: "[email protected]",
+      status: "active",
+      title: "经理",
+      hire_date: new Date("2026-01-10T00:00:00.000Z"),
+      created_at: new Date("2026-03-28T10:00:00.000Z"),
+      department: { name: "行政部" },
+    },
+  ]);
+  const count = vi.fn().mockResolvedValue(1);
+  const auditCreate = vi.fn().mockResolvedValue({});
+
+  app.decorate("authenticate", async (request) => {
+    request.employee = actor;
+  });
+  app.decorate("requirePermission", (permissionCode) => async (request) => {
+    request.employee = actor;
+    const permissionCodes = actor.permissionCodes ?? [];
+    if (!permissionCodes.includes("*") && !permissionCodes.includes(permissionCode)) {
+      throw new AppError({ code: "PERM_001", message: "无权限", statusCode: 403 });
+    }
+  });
+  app.decorate("hasPermission", (employee, permissionCode) => {
+    const permissionCodes = employee.permissionCodes ?? [];
+    return permissionCodes.includes("*") || permissionCodes.includes(permissionCode);
+  });
+  app.decorate("prisma", {
+    employee: {
+      findMany,
+      count,
+    },
+    auditLog: {
+      create: auditCreate,
+    },
+  });
+
+  await app.register(exportsRoutes, { prefix: "/api" });
+  return { app, findMany, count, auditCreate };
+}
+
+describe("employee exports route", () => {
+  it("exports filtered employees for system.users", async () => {
+    const { app, findMany, count, auditCreate } = await buildApp({
+      id: "actor-1",
+      roleCodes: ["administration"],
+      permissionCodes: ["system.users"],
+    });
+
+    const response = await app.inject({
+      method: "GET",
+      url: `/api/exports/employees?format=csv&status=active&departmentId=${DEPARTMENT_ID}&q=alice`,
+    });
+
+    expect(response.statusCode).toBe(200);
+    expect(response.headers["content-type"]).toContain("text/csv");
+    expect(response.headers["content-disposition"]).toContain("employees-");
+    expect(findMany).toHaveBeenCalledWith(
+      expect.objectContaining({
+        where: expect.objectContaining({
+          status: "active",
+          department_id: DEPARTMENT_ID,
+          OR: expect.arrayContaining([
+            expect.objectContaining({ name: expect.any(Object) }),
+            expect.objectContaining({ employee_no: expect.any(Object) }),
+          ]),
+        }),
+      }),
+    );
+    expect(count).toHaveBeenCalledWith({
+      where: expect.objectContaining({
+        status: "active",
+        department_id: DEPARTMENT_ID,
+      }),
+    });
+    expect(auditCreate).toHaveBeenCalledWith(
+      expect.objectContaining({
+        data: expect.objectContaining({
+          action: "EXPORT_EMPLOYEES",
+        }),
+      }),
+    );
+
+    await app.close();
+  });
+
+  it("rejects non system.users access", async () => {
+    const { app } = await buildApp({
+      id: "actor-2",
+      roleCodes: ["manager"],
+      permissionCodes: ["report.dashboard.view"],
+    });
+
+    const response = await app.inject({
+      method: "GET",
+      url: "/api/exports/employees?format=csv",
+    });
+
+    expect(response.statusCode).toBe(403);
+
+    await app.close();
+  });
+});