feat: 增强功能批量入库 - 双色彩引擎/抖动/杂色清理/品牌色板/PDF导出/编辑工具/分享/i18n 等验收代码

This commit is contained in:
Sisyphus (主代理) committed 2026-08-14 00:20:40 +08:00
1 parent 02762400fb
commit f846fabfc6
77 files changed
+11372 -226

No files matched your search

+110
View File
@@ -0,0 +1,110 @@
/**
* 图案导出路由(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;
}