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:
@@ -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 头里的令牌为空" };
|
||||
}
|
||||
Reference in New Issue
Block a user