文件
hyb-oa/server/tests/unit/routes/payroll.payslips.test.js
T

396 行
11 KiB
JavaScript

const Fastify = require("fastify");
const payrollRoutes = require("../../../src/routes/payroll");
const { AppError } = require("../../../src/utils/AppError");
const ADMIN_ID = "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa";
const EMPLOYEE_ID = "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb";
const OTHER_EMPLOYEE_ID = "cccccccc-cccc-4ccc-8ccc-cccccccccccc";
function buildEmployee(overrides = {}) {
return {
id: EMPLOYEE_ID,
employee_no: "E001",
name: "Alice",
title: "专员",
status: "active",
department: { id: "dept-1", name: "行政部" },
...overrides,
};
}
function buildSalaryItem(overrides = {}) {
return {
id: "11111111-1111-4111-8111-111111111111",
name: "基本工资",
item_type: "earning",
sort_order: 10,
enabled: true,
...overrides,
};
}
function buildSalaryRow(overrides = {}) {
return {
id: "salary-1",
employee_id: EMPLOYEE_ID,
salary_item_id: "11111111-1111-4111-8111-111111111111",
monthly_amount: "10000.00",
effective_date: new Date("2026-04-01T00:00:00.000Z"),
...overrides,
};
}
const PAYSLIP_IDS = [
"dddddddd-dddd-4ddd-8ddd-dddddddddddd",
"eeeeeeee-eeee-4eee-8eee-eeeeeeeeeeee",
"ffffffff-ffff-4fff-8fff-ffffffffffff",
];
async function buildApp({
actor = { id: ADMIN_ID, permissionCodes: ["system.users"] },
omitProfileFor = [],
} = {}) {
const app = Fastify();
const state = {
employees: [
buildEmployee(),
buildEmployee({
id: OTHER_EMPLOYEE_ID,
employee_no: "E002",
name: "Bob",
}),
],
salaryItems: [
buildSalaryItem(),
buildSalaryItem({
id: "22222222-2222-4222-8222-222222222222",
name: "社保扣除",
item_type: "deduction",
sort_order: 20,
}),
],
salaryRows: [
buildSalaryRow(),
buildSalaryRow({
id: "salary-2",
employee_id: EMPLOYEE_ID,
salary_item_id: "22222222-2222-4222-8222-222222222222",
monthly_amount: "600.00",
}),
buildSalaryRow({
id: "salary-3",
employee_id: OTHER_EMPLOYEE_ID,
monthly_amount: "9000.00",
}),
buildSalaryRow({
id: "salary-4",
employee_id: OTHER_EMPLOYEE_ID,
salary_item_id: "22222222-2222-4222-8222-222222222222",
monthly_amount: "500.00",
}),
].filter((item) => !omitProfileFor.includes(item.employee_id)),
payslips: [],
payslipItems: [],
};
function hydratePayslip(payslip) {
return {
...payslip,
employee: state.employees.find((item) => item.id === payslip.employee_id),
items: state.payslipItems
.filter((item) => item.payslip_id === payslip.id)
.map((item) => ({
...item,
salary_item: state.salaryItems.find((salaryItem) => salaryItem.id === item.salary_item_id),
})),
};
}
const payslip = {
count: vi.fn(async ({ where }) => state.payslips.filter((item) => item.pay_month.getTime() === where.pay_month.getTime()).length),
findMany: vi.fn(async ({ where, select, include }) => {
const filtered = state.payslips.filter((item) => {
if (where?.pay_month && item.pay_month.getTime() !== where.pay_month.getTime()) {
return false;
}
if (where?.employee_id && item.employee_id !== where.employee_id) {
return false;
}
if (where?.status && item.status !== where.status) {
return false;
}
if (where?.id?.in && !where.id.in.includes(item.id)) {
return false;
}
return true;
});
if (select) {
return filtered.map((item) => ({
id: item.id,
status: item.status,
}));
}
if (include) {
return filtered.map(hydratePayslip);
}
return filtered;
}),
findUnique: vi.fn(async ({ where }) => {
const payslipRow = state.payslips.find((item) => item.id === where.id);
return payslipRow ? hydratePayslip(payslipRow) : null;
}),
create: vi.fn(async ({ data }) => {
const row = {
id: PAYSLIP_IDS[state.payslips.length] ?? PAYSLIP_IDS[0],
employee_id: data.employee_id,
pay_month: data.pay_month,
status: data.status,
gross_amount: data.gross_amount,
deduction_amount: data.deduction_amount,
net_amount: data.net_amount,
issued_at: data.issued_at ?? null,
created_at: new Date("2026-04-30T08:00:00.000Z"),
created_by: data.created_by,
updated_at: new Date("2026-04-30T08:00:00.000Z"),
updated_by: data.updated_by,
};
state.payslips.push(row);
state.payslipItems.push(
...(data.items?.create ?? []).map((item, index) => ({
id: `payslip-item-${state.payslipItems.length + index + 1}`,
payslip_id: row.id,
salary_item_id: item.salary_item_id,
amount: item.amount,
})),
);
return row;
}),
update: vi.fn(async ({ where, data }) => {
const index = state.payslips.findIndex((item) => item.id === where.id);
state.payslips[index] = {
...state.payslips[index],
...data,
updated_at: new Date("2026-04-30T09:00:00.000Z"),
};
return state.payslips[index];
}),
updateMany: vi.fn(async ({ where, data }) => {
let count = 0;
state.payslips = state.payslips.map((item) => {
if (where.id?.in && where.id.in.includes(item.id)) {
count += 1;
return {
...item,
...data,
};
}
return item;
});
return { count };
}),
};
const payslipItem = {
deleteMany: vi.fn(async ({ where }) => {
state.payslipItems = state.payslipItems.filter((item) => item.payslip_id !== where.payslip_id);
return { count: 1 };
}),
createMany: vi.fn(async ({ data }) => {
state.payslipItems.push(
...data.map((item, index) => ({
id: `payslip-item-${state.payslipItems.length + index + 1}`,
payslip_id: item.payslip_id,
salary_item_id: item.salary_item_id,
amount: item.amount,
})),
);
return { count: data.length };
}),
};
app.decorate("authenticate", async (request) => {
request.employee = actor;
});
app.decorate("requirePermission", (permissionCode) => async (request) => {
request.employee = actor;
const codes = actor.permissionCodes ?? [];
if (!codes.includes("*") && !codes.includes(permissionCode)) {
throw new AppError({ code: "PERM_001", message: "无权限", statusCode: 403 });
}
});
app.decorate("hasPermission", (employee, permissionCode) => {
const codes = employee.permissionCodes ?? [];
return codes.includes("*") || codes.includes(permissionCode);
});
app.decorate("prisma", {
employee: {
findMany: vi.fn(async ({ where }) => {
if (where?.status === "active") {
return state.employees.filter((item) => item.status === "active");
}
return [...state.employees];
}),
findUnique: vi.fn(async ({ where }) => state.employees.find((item) => item.id === where.id) ?? null),
},
salaryItem: {
findMany: vi.fn(async ({ where }) => {
if (where?.enabled === true) {
return state.salaryItems.filter((item) => item.enabled);
}
if (where?.id?.in) {
return state.salaryItems.filter((item) => where.id.in.includes(item.id));
}
return [...state.salaryItems];
}),
},
employeeSalary: {
findMany: vi.fn(async ({ where, select }) =>
state.salaryRows.filter((item) => {
if (where.employee_id?.in && !where.employee_id.in.includes(item.employee_id)) {
return false;
}
if (where.effective_date?.lte && item.effective_date > where.effective_date.lte) {
return false;
}
return true;
}).map((item) => (select ? { ...item } : item)),
),
},
payslip,
payslipItem,
auditLog: {
create: vi.fn().mockResolvedValue({}),
},
$transaction: vi.fn(async (callback) => callback(app.prisma)),
});
app.setErrorHandler((error, request, reply) => {
reply.status(error.statusCode || 500).send({
requestId: request.id,
error: {
code: error.code || "SYS_001",
message: error.message,
details: error.details ?? null,
},
});
});
await app.register(payrollRoutes, { prefix: "/api" });
return { app, state, payslip, payslipItem };
}
describe("payroll payslip routes", () => {
it("generates, edits and issues payslips and limits self view to issued records", async () => {
const { app, state, payslipItem } = await buildApp();
const generateResponse = await app.inject({
method: "POST",
url: "/api/payroll/payslips/generate",
payload: { month: "2026-04" },
});
expect(generateResponse.statusCode).toBe(200);
expect(generateResponse.json().data.summary).toEqual({
total: 2,
generated: 2,
});
expect(state.payslips).toHaveLength(2);
const patchResponse = await app.inject({
method: "PATCH",
url: `/api/payroll/payslips/${state.payslips[0].id}`,
payload: {
items: [
{
salaryItemId: state.salaryItems[0].id,
amount: 11000,
},
{
salaryItemId: state.salaryItems[1].id,
amount: 500,
},
],
},
});
expect(patchResponse.statusCode).toBe(200);
expect(patchResponse.json().data).toMatchObject({
grossAmount: 11000,
deductionAmount: 500,
netAmount: 10500,
status: "draft",
});
expect(payslipItem.createMany).toHaveBeenCalledTimes(1);
const issueResponse = await app.inject({
method: "POST",
url: "/api/payroll/payslips/issue",
payload: { month: "2026-04" },
});
expect(issueResponse.statusCode).toBe(200);
expect(issueResponse.json().data.summary).toEqual({
total: 2,
issued: 2,
});
const frozenResponse = await app.inject({
method: "PATCH",
url: `/api/payroll/payslips/${state.payslips[0].id}`,
payload: {
items: [
{
salaryItemId: state.salaryItems[0].id,
amount: 12000,
},
],
},
});
expect(frozenResponse.statusCode).toBe(409);
await app.close();
const selfApp = await buildApp({
actor: {
id: EMPLOYEE_ID,
permissionCodes: ["employee"],
},
});
selfApp.state.payslips = state.payslips;
selfApp.state.payslipItems = state.payslipItems;
const selfResponse = await selfApp.app.inject({
method: "GET",
url: `/api/payroll/employees/${EMPLOYEE_ID}/payslips`,
});
expect(selfResponse.statusCode).toBe(200);
expect(selfResponse.json().data.items).toHaveLength(1);
expect(selfResponse.json().data.items[0].status).toBe("issued");
await selfApp.app.close();
});
it("fails generation when an active employee has no effective salary profile", async () => {
const { app, state } = await buildApp({
omitProfileFor: [OTHER_EMPLOYEE_ID],
});
const response = await app.inject({
method: "POST",
url: "/api/payroll/payslips/generate",
payload: { month: "2026-04" },
});
expect(response.statusCode).toBe(409);
expect(response.json().error.details.month).toBe("salary_profile_missing");
expect(state.payslips).toHaveLength(0);
await app.close();
});
});