文件
hyb-oa/server/tests/unit/routes/exports.contractsRegistry.test.js
T
wangsli 1f8d5b658a 完善借款、编号、付款与预算并发及验收(09-06-release-gate-integrity)
汇总已落盘的借款本金与还款、兼容历史编号的周期化编号、付款责任与回单核验、报销进度和排序、PWA/采购事务、错误原因与日期校验及ERP退役。
统一共享预算池锁序和锁后判断,恢复差旅原预算选择,补原因码固定夹具及反向完整性检查。
纳入配套迁移、测试、受管QA、分层验收合同、规约及任务记录;原始证据留在ignored artifacts。

关联任务:09-17-company-loan-principal-repayment、09-17-erp-exclusive-retirement、09-18-reimbursement-periodic-numbering、09-08-reimbursement-payment-closeout、09-18-local-concurrency-product-fixes、09-19-budget-pool-concurrency、09-05-error-explainability-payment-readiness。
预算补审由Claude定向验证2文件928项通过,原4446/28及r6结果仍仅对应各自历史输入;本轮未重跑测试。
完整新候选门禁、R1真实入口接入与12项公网义务仍开放。生产编号未启用、差旅仍冻结;不推送、不部署,不宣称发布资格。
2026-09-19 13:11:04 +08:00

280 行
9.6 KiB
JavaScript

