feat(plugin): 发放 SN 带 source;插件 id 收敛到 src/meta.ts
- 新增 src/meta.ts 作为 PLUGIN_ID 的唯一字面量来源(index.ts 与页面共用)。 这个 id 同时出现在 config、自注册 manifest、菜单/路由/命令 id 前缀、 发放请求的 source 四处,任何一处抄错都是难查的静默故障。 - 发放请求加 source: funjia.print-tag(页面与 print-tag:issue-sn 命令都加)。 后端 callerMeta 明确建议插件填自己的 ID,否则 SN 台账里一律记成 pc, 分不清是插件发的还是别的入口发的。已在预览里验证落到台账。 - preview/mock-api.ts 的 SN 部分改为逐位镜像真后端(库存管理系统 backend/src/api/sn-code/):校验位算法与字符表照抄,SN 形状/正则/补位口径一致。 实测 mock 产出的 SN 全部能通过真后端校验位算法 —— 本地调通的码切到真后端不会失效。 最终验收:typecheck 通过;插件自检 0 error;仓库 verify-repository 32 passed / 0 failed; repo-doctor 0 error 0 warning;源码模式与产物模式预览均跑通且无控制台报错。
This commit is contained in:
+43
-18
@@ -174,12 +174,17 @@ function readBody(req: IncomingMessage): Promise<any> {
|
||||
* ## 与真后端的关系
|
||||
*
|
||||
* 参数口径(`targetType` / `count` / `refId` / `refLabel` / `remark`、返回
|
||||
* `{ items }`、校验返回 `{ valid, reason, exists, record }`)**照着真后端抄**,
|
||||
* 但**数据是进程内的**、格式里的校验位算法也是这里自己定的 ——
|
||||
* 所以:**别看号段,只验链路**。真要对接,关掉开关或设 `PREVIEW_API_TARGET`。
|
||||
* `{ batch, count, items }`、校验返回 `{ valid, reason, exists, record }`)、
|
||||
* 前缀表、SN 形状、**校验位算法与字符表**都是从真后端
|
||||
* `库存管理系统/backend/src/api/sn-code/` 逐项抄过来的 —— 所以这里生成的 SN
|
||||
* 拿去真后端 `/verify` 也能过校验位。
|
||||
*
|
||||
* 唯一不是真的地方是**数据**:台账在进程内存里,重启即清空。
|
||||
* 所以:**别看号段连不连号,只验链路**。真要对接,关掉开关或设
|
||||
* `PREVIEW_API_TARGET` 指向真后端。
|
||||
*/
|
||||
|
||||
/** 业务类型 → 号段前缀。真后端同结构,前缀值以真后端 `/meta` 为准 */
|
||||
/** 业务类型 → 号段前缀。与真后端 `services/sn-code.js` 的 `DEFAULT_PREFIX` 逐项一致 */
|
||||
const SN_PREFIX: Record<string, string> = {
|
||||
DEVICE: "ZP",
|
||||
PART: "PJ",
|
||||
@@ -189,23 +194,37 @@ const SN_PREFIX: Record<string, string> = {
|
||||
OTHER: "SN",
|
||||
};
|
||||
|
||||
/** 校验位:body 各字符按 31 进制滚动求和后取模 36,映射到 0-9A-Z */
|
||||
function snChecksum(body: string): string {
|
||||
let sum = 0;
|
||||
for (let i = 0; i < body.length; i += 1) {
|
||||
sum = (sum * 31 + body.charCodeAt(i)) % 36;
|
||||
/** 校验位字符表:真后端刻意剔除了 0/O、1/I/L 这类肉眼与扫码都易混的字符 */
|
||||
const SN_CHECK_ALPHABET = "ABCDEFGHJKMNPQRSTUVWXYZ23456789";
|
||||
|
||||
/**
|
||||
* 校验位算法 —— **与真后端逐位相同**(`services/sn-code.js` 的 `checksumChar`)。
|
||||
*
|
||||
* 这里刻意照抄而不是"自己定一个":抄一致之后,预览里生成的 SN
|
||||
* 拿去真后端的 `/verify` 也能过校验位,本地调出来的码不会在切到真后端时集体失效。
|
||||
* 数据仍然是进程内的(不查库),但**形状与算法是真的**。
|
||||
*/
|
||||
function snChecksum(payload: string): string {
|
||||
let acc = 0;
|
||||
for (let i = 0; i < payload.length; i += 1) {
|
||||
// 位置加权:避免「字母调序」这类错误也算通过
|
||||
acc = (acc * 31 + payload.charCodeAt(i) * (i + 1)) % 1000003;
|
||||
}
|
||||
return "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ"[sum];
|
||||
return SN_CHECK_ALPHABET[acc % SN_CHECK_ALPHABET.length];
|
||||
}
|
||||
|
||||
/** 与真后端一致的 SN 形状:`PREFIX-YYMMDD-NNNN-C` */
|
||||
function makeSn(targetType: string, seq: number): string {
|
||||
const pad = (n: number) => String(n).padStart(2, "0");
|
||||
const pad = (n: number, w = 2) => String(n).padStart(w, "0");
|
||||
const now = new Date();
|
||||
const prefix = SN_PREFIX[targetType] || "SN";
|
||||
const body = `${prefix}-${String(now.getFullYear()).slice(2)}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${String(seq).padStart(4, "0")}`;
|
||||
return `${body}-${snChecksum(body)}`;
|
||||
const prefix = SN_PREFIX[targetType] || SN_PREFIX.OTHER;
|
||||
const payload = `${prefix}-${String(now.getFullYear()).slice(2)}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(seq, 4)}`;
|
||||
return `${payload}-${snChecksum(payload)}`;
|
||||
}
|
||||
|
||||
/** 与真后端同一套正则以判定格式 */
|
||||
const SN_PATTERN = /^([A-Z0-9]{2,3})-(\d{6})-(\d{1,6})-([A-Z0-9])$/;
|
||||
|
||||
function issueSn(ledger: Row[], body: any, count: number): Row[] {
|
||||
const targetType = String(body?.targetType || "DEVICE");
|
||||
const batch = `B${Date.now().toString(36).toUpperCase()}`;
|
||||
@@ -218,6 +237,9 @@ function issueSn(ledger: Row[], body: any, count: number): Row[] {
|
||||
batch,
|
||||
status: "ISSUED",
|
||||
issuedAt: new Date().toISOString(),
|
||||
// 真后端会记「调用来源」,插件建议填自己的 id(便于台账追溯是谁发的码)——
|
||||
// 这里原样透传,好让预览里也能验到「插件有没有带上 source」
|
||||
source: body?.source ? String(body.source) : null,
|
||||
...(body?.refId ? { refId: body.refId } : {}),
|
||||
...(body?.refLabel ? { refLabel: body.refLabel } : {}),
|
||||
...(body?.remark ? { remark: body.remark } : {}),
|
||||
@@ -261,12 +283,15 @@ function handleSnCode(
|
||||
}
|
||||
|
||||
if (method === "POST" && path === "/api/sn-codes/verify") {
|
||||
const text = String(body?.sn || "").trim();
|
||||
const text = String(body?.sn || "").trim().toUpperCase();
|
||||
if (!text) return ok({ valid: false, reason: "EMPTY" });
|
||||
const matched = text.match(/^([A-Z]{2})-(\d{6})-(\d{4})-([0-9A-Z])$/);
|
||||
const matched = SN_PATTERN.exec(text);
|
||||
if (!matched) return ok({ valid: false, reason: "FORMAT" });
|
||||
if (snChecksum(`${matched[1]}-${matched[2]}-${matched[3]}`) !== matched[4]) {
|
||||
return ok({ valid: false, reason: "CHECKSUM" });
|
||||
const [, prefix, date, seq, check] = matched;
|
||||
// 与真后端一致:序号补齐到 4 位后再算校验位
|
||||
const payload = `${prefix}-${date}-${String(Number(seq)).padStart(4, "0")}`;
|
||||
if (snChecksum(payload) !== check) {
|
||||
return ok({ valid: false, reason: "CHECKSUM", expectedCheck: snChecksum(payload) });
|
||||
}
|
||||
const record = ledger.find((row) => row.sn === text) || null;
|
||||
return ok({ valid: true, exists: !!record, record });
|
||||
|
||||
Reference in New Issue
Block a user