refactor(db): 删除旧分区展示块与兼容字段
- v23 迁移删除 section_block 表，以及 node 的 view_mode / empty_text / show_in_sidebar / allow_groups
- 重建 node 表并保留 44 条内容、15 个分组、5 张卡片，外键检查通过
- 种子库直接生成 card / card_group，不再依赖 section_block
- 删除旧 /api/catalog、/api/categories、/api/groups/{id} 与 categories 模块
- 分组接口不再接收/返回 format，前端 GroupNode 同步移除
- README/HANDOFF 更新到 v23；管理页提示改为『格式由每条内容决定』
This commit is contained in:
+8
-15
@@ -11,7 +11,7 @@
|
||||
> - 新增 `/interface` 接口一览页；侧栏「查看接口」走站内路由，不再直接开 `/api/projects`；
|
||||
> - 接入 `@stash/ui` 组件库：前后台所有卡片、表格、开关、文字按钮都来自库里，
|
||||
> 明暗主题（浅色 / 深色 / 跟随系统）由令牌接管；
|
||||
> - 内容库表结构升到 v22 并**有了自动迁移**，卡片模型是 `card` + `card_group`（`section_block` 仅作旧库迁移来源）。
|
||||
> - 内容库表结构升到 v23 并**有了自动迁移**，卡片模型是 `card` + `card_group`；`section_block` 与旧 `node` 兼容字段已删除。
|
||||
|
||||
## 0. 一句话现状
|
||||
|
||||
@@ -135,11 +135,10 @@ README.md 运行、路由、库结构、登录说明
|
||||
```
|
||||
GET /api/health
|
||||
GET /api/projects GET /api/projects/events (SSE)
|
||||
GET /api/catalog GET /api/catalog/events (SSE) 旧结构（兼容）
|
||||
GET /api/catalog2 分组树 + 卡片（新前台/后台）
|
||||
GET /api/cards 卡片列表
|
||||
POST /api/nodes {key,title,parentKey?,format?} 需登录
|
||||
PATCH /api/nodes/{key} {title,parentKey?,sort?,format?} 需登录
|
||||
POST /api/nodes {key,title,parentKey?,icon?,sort?,enabled?} 需登录
|
||||
PATCH /api/nodes/{key} {title,parentKey?,sort?,icon?,enabled?} 需登录
|
||||
DELETE /api/nodes/{key} 需登录，级联
|
||||
POST /api/cards {title} 需登录
|
||||
PATCH /api/cards/{id} {title?,sort?} 需登录
|
||||
@@ -162,26 +161,20 @@ DELETE /api/items/{key} 需登录
|
||||
POST /api/items/{key}/view
|
||||
POST /api/items/{key}/like {liked}
|
||||
|
||||
POST /api/categories {id,title,kind} 需登录
|
||||
PATCH /api/categories/{id} {title,icon,barColor,kind,previewLimit,emptyText,blockNodeKey,allowGroups} 需登录
|
||||
POST /api/categories/{id}/groups {id,title} 需登录，仅应用分区
|
||||
DELETE /api/categories/{id} 需登录，级联，local 不可删
|
||||
PATCH /api/groups/{id} {title,showInSidebar} 需登录
|
||||
DELETE /api/groups/{id} 需登录，级联组内条目
|
||||
|
||||
GET /api/backup SQLite 快照附件 需登录
|
||||
```
|
||||
|
||||
## 5. 数据库与迁移
|
||||
|
||||
- 文件：开发态在 `target/debug/data/stash.db`；可用 `--root` / 数据目录覆盖（见 `config.rs`）。
|
||||
- 当前 `PRAGMA user_version = 22`；`schema::migrate` 逐级升级：0 建全量、15→16→17→18→19→20→21→22、更高版本拒绝启动。
|
||||
- 格式在 `entry.format`（apps / posters / articles），同组可混合；`node` 的旧 `view_mode` 仅保留兼容，不再决定渲染。
|
||||
- 当前 `PRAGMA user_version = 23`；`schema::migrate` 逐级升级：0 建全量、15→16→17→18→19→20→21→22→23、更高版本拒绝启动。
|
||||
- 格式在 `entry.format`（apps / posters / articles），同组可混合；`node` 不再保存格式。
|
||||
- v23 迁移删除 `section_block` 表与 `node` 的 `view_mode / empty_text / show_in_sidebar / allow_groups` 字段。
|
||||
- `settings.sidebar.show_profile / show_service` 控制侧栏两张卡片显隐（默认 true）。
|
||||
- 首页滚动：`#page-scroll`（Layout 的 body）是唯一滚动容器，搜索框固定在其上方；左右两栏顶部对齐，左侧到底后通过 `translateY` 吸底，右侧继续滚动；滚动条隐藏；页头实底，搜索框 50% 透明，顶部另有一层上下渐隐的软虚化（`blur(8px)`）。
|
||||
- 本地服务是运行时卡片，但 `card` 表里有一行 `local-service` 只用于排序；内容来自 `/api/projects`，后端禁止删除/改名/配置分组。
|
||||
- `node` 是统一分组树（根节点 `kind='section'`，子节点 `kind='group'` 可多层）；`enabled` 控制启停；`icon` 可为空。
|
||||
- 主要表：`node`、`entry`、`entry_tag`、`section_block`、`admin`、`session`、`setting`、`audit`。
|
||||
- 主要表：`node`、`entry`、`entry_tag`、`card`、`card_group`、`admin`、`session`、`setting`、`audit`。
|
||||
- `entry.updated_at` 用于编辑乐观锁；`setting` 表 `key='site'` 存站点 JSON。
|
||||
- **设置/内容都是 SQLite**：备份用 `/api/backup`，恢复需停机替换文件。
|
||||
|
||||
@@ -223,7 +216,7 @@ GET /api/backup SQLite 快照附件 需登录
|
||||
| 分组移动 | 编辑弹窗里可改「上级分组」（防环）；根分组不能移到子级 |
|
||||
| 条目移动 | 内容弹窗里可直接换分组（`PATCH /api/items/{key}` 的 `nodeKey`） |
|
||||
| 分组排序 | 可编辑「排序权重」数值；拖拽排序未做 |
|
||||
| 旧接口 | `/api/catalog`、`/api/categories/*`、`/api/groups/*` 仍保留给旧组件/兼容，后续可删 |
|
||||
| 旧接口 | 已删除 `/api/catalog`、`/api/categories/*`、旧 `/api/groups/{id}`；当前只保留 `/api/catalog2` 与 `/api/nodes` |
|
||||
| 登录限流 | 进程内计数，重启清空 |
|
||||
|
||||
## 10. 约定与坑
|
||||
|
||||
Reference in New Issue
Block a user