const { AppError } = require("../../../src/utils/AppError");
const Fastify = require("fastify");
const exportsRoutes = require("../../../src/routes/exports");
const ACTOR_ID = "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa";
const PROJECT_ID = "11111111-1111-4111-8111-111111111111";
const OWNER_ID = "22222222-2222-4222-8222-222222222222";
const DEPARTMENT_ID = "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb";
function buildFeatureFlagRecord(flagKey) {
return {
id: `flag-${flagKey}`,
flag_key: flagKey,
override_mode: "force_on",
rollout_type: "global",
department_ids: [],
note: "unit-test",
version: 1,
created_at: new Date("2026-04-04T08:00:00.000Z"),
created_by: null,
updated_at: new Date("2026-04-04T08:00:00.000Z"),
updated_by: null,
};
}
function buildContractRow(overrides = {}) {
return {
id: "contract-1",
contract_no: "HT-2026-001",
project_id: PROJECT_ID,
contract_type: "service",
counterparty_name: "测试客户",
summary: "合同摘要",
amount: "88000.00",
currency: "CNY",
signed_date: new Date("2026-03-01T00:00:00.000Z"),
effective_date: new Date("2026-03-05T00:00:00.000Z"),
expiry_date: new Date("2026-03-31T00:00:00.000Z"),
confidentiality_level: "internal",
archive_location: "/archive/contracts/001",
offline_archive_no: "OFF-001",
owner_employee_id: OWNER_ID,
status: "active",
created_at: new Date("2026-03-01T08:00:00.000Z"),
updated_at: new Date("2026-04-01T08:00:00.000Z"),
owner: {
name: "Owner",
},
project: {
project_no: "PRJ-001",
name: "试点项目",
},
...overrides,
};
}
async function buildApp(options = {}) {
const app = Fastify();
const actor = options.actor ?? {
id: ACTOR_ID,
department_id: DEPARTMENT_ID,
permissionCodes: ["project.manage"],
};
const count = options.count ?? vi.fn().mockResolvedValue(1);
const findMany =
options.findMany ??
vi.fn().mockImplementation(async ({ where }) => {
if (where?.OR) {
return [];
}
return [buildContractRow()];
});
const auditCreate = options.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 Error(`unexpected permission check: ${permissionCode}`);
}
});
app.decorate("hasPermission", (employee, permissionCode) => {
const permissionCodes = employee.permissionCodes ?? [];
return permissionCodes.includes("*") || permissionCodes.includes(permissionCode);
});
app.decorate("config", {
appTimezone: "Asia/Shanghai",
projectLinkingEnabled: true,
});
app.decorate("prisma", {
featureFlag: {
findUnique: vi.fn().mockImplementation(async ({ where }) => buildFeatureFlagRecord(where.flag_key)),
},
auditLog: {
create: auditCreate,
},
contractRegistry: {
count,
findMany,
},
});
app.setErrorHandler((error, request, reply) => {
if (error instanceof AppError) {
return reply.status(error.statusCode).send({
error: { code: error.code, message: error.message, ...(error.details ? { details: error.details } : {}) },
});
}
return reply.status(500).send({ error: { code: "SYS_001" } });
});
await app.register(exportsRoutes, { prefix: "/api" });
return { app, count, findMany, auditCreate };
}
describe("contracts registry export route", () => {
it("exports filtered contracts registry as csv", async () => {
const { app, count, findMany, auditCreate } = await buildApp();
const response = await app.inject({
method: "POST",
url: "/api/exports/contracts-registry",
payload: {
format: "csv",
status: "expired",
contractType: "service",
counterpartyName: "测试",
expiryDateFrom: "2026-03-01",
expiryDateTo: "2026-03-31",
},
});
expect(response.statusCode).toBe(200);
expect(response.headers["content-type"]).toContain("text/csv");
expect(response.headers["content-disposition"]).toContain("contracts-registry-");
expect(response.body).toContain("合同编号");
expect(response.body).toContain("服务合同");
expect(response.body).toContain("已过期");
expect(count).toHaveBeenCalledWith(
expect.objectContaining({
where: expect.objectContaining({
AND: expect.arrayContaining([
expect.objectContaining({ contract_type: "service" }),
expect.objectContaining({
counterparty_name: expect.objectContaining({ contains: "测试", mode: "insensitive" }),
}),
]),
}),
}),
);
expect(findMany).toHaveBeenCalled();
expect(auditCreate).toHaveBeenCalledWith(
expect.objectContaining({
data: expect.objectContaining({
action: "EXPORT_CONTRACTS_REGISTRY",
extra: expect.objectContaining({
format: "csv",
status: "expired",
contractType: "service",
counterpartyName: "测试",
matchedTotal: 1,
}),
}),
}),
);
await app.close();
});
it("exports contracts registry as xlsx", async () => {
const { app, auditCreate } = await buildApp({
count: vi.fn().mockResolvedValue(1),
findMany: vi.fn().mockResolvedValue([
buildContractRow({
id: "contract-2",
contract_no: "HT-2026-002",
contract_type: "purchase",
status: "archived",
expiry_date: new Date("2026-04-15T00:00:00.000Z"),
}),
]),
});
const response = await app.inject({
method: "POST",
url: "/api/exports/contracts-registry",
payload: {
format: "xlsx",
},
});
expect(response.statusCode).toBe(200);
expect(response.headers["content-type"]).toContain(
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
);
expect(response.headers["content-disposition"]).toContain("contracts-registry-");
expect(Buffer.from(response.rawPayload).length).toBeGreaterThan(0);
expect(auditCreate).toHaveBeenCalledWith(
expect.objectContaining({
data: expect.objectContaining({
action: "EXPORT_CONTRACTS_REGISTRY",
extra: expect.objectContaining({
format: "xlsx",
matchedTotal: 1,
}),
}),
}),
);
await app.close();
});
it("exports terminated contracts with a Chinese status label", async () => {
const { app } = await buildApp({
findMany: vi
.fn()
.mockResolvedValueOnce([
buildContractRow({
status: "terminated",
expiry_date: new Date("2026-03-31T00:00:00.000Z"),
}),
])
.mockResolvedValue([]),
});
const response = await app.inject({
method: "POST",
url: "/api/exports/contracts-registry",
payload: { format: "csv", status: "terminated" },
});
expect(response.statusCode).toBe(200);
expect(response.body).toContain("已终止");
expect(response.body).not.toContain(",terminated,");
await app.close();
});
});
describe("contract export calendar boundaries", () => {
it.each(["csv", "xlsx"].flatMap((format) => ["expiryDateFrom", "expiryDateTo"].map((field) => [format, field])))("rejects %s overflowing %s before export reads/audit", async (format, field) => {
const { app, findMany, count, auditCreate } = await buildApp();
try {
const response = await app.inject({ method: "POST", url: "/api/exports/contracts-registry", payload: { format, [field]: "2026-02-30" } });
expect(response.statusCode).toBe(400);
expect(response.json().error).toMatchObject({ code: "VALID_001", details: { reasonCode: "contract_registry.query_invalid", formErrors: [], fieldErrors: { [field]: expect.arrayContaining(["invalid_calendar_date"]) } } });
expect(findMany).not.toHaveBeenCalled();
expect(count).not.toHaveBeenCalled();
expect(auditCreate).not.toHaveBeenCalled();
} finally { await app.close(); }
});
});
describe("contract export range reasons", () => {
it.each(["csv", "xlsx"])("rejects a reversed %s range without reads/audit", async (format) => {
const { app, findMany, count, auditCreate } = await buildApp();
try {
const response = await app.inject({ method: "POST", url: "/api/exports/contracts-registry", payload: { format, expiryDateFrom: "2024-03-01", expiryDateTo: "2024-02-29" } });
expect(response.statusCode).toBe(400);
expect(response.json().error.details).toEqual({ reasonCode: "contract_registry.expiry_date_range_invalid", expiryDateTo: "must_be_after_or_equal_expiryDateFrom" });
for (const fn of [findMany, count, auditCreate]) expect(fn).not.toHaveBeenCalled();
} finally { await app.close(); }
});
it("explains an invalid export format at the outer schema", async () => {
const { app, findMany, count, auditCreate } = await buildApp();
try {
const response = await app.inject({ method: "POST", url: "/api/exports/contracts-registry", payload: { format: "invalid" } });
expect(response.statusCode).toBe(400);
expect(response.json().error.details).toMatchObject({ reasonCode: "contract_registry.query_invalid", fieldErrors: { format: expect.any(Array) } });
for (const fn of [findMany, count, auditCreate]) expect(fn).not.toHaveBeenCalled();
} finally { await app.close(); }
});
});