feat: P4-3 eip4-web 前端渲染宿主脚手架(amis 6.13.0 本地化/登录JWT/待办/双闸渲染闸)

- 脚手架:React 18 + Vite 5 + TS;amis 6.13.0 本地 SDK(public/sdk-local,不依赖 CDN,
  照 PoC amis-local.html 范式 amisRequire('amis/embed'))
- 登录页:POST /api/auth/login + JWT 存储(内存+localStorage 折中,XSS 权衡见 README/token.ts)
- 页面渲染 /page/:templateId:取转换后 schema 渲染;开发期静态 mock(public/schemas/ 放
  角色维护/通知管理归档/用户组管理 3 个真实转换产物,均过官方 schema.json 校验闸);
  生产期 schema 接口契约已设计(VITE_SCHEMA_SOURCE 切换)
- 待办页 /todo:GET /api/todo + 503 熔断降级展示
- amis fetcher 适配:复用宿主 axios 注入 Bearer,对接 /api/entity amis CRUD 格式
- axios 拦截器:Bearer 注入 + 401 清会话跳登录
- 联调验证(playwright 无头):登录跳转→渲染用户组(本地库 3 行)→角色维护(真实产物)→
  待办 503 降级→401 跳登录(prod 严格链 8090),5 张截图留 docs/
- 工程化:npm run build → dist/(应用 208KB/gzip 71KB + 本地 SDK 61MB,Nginx 可托管);
  README/报告/gitignore

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-11 16:13:17 +08:00
parent c51f37e228
commit b3486c093e
140 changed files with 88352 additions and 12 deletions

56
src/api/schema.ts Normal file
View File

@@ -0,0 +1,56 @@
// ============================================================================
// 页面 schema 获取 —— 双源(开发期静态 mock / 生产期后端接口)
// ----------------------------------------------------------------------------
// templateId → schema 映射:
// - 开发期(VITE_SCHEMA_SOURCE 缺省或 'mock'):读 public/schemas/<id>.json
// (内容是 eip4-poc 转换器对客户库真实模板的转换产物,已过官方 schema.json 校验闸)。
// - 生产期(VITE_SCHEMA_SOURCE='backend'):读后端 schema 接口(契约见下)。
//
// 生产期后端 schema 接口契约(本期为设计,后端 P5 落地):
// GET /api/page/schema/{templateId}
// 响应:200 直接返回 amis 页面 schema(JSON,顶层 type:'page'),
// 由后端在「校验闸」通过后下发(官方 schema.json 校验,见迁移手册 §8 双闸)。
// 404:模板不存在;503:转换器不可用。
// 鉴权:带 Bearer(由 http 拦截器注入)。
// ============================================================================
import { http } from './http';
const SOURCE = (import.meta.env.VITE_SCHEMA_SOURCE as string) || 'mock';
// 开发期 mock:templateId → public/schemas 文件名
const MOCK_MAP: Record<string, string> = {
'role-maintain': '/schemas/role-maintain.json',
'notice-archive': '/schemas/notice-archive.json',
'usergroup-manage': '/schemas/usergroup-manage.json',
};
export interface PageMeta {
id: string;
title: string;
}
// 开发期可选页面清单(供页面入口展示导航)
export const MOCK_PAGES: PageMeta[] = [
{ id: 'usergroup-manage', title: '用户组管理(本地实体联调)' },
{ id: 'role-maintain', title: '角色维护(真实转换产物)' },
{ id: 'notice-archive', title: '通知管理归档(真实转换产物)' },
];
export async function fetchSchema(templateId: string): Promise<Record<string, unknown>> {
if (SOURCE === 'backend') {
const { data } = await http.get<Record<string, unknown>>(
`/api/page/schema/${encodeURIComponent(templateId)}`,
);
return data;
}
// 开发期静态 mock
const path = MOCK_MAP[templateId];
if (!path) {
throw new Error(`未知模板:${templateId}(开发期 mock 未配置)`);
}
const resp = await fetch(path);
if (!resp.ok) {
throw new Error(`加载 schema 失败:${resp.status}`);
}
return (await resp.json()) as Record<string, unknown>;
}