feat: 新增 plugin/ 插件化形态(funjia.print-tag)+ 可选 SN 条码/二维码

把本工程的标签排版能力改造成 FunjiaUI 远端插件,放进 plugin/ 子目录,
与原独立 Web 版并存(两者功能一致,模板/版面/打印行为逐项对齐)。

- 入口从 createApp().mount() 改为 activate(ctx) + ctx.addRoute,注册 1 菜单 / 1 路由 / 2 命令
- 11 个模板的渲染收敛成 SpecTag,差异集中到 templates/registry.ts(字段/选项/默认值原样保留)
- 店铺名 / 电话从写死改为可配置,记忆在插件私有存储
- 内置二维码图片改为打包 data URL —— 远端插件没有自己的 public/
- 去掉 @headlessui/vue(换原生 select)与 Tailwind,样式类名统一 pt- 前缀避免污染宿主
- 可选接入宿主 api::sn-code:按 SN 生成真 Code 128 条码与可扫二维码;
  关闭时(默认)完全保持原静态二维码行为。领码优先贴到已排版的格子,不够才新建
- 新增 commands: print-tag:issue-sn / print-tag:render-svg(后者纯本地出图,供其它插件复用)
- code128.ts 实现真 Code 128 Set B(含校验位);二维码走 qrcode-generator(真 QR)
- 自带本地预览器(preview/mock-api.ts 补了 /api/sn-codes mock)与 deploy / verify 脚本
- verify.mjs 修掉一处误报:源码边界判据改为「解析后是否逃出工程根」,
  而不是「说明符是否以 .. 开头」(后者会把 src/components/X.vue → ../codes 误判为越界)

已发布到插件仓库:funjia.print-tag@1.0.0
This commit is contained in:
2026-10-03 23:48:32 +08:00
parent 1896d1032b
commit ef41d98838
43 changed files with 8835 additions and 0 deletions
+117
View File
@@ -0,0 +1,117 @@
/**
* 预览器的**接口契约**:客户端(`preview/host.ts`)与服务端(`preview/mock-api.ts`)
* 共用这一份定义。
*
* ## 为什么单独一个文件
*
* 这两边是同一份契约的两个实现方。如果各写各的 `AuthUser`、各写各的
* `parseAuthHeader`、各写各的令牌前缀,那么「客户端以为令牌是 `Bearer x`、
* 服务端以为就是 `x`」这类错误**不会有任何编译错误**,只会表现为
* 「登录成功但所有接口都 401」。
*
* 放一个文件里,改一边就同时改了另一边。
*
* ## 它不管什么
*
* 这里只有**线上跑的东西**(存储键、令牌形状、响应包络、请求头解析)。
* 数据表种子、内存 CRUD 逻辑属于实现,在 `mock-api.ts` 里。
*
* ## 与宿主的关系
*
* 契约本身**以宿主为准**(`src/mock/auth.ts` + `src/core/http/index.ts`):
* 同一个地址、同一个包络、同样的 401 语义。预览器是独立工程、拿不到宿主源码,
* 所以这里是一份**手抄的副本** —— 它必然有漂移的风险,这是一处已知的取舍,
* 由 `npm run verify` 的契约断言兜住最关键的几个字段。
*/
/* ------------------------------------------------------------ 存储键 */
/**
* 令牌存储键。
*
* **刻意与宿主不同名**(宿主是 `funjia-plugin-host:token`)。两者平时确实是
* 不同的 origin(预览 5310 / 宿主 5180),但一旦有人把预览挂到宿主同源的
* 子路径下调试,同名的键就会互相覆盖 —— 表现为「预览里登录把宿主的会话踢了」,
* 而且没人会往 localStorage 的键名上想。
*/
export const TOKEN_KEY = "funjia-plugin-preview:token";
/** 用户信息存储键,理由同上 */
export const USER_KEY = "funjia-plugin-preview:user";
/* ------------------------------------------------------------ 令牌形状 */
/** 令牌前缀。明文自描述,肉眼能看出「这是预览 mock 签的」 */
export const TOKEN_PREFIX = "mock";
/** 令牌有效期,与宿主 mock 一致 */
export const TOKEN_TTL_MS = 2 * 60 * 60 * 1000;
/* -------------------------------------------------------------- 类型 */
/** 登录用户(**不含密码**)。字段与宿主 mock 返回的 `user` 对齐 */
export interface AuthUser {
id: number;
name: string;
account: string;
role: string;
dept?: string;
}
/** 演示账号:登录页直接列出来,省掉「文档里翻账号」这一步 */
export interface DemoAccount {
account: string;
password: string;
role: string;
}
/** 统一响应包络。`code === 0` 表示成功 */
export interface ApiResult<T = any> {
code: number;
msg: string;
data: T;
total?: number;
}
/* ------------------------------------------------------------ 约定值 */
/**
* 未授权的业务码。
*
* 与宿主取同一个数字,且**刻意与 HTTP 状态码同值** —— 于是客户端一句
* `result.code === 401` 就能同时覆盖「内置 mock 返回的 code」与
* 「真后端返回的 HTTP 401」(后者由请求层归一成前者)。见 `host.ts` 的 `httpCall`。
*/
export const UNAUTHORIZED_CODE = 401;
/**
* 登录态广播的**全局事件名**(与宿主 `src/core/session.ts` 完全一致)。
*
* 插件用 `ctx.event.onGlobal("user:login", ...)` 监听的就是这两条。
* 预览器也发同样的名字,插件才能在预览里验到「登出后我被通知了」。
*/
export const AUTH_EVENTS = {
login: "user:login",
logout: "user:logout",
} as const;
/* -------------------------------------------------------- 请求头解析 */
/**
* 从 `Authorization` 头的值里取出裸令牌。
*
* **严格校验 `Bearer ` 前缀**,与真后端(和宿主 mock)同口径。
* 宽松处理会把「客户端忘了加前缀」这个 bug 藏起来 —— 而这个 bug 在
* 预览阶段暴露出来只需要一次请求,拖到接真后端那天就变成了
* 「登录明明成功、接口全 401」。
*
* 只有**服务端**(`mock-api.ts`)用到它;放在这里是因为它描述的是
* 契约的校验规则,写错就两边对不上。
*/
export function parseAuthHeader(raw?: string): { token: string; reason?: string } {
const value = (raw || "").trim();
if (!value) return { token: "", reason: "缺少 Authorization 请求头" };
if (!/^Bearer\s+/i.test(value)) {
return { token: "", reason: "Authorization 头缺少 `Bearer ` 前缀" };
}
const token = value.replace(/^Bearer\s+/i, "").trim();
return token ? { token } : { token: "", reason: "Authorization 头里的令牌为空" };
}