docs: 同步分组按类型收口
This commit is contained in:
+4
-4
@@ -99,9 +99,9 @@ README.md 运行、路由、库结构、登录说明
|
||||
| --- | --- |
|
||||
| 页头滚动信息 | 启用开关、速度 8–120、条目增删/排序、标签与色调、占位符 `{count}` `{project}` `{status}` |
|
||||
| 首页卡片 | 显示/隐藏、标题覆盖、预览条数、顺序、**新增分类**、**删除分类**(不可删的显示灰色按钮) |
|
||||
| 内容 | 弹窗新增应用/海报/图文条目(选分区 + 分组,分组可选「直属分区」);列表逐条编辑(含换分区/分组)与删除 |
|
||||
| 分区 | 分区类型(应用/海报/图文)、标题、图标、色条、预览条数;首页卡片预览哪个分组;**任意类型的分组都可新建/改名/显隐/删除** |
|
||||
| 侧栏导航 | 分类显示/隐藏、顺序、删除/新增;**任意类型**的子分组单独显隐与排序,并可直接新建子分组 |
|
||||
| 内容 | 弹窗新增应用/海报/图文条目(选分区;应用类可选分组或「直属分区」);列表逐条编辑(含换分区/分组)与删除 |
|
||||
| 分区 | 分区类型(应用/海报/图文)、标题、图标、色条、预览条数;**应用类**可管理分组与首页卡片预览分组,海报/图文保持平铺 |
|
||||
| 侧栏导航 | 分类显示/隐藏、顺序、删除/新增;**应用类**的子分组单独显隐与排序,并可直接新建;空分组不在侧栏出现 |
|
||||
| 资料 | 头像 URL、名称、角色、简介、位置(应用到侧栏资料卡) |
|
||||
| 系统 | 修改密码(清空所有会话)、下载备份(VACUUM INTO 快照) |
|
||||
|
||||
@@ -197,7 +197,7 @@ GET /api/backup SQLite 快照附件 需登录
|
||||
| 多用户/角色 | 未做,当前单管理员 |
|
||||
| 分区编辑 UI | 已支持标题/图标/色条/类型/预览条数(`PATCH /api/categories/{id}`);改类型会自动迁移条目 |
|
||||
| 条目移动 | 编辑弹窗里可直接换分区 / 分组(`PATCH /api/items/{key}` 的 `nodeKey`) |
|
||||
| 分组管理 | 所有类型的分区都可建组/改名/显隐/删除(删除级联组内条目);分组拖拽排序未做 |
|
||||
| 分组管理 | 只有**应用类**分区可建组/改名/显隐/删除(删除级联组内条目);海报/图文平铺;分组拖拽排序未做 |
|
||||
| 登录限流 | 进程内计数,重启清空 |
|
||||
|
||||
## 10. 约定与坑
|
||||
|
||||
@@ -34,7 +34,7 @@ cargo run -- --root ./sites --host 0.0.0.0 --port 3000
|
||||
### 登录与设置(v0.1.1 起)
|
||||
|
||||
- 登录是**页内弹窗**:点右上角用户图标;首次使用弹窗里是「设置密码 + 确认」(至少 8 位);
|
||||
- 登录后点「站点设置」进入 `/admin`,可编辑页头滚动信息、首页卡片、内容(弹窗新增/编辑应用、海报、图文并选择分区/分组)、分区与分组(类型、标题、图标、色条、卡片预览分组;三种类型都支持分组,分组可增删改)以及侧栏顺序、显隐;
|
||||
- 登录后点「站点设置」进入 `/admin`,可编辑页头滚动信息、首页卡片、内容(弹窗新增/编辑应用、海报、图文并选择分区/分组)、分区与分组(类型、标题、图标、色条、卡片预览分组;应用类支持分组,海报/图文平铺)以及侧栏顺序、显隐;
|
||||
- 详情页的 `[编辑]` 只在登录后显示;保存后局部刷新,`updated_at` 乐观锁;
|
||||
- `/admin` 的「系统」页可以改密码、下载整库备份(`VACUUM INTO` 快照);
|
||||
- 密码用 argon2id 哈希存在 `data/stash.db` 的 `admin` 表,会话是 HttpOnly + SameSite=Strict 的 Cookie(7 天);
|
||||
|
||||
@@ -147,6 +147,13 @@ DELETE /api/items/:id
|
||||
|
||||
## 11. 实施记录
|
||||
|
||||
### P8(2026-10-30,按类型收口)
|
||||
|
||||
- **分组能力按类型区分**:只有应用类分区允许分组;海报 / 图文保持平铺(后台不再显示分组与卡片预览分组,接口也拒绝建组);
|
||||
- **平铺兼容**:海报 / 图文读取时会把(历史)分组内的条目一并平铺,切换类型不丢内容;应用类切回时仍按分组渲染;
|
||||
- **侧栏**:非应用类不出现子项;应用类里的空分组也不在侧栏显示(详情页早已隐藏空分组);
|
||||
- 验证:类型 应用 ↔ 海报 切换时,分组管理入口与侧栏子项随类型出现/消失,`cargo test` 59 passed。
|
||||
|
||||
### P7(2026-10-30,统一内容模型)
|
||||
|
||||
- **模型统一**:分区(section)是容器,分组(group)是任意类型的可选子容器,条目可挂在分区或分组上;`view_mode` 只决定渲染方式;
|
||||
|
||||
Reference in New Issue
Block a user