CNWei
1effbea3dd
README： - 快速开始补上 stash-ui 必须先构建（file: 依赖），目录结构补 stash-ui 与新的前端目录 - 登录与设置改写为新的后台结构（左侧导航 + 页头/侧边栏/内容卡片子项）、明暗主题与 /interface - 前端路由补 /interface、/admin 与 /c/ 前缀；服务端回落说明改成 SPA_PREFIXES + SPA_PAGES - 表结构：node 增补 allow_groups / enabled，section_block 章节改为 card / card_group， 说明 user_version=22 与自动迁移 - HTTP API：内容目录改为 /api/catalog2，新增「其它接口」汇总表（与 /interface 页一致） - 已知限制：删掉「没有迁移」「没有身份认证」「只有 /c/** 一个前缀」等过时结论 HANDOFF.md 顶部加历史快照说明与变更摘要；ADMIN-PLAN.md 的待办标注已完成项； stash-web/README.md 从 Vite 模板换成真实说明
30 lines
1.5 KiB
Markdown
30 lines
1.5 KiB
Markdown
# stash-web
|
||
|
||
Stash 的前端控制台：React 19 + Vite + TypeScript。组件与样式全部来自
|
||
[`@stash/ui`](../stash-ui)（`file:` 依赖，需要先在同级目录构建出它的 `dist`）。
|
||
|
||
```bash
|
||
npm install
|
||
npm run dev # http://127.0.0.1:5173，/api 代理到后端 8080
|
||
npm run build # 产物到 dist，随后会被 cargo build 内嵌进二进制
|
||
npm run lint # oxlint
|
||
```
|
||
|
||
## 目录
|
||
|
||
| 路径 | 内容 |
|
||
| --- | --- |
|
||
| `src/AppNext.tsx` | 前台外壳：路由、卡片、侧栏、搜索、主题应用 |
|
||
| `src/components/admin/` | 后台（`AdminNext.tsx`：左侧导航 + 分组 / 数据 / 首页 / 资料 / 系统面板） |
|
||
| `src/components/api/` | `/interface` 接口一览页 |
|
||
| `src/components/header/`、`sidebar/` | 页头（品牌、滚动信息、操作图标）与侧栏卡片 |
|
||
| `src/components/content/` | 卡片、网格、详情视图 |
|
||
| `src/data/view.ts`、`src/useViewRoute.ts` | 地址 ↔ 视图的路由规则（与服务端 `SPA_PREFIXES` / `SPA_PAGES` 对应） |
|
||
| `src/theme.ts` | 明暗主题：本机偏好（localStorage）优先于站点默认 |
|
||
|
||
## 约定
|
||
|
||
- 页面里不写死颜色 / 字号 / 间距，一律用 `@stash/ui` 的 `--su-*` 令牌；
|
||
- 站内跳转走 `navigate()`，不要用 `<a href>` 触发整页刷新；需要「新标签打开」时保留 `href` 并放行修饰键点击；
|
||
- 组件库里没有的东西优先补进 `stash-ui`，而不是在这里再手写一遍（后台已经是 100% 由库组件组装）。
|