forked from EduCraft/curriculum-project-hub
白
6990082247
三处引用旧工程名/旧资源路径的地方一并更新,它们必须同时改 —— 少改一处 就是静默故障,而不是构建期报错: 1. 部署脚本(deploy_platform.sh / deploy_fleet_release.sh):npm ci 的 prefix、rsync 排除项、构建产物存在性检查从 database-admin 换成 filelib-web。最后一项是真门禁:static.ts 缺产物时只 warn 不注册路由, 漏改会让 /app 与 /database 静默 404 —— 恰是 database-admin 长期处于 禁用状态的原因。 2. silo 限流豁免:资源路径随 appDir 改名而变(/database/_app/* 已不存在, 现为 /_filelib/*);/app/* 此前不在豁免列表,它现在也是 SPA 外壳, 客户端路由无法预先枚举。 注:/database/* 是整体豁免,filelib 的 JSON API 也绕过限流预算。这是 迁移前就有的行为,原样保留,但覆盖面因多了 /app/* 而变宽。 3. 回归测试:把 registerStaticSpa 与 registerDatabaseSpa 挂到同一个 Fastify 实例,断言 ready() 不因重复路由抛错 —— appDir 若用回默认的 _app,这里会红(ADR-0029 的承重约束)。另断言 /app 与 /database/dashboard/users 返回同一份字节(SPA 回退不读请求)、body 含 /_filelib/。构建产物缺失时不 skip 而是直接失败:那说明该先跑 filelib-web 的 build,不是测试不适用。
44 lines
2.0 KiB
TypeScript
44 lines
2.0 KiB
TypeScript
/**
|
|
* 两套 SPA 静态托管共存于同一个 Fastify 实例。
|
|
*
|
|
* 这是 ADR-0029 的承重约束的回归测试:filelib-web 的 appDir 若用 SvelteKit 默认的
|
|
* `_app`,就会与 admin-web 在根上注册的 `/_app/*` 撞成重复路由,Fastify 启动即抛错。
|
|
* 改名为 `_filelib` 后两者共存 —— 这里把两个注册函数挂到同一实例上验证。
|
|
*/
|
|
import Fastify from "fastify";
|
|
import { describe, expect, it } from "vitest";
|
|
import { registerStaticSpa } from "../../src/admin/static.js";
|
|
import { registerDatabaseSpa } from "../../src/database/static.js";
|
|
|
|
describe("SPA static route registration", () => {
|
|
it("admin-web and filelib-web shells coexist without duplicate routes", async () => {
|
|
const app = Fastify({ logger: false });
|
|
await registerStaticSpa(app);
|
|
await registerDatabaseSpa(app);
|
|
await expect(app.ready()).resolves.toBeDefined();
|
|
await app.close();
|
|
});
|
|
|
|
it("serves the same index.html at /app and /database, and assets under /_filelib", async () => {
|
|
const app = Fastify({ logger: false });
|
|
await registerDatabaseSpa(app);
|
|
await app.ready();
|
|
|
|
const appShell = await app.inject({ method: "GET", url: "/app" });
|
|
const dbShell = await app.inject({ method: "GET", url: "/database/dashboard/users" });
|
|
|
|
// 前置:构建产物必须存在。缺失时 registerDatabaseSpa 只 warn 不注册路由,
|
|
// 断言会全部落到 404 —— 那说明该先跑 `npm run build --prefix filelib-web`,
|
|
// 不是测试不适用,所以这里不跳过而是直接失败。
|
|
expect(appShell.statusCode).toBe(200);
|
|
expect(dbShell.statusCode).toBe(200);
|
|
// 同一份字节:SPA 回退不读请求(ADR-0029)。
|
|
expect(dbShell.body).toBe(appShell.body);
|
|
expect(appShell.headers["content-type"]).toContain("text/html");
|
|
// 资源用绝对路径引用(paths.relative=false),否则深层 URL 下会解析错。
|
|
expect(appShell.body).toContain("/_filelib/");
|
|
|
|
await app.close();
|
|
});
|
|
});
|