Files
perler-lab/perler-lab-server/src/export/routes.ts
T

111 lines
4.3 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* 图案导出路由(T-076 + T-077):PDF 图纸生成 + 珠子用量统计。
* 纯计算模块,不依赖数据库。
*
* POST /api/export/pdf { title?, gridSize, grid, palette } → application/pdf(附件下载)
* POST /api/export/stats { palette, totalBeads } → 200 { stats }
*/
import { Router } from "express";
import type { Request, Response } from "express";
import { computeUsageStats } from "./usage-stats.js";
import { generatePatternPdf } from "./pdf.js";
const MAX_GRID_SIZE = 512;
/**
* 校验并标准化色板为 { code, hex, count } 列表;
* 任一元素缺 code/hex(非字符串)视为整体非法,count 缺失时按 0 处理。
*/
function parsePalette(raw: unknown): { code: string; hex: string; count: number }[] | null {
if (!Array.isArray(raw)) return null;
const out: { code: string; hex: string; count: number }[] = [];
for (const item of raw) {
if (typeof item !== "object" || item === null) return null;
const rec = item as Record<string, unknown>;
if (typeof rec.code !== "string" || typeof rec.hex !== "string") return null;
const count =
typeof rec.count === "number" && Number.isFinite(rec.count)
? Math.max(0, Math.floor(rec.count))
: 0;
out.push({ code: rec.code, hex: rec.hex, count });
}
return out;
}
/** 创建图案导出路由(无状态,无需注入数据库) */
export function createExportRouter(): Router {
const router = Router();
/**
* POST /api/export/pdf
* 请求: { title?, gridSize, grid: { color }[], palette: { code, hex, count }[] }
* 响应: 200 application/pdf(Content-Disposition: attachment)
* 400 中文参数提示 / 500 服务器内部错误
*/
router.post("/pdf", (req: Request, res: Response): void => {
try {
const body = (req.body ?? {}) as Record<string, unknown>;
const title = typeof body.title === "string" ? body.title : "";
const gridSize = Number(body.gridSize);
if (!Number.isInteger(gridSize) || gridSize < 1 || gridSize > MAX_GRID_SIZE) {
res.status(400).json({ error: "网格尺寸无效" });
return;
}
const grid = body.grid;
if (!Array.isArray(grid) || grid.length !== gridSize * gridSize) {
res.status(400).json({ error: "网格数据与尺寸不匹配" });
return;
}
const cells: { color: string }[] = grid.map((item) => {
if (typeof item !== "object" || item === null) return { color: "" };
const rec = item as Record<string, unknown>;
return { color: typeof rec.color === "string" ? rec.color : "" };
});
const palette = parsePalette(body.palette);
if (palette === null) {
res.status(400).json({ error: "色板数据无效" });
return;
}
// 珠子总数 = 网格中实际填色的格子数
const totalBeads = cells.filter((c) => c.color.trim() !== "").length;
const stats = computeUsageStats(palette, totalBeads);
const pdf = generatePatternPdf({ title, gridSize, grid: cells, stats });
res
.status(200)
.setHeader("Content-Type", "application/pdf")
.setHeader("Content-Disposition", 'attachment; filename="perler-pattern.pdf"')
.send(pdf);
} catch (err) {
console.error("POST /api/export/pdf error:", err);
res.status(500).json({ error: "服务器内部错误,请稍后重试" });
}
});
/**
* POST /api/export/stats
* 请求: { palette: { code, hex, count }[], totalBeads: number }
* 响应: 200 { stats } / 400 中文参数提示 / 500 服务器内部错误
*/
router.post("/stats", (req: Request, res: Response): void => {
try {
const body = (req.body ?? {}) as Record<string, unknown>;
const palette = parsePalette(body.palette);
if (palette === null) {
res.status(400).json({ error: "色板数据无效" });
return;
}
const totalBeads = Number(body.totalBeads);
if (!Number.isInteger(totalBeads) || totalBeads < 0) {
res.status(400).json({ error: "珠子总数无效" });
return;
}
res.status(200).json({ stats: computeUsageStats(palette, totalBeads) });
} catch (err) {
console.error("POST /api/export/stats error:", err);
res.status(500).json({ error: "服务器内部错误,请稍后重试" });
}
});
return router;
}