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:
111
README.md
111
README.md
@@ -1,18 +1,105 @@
|
||||
# eip4-web
|
||||
|
||||
EIP4 前端工程(占位,P4 开工时起脚手架)。架构依据:eip4-platform/docs/架构设计.md 选型表
|
||||
「前端 = 独立 React 工程(amis 渲染宿主 + 设计器),Nginx 托管」。
|
||||
EIP4 前端渲染宿主——amis 6.13.0 本地化 SDK 渲染 + 登录/JWT + 待办聚合。
|
||||
架构定位:前端独立 React 工程(amis 渲染宿主 + 设计器),Nginx 托管;
|
||||
转换器产出页面在此渲染,登录/JWT 适配后端 platform-auth,待办聚合对接 platform-flow-gateway。
|
||||
|
||||
## 已定约定(开工前勿改)
|
||||
## 技术栈
|
||||
|
||||
- **amis 锁 6.13.0 本地化部署**,不依赖 CDN —— SDK 产物来源见 C5 构建预演
|
||||
(eip4-platform/docs/C5构建预演报告.md);构建环境 ../amis-fork(node_modules 已清,
|
||||
`npm install --legacy-peer-deps` 约 7 分钟重装,**须按 monorepo 拓扑序逐包构建**)
|
||||
- 渲染宿主参照 PoC:eip4-poc/src/main/resources/static/amis-local.html(本地 SDK 引用方式)
|
||||
- 页面 schema 双闸:官方 schema.json 校验 + 运行时渲染冒烟,缺一不可(迁移手册 §8)
|
||||
- 设计器:amis-editor 二开,排 P4 后半,优先级低于批量转换
|
||||
- 渲染层备选(amis fork 失败时):lowcode-engine / ProComponents,见架构设计第七节
|
||||
| 层 | 选型 | 说明 |
|
||||
|----|------|------|
|
||||
| 框架 | React 18.3 + Vite 5 + TypeScript 5 | 主流稳妥,不引重型框架 |
|
||||
| 路由 | react-router-dom 6 | 登录守卫 + 页面路由 |
|
||||
| HTTP | axios 1.7 | 拦截器注入 Bearer + 401 跳登录 |
|
||||
| 渲染 | amis 6.13.0 **本地 SDK** | `public/sdk-local/`(非 npm 包),`amisRequire('amis/embed')` 模式,**不依赖 CDN** |
|
||||
|
||||
## 规划内容(P4)
|
||||
amis 选型理由(选**本地 SDK** 而非 npm 包):本期约定 amis 锁 6.13.0 本地化部署,
|
||||
SDK 产物来自 C5 构建预演(eip4-poc 的 `sdk-local/`),整套渲染器(图表/富文本/office 预览等)
|
||||
已构建为离线产物。npm 包形态(`amis` + `amis-core` + 按需 thirds)虽利于 tree-shaking,
|
||||
但需自行解决 6.13 本地化(locale)与可选渲染器装配,且与 PoC 已验证的 `amis-local.html`
|
||||
范式不一致。本期复用 PoC 已验证产物,**与转换器/校验闸同源**,风险最低。详见 `docs/P4脚手架报告.md`。
|
||||
|
||||
转换器产出页面的渲染宿主、登录/JWT 适配、待办聚合页、153 视图重写组件的装配点(外包交付物集成)。
|
||||
## 启动
|
||||
|
||||
前置:Node v22+,后端 platform-app(端口 8084),本地 PG(`localhost:5433/eip4m0`,已自举)。
|
||||
|
||||
```bash
|
||||
npm install
|
||||
npm run dev # dev server :5173,/api 反代到后端(默认 8084)
|
||||
```
|
||||
|
||||
浏览器开 http://localhost:5173/login,默认账号 `alice` / `123456`。
|
||||
|
||||
### 后端联调(单独终端)
|
||||
|
||||
```bash
|
||||
cd ../eip4-platform
|
||||
JAVA_HOME=/opt/homebrew/opt/openjdk@17 \
|
||||
mvn spring-boot:run -pl platform-app -Dspring-boot.run.profiles=local
|
||||
# 端口 8084;若被占,加 -Dspring-boot.run.arguments="--server.port=8090"
|
||||
# 并把前端 .env 的 VITE_BACKEND_TARGET 同步改为 http://localhost:8090
|
||||
```
|
||||
|
||||
本地库自举(首次):依次灌入 `../eip4-platform/platform-parity/src/main/resources/bootstrap/`
|
||||
的 `bootstrap-sys.sql` → `bootstrap-privilege.sql` → `bootstrap-auth.sql`,
|
||||
再灌 `platform-flow-gateway/.../bootstrap-datastatus.sql`(详见 P4 报告附录)。
|
||||
|
||||
## 构建
|
||||
|
||||
```bash
|
||||
npm run build # tsc -b && vite build → dist/
|
||||
npm run preview # 本地预览 dist
|
||||
```
|
||||
|
||||
产物 `dist/` 可直接交 Nginx 托管:
|
||||
- `dist/assets/` + `dist/index.html`:应用包(~204 KB,gzip ~71 KB)
|
||||
- `dist/sdk-local/`:amis 6.13.0 本地 SDK(~61 MB,原样拷贝,不参与打包)
|
||||
- `dist/schemas/`:开发期静态 schema(生产期改走后端接口,见下)
|
||||
|
||||
Nginx 关键配置:SPA 路由回退 `try_files $uri /index.html`;`/api` 反代到后端。
|
||||
|
||||
## 配置(.env)
|
||||
|
||||
| 变量 | 默认 | 说明 |
|
||||
|------|------|------|
|
||||
| `VITE_BACKEND_TARGET` | `http://localhost:8084` | dev server 的 `/api` 反代目标;8084 被占改 8090 |
|
||||
| `VITE_SCHEMA_SOURCE` | `mock` | `mock`=读 `public/schemas/`;`backend`=读后端 schema 接口 |
|
||||
|
||||
## 与后端契约清单
|
||||
|
||||
| 用途 | 方法 路径 | 契约来源 | 前端文件 |
|
||||
|------|-----------|----------|----------|
|
||||
| 登录签发 JWT | `POST /api/auth/login` | platform-auth/P2认证实测报告.md | `src/api/auth.ts` |
|
||||
| 实体 amis CRUD 列表 | `GET /api/entity/{t}/list` | EntityController(amis 格式 `{status,msg,data:{items,total}}`) | `src/components/AmisRenderer.tsx`(fetcher) |
|
||||
| 待办聚合 | `GET /api/todo` | platform-flow-gateway/P3网关实测报告.md(503 熔断降级) | `src/api/todo.ts` |
|
||||
| 页面 schema(生产期) | `GET /api/page/schema/{templateId}` | **本期设计契约**(P5 后端落地),开发期用静态 mock 替代 | `src/api/schema.ts` |
|
||||
|
||||
JWT 经 `src/api/http.ts` 拦截器注入 `Authorization: Bearer`;401(非登录端点)自动清会话 + 跳 `/login`。
|
||||
|
||||
## 安全权衡(JWT 存储)
|
||||
|
||||
折中:**内存权威副本 + localStorage 恢复源**(`src/auth/token.ts`)。
|
||||
- 收益:刷新不掉登录态。
|
||||
- 残留风险:XSS 脚本可读 localStorage 中的令牌。
|
||||
- 缓解/演进:生产建议短有效期 + 后端令牌轮转 + CSP 限制脚本来源;
|
||||
长期演进到 httpOnly Cookie + 刷新令牌(需后端下发 Set-Cookie + CSRF 防护)。
|
||||
|
||||
## 已定约定(开工前勿改 / 已遵守)
|
||||
|
||||
- amis 锁 6.13.0 本地化部署,不依赖 CDN(SDK 在 `public/sdk-local/`,来源见 C5 构建预演)✅
|
||||
- 渲染宿主参照 PoC `amis-local.html`(本地 SDK 引用方式)✅
|
||||
- 页面 schema 双闸:官方 schema.json 校验闸 + 运行时渲染冒烟闸(迁移手册 §8)✅
|
||||
- 设计器(amis-editor 二开)排 P4 后半,本期未做(装配点见 P4 报告遗留)✅
|
||||
- 渲染层备选(amis fork 失败时):lowcode-engine / ProComponents(架构设计第七节)✅
|
||||
|
||||
## 目录
|
||||
|
||||
```
|
||||
public/sdk-local/ amis 6.13.0 本地 SDK(从 eip4-poc 拷贝,不依赖 CDN)
|
||||
public/schemas/ 开发期静态 schema(eip4-poc 转换器对客户库真实模板的转换产物)
|
||||
src/api/ http(拦截器)/ auth / todo / schema
|
||||
src/auth/ JWT 存储(内存+localStorage)
|
||||
src/components/ AmisRenderer(本地 SDK 渲染 + fetcher 适配)/ AppLayout / RequireAuth
|
||||
src/pages/ LoginPage / PageRenderPage / TodoPage
|
||||
docs/ 联调验证截图 + P4脚手架报告.md
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user