- 脚手架: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>
75 lines
2.5 KiB
TypeScript
75 lines
2.5 KiB
TypeScript
// ============================================================================
|
|
// JWT 令牌存储 —— 内存 + localStorage 折中方案
|
|
// ----------------------------------------------------------------------------
|
|
// 权衡(XSS vs 刷新留存):
|
|
// - 纯内存:最抗 XSS(脚本注入也读不到跨标签持久令牌),但刷新即丢失,体验差。
|
|
// - 纯 localStorage:刷新留存,但任意 XSS 脚本可读取令牌 → 失窃风险高。
|
|
// - httpOnly Cookie:最抗 XSS(JS 读不到),但需后端配合 Set-Cookie + CSRF 防护,
|
|
// 当前后端契约是「Authorization: Bearer」头(P2 报告),不下发 Cookie,故本期不用。
|
|
// 本期折中:运行内存为权威副本(请求注入用内存),localStorage 仅作刷新后的恢复源。
|
|
// - 收益:刷新不掉登录态。
|
|
// - 残留风险:XSS 仍可读 localStorage —— 缓解项见 README「安全权衡」:
|
|
// 生产建议短有效期 + 后端轮转 + CSP 限制脚本来源;长期演进到 httpOnly Cookie + 刷新令牌。
|
|
// ============================================================================
|
|
|
|
const STORAGE_KEY = 'eip4_token';
|
|
const PROFILE_KEY = 'eip4_profile';
|
|
|
|
export interface UserProfile {
|
|
userId: string;
|
|
account: string;
|
|
name: string;
|
|
roles: string[];
|
|
}
|
|
|
|
// 内存权威副本(请求注入读这里,避免每次同步访问 localStorage)
|
|
let memoryToken: string | null = null;
|
|
let memoryProfile: UserProfile | null = null;
|
|
|
|
export function setSession(token: string, profile: UserProfile): void {
|
|
memoryToken = token;
|
|
memoryProfile = profile;
|
|
try {
|
|
localStorage.setItem(STORAGE_KEY, token);
|
|
localStorage.setItem(PROFILE_KEY, JSON.stringify(profile));
|
|
} catch {
|
|
// localStorage 不可用(隐私模式等)时退化为纯内存,登录态随刷新丢失,不阻断功能。
|
|
}
|
|
}
|
|
|
|
export function getToken(): string | null {
|
|
if (memoryToken) return memoryToken;
|
|
try {
|
|
memoryToken = localStorage.getItem(STORAGE_KEY);
|
|
} catch {
|
|
memoryToken = null;
|
|
}
|
|
return memoryToken;
|
|
}
|
|
|
|
export function getProfile(): UserProfile | null {
|
|
if (memoryProfile) return memoryProfile;
|
|
try {
|
|
const raw = localStorage.getItem(PROFILE_KEY);
|
|
memoryProfile = raw ? (JSON.parse(raw) as UserProfile) : null;
|
|
} catch {
|
|
memoryProfile = null;
|
|
}
|
|
return memoryProfile;
|
|
}
|
|
|
|
export function clearSession(): void {
|
|
memoryToken = null;
|
|
memoryProfile = null;
|
|
try {
|
|
localStorage.removeItem(STORAGE_KEY);
|
|
localStorage.removeItem(PROFILE_KEY);
|
|
} catch {
|
|
// 忽略
|
|
}
|
|
}
|
|
|
|
export function isAuthenticated(): boolean {
|
|
return !!getToken();
|
|
}
|