29 lines
1.6 KiB
Markdown
29 lines
1.6 KiB
Markdown
# 本次后台表查询接入的可复用经验
|
||
|
||
## 需求落点
|
||
- 后台“总览”页的表统计仍保留，只把每张表的表名改成可点击跳转到 `#tables?table=<name>`。
|
||
- 新增独立 `#tables` 页承载表选择、关键词搜索、JSON filters、limit、行详情弹窗。
|
||
|
||
## 后端实现要点
|
||
- 新增只读接口：
|
||
- `GET /admin/api/database/tables`
|
||
- `GET /admin/api/database/tables/{table_name}/rows`
|
||
- 表名必须来自 schema 白名单；再加一层 identifier 校验，避免任意 SQL 表名注入。
|
||
- `limit` 必须 clamp；本次实现使用默认 100、最大 500。
|
||
- `search` / `filters` 不进入 SQL 字符串：
|
||
- SQL 只负责 `SELECT * FROM {table_name} LIMIT {limit}`
|
||
- 返回后在 api-server 内存中过滤
|
||
- `filters` 仅接受 JSON object，按列名匹配；非 object 直接 400
|
||
- SpacetimeDB HTTP SQL 返回可能是 statement array + rows，解析时要兼容这一层结构。
|
||
|
||
## 前端实现要点
|
||
- `adminRoutes` 必须新增 `tables`，`AdminShell.routeIcons` 也要同步覆盖。
|
||
- `AdminApp` 需要显式渲染 `AdminDatabaseTablesPage`。
|
||
- worktree 下可能没有本地 `node_modules/typescript/bin/tsc`，而根目录有依赖；在验证前可以临时把根目录 `node_modules` 软链到 worktree 再执行 `npm run admin-web:typecheck`，验证后删除软链，避免污染 git 状态。
|
||
|
||
## 验证结果
|
||
- `cargo test -p api-server admin_database -- --nocapture` 通过。
|
||
- `cargo fmt --manifest-path Cargo.toml -p api-server -p shared-contracts --check` 通过。
|
||
- `npm run admin-web:typecheck` 通过。
|
||
- `npm run admin-web:build` 通过。
|
||
- `npm run check:encoding` 通过。 |