const Fastify = require("fastify"); const usersRoutes = require("../../../src/routes/users"); const { AppError } = require("../../../src/utils/AppError"); const ACTOR_ID = "11111111-1111-4111-8111-111111111111"; const DEPARTMENT_ID = "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa"; const USER_ID = "22222222-2222-4222-8222-222222222222"; const MANAGER_ID = "33333333-3333-4333-8333-333333333333"; async function buildApp({ createdEmployeeNo = "HYD000001", currentEmployee = null, actor = { id: ACTOR_ID, department_id: DEPARTMENT_ID, roleCodes: ["system_admin"], permissionCodes: ["system.accounts.manage", "system.roles.manage"], }, currentRoles = ["employee"], } = {}) { const app = Fastify(); const departmentFindUnique = vi.fn().mockResolvedValue({ id: DEPARTMENT_ID, archived_at: null, }); const employeeCreate = vi.fn(async ({ data }) => ({ id: USER_ID, employee_no: data.employee_no ?? createdEmployeeNo, name: data.name, phone: data.phone, email: data.email, status: data.status, department_id: data.department_id, title: data.title, direct_manager_id: data.direct_manager_id ?? null, hire_date: data.hire_date, created_at: data.created_at, updated_at: data.updated_at, })); const employeeFindUnique = vi .fn() .mockResolvedValue( currentEmployee ?? { id: USER_ID, employee_no: "HYD000321", name: "Alice", phone: "13800000000", email: "alice@example.com", status: "active", department_id: DEPARTMENT_ID, title: "员工", direct_manager_id: null, hire_date: new Date("2026-05-01T00:00:00.000Z"), bank_account_encrypted: "", bank_name: "", id_number_encrypted: null, archived_at: null, created_at: new Date("2026-05-01T00:00:00.000Z"), updated_at: new Date("2026-05-01T00:00:00.000Z"), roles: [{ role_code: "employee" }], }, ); const employeeUpdate = vi.fn(async ({ data }) => ({ ...(currentEmployee ?? { id: USER_ID, employee_no: "HYD000321", name: "Alice", phone: "13800000000", email: "alice@example.com", status: "active", department_id: DEPARTMENT_ID, title: "员工", direct_manager_id: null, hire_date: new Date("2026-05-01T00:00:00.000Z"), archived_at: null, created_at: new Date("2026-05-01T00:00:00.000Z"), updated_at: new Date("2026-05-01T00:00:00.000Z"), roles: [{ role_code: "employee" }], wecom_identity_binding: null, wecom_directory_sync_runs: [], }), ...data, })); const employeeRoleCreateMany = vi.fn().mockResolvedValue({ count: 1 }); const employeeRoleFindMany = vi.fn().mockResolvedValue(currentRoles.map((role_code) => ({ role_code }))); const employeeRoleDeleteMany = vi.fn().mockResolvedValue({ count: currentRoles.length }); const auditCreate = vi.fn().mockResolvedValue({ id: "audit-1" }); const authSessionUpdateMany = vi.fn().mockResolvedValue({ count: 0 }); const passwordResetCodeUpdateMany = vi.fn().mockResolvedValue({ count: 0 }); const emailLoginCodeUpdateMany = vi.fn().mockResolvedValue({ count: 0 }); const lifecycleEventCreate = vi.fn().mockResolvedValue({ id: "lifecycle-1" }); const checklistTaskCreateMany = vi.fn().mockResolvedValue({ count: 1 }); const wecomSyncRunCreate = vi.fn().mockResolvedValue({ id: "sync-run-1" }); const queryRaw = vi.fn(async (strings, employeeId) => { const sql = Array.isArray(strings) ? strings.join(" ") : String(strings ?? ""); if (sql.includes('FROM "employee_roles"')) { return currentRoles.map((role_code) => ({ role_code })); } if (sql.includes('FROM "employees"')) { return [{ id: employeeId }]; } return []; }); const tx = { department: { findUnique: departmentFindUnique, }, employee: { create: employeeCreate, findUnique: employeeFindUnique, update: employeeUpdate, }, employeeRole: { createMany: employeeRoleCreateMany, deleteMany: employeeRoleDeleteMany, }, employeeLifecycleEvent: { create: lifecycleEventCreate, }, employeeChecklistTask: { createMany: checklistTaskCreateMany, }, auditLog: { create: auditCreate, }, authSession: { updateMany: authSessionUpdateMany, }, passwordResetCode: { updateMany: passwordResetCodeUpdateMany, }, emailLoginCode: { updateMany: emailLoginCodeUpdateMany, }, $queryRaw: queryRaw, }; app.decorate("config", { employeeLifecycleEnabled: true }); app.decorate("prisma", { department: { findUnique: departmentFindUnique, }, employee: { findUnique: employeeFindUnique, }, employeeRole: { findMany: employeeRoleFindMany, }, featureFlag: { findUnique: vi.fn().mockResolvedValue({ id: "flag-employee-lifecycle", flag_key: "employee_lifecycle_v1", override_mode: "force_on", rollout_type: "global", department_ids: [], version: 1, }), }, $transaction: vi.fn(async (callback) => callback(tx)), }); app.decorate("requirePermission", (permissionCode) => async (request) => { request.employee = actor; const permissions = request.employee.permissionCodes ?? []; if (!permissions.includes("*") && !permissions.includes(permissionCode)) { throw new AppError({ code: "PERM_001", message: "无权限", statusCode: 403 }); } }); app.decorate("authenticate", async (request) => { request.employee = actor; }); app.decorate("hasPermission", (employee, permissionCode) => { const permissions = employee?.permissionCodes ?? []; return permissions.includes("*") || permissions.includes(permissionCode); }); app.setErrorHandler((error, request, reply) => { if (error instanceof AppError) { return reply.status(error.statusCode).send({ requestId: request.id, error: { code: error.code, message: error.message, details: error.details ?? {} }, }); } return reply.status(500).send({ requestId: request.id, error: { code: error.code ?? "SYS_001", message: error.message ?? "服务器内部错误", details: error.details ?? {} }, }); }); await app.register(usersRoutes, { prefix: "/api" }); return { app, departmentFindUnique, employeeCreate, employeeFindUnique, employeeUpdate, employeeRoleCreateMany, employeeRoleFindMany, employeeRoleDeleteMany, auditCreate, authSessionUpdateMany, passwordResetCodeUpdateMany, emailLoginCodeUpdateMany, lifecycleEventCreate, checklistTaskCreateMany, wecomSyncRunCreate, queryRaw, }; } describe("usersRoutes write flows", () => { it("creates a user without employeeNo or password and returns generated credentials", async () => { const { app, employeeCreate, employeeRoleCreateMany } = await buildApp(); const response = await app.inject({ method: "POST", url: "/api/users", payload: { name: "张三", phone: "13800000001", email: "ZhangSan@Example.COM", roles: ["employee"], syncWecomDirectory: false, }, }); expect(response.statusCode).toBe(200); expect(employeeCreate).toHaveBeenCalledWith( expect.objectContaining({ data: expect.objectContaining({ email: "zhangsan@example.com" }), }), ); expect(employeeCreate.mock.calls[0][0].data).not.toHaveProperty("employee_no"); expect(employeeRoleCreateMany).toHaveBeenCalledWith( expect.objectContaining({ data: [ expect.objectContaining({ employee_id: USER_ID, role_code: "employee", }), ], }), ); const payload = response.json().data; expect(payload).toEqual( expect.objectContaining({ id: USER_ID, employeeNo: "HYD000001", name: "张三", email: "zhangsan@example.com", roleCodes: ["employee"], }), ); expect(payload.oneTimePassword).toMatch(/^ResetA1[a-f0-9]{12}$/); await app.close(); }); it("creates a user with a null phone when the field is omitted", async () => { const { app, employeeCreate } = await buildApp(); const response = await app.inject({ method: "POST", url: "/api/users", payload: { name: "暂缺手机号成员", email: "no-phone@example.com", roles: ["employee"], syncWecomDirectory: false, }, }); expect(response.statusCode).toBe(200); expect(employeeCreate).toHaveBeenCalledWith(expect.objectContaining({ data: expect.objectContaining({ phone: null }), })); await app.close(); }); it("allows an administrator to explicitly clear an existing phone to null", async () => { const { app, employeeUpdate } = await buildApp(); const response = await app.inject({ method: "PATCH", url: `/api/users/${USER_ID}`, payload: { phone: null }, }); expect(response.statusCode).toBe(200); expect(employeeUpdate).toHaveBeenCalledWith(expect.objectContaining({ data: expect.objectContaining({ phone: null }), })); await app.close(); }); it("rejects employeeNo changes on patch", async () => { const { app, employeeFindUnique, employeeUpdate } = await buildApp(); const response = await app.inject({ method: "PATCH", url: `/api/users/${USER_ID}`, payload: { employeeNo: "HYD999999", name: "李四", }, }); expect(response.statusCode).toBe(409); expect(response.json().error).toEqual( expect.objectContaining({ code: "VALID_001", details: { employeeNo: "immutable", reasonCode: "user.employee_no_immutable" }, }), ); expect(employeeFindUnique).not.toHaveBeenCalled(); expect(employeeUpdate).not.toHaveBeenCalled(); await app.close(); }); it("prevents a system administrator from creating protected administrator roles", async () => { const { app, departmentFindUnique, employeeCreate } = await buildApp(); const response = await app.inject({ method: "POST", url: "/api/users", payload: { name: "受限账号", phone: "13800000002", email: "restricted@example.com", roles: ["employee", "system_admin"], }, }); expect(response.statusCode).toBe(403); expect(response.json().error.details).toEqual({ role: "protected_role_change_not_allowed" }); expect(departmentFindUnique).not.toHaveBeenCalled(); expect(employeeCreate).not.toHaveBeenCalled(); await app.close(); }); it("prevents a system administrator from granting or revoking protected roles before mutation", async () => { const grantApp = await buildApp(); const grantResponse = await grantApp.app.inject({ method: "POST", url: `/api/users/${USER_ID}/roles`, payload: { roles: ["employee", "admin"] }, }); expect(grantResponse.statusCode).toBe(403); expect(grantApp.employeeRoleDeleteMany).not.toHaveBeenCalled(); expect(grantApp.employeeRoleCreateMany).not.toHaveBeenCalled(); await grantApp.app.close(); const revokeApp = await buildApp({ currentRoles: ["employee", "system_admin"] }); const revokeResponse = await revokeApp.app.inject({ method: "POST", url: `/api/users/${USER_ID}/roles`, payload: { roles: ["employee"] }, }); expect(revokeResponse.statusCode).toBe(403); expect(revokeApp.employeeRoleDeleteMany).not.toHaveBeenCalled(); expect(revokeApp.employeeRoleCreateMany).not.toHaveBeenCalled(); await revokeApp.app.close(); }); it("prevents a system administrator from changing their own business roles before lookup", async () => { const testApp = await buildApp(); const response = await testApp.app.inject({ method: "POST", url: `/api/users/${ACTOR_ID}/roles`, payload: { roles: ["employee", "manager", "system_admin"] }, }); expect(response.statusCode).toBe(403); expect(response.json().error.details).toEqual({ user: "self_role_change_not_allowed" }); expect(testApp.employeeRoleFindMany).not.toHaveBeenCalled(); expect(testApp.employeeRoleDeleteMany).not.toHaveBeenCalled(); expect(testApp.employeeRoleCreateMany).not.toHaveBeenCalled(); await testApp.app.close(); }); it.each([ { name: "批量调部门", url: "/api/users/batch/transfer-department", payload: { employeeIds: [USER_ID], departmentId: DEPARTMENT_ID }, }, { name: "批量设直属经理", url: "/api/users/batch/set-manager", payload: { employeeIds: [USER_ID], managerId: MANAGER_ID }, }, { name: "批量停用", url: "/api/users/batch/disable", payload: { employeeIds: [USER_ID] }, }, { name: "批量启用", url: "/api/users/batch/enable", payload: { employeeIds: [USER_ID] }, }, ])("rejects $name when any target has a protected role before all writes", async ({ url, payload }) => { const testApp = await buildApp({ currentRoles: ["employee", "system_admin"] }); const response = await testApp.app.inject({ method: "POST", url, payload }); expect(response.statusCode).toBe(403); expect(response.json().error.details).toEqual({ user: "protected_account_not_manageable" }); expect(testApp.queryRaw).toHaveBeenCalledTimes(2); expect(testApp.employeeUpdate).not.toHaveBeenCalled(); expect(testApp.lifecycleEventCreate).not.toHaveBeenCalled(); expect(testApp.checklistTaskCreateMany).not.toHaveBeenCalled(); expect(testApp.authSessionUpdateMany).not.toHaveBeenCalled(); expect(testApp.auditCreate).not.toHaveBeenCalled(); expect(testApp.wecomSyncRunCreate).not.toHaveBeenCalled(); await testApp.app.close(); }); it.each([ { name: "更新账号", method: "PATCH", path: "", payload: { name: "受保护账号" } }, { name: "归档账号", method: "POST", path: "/archive" }, { name: "停用账号", method: "POST", path: "/disable" }, { name: "启用账号", method: "POST", path: "/enable" }, { name: "解锁账号", method: "POST", path: "/unlock" }, ])("rejects $name for a protected target before account side effects", async ({ method, path, payload }) => { const testApp = await buildApp({ currentRoles: ["employee", "admin"] }); const response = await testApp.app.inject({ method, url: `/api/users/${USER_ID}${path}`, ...(payload ? { payload } : {}), }); expect(response.statusCode).toBe(403); expect(response.json().error.details).toEqual({ user: "protected_account_not_manageable" }); expect(testApp.employeeUpdate).not.toHaveBeenCalled(); expect(testApp.authSessionUpdateMany).not.toHaveBeenCalled(); expect(testApp.auditCreate).not.toHaveBeenCalled(); expect(testApp.wecomSyncRunCreate).not.toHaveBeenCalled(); await testApp.app.close(); }); it("allows an emergency administrator to assign system_admin with before/after role audit", async () => { const testApp = await buildApp({ actor: { id: ACTOR_ID, department_id: DEPARTMENT_ID, roleCodes: ["admin"], permissionCodes: ["*"], }, }); const response = await testApp.app.inject({ method: "POST", url: `/api/users/${USER_ID}/roles`, payload: { roles: ["employee", "system_admin"] }, }); expect(response.statusCode).toBe(200); expect(testApp.employeeRoleDeleteMany).toHaveBeenCalledTimes(1); expect(testApp.auditCreate).toHaveBeenCalledWith({ data: expect.objectContaining({ action: "SYSTEM_USER_ROLES_SET", extra: { beforeRoleCodes: ["employee"], afterRoleCodes: ["employee", "system_admin"], }, }), }); await testApp.app.close(); }); it("prevents a system administrator from resetting a protected account", async () => { const testApp = await buildApp({ currentRoles: ["employee", "admin"] }); const response = await testApp.app.inject({ method: "POST", url: `/api/users/${USER_ID}/reset-password`, payload: { newPassword: "AdministratorReset1234" }, }); expect(response.statusCode).toBe(403); expect(response.json().error.details).toEqual({ user: "protected_account_not_manageable" }); expect(testApp.employeeUpdate).not.toHaveBeenCalled(); expect(testApp.authSessionUpdateMany).not.toHaveBeenCalled(); expect(testApp.auditCreate).not.toHaveBeenCalled(); await testApp.app.close(); }); it("revokes sessions and outstanding challenges during an administrator password reset", async () => { const { app, employeeUpdate, authSessionUpdateMany, passwordResetCodeUpdateMany, emailLoginCodeUpdateMany, auditCreate, } = await buildApp(); const response = await app.inject({ method: "POST", url: `/api/users/${USER_ID}/reset-password`, payload: { newPassword: "AdministratorReset1234" }, }); expect(response.statusCode).toBe(200); expect(response.json().data).toEqual({ id: USER_ID, oneTimePassword: "AdministratorReset1234", }); expect(employeeUpdate).toHaveBeenCalledWith({ where: { id: USER_ID }, data: expect.objectContaining({ must_change_password: true, token_version: { increment: 1 }, email_login_code_failed_count: 0, password_reset_failed_count: 0, password_reset_request_count: 0, }), }); expect(authSessionUpdateMany).toHaveBeenCalledWith({ where: { employee_id: USER_ID, revoked_at: null }, data: { revoked_at: expect.any(Date), last_seen_at: expect.any(Date) }, }); expect(passwordResetCodeUpdateMany).toHaveBeenCalledWith({ where: { employee_id: USER_ID, invalidated_at: null }, data: { invalidated_at: expect.any(Date) }, }); expect(emailLoginCodeUpdateMany).toHaveBeenCalledWith({ where: { employee_id: USER_ID, used_at: null }, data: { used_at: expect.any(Date) }, }); expect(auditCreate).toHaveBeenCalledWith({ data: expect.objectContaining({ action: "SYSTEM_USER_PASSWORD_RESET" }), }); await app.close(); }); }); describe("users hireDate calendar boundary", () => { it.each(["POST", "PATCH"].flatMap((method) => ["2026-02-29", "2026-04-31", "2026-00-10"].map((date) => [method, date])))( "%s rejects %s before account, role, audit or lifecycle writes", async (method, hireDate) => { const fixture = await buildApp(); const { app } = fixture; try { const response = await app.inject({ method, url: method === "POST" ? "/api/users" : `/api/users/${USER_ID}`, payload: method === "POST" ? { name: "Synthetic", email: "calendar@example.test", roles: ["employee"], syncWecomDirectory: false, hireDate } : { hireDate } }); expect(response.statusCode).toBe(400); expect(response.json().error.code).toBe("VALID_001"); expect(response.json().error.details).toEqual({ formErrors: [], fieldErrors: { hireDate: ["invalid_calendar_date"] }, reasonCode: method === "POST" ? "user.create_input_invalid" : "user.update_input_invalid" }); expect(app.prisma.$transaction).not.toHaveBeenCalled(); for (const name of ["employeeCreate", "employeeUpdate", "employeeRoleCreateMany", "employeeRoleDeleteMany", "auditCreate", "lifecycleEventCreate", "checklistTaskCreateMany", "wecomSyncRunCreate"]) expect(fixture[name]).not.toHaveBeenCalled(); } finally { await app.close(); } }, ); it.each(["POST", "PATCH"].flatMap((method) => ["2024-02-29", "2026-04-30", undefined].map((date) => [method, date])))( "%s preserves valid or omitted hireDate %s", async (method, hireDate) => { const { app, employeeCreate, employeeUpdate } = await buildApp(); try { const before = Date.now(); const response = await app.inject({ method, url: method === "POST" ? "/api/users" : `/api/users/${USER_ID}`, payload: method === "POST" ? { name: "Synthetic", email: "calendar@example.test", roles: ["employee"], syncWecomDirectory: false, ...(hireDate ? { hireDate } : {}) } : { title: "员工", ...(hireDate ? { hireDate } : {}) } }); expect(response.statusCode).toBe(200); const data = (method === "POST" ? employeeCreate : employeeUpdate).mock.calls[0][0].data; if (hireDate) expect(data.hire_date.toISOString()).toBe(`${hireDate}T00:00:00.000Z`); else if (method === "PATCH") expect(data).not.toHaveProperty("hire_date"); else { expect(data.hire_date.getTime()).toBeGreaterThanOrEqual(before); expect(data.hire_date.getTime()).toBeLessThanOrEqual(Date.now()); } } finally { await app.close(); } }, ); }); describe("user immutable and empty update reasons", () => { it.each([[{ employeeNo: "SYNTHETIC" }, 409, { employeeNo: "immutable", reasonCode: "user.employee_no_immutable" }], [{}, 400, { body: "empty", reasonCode: "user.update_empty" }]])("rejects %j without account writes", async (payload, status, details) => { const { app, employeeUpdate, auditCreate } = await buildApp(); try { const response = await app.inject({ method: "PATCH", url: `/api/users/${USER_ID}`, payload }); expect(response.statusCode).toBe(status); expect(response.json().error).toEqual({ code: "VALID_001", message: "参数校验失败", details }); expect(app.prisma.$transaction).not.toHaveBeenCalled(); expect(employeeUpdate).not.toHaveBeenCalled(); expect(auditCreate).not.toHaveBeenCalled(); } finally { await app.close(); } }); }); describe("remaining account error reasons", () => { function expectNoWrites(t) { for (const fn of [t.employeeCreate, t.employeeUpdate, t.employeeRoleCreateMany, t.employeeRoleDeleteMany, t.auditCreate, t.authSessionUpdateMany, t.passwordResetCodeUpdateMany, t.emailLoginCodeUpdateMany, t.lifecycleEventCreate, t.checklistTaskCreateMany, t.wecomSyncRunCreate]) expect(fn).not.toHaveBeenCalled(); } it.each([ ["PATCH", "/api/users/bad", { name: "合成" }, "user.id_invalid", { id: "invalid_uuid" }], ["POST", `/api/users/${USER_ID}/reset-password`, { newPassword: "" }, "user.reset_password_input_invalid", null], ["POST", `/api/users/${USER_ID}/roles`, { roles: [] }, "user.roles_input_invalid", null], ["POST", "/api/users/batch/transfer-department", { employeeIds: [] }, "user.batch_transfer_input_invalid", null], ["POST", "/api/users/batch/set-manager", { employeeIds: [] }, "user.batch_manager_input_invalid", null], ["POST", "/api/users/batch/disable", { employeeIds: [] }, "user.batch_toggle_input_invalid", null], ["POST", "/api/users/batch/enable", { employeeIds: [] }, "user.batch_toggle_input_invalid", null], ])("%s %s explains invalid input before transactions", async (method, url, payload, reasonCode, details) => { const t = await buildApp(); try { const response = await t.app.inject({ method, url, payload }); expect(response.statusCode).toBe(400); expect(response.json().error).toMatchObject({ code: "VALID_001", details: { reasonCode } }); if (details) expect(response.json().error.details).toEqual({ ...details, reasonCode }); else expect(response.json().error.details).toMatchObject({ formErrors: expect.any(Array), fieldErrors: expect.any(Object) }); expect(t.app.prisma.$transaction).not.toHaveBeenCalled(); expectNoWrites(t); } finally { await t.app.close(); } }); it.each(["create", "reset"])("preserves password policy failure for %s", async (operation) => { const t = await buildApp(); try { const response = await t.app.inject({ method: "POST", url: operation === "create" ? "/api/users" : `/api/users/${USER_ID}/reset-password`, payload: operation === "create" ? { name: "合成", email: "synthetic@example.test", password: "short" } : { newPassword: "short" } }); expect(response.statusCode).toBe(400); expect(response.json().error.details).toMatchObject({ reasonCode: "user.password_policy_failed", [operation === "create" ? "password" : "newPassword"]: expect.arrayContaining(["密码长度必须 ≥ 12", "密码必须包含大写字母", "密码必须包含数字"]) }); expect(t.app.prisma.$transaction).not.toHaveBeenCalled(); expectNoWrites(t); } finally { await t.app.close(); } }); it.each([ ["department", null, { departmentId: DEPARTMENT_ID }, 400, "user.department_not_found", { departmentId: "not_found" }], ["department", { id: DEPARTMENT_ID, archived_at: new Date("2024-01-01T00:00:00Z") }, { departmentId: DEPARTMENT_ID }, 409, "user.department_archived", { departmentId: "archived" }], ["employee", null, { directManagerId: MANAGER_ID }, 400, "user.manager_not_found", { directManagerId: "not_found" }], ["employee", { id: MANAGER_ID, status: "archived" }, { directManagerId: MANAGER_ID }, 409, "user.manager_inactive", { directManagerId: "inactive" }], ["employee", null, { directManagerId: USER_ID }, 409, "user.manager_self_forbidden", { directManagerId: "self_not_allowed" }], ])("explains unavailable %s reference", async (model, row, payload, status, reasonCode, details) => { const t = await buildApp(); try { (model === "department" ? t.departmentFindUnique : t.employeeFindUnique).mockResolvedValue(row); const response = await t.app.inject({ method: "PATCH", url: `/api/users/${USER_ID}`, payload }); expect(response.statusCode).toBe(status); expect(response.json().error.details).toEqual({ ...details, reasonCode }); expect(t.app.prisma.$transaction).not.toHaveBeenCalled(); expectNoWrites(t); } finally { await t.app.close(); } }); it.each(["archive", "disable", "batch/disable", "roles"])("keeps the self-protection guard for %s", async (operation) => { const t = await buildApp({ actor: { id: ACTOR_ID, department_id: DEPARTMENT_ID, roleCodes: ["admin"], permissionCodes: ["*"] } }); try { const response = await t.app.inject({ method: "POST", url: operation === "batch/disable" ? "/api/users/batch/disable" : `/api/users/${ACTOR_ID}/${operation}`, ...(operation === "batch/disable" ? { payload: { employeeIds: Array(51).fill(ACTOR_ID) } } : operation === "roles" ? { payload: { roles: ["employee"] } } : {}) }); expect(response.statusCode).toBe(409); expect(response.json().error.details).toEqual(operation === "roles" ? { user: "self_role_change_not_allowed", reasonCode: "user.self_role_change_forbidden" } : { user: "self_disable_not_allowed", reasonCode: "user.self_disable_forbidden" }); expect(t.app.prisma.$transaction).not.toHaveBeenCalled(); expectNoWrites(t); } finally { await t.app.close(); } }); it("limits distinct batch employees before transactions", async () => { const t = await buildApp(); try { const employeeIds = Array.from({ length: 51 }, (_, i) => `00000000-0000-4000-8000-${String(i + 1).padStart(12, "0")}`); const response = await t.app.inject({ method: "POST", url: "/api/users/batch/enable", payload: { employeeIds } }); expect(response.statusCode).toBe(409); expect(response.json().error.details).toEqual({ employeeIds: "too_many", reasonCode: "user.batch_limit_exceeded" }); expect(t.app.prisma.$transaction).not.toHaveBeenCalled(); expectNoWrites(t); } finally { await t.app.close(); } }); it("preserves feature refusal before batch validation", async () => { const t = await buildApp(); try { t.app.prisma.featureFlag.findUnique.mockResolvedValue({ flag_key: "employee_lifecycle_v1", override_mode: "force_off", rollout_type: "global", department_ids: [] }); const response = await t.app.inject({ method: "POST", url: "/api/users/batch/set-manager", payload: {} }); expect(response.statusCode).toBe(409); expect(response.json().error.details).toEqual({ featureFlag: "employee_lifecycle_v1_disabled", reason: "flag_force_off", reasonCode: "user.lifecycle_disabled" }); expect(t.app.prisma.$transaction).not.toHaveBeenCalled(); expectNoWrites(t); } finally { await t.app.close(); } }); it.each(["POST", "PATCH"])("keeps unique-conflict details for %s", async (method) => { const t = await buildApp(); try { t.app.prisma.$transaction.mockRejectedValue({ code: "P2002", meta: { target: ["email"] } }); const response = await t.app.inject({ method, url: method === "POST" ? "/api/users" : `/api/users/${USER_ID}`, payload: method === "POST" ? { name: "合成", email: "synthetic@example.test" } : { email: "synthetic@example.test" } }); expect(response.statusCode).toBe(409); expect(response.json().error.details).toEqual({ email: "duplicate", reasonCode: "user.unique_conflict" }); expectNoWrites(t); } finally { await t.app.close(); } }); it("fails closed when a synthetic random-source fault produces an unsafe temporary password", async () => { const t = await buildApp(); const random = vi.spyOn(require("node:crypto"), "randomBytes").mockReturnValueOnce(Buffer.alloc(0)); try { const response = await t.app.inject({ method: "POST", url: "/api/users", payload: { name: "合成", email: "synthetic@example.test" } }); expect(response.statusCode).toBe(400); expect(response.json().error.details).toMatchObject({ reasonCode: "user.generated_password_unavailable", password: expect.arrayContaining(["密码长度必须 ≥ 12"]) }); expect(t.app.prisma.$transaction).not.toHaveBeenCalled(); expectNoWrites(t); } finally { random.mockRestore(); await t.app.close(); } }); }); describe("system-user creation transaction cost boundary", () => { it("finishes real cost12 hashing before beginning the atomic account-role-audit transaction", async () => { const t = await buildApp(); const bcrypt = require("bcryptjs"); const realHash = bcrypt.hash; const events = []; const hash = vi.spyOn(bcrypt, "hash").mockImplementation(async (...args) => { expect(args[1]).toBe(12); events.push("hash:start"); const result = await realHash(...args); events.push("hash:done"); return result; }); const transaction = t.app.prisma.$transaction.getMockImplementation(); t.app.prisma.$transaction.mockImplementation(async cb => { events.push("begin"); const result = await transaction(cb); events.push("commit"); return result; }); for (const [name, mock] of [["employee", t.employeeCreate], ["roles", t.employeeRoleCreateMany], ["audit", t.auditCreate]]) { const original = mock.getMockImplementation(); mock.mockImplementation(async (...args) => { events.push(name); return original(...args); }); } try { const r = await t.app.inject({ method: "POST", url: "/api/users", payload: { name: "合成账号", email: "boundary@example.test", roles: ["employee"], syncWecomDirectory: false } }); expect(r.statusCode).toBe(200); expect(hash).toHaveBeenCalledOnce(); expect(events).toEqual(["hash:start", "hash:done", "begin", "employee", "roles", "audit", "commit"]); const stored = t.employeeCreate.mock.calls[0][0].data; expect(stored.must_change_password).toBe(true); expect(await bcrypt.compare(r.json().data.oneTimePassword, stored.password_hash)).toBe(true); expect(t.auditCreate.mock.calls[0][0].data).toMatchObject({ action: "SYSTEM_USER_CREATED", actor_id: ACTOR_ID, target_id: USER_ID }); expect(t.wecomSyncRunCreate).not.toHaveBeenCalled(); } finally { hash.mockRestore(); await t.app.close(); } }); it("does not enter a transaction or create an account if password hashing fails", async () => { const t = await buildApp(); const hash = vi.spyOn(require("bcryptjs"), "hash").mockRejectedValue(new Error("synthetic hash failure")); try { const r = await t.app.inject({ method: "POST", url: "/api/users", payload: { name: "合成账号", email: "hash-failure@example.test", syncWecomDirectory: false } }); expect(r.statusCode).toBe(500); expect(hash).toHaveBeenCalledOnce(); expect(t.app.prisma.$transaction).not.toHaveBeenCalled(); for (const mock of [t.employeeCreate, t.employeeRoleCreateMany, t.auditCreate, t.wecomSyncRunCreate]) expect(mock).not.toHaveBeenCalled(); } finally { hash.mockRestore(); await t.app.close(); } }); it.each(["roles", "audit", "commit"])("does not read completed roles or sync externally after a %s failure", async phase => { const t = await buildApp(); const failure = new Error("synthetic transaction failure"); if (phase === "roles") t.employeeRoleCreateMany.mockRejectedValue(failure); if (phase === "audit") t.auditCreate.mockRejectedValue(failure); if (phase === "commit") { const original = t.app.prisma.$transaction.getMockImplementation(); t.app.prisma.$transaction.mockImplementation(async cb => { await original(cb); throw failure; }); } try { const r = await t.app.inject({ method: "POST", url: "/api/users", payload: { name: "合成账号", email: "write-failure@example.test", roles: ["employee"], syncWecomDirectory: false } }); expect(r.statusCode).toBe(500); expect(t.app.prisma.$transaction).toHaveBeenCalledOnce(); expect(t.employeeCreate).toHaveBeenCalledOnce(); expect(t.employeeRoleFindMany).not.toHaveBeenCalled(); expect(t.wecomSyncRunCreate).not.toHaveBeenCalled(); if (phase === "roles") expect(t.auditCreate).not.toHaveBeenCalled(); } finally { await t.app.close(); } }); });