feat: 前端逐字复制(仅代理端口改 30010)+ run.sh + check-module.sh + 文档

前端:从 ssw-jnpf-lite-react/src/frontend 逐字复制(package-lock.json 一并复制),
唯一改动 = vite.config.ts 的代理目标 30000 → 30010(含紧邻注释行的端口);
src/api/request.ts 的注释与 axios timeout: 30000 逐字节保留。

脚本:run.sh(install/build/dev/backend/frontend/stop/logs,退出码 0/1/2,
kill_ports 只清 30010 与 5173);scripts/check-module.sh(9 接触点静态自检,
纯静态零 node 依赖)。

文档:README.md、docs/runbook.md、.env.example;CLAUDE.md 逐条核对并与代码同步,
HANDOFF.md §0 状态表与 §9 交接话术改为交付态。

Co-Authored-By: Claude Code <[email protected]>
This commit is contained in:
adminandClaude Code committed 2026-10-26 03:26:22 +08:00
1 parent 8366a3745f
commit 8edcd3507d
31 files changed
+4536 -33

No files matched your search

+23
View File
@@ -0,0 +1,23 @@
# tds-lite-rs 环境变量样例
#
# 用法:cp .env.example .env 后按需修改;run.sh 会把 .env 里的变量导出给子进程。
# 🔴 本文件里的每一项都必须是「**生效的**」值 —— 注释掉才是「不生效」。
# 后端监听端口(缺省 30010)。
# 🔴 不许改成 30010 以外的端口:兄弟项目 tdc-rs 已经占了它自己的后端端口,
# 两套服务必须彻底分开(不共享端口 / 数据目录 / 代码)。
PORT=30010
# pglite 数据目录。
#
# 🔴 **留空** ⇒ 用后端的默认值 `<项目根>/src/backend/data/lite.pg`
# (**绝对路径**,由可执行文件向上定位项目根 ⇒ 与 cwd 无关)。
#
# 🔴 **不要**在这里写一个**相对**的 PGLITE_DIR:config.rs 对 PGLITE_DIR 是**原样使用**
# (相对路径 ⇒ 相对**当前工作目录**解析)⇒ 换个 cwd 就换一份库,而且**静默**。
# 真要覆盖,只能写**绝对路径**,例如:
# PGLITE_DIR=/Users/xxx/tds-lite-rs/src/backend/data/lite.pg
#
# 临时库(进程退出即销毁)—— pglite-rs 0.2.7 没有真内存模式,
# `memory://` 走的是 `PGlite::open_temp()`(系统临时目录里的一次性数据目录)。
# PGLITE_DIR=memory://
+1
View File
@@ -17,6 +17,7 @@ src/frontend/.vite/
# 运行期 PID / 日志
.run/
.logs/
*.log
# macOS
+47 -20
View File
@@ -37,7 +37,7 @@ v1 = **全量契约对齐**:登录 / `CurrentUser` / 5 组 `base_*` 管理 CRU
|---|---|---|
| 后端 | Rust 2021 + axum 0.8 + tokio | 单二进制 |
| 数据库 | **`pglite-rs` 0.2**(进程内原生 PostgreSQL) | 零服务/零 Docker/零 WASM;数据落盘 `src/backend/data/lite.pg` |
| 前端 | **react 技能的前端产物,逐字复用**(React + Vite) | **零改前端**;vite 代理 `/api` → 后端 |
| 前端 | **react 技能的前端产物,逐字复用**(React + Vite) | **唯一改动 = vite 代理端口 `30000 → 30010`**;vite 代理 `/api` → 后端 |
| 密码学 | `aes` 0.8 + `ecb` 0.1 + `md-5` 0.10 | 与 react 技能 `cipher.ts` **逐字节等价** |
| 其它 | `serde` / `serde_json` / `serde_urlencoded` 0.7 / `uuid` v4 / `rand` 0.8 | |
@@ -45,12 +45,19 @@ v1 = **全量契约对齐**:登录 / `CurrentUser` / 5 组 `base_*` 管理 CRU
> 它把 postgres-pglite 编译成原生静态库链进二进制 ⇒ **真实 PostgreSQL 语义**(类型/MVCC/事务/扩展/线协议),
> 进程内单 backend。**不是** `@electric-sql/pglite`(那是 WASM + IndexedDB,本仓禁止引入)。
## 目录速览(目标形态)
## 目录速览(当前形态)
```
tds-lite-rs/
├── Cargo.toml # 【workspace 根】members = ["src/backend"];release profile 写在这里
├── CLAUDE.md / HANDOFF.md # 本文件 / 交接文档
├── README.md # 项目定位 / 启动方式 / 验收门
├── run.sh # install / build / dev / backend / frontend / stop / logs
├── .env.example # PORT / PGLITE_DIR(后者只能写绝对路径或 memory://)
├── docs/
│ ├── contract.md # 【契约唯一真源】端点 / 返回形状 / 数据模型
│ ├── runbook.md # 怎么起 / 怎么冒烟 / 常见故障
│ └── ddl/ # 官方 DDL 摘录
├── src/
│ ├── backend/ # Rust 后端(workspace 唯一成员,crate 名 tds-lite-rs)
│ │ ├── Cargo.toml
@@ -71,12 +78,11 @@ tds-lite-rs/
│ │ │ └── routes.rs # 路由装配
│ │ ├── db/schema.sql # 完整 DDL(base_* 7 张 + 3 业务表)
│ │ └── data/ # 运行期数据(gitignore)
│ └── frontend/ # react 技能前端逐字复制(不改)
│ └── frontend/ # react 技能前端逐字复制(**只改** vite.config.ts 的代理端口 30000→30010)
├── scripts/
│ ├── perm-smoke.sh # 权限闭环冒烟(22+ 断言)
│ └── check-module.sh # 业务模块 9 接触点静态自检
├── run.sh # install / build / dev / stop / logs
└── .env.example
│ ├── perm-smoke.sh # 权限闭环冒烟(32 条断言,零 node 依赖)
│ └── check-module.sh # 业务模块 9 接触点静态自检(纯静态,不起后端)
└── .gitignore
```
## 架构红线
@@ -184,8 +190,12 @@ tds-lite-rs/
## 端点全表
🔴 `src/backend/src/routes.rs` 里**逐条注册 27 条**路径(axum 0.8.9 用 matchit 0.8.4,
**不支持** `{a,b}` 这种「一段里多个参数」的写法 ⇒ 必须逐条注册)。
| 方法 | 路径 | 守卫 | 说明 |
|---|---|---|---|
| GET | `/api/health` | 无 | **非契约**探活 ⇒ `{ok, tables, version}`;永远有响应(查不到表也返 200) |
| POST | `/api/oauth/Login` | 无 | form-urlencoded:`account` / `password`(密文 hex) / `grant_type=password`;成功返回 `{token, expiresIn:7200, tokenTypeName:'bearer'}` |
| GET | `/api/oauth/CurrentUser` | 登录 | `{userInfo:{userId,userAccount,userName,isAdministrator}, menuList}`;未登录 `code=600` |
| GET/POST/DELETE | `/api/ssw/sys/User/{List,Save,Delete?id=}` | 登录 + 菜单 `system/User` | 列表**去掉 `password`**,附 `roleIds`/`roleNames` |
@@ -200,6 +210,7 @@ tds-lite-rs/
| GET/POST/DELETE | `/api/ssw/books/Book/{List,Save,Delete?id=}` | 登录 + 菜单 `books/Book` | |
其它:未知路由 → **HTTP 404** + `{code:404,msg:'接口不存在',data:null}`。
(`routes.rs` 的「路由表钉子测试」用「错方法 ⇒ 405」逐条证明这 27 条都注册了。)
## 命令速查
@@ -209,13 +220,29 @@ cargo build # debug
cargo build --release # 发布版(release profile 写在根 Cargo.toml)
cargo test # 单测
# 工程脚本(仓库根 run.sh;退出码 0 成功 / 1 运行期失败 / 2 用法错)
bash run.sh install # cargo fetch + npm --prefix src/frontend install
bash run.sh build # cargo build --release + vite build
bash run.sh dev # 后台起后端(30010) + 前端(5173),日志 .logs/、PID .run/
bash run.sh backend # 前台起后端
bash run.sh frontend # 前台起前端
bash run.sh stop # 停后台进程(幂等)
bash run.sh logs # tail .logs/{backend,frontend}.log
bash run.sh # 无参 ⇒ 用法错 ⇒ 退出码 2
# 运行(后端)
PORT=30010 ./target/release/tds-lite-rs
PGLITE_DIR=memory:// PORT=30010 ./target/release/tds-lite-rs # 纯内存
PGLITE_DIR=memory:// PORT=30010 ./target/release/tds-lite-rs # 临时库(系统临时目录的一次性数据目录,进程退出即销毁;pglite-rs 0.2.7 没有真内存模式)
# 冒烟
bash scripts/perm-smoke.sh # 默认打 127.0.0.1:30010
# 前端
npm --prefix src/frontend install # 或 npm ci(严格按 package-lock.json 装)
npm --prefix src/frontend run build # 产出 src/frontend/dist
npm --prefix src/frontend run dev # http://127.0.0.1:5173(vite 代理 /api → 30010)
# 冒烟 / 自检
bash scripts/perm-smoke.sh # 默认打 127.0.0.1:30010(32 条断言)
B=http://127.0.0.1:30010 bash scripts/perm-smoke.sh
bash scripts/check-module.sh # 9 接触点静态自检(纯静态,不起后端)
./target/release/tds-lite-rs --enc 123456 # cipher 自证(免 node 依赖)
```
@@ -227,16 +254,16 @@ B=http://127.0.0.1:30010 bash scripts/perm-smoke.sh
| 症状 | 根因 | 处理 |
|---|---|---|
| 登录必失败(400 账号或密码错误) | cipher key 当成了 16 字节原始摘要 ⇒ AES-128 | key = md5_hex 的 **32 个 ASCII 字节** ⇒ AES-256 |
| `f_price` 回显 `9.9` 而不是 `"9.90"` | `row_to_json` 把 numeric 给了数字 | 投影里 `f_price::text AS price` |
| 角色授权写了不生效 | 写进 `base_role_relation.f_user_id`(**不存在此列**) | 用户 id 写 `f_object_id` + `f_object_type='user'` |
| 组织/岗位授权不生效 | 写进 `base_role_relation` | 写 `base_user_relation`(有 `f_user_id`) |
| 授权接口返 200 但一行没写 | `objectType` 传了 `'Role'`(大写) | 必须小写 `'role'`;`module` 传一维数组 |
| 非管理员拿到了全部菜单 | 只查了角色授权 | 四源合并(直授+角色+组织+岗位) |
| 菜单授权没生效但接口放行 | 菜单 `f_url_address` ≠ 前端 Route path | 三处(urlAddress / Route path / 守卫 key)必须一字不差 |
| `Option<Form<T>>` 编译不过 | axum 0.8.9 的 `Form` 无 `OptionalFromRequest` | 取原始 body 自己 `serde_urlencoded` 解析 |
| 405 返回 HTML / 丢 `Allow` 头 | 用了 axum 的 `method_not_allowed_fallback` | 用响应改写中间件(链尾) |
| DDL 能从 HTTP 下载 | DDL 落在 web root | 移到 `db/` + 兜底守卫 |
| 登录必失败(400 账号或密码错误) | cipher key 当成了 16 字节原始摘要 ⇒ AES-128 | key = md5_hex 的 **32 个 ASCII 字节** ⇒ AES-256 ✅**本仓已修**(`cipher.rs` 按此实现,上游检验向量单测钉死) |
| `f_price` 回显 `9.9` 而不是 `"9.90"` | `row_to_json` 把 numeric 给了数字 | 投影里 `f_price::text AS price` ✅**本仓已修**(冒烟断言比的是**原始 JSON 文本**,字符串与数字能分出来) |
| 角色授权写了不生效 | 写进 `base_role_relation.f_user_id`(**不存在此列**) | 用户 id 写 `f_object_id` + `f_object_type='user'` ✅**本仓已修** |
| 组织/岗位授权不生效 | 写进 `base_role_relation` | 写 `base_user_relation`(有 `f_user_id`) ✅**本仓已修** |
| 授权接口返 200 但一行没写 | `objectType` 传了 `'Role'`(大写) | 必须小写 `'role'`;`module` 传一维数组 ✅**本仓已修**(冒烟断言覆盖一维/二维两种写法) |
| 非管理员拿到了全部菜单 | 只查了角色授权 | 四源合并(直授+角色+组织+岗位) ✅**本仓已修**(冒烟断言「菜单已按授权收窄」+「访问 User/List ⇒ 403」) |
| 菜单授权没生效但接口放行 | 菜单 `f_url_address` ≠ 前端 Route path | 三处(urlAddress / Route path / 守卫 key)必须一字不差 ✅**本仓已修**(`scripts/check-module.sh` 的第 9 条接触点逐模块钉住) |
| `Option<Form<T>>` 编译不过 | axum 0.8.9 的 `Form` 无 `OptionalFromRequest` | 取原始 body 自己 `serde_urlencoded` 解析 ✅**本仓已修**(登录端点即此写法) |
| 405 返回 HTML / 丢 `Allow` 头 | 用了 axum 的 `method_not_allowed_fallback` | 用响应改写中间件(链尾) ✅**本仓已修**(`routes.rs` 测试断言 405 + 保留 `Allow` 头) |
| DDL 能从 HTTP 下载 | DDL 落在 web root | 移到 `db/` + 兜底守卫 ✅**本仓已修**(测试断言两条 DDL 路径都返 404) |
| 第二个实例起不来 | pglite 单实例独占数据目录 | 换数据目录/端口 |
| 集成测试互相撞车 | pglite 独占 + 种子账号唯一 | 串行跑 或 各用独立数据目录 |
| 账号能建重复 | 官方 `f_account` **无 UNIQUE**(故意的) | 唯一性**应用层**保证;只比 `delete_mark=0` 的行 |
+88 -13
View File
@@ -7,17 +7,22 @@
## 0. 当前状态
**v1 已完成,验收四门全绿**(每一条 ✅ 都有实际执行输出,见 §9 与各任务报告)。
| 项 | 状态 |
|---|---|
| 目录 `~/Desktop/workspace/tds-lite-rs/` | ✅ 已建(`git init` 已做,**未 commit**) |
| `CLAUDE.md` | ✅ 已写(项目级 agent 指引:红线 / 坑位 / 端点全表 / 数据模型) |
| `HANDOFF.md`(本文件) | ✅ 已写 |
| 代码 | ⬜ **零行**。`src/` `scripts/` `Cargo.toml` `schema.sql` 都还没有 |
| 前端 | ⬜ 还没复制(`ssw-jnpf-lite-react/src/frontend` → 本仓 `src/frontend`) |
| 设计 | ✅ 已定稿(见 §3),**不要再重新设计** |
| 目录 `~/Desktop/workspace/tdc-lite-rs/` | ✅ 已建并已 commit(`main` 分支) |
| `CLAUDE.md` | ✅ 已写;**已逐条核对并与代码同步**(Task 12) |
| `HANDOFF.md`(本文件) | ✅ 已写并已同步(§0 状态表 / §9 交接话术,Task 12) |
| 代码 | ✅ 后端已实现(`src/backend/`,Rust 2021 + axum 0.8 + pglite-rs 0.2,**10 张表**、**27 条路由**) |
| 前端 | ✅ 已逐字复制(`src/frontend/`;**唯一改动 = vite 代理端口 `30000 → 30010`**,其余文件逐字节相同) |
| 脚本 | ✅ `scripts/perm-smoke.sh`(**32 条断言**)+ `scripts/check-module.sh`(9 接触点静态自检,**55 条 ✅**) |
| 工程脚本 | ✅ `run.sh`(`install`/`build`/`dev`/`backend`/`frontend`/`stop`/`logs`,退出码 0/1/2) |
| 文档 | ✅ `README.md` / `docs/runbook.md` / `.env.example` |
| 验收四门 | ✅ 全绿(编译 **0 error 0 warning** · 单测 **177 passed / 0 failed** · 冒烟 **PASS=32 FAIL=0** · 前端**浏览器**手验全过) |
**开工前先读**:`CLAUDE.md`(红线与坑位)→ 本文件 §3(设计)→ §5(实施顺序)。
§4 的四道验收门是"什么算做完"的唯一判据。
**读法**:`CLAUDE.md`(红线与坑位,日常改代码必读)→ §9(怎么起 / 怎么复现验收)。
§3(设计)与 §5(实施顺序 step 0–12)已**完结**,留作背景与决策记录,**不要再照着实施一遍**。
---
@@ -352,9 +357,79 @@ tds-lite-rs/ ← 独立 git 仓(已 init,未 commit)
---
## 9. 会话交接话术(给下一个会话的提示词)
## 9. 交接话术(交付态:这个仓是什么、怎么跑、怎么复现验收)
> 读 `CLAUDE.md` + `HANDOFF.md`(本文件)。设计已定稿,**不要重新设计**。
> 从 **step 0** 开始按 §5 顺序实施,每步先跑该步的完成判据。
> 参照物:`ssw-jnpf-lite-react`(契约真源,只读)、`jnpf/jnpf-database/PostgreSQL/JNPF-PostgreSQL.sql`(数据模型真源,只读)、
> `tdc-rs`(工程手法参考,只读,**不改**)。四道验收门见 §4,全部绿了才算完成。
> 读 `CLAUDE.md` + `HANDOFF.md`(本文件)。**设计已定稿且已实现完毕,不要重新设计、不要重写。**
### 一句话
`tds-lite-rs` = **JNPF 兼容契约的 Rust 实现**(单二进制、零外部服务:Rust 2021 + axum 0.8 +
pglite-rs 0.2 进程内原生 PostgreSQL;10 张表、27 条路由)。
**状态:v1 已完成,四道验收门全绿**(见 §0)。
### 怎么起
```bash
cd ~/Desktop/workspace/tdc-lite-rs
bash run.sh install # 一次性:cargo fetch + npm --prefix src/frontend install
bash run.sh build # 一次性:cargo build --release + vite build
bash run.sh dev # 日常:后台起后端(30010) + 前端(5173)
```
- 前端:**http://127.0.0.1:5173**(vite dev server,`/api` 代理到后端)
- 后端:**http://127.0.0.1:30010**
- 账号:**`admin` / `123456`**(首次启动自动种子)
- `bash run.sh logs` 看日志(`.logs/backend.log`、`.logs/frontend.log`);`bash run.sh stop` 停(幂等)
- 🔴 `run.sh` 的 `kill_ports` 是 `kill -9` ⇒ 只清 **30010 / 5173**,**绝不碰兄弟项目 `tdc-rs` 的端口**
- 🔴 打 localhost 用 curl **必须**加 `--noproxy '*'`(本机 curl 走系统代理)
### 怎么复现验收(四门,逐字命令 + 通过标准)
| 门 | 命令 | 通过标准 |
|---|---|---|
| ① 编译 | `cargo build --release` | **0 error 0 warning** |
| ② 单测 | `cargo test` | **177 passed / 0 failed**(8 个测试目标:63+6+19+24+3+18+7+37) |
| ③ 冒烟 | `bash scripts/perm-smoke.sh`(后端先起在 `:30010`) | **PASS=32 FAIL=0**,退出码 0 |
| ④ 前端手验 | `bash run.sh dev` ⇒ 浏览器开 `http://127.0.0.1:5173` | `admin/123456` 登录 → 菜单树正确 → 5 个管理页可增删改 → 3 个业务页可用 → 退出再登录 |
外加前置闸门:`bash scripts/check-module.sh`(9 接触点静态自检,纯静态、零 node 依赖;
期望 `PASS=55 FAIL=0`;无参 ⇒ 查全部三个业务模块)。
> 门④ 的浏览器手验清单(逐条):
> 1. `admin/123456` 登录 ⇒ Dashboard 出现「功能菜单」;
> 2. 菜单树 = 系统管理(用户管理 / 角色管理 / 机构管理 / 菜单管理)+ Demo 示例 + 产品管理 + 图书超市;
> 3. 4 个管理页(用户/角色/机构/菜单)从菜单按钮进入,页面标题正确,且**可增删改**;
> 4. 3 个业务页(DemoItem / Product / Book)可达、可增删;
> 5. 退出 ⇒ 回登录页 ⇒ 再登录 ⇒ 仍正常。
>
> ⚠️ 已知:**react 版 Dashboard 只渲染「目录的子项」**(`node.children`)⇒
> Demo 示例 / 产品管理 / 图书超市是**顶层页面型菜单**(`parentId='0'`,无子项)⇒
> **Dashboard 里没有按钮**,只能按 URL 直达(`/demo-item`、`/shop/Product`、`/books/Book`)。
> 这是**参照物原样行为**(前端逐字复制 ⇒ 本仓未改),**不是本仓的 bug**。
### 已知限制(分支级)
摘自 ledger(`.superpowers/sdd/tds-lite-rs-v1/progress.md`)的「分支级已知限制清单」:
- **(k)** release 二进制**没有** catch-all 的自动化覆盖(触发 panic 的端点是 `#[cfg(test)]` 专属;
catch-all 中间件代码在测试构建与 release 构建里**逐字相同**,且 release profile **无** `panic = "abort"` ⇒ 行为等价)。
- **(l)** `Path<String>` 遇**畸形百分号编码** ⇒ axum 默认返**纯文本 400(非信封)**(handler 签名由契约 §S17 定死,改它要动 `sys.rs`)。
- **(m)** 冒烟脚本**每次跑**会往库里留一行 `shop_product` + 一行 `book_shop_book` + 一行 `smoke_user`
(react 同款行为;契约 §13 未要求清理 ⇒ 不改)。
- **(n)** 冒烟脚本在「重复账号 curl 超时」场景下 stderr 会多一行 `cat: … No such file`(观感,判据不受影响)。
- **(o)** 冒烟脚本在「空 body 前置失败」时 jq / python 两条路径的**前置提示文案**不同
(`code=无` vs `code=ERR`),退出码都是 2。
本任务(Task 12)另记两条**已观察、未改**的观察(留给最终整体评审裁决):
- **react 版 Dashboard 只渲染「目录的子项」** ⇒ 3 个顶层业务页在菜单里**没有入口按钮**(只能按 URL 直达)。
前端是**逐字复制** ⇒ 改它会破「除代理端口外一字不改」的硬约束 ⇒ **不改**,只记档。
- `src/frontend/vite.config.ts` 的注释仍写着「转发到 **NestJS** 后端(30010)」——
本仓后端是 **Rust**。该注释行属于「代理目标行 + 紧邻注释行」两行允许改动范围,
但 brief 只授权把端口 `30000 → 30010` ⇒ 框架名**逐字保留**,**不「顺手修好」**(最终评审按 Minor 记)。
### 下一步(按 plan)
验收四门全绿 ⇒ **下一步是把本仓 1:1 复制成技能 `ssw-jnpf-lite-rust`**,
落在 `~/Desktop/workspace/skills/`,与 `ssw-jnpf-lite-react` 并列
(技能资产形态 = 本仓 1:1 复制;目录结构已刻意与 react 版对齐)。
+113
View File
@@ -0,0 +1,113 @@
# tds-lite-rs
**JNPF 兼容契约的 Rust 实现** —— 单二进制、零外部服务(进程内原生 PostgreSQL)。
它的存在意义只有一条:**让「用 Rust 写业务」和「迁回官方 JNPF(Java)」之间是机械翻译,而不是重写。**
为此本仓的**数据模型(`base_*` 表名/列名/语义)与 HTTP 契约**从第一天起就锁死成官方 JNPF 的形状。
- 📘 **契约唯一真源**:[`docs/contract.md`](docs/contract.md) —— 与本文件冲突时以契约为准。
- 🧭 **agent 指引**:[`CLAUDE.md`](CLAUDE.md)(红线 / 踩坑 / 端点全表)· [`HANDOFF.md`](HANDOFF.md)(交接)。
- 🛠 **怎么起 / 怎么冒烟 / 常见故障**:[`docs/runbook.md`](docs/runbook.md)。
---
## 快速开始
```bash
# 一次性:装依赖(cargo fetch + npm install)+ 构建(cargo build --release + vite build)
bash run.sh install
bash run.sh build
# 日常:后台起后端(30010) + 前端(5173),日志在 .logs/,PID 在 .run/
bash run.sh dev
# 前端 http://127.0.0.1:5173 后端 http://127.0.0.1:30010
# 账号 admin / 123456
bash run.sh stop # 停(幂等)
bash run.sh logs # 看日志尾部
```
| 端口 | 谁 | 说明 |
|---|---|---|
| `30010` | 后端(Rust) | `PORT` 可覆盖;**兄弟项目 `tdc-rs` 占了 `:30000`,本仓不碰** |
| `5173` | 前端(vite dev) | `strictPort: true` ⇒ 端口被占直接报错,不自动换端口 |
---
## 目录
```
tds-lite-rs/
├── Cargo.toml # cargo workspace 根(成员 = src/backend)+ release profile
├── run.sh # install / build / dev / backend / frontend / stop / logs
├── .env.example # PORT / PGLITE_DIR(PGLITE_DIR 只能写绝对路径或 memory://)
├── src/backend/ # Rust 后端(axum 0.8 + pglite-rs 0.2,10 张表,27 条路由)
├── src/frontend/ # react 技能前端**逐字复制**(只改 vite 代理端口 30000 → 30010)
├── scripts/perm-smoke.sh # 权限闭环冒烟(32 条断言,零 node 依赖)
├── scripts/check-module.sh # 业务模块 9 接触点静态自检(纯静态,不起后端)
└── docs/ # contract.md(契约)· runbook.md(运维)· ddl/
```
---
## 它做了什么(v1 = 全量契约对齐)
- **登录 / `CurrentUser`**:`POST /api/oauth/Login`(form-urlencoded,密文 hex)⇒ `{token, expiresIn:7200, tokenTypeName:'bearer'}`;
`GET /api/oauth/CurrentUser` ⇒ `{userInfo, menuList}`。
- **5 组 `base_*` 管理 CRUD**:用户 / 角色 / 机构 / 菜单 / 授权。
- **统一授权**:`PUT /api/permission/Authority/Data/{objectId}`(body `{objectType:'role', module:[...]}`,**小写 + 一维数组**)。
- **四源权限合并**:用户直授 + 角色 + 组织 + 岗位;**管理员在任何 SQL 之前短路放行**;**菜单未映射 ⇒ 放行**。
- **两段式种子**:`ensure_base`(每次启动补内置角色/菜单/授权)+ `first_seed`(仅首次建 `admin/123456`)。
- **3 个业务模块**(spec 驱动 CRUD 引擎):`demo/DemoItem` · `shop/Product` · `books/Book`。
### 契约红线(摘要,完整版见 `CLAUDE.md`)
1. **业务失败一律 HTTP 200 + `{code,msg,data}`**;成败只看 body 的 `code`。
唯一例外:**未知路由 = HTTP 404**(body 仍是信封)。鉴权失败也是 200(`600` 未登录 / `403` 无菜单权限)。
2. **`base_*` 表名/列名逐字对齐官方 JNPF DDL**(含两个「故意不修正」的陷阱,见 `CLAUDE.md`)。
3. **numeric 列必须是 JSON 字符串**(`"9.90"`,不是 `9.9`);int 列保持数字。
4. **口令不得外泄**:库里存 `md5(明文)`,对外响应手工挑字段(用户列表去掉 `password`)。
5. **schema DDL 绝不可从 HTTP 下载**。
---
## 验收门
| 门 | 命令 | 通过标准 |
|---|---|---|
| ① 编译 | `cargo build --release` | 0 error **0 warning** |
| ② 单测 | `cargo test` | 全绿(当前 **177 passed / 0 failed**) |
| ③ 冒烟 | `bash scripts/perm-smoke.sh` | **PASS=32 FAIL=0**(需后端已起在 `:30010`) |
| ④ 前端手验 | `bash run.sh frontend` | `http://127.0.0.1:5173` → `admin/123456` 登录 → 菜单树正确 → 5 个管理页可增删改 → DemoItem/Product/Book 三页可用 → 退出再登录 |
外加:`bash scripts/check-module.sh`(9 接触点静态自检)—— 加业务模块后立刻跑的前置闸门。
> 本机 curl 走系统代理 ⇒ 打 localhost **必须**加 `--noproxy '*'`。
---
## 三个参照物(各司其职,别混)
| 参照物 | 地位 |
|---|---|
| 官方 JNPF 源码 + DDL(`~/Desktop/workspace/jnpf/`) | **数据模型真源**(`base_*` 表名/列名) |
| `ssw-jnpf-lite-react` 技能(`~/Desktop/workspace/skills/ssw-jnpf-lite-react/`) | **行为真源**(NestJS 版把契约跑起来了);本仓前端是它的**逐字复制** |
| `tdc-rs` 兄弟项目(`~/Desktop/workspace/tdc-rs/`) | **只抄工程手法**;不共享代码 / 端口 / 数据目录 |
---
## 已知限制(分支级)
- **release 二进制没有 catch-all 的自动化覆盖**:触发 panic 的端点是 `#[cfg(test)]` 专属;
catch-all 中间件代码在测试构建与 release 构建里逐字相同,且 release profile **无** `panic = "abort"` ⇒ 行为等价。
- **`Path<String>` 遇畸形百分号编码** ⇒ axum 默认返纯文本 400(**非信封**);handler 签名由契约定死。
- **冒烟脚本每次跑会往库里留一行** `shop_product` + 一行 `book_shop_book` + 一行 `smoke_user`(react 同款行为,契约未要求清理)。
- 冒烟脚本在「重复账号 curl 超时」场景下 stderr 会多一行 `cat: … No such file`(观感,判据不受影响)。
- 冒烟脚本在「空 body 前置失败」时 jq / python 两条路径的前置提示文案不同(退出码都是 2)。
---
## 技术栈
Rust 2021 · axum 0.8 · tokio · pglite-rs 0.2(进程内原生 PostgreSQL,零服务/零 Docker/零 WASM)·
aes 0.8 + ecb 0.1 + md-5 0.10 · React 18 + Vite 5(逐字复用)
+195
View File
@@ -0,0 +1,195 @@
# runbook —— tds-lite-rs 怎么起、怎么冒烟、坏了怎么办
> 契约见 [`contract.md`](contract.md);红线与坑位清单见 [`../CLAUDE.md`](../CLAUDE.md)。
---
## 0. 前置
| 工具 | 版本(本机实测) | 用途 |
|---|---|---|
| Rust | ≥ 1.85(edition 2021;本机实测 rustc 1.95.0) | 后端 |
| Node / npm | node v26.8.1 · npm 11.19.0 | 前端(vite 5) |
| jq | 1.7.1(`/usr/bin/jq`) | 冒烟脚本的 JSON 取值(无则 python3 兜底) |
| python3 | 3.14.5 | 冒烟脚本的 JSON 取值兜底 |
🔴 **后端与 `scripts/perm-smoke.sh` 零 node 依赖** —— 冒烟脚本用后端自己的 `--enc` 子命令自证 cipher。
前端用 npm/vite 是它本来的工具链,允许。
---
## 1. 第一次上手
```bash
cd ~/Desktop/workspace/tdc-lite-rs
bash run.sh install # cargo fetch + npm --prefix src/frontend install
bash run.sh build # cargo build --release + vite build(产出 src/frontend/dist)
```
`install` 用的是 `npm install`(**可能更新 `package-lock.json`**)。想严格按 lock 装、不碰 lock,用:
```bash
npm --prefix src/frontend ci
```
> ⚠️ 本机 npm 11 会打印 `install-scripts 2 packages have install scripts not yet covered by allowScripts`
> (`esbuild` / `fsevents`)。**不影响构建** —— vite 用的二进制来自平台包 `@esbuild/darwin-*`。
> 万一 vite 报「esbuild binary not found」,再执行:
> `npm --prefix src/frontend install-scripts approve esbuild && npm --prefix src/frontend install`。
---
## 2. 日常启动
```bash
bash run.sh dev # 后台起后端(30010) + 前端(5173)
bash run.sh logs # 看 .logs/backend.log + .logs/frontend.log 尾部
bash run.sh stop # 停(幂等:无进程时也不报错,退出码 0)
```
- 前端:**http://127.0.0.1:5173**
- 后端:**http://127.0.0.1:30010**
- 账号:**`admin` / `123456`**(首次启动自动种;密码用浏览器侧 `utils/cipher.ts` 加密后提交)
- PID 在 `.run/{backend,frontend}.pid`,日志在 `.logs/{backend,frontend}.log`(两者都在 `.gitignore` 里)
单起一半:
```bash
bash run.sh backend # 前台跑后端(Ctrl-C 停)
bash run.sh frontend # 前台跑 vite
```
`run.sh` 退出码:**0** 成功 / **1** 运行期失败 / **2** 用法错(无参、未知子命令)。
`bash run.sh --help` 打印用法并退出 **0**。
🔴 **`run.sh` 的 `kill_ports` 是 `kill -9`** ⇒ 它只会清 **30010** 和 **5173** 两个端口。
**兄弟项目 `tdc-rs` 的端口不在列表里**(打死它就是破坏兄弟项目)。
---
## 3. 环境变量(`.env`)
`run.sh` 会把仓库根的 `.env` 导出给子进程(`set -a; . .env; set +a`)。样例见 `.env.example`。
| 变量 | 默认 | 说明 |
|---|---|---|
| `PORT` | `30010` | 后端监听端口 |
| `PGLITE_DIR` | `<项目根>/src/backend/data/lite.pg` | 数据目录(**绝对路径**,与 cwd 无关) |
🔴 **`PGLITE_DIR` 只能写绝对路径**。`config.rs` 对它是**原样使用** ⇒ 相对路径会相对**当前工作目录**解析
⇒ 换个 cwd 就换一份库,而且**静默**。要临时库就写 `PGLITE_DIR=memory://`
(pglite-rs 0.2.7 没有真内存模式,走的是系统临时目录里的一次性数据目录,进程退出即销毁)。
---
## 4. 冒烟与自检
### 4.1 权限闭环冒烟(32 条断言)
```bash
bash run.sh dev # 后端得先起来
bash scripts/perm-smoke.sh # 期望:PASS=32 FAIL=0,退出码 0
B=http://127.0.0.1:30010 bash scripts/perm-smoke.sh # 打别的地址
JQ_BIN="" bash scripts/perm-smoke.sh # 强制走 python3 兜底路径(两条路径判据一致)
```
退出码:**0** 全绿 / **1** 有断言失败 / **2** 前置错误(后端不可达、缺 jq+python3、缺 `--enc` 二进制)。
断言覆盖:未登录 `600` → 加密登录 → 菜单树分组 → 建用户 → 重复账号 `400`(不是 500)→
一维/二维授权写入 → 非管理员菜单收窄 → `403` → 未知路由 `404` → 管理员短路 →
Product/Book 往返(36 位 UUID、numeric 是 JSON 字符串 `"9.90"`、int 是 JSON 数字 `100`)。
### 4.2 业务模块 9 接触点静态自检
```bash
bash scripts/check-module.sh # 无参 ⇒ 检查全部三个业务模块
bash scripts/check-module.sh books Book # 只查一个
```
**纯静态**:不启动后端、不发请求、不依赖 node。
每个 `appCode/Entity` 查 9 个接触点(后端路由注册 · spec 定义 · 实体表 · 守卫 `module_key` ·
前端 api 文件 · 前端页面 · 前端路由 · 菜单种子 · **授权 key 三处一字不差**),
外加两条契约红线(`f_` 前缀 + `f_id VARCHAR(50)` 主键 · 软删契约)。
退出码:**0** 全过 / **1** 有 ❌ / **2** 用法错(未知参数、app_code/Entity 不在本仓已知清单)。
> 🔴 demo 模块**没有** `api/demoitem.ts`(`views/DemoItem.tsx` 直接 `request.get('/ssw/demo/DemoItem/List')`)
> ⇒ 这一条走「view 直连」分支;两种都查不到才算 ❌。
---
## 5. 前端手验清单(验收门④)
```bash
bash run.sh dev
```
浏览器打开 **http://127.0.0.1:5173**:
1. `admin` / `123456` 登录 ⇒ 进 Dashboard;
2. 菜单树正确:系统管理(用户管理 / 角色管理 / 机构管理 / 菜单管理)+ Demo 示例 + 产品管理 + 图书超市;
3. 5 个管理页可增删改(用户 / 角色 / 机构 / 菜单 / 授权);
4. 3 个业务页可用(DemoItem / Product / Book);
5. 退出再登录 ⇒ 仍正常。
**代理自检**(不开浏览器也能验):
```bash
curl --noproxy '*' -s http://127.0.0.1:5173/ | grep '<div id="root">'
curl --noproxy '*' -s http://127.0.0.1:5173/api/health
# => {"ok":true,"tables":10,"version":"0.1.0"} ← 说明 vite 代理把 /api 转到了 30010
```
---
## 6. 常见故障
### 6.1 本机特有
| 症状 | 根因 | 处理 |
|---|---|---|
| `curl http://127.0.0.1:5173` 连不上 / 502 | 本机 curl 走**系统代理** | 加 `--noproxy '*'` |
| `localhost:5173` 连不上 | macOS 上 vite 默认只 bind `::1` | 用 `127.0.0.1:5173`(`vite.config.ts` 已强制 IPv4) |
| 起后台进程后工具一返回就没了 | `nohup … &` 会被回收 | 用 Bash 工具的 `run_in_background`;stdout **不要**指向 `/dev/null`(进程会以 100 退出) |
| vite 报端口被占 | `strictPort: true`(故意不自动换端口) | `lsof -ti:5173` 看清是谁;或 `bash run.sh stop` |
| `npm install` 卡在 esbuild | npm 11 的 `allowScripts` 闸门 | `npm --prefix src/frontend install-scripts approve esbuild && npm --prefix src/frontend install` |
| 第二个后端实例起不来 | **pglite 单实例独占数据目录** | 换 `PGLITE_DIR` 或换端口 |
### 6.2 契约层(与 `CLAUDE.md` 的踩坑清单一一对应)
| 症状 | 根因 | 处理 |
|---|---|---|
| 登录必失败(400 账号或密码错误) | cipher key 当成 16 字节原始摘要 ⇒ AES-128 | key = `md5_hex` 的 **32 个 ASCII 字节** ⇒ AES-256 |
| `f_price` 回显 `9.9` 而不是 `"9.90"` | `row_to_json` 把 numeric 给了数字 | 投影里 `f_price::text AS price` |
| 角色授权写了不生效 | 写进 `base_role_relation.f_user_id`(**不存在此列**) | 用户 id 写 `f_object_id` + `f_object_type='user'` |
| 组织/岗位授权不生效 | 写进 `base_role_relation` | 写 `base_user_relation`(那里才有 `f_user_id`) |
| 授权接口返 200 但一行没写 | `objectType` 传了 `'Role'`(大写) | 必须小写 `'role'`;`module` 传一维数组 |
| 非管理员拿到了全部菜单 | 只查了角色授权 | 四源合并(直授+角色+组织+岗位) |
| 菜单授权没生效但接口放行 | 菜单 `f_url_address` ≠ 前端 Route path | 三处(urlAddress / Route path / 守卫 key)必须一字不差 |
| 405 返回 HTML / 丢 `Allow` 头 | 用了 axum 的 `method_not_allowed_fallback` | 用响应改写中间件(链尾) |
| DDL 能从 HTTP 下载 | DDL 落在 web root | 移到 `db/` + 兜底守卫 |
---
## 7. 数据重置
库是**嵌入式 pglite 数据目录**(默认 `src/backend/data/lite.pg`),**没有独立的 PG 服务**。
```bash
bash run.sh stop
mv src/backend/data src/backend/data.bak-$(date +%s) # 改名备份(可恢复),下次启动重建空库
bash run.sh dev # 空库 ⇒ 重新种子(admin/123456)
```
🔴 **schema 只在首次建表时执行** ⇒ 改了 `src/backend/db/schema.sql` 之后**必须**走这一步,否则改动不生效。
---
## 8. 边界(别越界)
- `tdc-rs` 兄弟项目:**不共享**代码 / 端口 / 数据目录。`run.sh` 的 `kill_ports` 只清 30010 与 5173。
- `~/Desktop/workspace/skills/ssw-jnpf-lite-react/`(参照物):**只读**。本仓 `src/frontend/` 是它的逐字复制,
唯一改动是 `vite.config.ts` 的代理端口 `30000 → 30010`(连注释行一起改;`src/api/request.ts` 的
注释与 axios 的 `timeout: 30000` **刻意逐字节不动**)。
- `src/backend/**`、`docs/contract.md`、`scripts/perm-smoke.sh`:**已定稿**,改动需走评审。
Executable
+172
View File
@@ -0,0 +1,172 @@
#!/usr/bin/env bash
# tds-lite-rs 一键脚本
#
# 后端 = Rust 单二进制(cargo workspace 根 = 仓库根 ⇒ target/ 在仓库根)。
# 数据库为嵌入式 pglite-rs(进程内原生 PostgreSQL),零服务 / 零 Docker / 零 WASM。
#
# 用法:
# ./run.sh install 安装依赖(cargo fetch + npm install)
# ./run.sh build 构建(cargo build --release + vite build)
# ./run.sh dev 后台起后端(30010) + 前端(5173),日志进 .logs/,PID 写入 .run/
# ./run.sh backend 前台起后端
# ./run.sh frontend 前台起前端
# ./run.sh stop 用 PID 文件停后台进程 + 兜底 kill_ports
# ./run.sh logs tail .logs/{backend,frontend}.log
# ./run.sh --help 本用法
#
# 退出码:0 成功 / 1 运行期失败 / 2 用法错
set -euo pipefail
ROOT="$(cd "$(dirname "$0")" && pwd)"
LOGS="$ROOT/.logs"
RUN="$ROOT/.run"
# 后端端口:兄弟项目 tdc-rs 已占用它自己的后端端口,本仓一律用 30010。
# 前端 vite 端口固定 5173(vite.config.ts 里 strictPort: true)。
BACKEND_PORT=30010
FRONTEND_PORT=5173
# 🔴 kill_ports 用的是 kill -9 ⇒ 端口列表**只能是本仓自己的这两个端口**。
# 不许把兄弟项目 tdc-rs 的端口写进来(打死它就是破坏兄弟项目)。
BACKEND_BIN="$ROOT/target/release/tds-lite-rs"
mkdir -p "$LOGS" "$RUN"
# 加载项目根 .env(后端不 import dotenv,靠这里把 PORT / PGLITE_DIR 导出给子进程)
if [ -f "$ROOT/.env" ]; then
set -a; . "$ROOT/.env"; set +a
fi
export PORT="${PORT:-30010}"
usage() {
cat <<'EOF'
用法: ./run.sh <子命令>
install 安装依赖(cargo fetch + npm install)
build 构建(cargo build --release + vite build)
dev 后台起后端(30010) + 前端(5173)
backend 前台起后端
frontend 前台起前端
stop 停止后台进程
logs 打印后端/前端日志尾部
--help 本用法
退出码: 0 成功 / 1 运行期失败 / 2 用法错
EOF
}
# 端口守护:dev/start 前清掉残留进程,避免 EADDRINUSE 被静默吞掉(旧进程仍占端口,
# 新进程崩溃但请求全部打到旧实例 → 看起来「改了 seed 但菜单不变」之类的灵异 bug)。
kill_ports() {
local killed=0
for p in "$@"; do
local pids
pids="$(lsof -ti:"$p" 2>/dev/null || true)"
if [ -n "$pids" ]; then
echo " ↳ 端口 $p 被旧进程占用 (PID: $pids),清理中…"
# shellcheck disable=SC2086
kill -9 $pids 2>/dev/null || true
killed=1
fi
done
# 注意 set -e:端口空闲时 [ ] 返回 1 会炸掉调用方(dev 走不到 start_logged)
[ "$killed" -eq 1 ] && sleep 1
return 0
}
# 用 PID 文件优雅停(先 SIGTERM,1s 后 SIGKILL),清理 root 进程树
stop_pid() {
local f="$1"
[ -f "$f" ] || return 0
local pid
pid="$(cat "$f" 2>/dev/null || true)"
if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
echo " ↳ stop $(basename "$f") PID=$pid SIGTERM"
kill -TERM "$pid" 2>/dev/null || true
sleep 1
kill -0 "$pid" 2>/dev/null && kill -KILL "$pid" 2>/dev/null || true
fi
rm -f "$f"
}
# 用 nohup 后台起,stdout/stderr 都进日志;写 PID 便于 ./run.sh stop 精准收
start_logged() {
local dir="$1" cmd="$2" name="$3"
mkdir -p "$LOGS"
: > "$LOGS/${name}.log"
(
cd "$ROOT/$dir" || exit 1
# nohup + & 把子进程从父进程会话脱离,CI/harness 退出不会拖垮服务;
# setsid 让子进程成为新进程组领头,避免父 SIGINT 误杀。
# macOS 无 setsid(Linux util-linux 专有),探测后回退纯 nohup。
if command -v setsid >/dev/null 2>&1; then
setsid nohup $cmd > "$LOGS/${name}.log" 2>&1 &
else
nohup $cmd > "$LOGS/${name}.log" 2>&1 &
fi
echo $! > "$RUN/${name}.pid"
)
echo " ↳ $name PID=$(cat "$RUN/${name}.pid") log=$LOGS/${name}.log"
}
case "${1:-}" in
-h|--help|help)
usage
;;
install)
(cd "$ROOT" && cargo fetch)
npm --prefix "$ROOT/src/frontend" install
;;
build)
(cd "$ROOT" && cargo build --release)
npm --prefix "$ROOT/src/frontend" run build
;;
dev)
kill_ports "$BACKEND_PORT" "$FRONTEND_PORT"
if [ ! -x "$BACKEND_BIN" ]; then
echo "[启动失败] 后端二进制不存在: $BACKEND_BIN"
echo " 先跑「./run.sh build」(cargo build --release)。"
exit 1
fi
# 🔴 后端 cwd = 仓库根(dir=".")⇒ 相对路径的 PGLITE_DIR 也落在仓库内。
# 🔴 命令行**不带** PORT= 前缀 —— PORT 已由 .env / export 导出,子进程继承。
start_logged . "./target/release/tds-lite-rs" backend
start_logged src/frontend "npm run dev" frontend
echo
echo "服务已在后台启动。后端: http://127.0.0.1:${BACKEND_PORT} 前端: http://127.0.0.1:${FRONTEND_PORT}"
echo "日志:tail -f $LOGS/{backend,frontend}.log"
echo "停止:./run.sh stop"
;;
backend)
kill_ports "$BACKEND_PORT"
if [ ! -x "$BACKEND_BIN" ]; then
echo "[启动失败] 后端二进制不存在: $BACKEND_BIN"
echo " 先跑「./run.sh build」(cargo build --release)。"
exit 1
fi
(cd "$ROOT" && exec ./target/release/tds-lite-rs)
;;
frontend)
kill_ports "$FRONTEND_PORT"
npm --prefix "$ROOT/src/frontend" run dev
;;
stop)
# ⚠️ vite 是通用名 —— 只有本仓真的起过前端(PID 文件存在)才 pkill,避免误杀别的项目。
if [ -f "$RUN/frontend.pid" ]; then
pkill -f "vite" 2>/dev/null || true
fi
stop_pid "$RUN/backend.pid"
stop_pid "$RUN/frontend.pid"
kill_ports "$BACKEND_PORT" "$FRONTEND_PORT"
pkill -f "tds-lite-rs" 2>/dev/null || true
echo "stopped"
;;
logs)
# 🔴 补 || true:日志文件不存在时 [ -f ] 返回 1,set -e 下会让脚本以 1 退出。
{ [ -f "$LOGS/backend.log" ] && echo "=== backend ===" && tail -n 50 "$LOGS/backend.log"; } || true
{ [ -f "$LOGS/frontend.log" ] && echo "=== frontend ===" && tail -n 50 "$LOGS/frontend.log"; } || true
;;
*)
usage
exit 2
;;
esac
+332
View File
@@ -0,0 +1,332 @@
#!/usr/bin/env bash
# tds-lite-rs 加业务模块的「接触点」静态自检(Rust 版)
#
# 目的:在跑 perm-smoke 之前,**快速发现漏改的文件或字符串不一致**——这类问题一旦漏掉,
# 表现是「菜单不显示」「页面 404」「权限静默放行」,非常难定位。
#
# 🔴 **纯静态**:不启动后端、不发一个请求、不依赖 node(契约明令:后端与冒烟脚本零 node 依赖)。
# ⇒ 用法里**没有** `--live`;传了未知参数 ⇒ 退出码 2(用法错)。
#
# 用法:
# bash scripts/check-module.sh # 无参 ⇒ 检查全部三个业务模块
# bash scripts/check-module.sh <appCode> <Entity> # 也可只查一个(如 books Book)
# bash scripts/check-module.sh --help # 本用法
#
# 例:
# bash scripts/check-module.sh # demo / shop / books 全查
# bash scripts/check-module.sh books Book # 单模块
#
# 退出码:0 全过 / 1 有 ❌ 项 / 2 用法错
set -u
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
BACKEND="$ROOT/src/backend"
ENTITIES="$BACKEND/src/entities.rs"
ROUTES="$BACKEND/src/routes.rs"
SCHEMA="$BACKEND/db/schema.sql"
SEED="$BACKEND/src/seed.rs"
CRUD="$BACKEND/src/crud.rs"
FE="$ROOT/src/frontend"
usage() {
echo "用法: bash scripts/check-module.sh [<appCode> <Entity>...]"
echo " 无参 ⇒ 检查全部三个业务模块(demo / shop / books)"
echo "例: bash scripts/check-module.sh"
echo " bash scripts/check-module.sh books Book"
echo "退出码: 0 全过 / 1 有 ❌ 项 / 2 用法错"
}
if [ "${1:-}" = "-h" ] || [ "${1:-}" = "--help" ]; then
usage
exit 0
fi
# ---- 目标清单:appCode:Entity ----
TARGETS=()
if [ "$#" -eq 0 ]; then
TARGETS=("demo:DemoItem" "shop:Product" "books:Book")
else
APP_ARG="$1"
shift
if [ "$#" -eq 0 ]; then
echo "❌ 用法错:<appCode> 后面至少要跟一个 <Entity>"
usage
exit 2
fi
for ENT_ARG in "$@"; do
case "${ENT_ARG}" in
-*)
echo "❌ 未知参数: ${ENT_ARG}"
usage
exit 2
;;
esac
TARGETS+=("${APP_ARG}:${ENT_ARG}")
done
fi
# ---- 期望值表(逐字,来自契约 §8.4 + 契约 §5.3)----
# 每个目标:表名 / ROUTE(= urlAddress = module_key)/ 种子 id / module_key(None = 仅登录)
T_COUNT=${#TARGETS[@]}
T_APP=(); T_ENT=(); T_TABLE=(); T_ROUTE=(); T_SEED=(); T_MK=()
for T in "${TARGETS[@]}"; do
A="${T%%:*}"
E="${T##*:}"
case "${A}:${E}" in
demo:DemoItem)
T_TABLE+=("demo_item"); T_ROUTE+=("demo-item")
T_SEED+=("m_demo"); T_MK+=("None")
;;
shop:Product)
T_TABLE+=("shop_product"); T_ROUTE+=("shop/Product")
T_SEED+=("m_product"); T_MK+=("shop/Product")
;;
books:Book)
T_TABLE+=("book_shop_book"); T_ROUTE+=("books/Book")
T_SEED+=("m_book"); T_MK+=("books/Book")
;;
*)
echo "❌ 未知 app_code/Entity: ${A}/${E}"
echo " 本仓已知: demo/DemoItem、shop/Product、books/Book"
exit 2
;;
esac
T_APP+=("${A}"); T_ENT+=("${E}")
done
PASS=0; FAIL=0
ok() { echo " ✅ $1"; PASS=$((PASS+1)); }
no() { echo " ❌ $1"; FAIL=$((FAIL+1)); }
hdr() { echo; echo "── $1 ──"; }
# 小写(兼容 bash 3.x,不用 ${var,,})
lower() { printf '%s' "$1" | tr '[:upper:]' '[:lower:]'; }
# 自然英语复数(兼容 bash 3.x,不依赖 declare -A)
# Apply → Applies / Box → Boxes / Match → Matches / Buy → Buys(y 辅音前) / Boy → Boys
plural() {
case "$1" in
*s|*x|*ch|*sh) echo "${1}es" ;; # -s/-x/-ch/-sh 直接加 es
*ay|*ey|*oy|*uy) echo "${1}s" ;; # 单元音 + y → 保留 +s(Boy → Boys)
*y) echo "${1%y}ies" ;; # 辅音 + y → 去 y 加 ies
*) echo "${1}s" ;; # 默认 +s
esac
}
# 从 entities.rs 里取某个 spec 的 table 字面量
spec_table_of() {
awk -v want="$1" '
/entity: "/ { e = $0; sub(/.*entity: "/, "", e); sub(/".*/, "", e) }
/table: "/ { t = $0; sub(/.*table: "/, "", t); sub(/".*/, "", t);
if (e == want) { print t; exit } }
' "$ENTITIES"
}
# 从 entities.rs 里取某个 spec 的 module_key(None 或 Some("x") 的 x)
spec_module_key_of() {
awk -v want="$1" '
/entity: "/ { e = $0; sub(/.*entity: "/, "", e); sub(/".*/, "", e) }
/module_key:/ {
m = $0; sub(/.*module_key:[[:space:]]*/, "", m); sub(/,[[:space:]]*$/, "", m)
if (e == want) {
if (m ~ /^Some\(/) { s = m; sub(/^Some\("/, "", s); sub(/"\)$/, "", s); print s }
else print "None"
exit
}
}
' "$ENTITIES"
}
# 从 seed.rs 里取某个内置菜单 id 的 url_address
seed_url_of() {
awk -v want="$1" '
/id: "/ { cur = $0; sub(/.*id: "/, "", cur); sub(/".*/, "", cur) }
/url_address: "/ {
u = $0; sub(/.*url_address: "/, "", u); sub(/".*/, "", u)
if (cur == want) { print u; exit }
}
' "$SEED"
}
# 从 schema.sql 里取某张表的 CREATE TABLE 块
schema_block_of() {
awk -v t="$1" '
$0 ~ ("CREATE TABLE " t " \\(") { inb = 1 }
inb { print }
inb && /^\);/ { exit }
' "$SCHEMA"
}
for i in $(seq 0 $((T_COUNT - 1))); do
APP="${T_APP[$i]}"
ENT="${T_ENT[$i]}"
TABLE="${T_TABLE[$i]}"
ROUTE="${T_ROUTE[$i]}"
SEED_ID="${T_SEED[$i]}"
MK="${T_MK[$i]}"
LC="$(lower "$ENT")"
URL="${APP}/${ENT}"
hdr "[${ENT}] 1) 后端路由注册:routes.rs 含 /api/ssw/${URL}/{List|Save|Delete}"
for ep in List Save Delete; do
if grep -q "/api/ssw/${URL}/${ep}" "$ROUTES" 2>/dev/null; then
ok "routes.rs 已注册 /api/ssw/${URL}/${ep}"
else
no "routes.rs 缺 /api/ssw/${URL}/${ep} → 端点 404"
fi
done
hdr "[${ENT}] 2) spec 定义:entities.rs 含 entity: \"${ENT}\" + table: \"${TABLE}\""
if grep -q "entity: \"${ENT}\"" "$ENTITIES" 2>/dev/null; then
ok "entities.rs 含 entity: \"${ENT}\""
else
no "entities.rs 缺 entity: \"${ENT}\"(spec 没登记这个实体)"
fi
SPEC_TABLE="$(spec_table_of "${ENT}")"
if [ "${SPEC_TABLE}" = "${TABLE}" ]; then
ok "spec.table = ${TABLE}"
else
no "spec.table = ${SPEC_TABLE:-(没取到)},期望 ${TABLE}"
fi
hdr "[${ENT}] 3) 实体表存在:schema.sql 含 CREATE TABLE ${TABLE}"
if grep -q "CREATE TABLE ${TABLE}" "$SCHEMA" 2>/dev/null; then
ok "schema.sql 有表 ${TABLE}"
else
no "schema.sql 缺表 ${TABLE} → 业务模块跑不起来"
fi
hdr "[${ENT}] 4) 守卫 module_key:entities.rs 的 spec.module_key"
SPEC_MK="$(spec_module_key_of "${ENT}")"
if [ "${SPEC_MK}" = "${MK}" ]; then
ok "spec.module_key = ${MK}"
else
no "spec.module_key = ${SPEC_MK:-(没取到)},期望 ${MK}"
fi
hdr "[${ENT}] 5) 前端 api 文件:api/${LC}.ts 含 list/save/delete 三导出"
API="$FE/src/api/${LC}.ts"
VIEW="$FE/src/views/${ENT}.tsx"
if [ -f "$API" ]; then
# 命名约定:list 函数走「自然英语复数」(Book → listBooks / Product → listProducts)
# save/delete 用 Entity 单数(PascalCase),与后端端点命名一致。
PLURAL_ENT="$(plural "$ENT")"
for fn in "list${PLURAL_ENT}" "save${ENT}" "delete${ENT}"; do
if grep -qE "export[[:space:]]+const[[:space:]]+${fn}" "$API" 2>/dev/null; then
ok "${fn} 导出存在"
else
no "${API} 缺 export const ${fn}(前端解构会 undefined)"
fi
done
else
# 🔴 本仓前端是逐字复制:demo 模块**没有** api 文件,
# views/DemoItem.tsx 直接 request.get('/ssw/demo/DemoItem/List') ⇒
# 「前端 api 文件」这一接触点对 demo 走**直连分支**(两种都查不到才算 ❌)。
ok "无 api/${LC}.ts(走 view 直连分支)"
if [ -f "$VIEW" ]; then
for ep in List Save Delete; do
if grep -qE "request\.(get|post|delete)\([^)]*/ssw/${URL}/${ep}" "$VIEW" 2>/dev/null; then
ok "views/${ENT}.tsx 直连 request → /ssw/${URL}/${ep}"
else
no "views/${ENT}.tsx 没有直连 request → /ssw/${URL}/${ep}"
fi
done
else
no "views/${ENT}.tsx 不存在,无法核对直连分支"
fi
fi
hdr "[${ENT}] 6) 前端页面:views/${ENT}.tsx 存在"
if [ -f "$VIEW" ]; then
ok "views/${ENT}.tsx"
else
no "缺文件: views/${ENT}.tsx"
fi
hdr "[${ENT}] 7) 前端路由:App.tsx 含 <Route path=\"/${ROUTE}\""
# JSX 常写成多行(<Route\n path=...>),BSD grep 不支持 -P 跨行匹配,
# 用 tr 把换行去掉再 grep 最稳。
if tr '\n' ' ' < "$FE/src/App.tsx" | grep -q "<Route[^>]*path=\"/${ROUTE}\"" 2>/dev/null; then
ok "Route path=\"/${ROUTE}\" 已注册"
else
no "App.tsx 缺 <Route path=\"/${ROUTE}\" → 路由 404"
fi
hdr "[${ENT}] 8) 菜单种子:seed.rs 的内置菜单 ${SEED_ID} 的 url_address"
SEED_URL="$(seed_url_of "${SEED_ID}")"
if [ "${SEED_URL}" = "${ROUTE}" ]; then
ok "seed ${SEED_ID}.url_address = ${ROUTE}"
else
no "seed ${SEED_ID}.url_address = ${SEED_URL:-(没取到)},期望 ${ROUTE} → 菜单不显示"
fi
hdr "[${ENT}] 9) 三处一字不差:module_key == url_address == Route path(去前导斜杠)"
if [ "${MK}" = "None" ]; then
# 🔴 demo 是「仅登录」守卫 ⇒ **没有** module_key 这一侧 ⇒ 只比 url_address == Route path。
if [ "${SEED_URL}" = "${ROUTE}" ]; then
ok "url_address == Route path:${SEED_URL} == ${ROUTE}(demo 仅登录 ⇒ 跳过 module_key 侧)"
else
no "url_address=${SEED_URL:-无} / Route=${ROUTE} 不一致"
fi
elif [ "${SPEC_MK}" = "${SEED_URL}" ] && [ "${SEED_URL}" = "${ROUTE}" ]; then
ok "三处相等:${SPEC_MK} == ${SEED_URL} == ${ROUTE}"
else
no "三处不一致:module_key=${SPEC_MK:-无} / url_address=${SEED_URL:-无} / Route=${ROUTE}"
fi
hdr "[${ENT}] 实体列 f_ 前缀 + 主键 f_id VARCHAR(50)(契约红线 4)"
BLOCK="$(schema_block_of "${TABLE}")"
if [ -z "${BLOCK}" ]; then
no "schema.sql 里没解析出 ${TABLE} 的建表块"
else
COLS="$(printf '%s\n' "${BLOCK}" | sed -n 's/^ \([A-Za-z_][A-Za-z0-9_]*\).*/\1/p')"
if [ -z "${COLS}" ]; then
no "${TABLE} 的建表块里没解析出任何列"
else
BADCOLS=""
for c in ${COLS}; do
case "${c}" in
f_*) ;;
*) BADCOLS="${BADCOLS} ${c}" ;;
esac
done
if [ -n "${BADCOLS}" ]; then
no "列名不是 f_ 前缀:${BADCOLS}"
else
ok "全部列名都是 f_ 前缀($(printf '%s\n' "${COLS}" | wc -l | tr -d ' ') 列)"
fi
fi
if printf '%s\n' "${BLOCK}" | grep -q "f_id VARCHAR(50)"; then
ok "主键 f_id VARCHAR(50)(36 位 UUID 装得下)"
else
no "主键必须是 f_id VARCHAR(50)(不要写成 32,否则 36 位 UUID 装不下)"
fi
fi
hdr "[${ENT}] 软删契约:list 带 f_delete_mark = 0 + remove 走软删(不是物理 DELETE)"
if grep -q "WHERE f_delete_mark = 0" "$CRUD" 2>/dev/null; then
ok "list 查询带 f_delete_mark = 0"
else
no "list 查询缺 f_delete_mark = 0 → 软删数据会显示"
fi
if grep -q "SET f_delete_mark = 1" "$CRUD" 2>/dev/null; then
ok "remove 置 f_delete_mark = 1(软删)"
else
no "remove 没软删(应是 UPDATE f_delete_mark=1,非物理 DELETE)"
fi
done
# -------- 总结 --------
echo
echo "── 总结 ──"
echo "Modules: ${TARGETS[*]}"
echo "PASS=$PASS FAIL=$FAIL"
if [ "$FAIL" -eq 0 ]; then
echo "全 ✅ 可以跑 perm-smoke 了"
else
echo "有 ❌,请按上面修复后再跑 perm-smoke"
fi
exit $([ "$FAIL" -eq 0 ] && echo 0 || echo 1)
+12
View File
@@ -0,0 +1,12 @@
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>SSW JNPF Lite · React MVP</title>
</head>
<body>
<div id="root"></div>
<script type="module" src="/src/main.tsx"></script>
</body>
</html>
+2115
View File
File diff suppressed because it is too large. Load diff
+27
View File
@@ -0,0 +1,27 @@
{
"name": "ssw-jnpf-lite-react-frontend",
"private": true,
"version": "0.1.0",
"type": "module",
"scripts": {
"dev": "vite",
"build": "vite build",
"typecheck": "tsc --noEmit",
"preview": "vite preview"
},
"dependencies": {
"axios": "^1.7.0",
"crypto-js": "^4.2.0",
"react": "^18.3.1",
"react-dom": "^18.3.1",
"react-router-dom": "^6.26.0"
},
"devDependencies": {
"@types/crypto-js": "^4.2.2",
"@types/react": "^18.3.0",
"@types/react-dom": "^18.3.0",
"@vitejs/plugin-react": "^4.3.0",
"typescript": "^5.4.0",
"vite": "^5.2.0"
}
}
+91
View File
@@ -0,0 +1,91 @@
import { Routes, Route, Navigate, useLocation } from 'react-router-dom';
import { JSX } from 'react';
import Login from './views/Login';
import Dashboard from './views/Dashboard';
import DemoItem from './views/DemoItem';
import Product from './views/Product';
import Book from './views/Book';
import UserManage from './views/UserManage';
import RoleManage from './views/RoleManage';
import OrganizeManage from './views/OrganizeManage';
import MenuManage from './views/MenuManage';
import { getToken } from './api/request';
function RequireAuth({ children }: { children: JSX.Element }) {
const token = getToken();
const location = useLocation();
if (!token) return <Navigate to="/login" state={{ from: location }} replace />;
return children;
}
export default function App() {
return (
<Routes>
<Route path="/login" element={<Login />} />
<Route
path="/"
element={
<RequireAuth>
<Dashboard />
</RequireAuth>
}
/>
<Route
path="/demo-item"
element={
<RequireAuth>
<DemoItem />
</RequireAuth>
}
/>
<Route
path="/shop/Product"
element={
<RequireAuth>
<Product />
</RequireAuth>
}
/>
<Route
path="/books/Book"
element={
<RequireAuth>
<Book />
</RequireAuth>
}
/>
<Route
path="/system/User"
element={
<RequireAuth>
<UserManage />
</RequireAuth>
}
/>
<Route
path="/system/Role"
element={
<RequireAuth>
<RoleManage />
</RequireAuth>
}
/>
<Route
path="/system/Organize"
element={
<RequireAuth>
<OrganizeManage />
</RequireAuth>
}
/>
<Route
path="/system/Module"
element={
<RequireAuth>
<MenuManage />
</RequireAuth>
}
/>
</Routes>
);
}
+19
View File
@@ -0,0 +1,19 @@
import request from './request';
export async function login(account: string, passwordHex: string) {
const params = new URLSearchParams();
params.set('account', account);
params.set('password', passwordHex);
params.set('grant_type', 'password');
// Content-Type: application/x-www-form-urlencoded,与 JNPF 登录一致
return (await request.post('/oauth/Login', params.toString(), {
headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
})) as { token: string; expiresIn: number; tokenTypeName: string };
}
export async function currentUser() {
return (await request.get('/oauth/CurrentUser')) as {
userInfo: any;
menuList: any[];
};
}
+5
View File
@@ -0,0 +1,5 @@
import request from './request';
export const listBooks = () => request.get('/ssw/books/Book/List');
export const saveBook = (dto: any) => request.post('/ssw/books/Book/Save', dto);
export const deleteBook = (id: string) => request.delete(`/ssw/books/Book/Delete?id=${id}`);
+7
View File
@@ -0,0 +1,7 @@
import request from './request';
// Product 业务 API —— 端点与后端 @Controller('api/ssw/shop/Product') 对应
export const listProducts = () => request.get('/ssw/shop/Product/List');
export const saveProduct = (dto: any) => request.post('/ssw/shop/Product/Save', dto);
export const deleteProduct = (id: string) =>
request.delete(`/ssw/shop/Product/Delete?id=${id}`);
+72
View File
@@ -0,0 +1,72 @@
import axios, { AxiosError, AxiosInstance } from 'axios';
/**
* 请求层 —— 复刻 JNPF/jweb 的 ActionResult 适配语义:
* - 统一 baseURL '/api'(dev 由 vite proxy 转发到 30000)
* - 拦截器处理 code:600/601/602 -> 清 token 跳 /login(对齐 jweb enum.ts: TOKEN_TIMEOUT/TOKEN_LOGGED/TOKEN_ERROR)
* - code !== 200 -> reject
* - 成功时把 ActionResult 的 data 解包抛给调用方
* 迁 jweb(Vue) 时这些逻辑 1:1 对应 vben 的 defHttp 拦截器,前端零改。
*/
const TOKEN_KEY = 'ssw_token';
export function getToken(): string | null {
return localStorage.getItem(TOKEN_KEY);
}
export function setToken(raw: string) {
const t = raw.startsWith('bearer ') ? raw : `bearer ${raw}`;
localStorage.setItem(TOKEN_KEY, t);
}
export function clearToken() {
localStorage.removeItem(TOKEN_KEY);
}
interface SswRequest extends AxiosInstance {
get<T = any>(url: string, config?: any): Promise<T>;
post<T = any>(url: string, data?: any, config?: any): Promise<T>;
put<T = any>(url: string, data?: any, config?: any): Promise<T>;
delete<T = any>(url: string, config?: any): Promise<T>;
}
const request = axios.create({ baseURL: '/api', timeout: 30000 }) as SswRequest;
request.interceptors.request.use((config) => {
const token = getToken();
config.headers.set('App-Code', 'sswflow');
config.headers.set('Jnpf-Origin', 'pc');
if (token) config.headers.set('Authorization', token);
return config;
});
function redirectLogin() {
if (location.pathname !== '/login') {
location.replace(`/login?next=${encodeURIComponent(location.pathname + location.search)}`);
}
}
request.interceptors.response.use(
(resp) => {
const body = resp.data || {};
if (body.code === 600 || body.code === 601 || body.code === 602) {
clearToken();
redirectLogin();
return Promise.reject(new Error('NOT_LOGIN'));
}
if (body.code !== undefined && body.code !== 200) {
return Promise.reject(new Error(body.msg || '操作失败'));
}
return body.data !== undefined ? body.data : body;
},
(error: AxiosError) => {
const status = error.response?.status;
const body: any = error.response?.data || {};
if (status === 401 || body.code === 600 || body.code === 601 || body.code === 602) {
clearToken();
redirectLogin();
return Promise.reject(new Error('NOT_LOGIN'));
}
return Promise.reject(new Error(body.msg || error.message || '请求失败'));
},
);
export default request;
+36
View File
@@ -0,0 +1,36 @@
import request from './request';
// 用户
export const listUsers = () => request.get('/ssw/sys/User/List');
export const saveUser = (dto: any) => request.post('/ssw/sys/User/Save', dto);
export const deleteUser = (id: string) =>
request.delete(`/ssw/sys/User/Delete?id=${id}`);
// 角色
export const listRoles = () => request.get('/ssw/sys/Role/List');
export const saveRole = (dto: any) => request.post('/ssw/sys/Role/Save', dto);
export const deleteRole = (id: string) =>
request.delete(`/ssw/sys/Role/Delete?id=${id}`);
export const roleModules = (roleId: string) =>
request.get(`/ssw/sys/Role/Modules?roleId=${roleId}`);
// 机构
export const listOrganize = () => request.get('/ssw/sys/Organize/List');
export const saveOrganize = (dto: any) => request.post('/ssw/sys/Organize/Save', dto);
export const deleteOrganize = (id: string) =>
request.delete(`/ssw/sys/Organize/Delete?id=${id}`);
// 菜单
export const listModules = () => request.get('/ssw/sys/Module/List');
export const saveModule = (dto: any) => request.post('/ssw/sys/Module/Save', dto);
export const deleteModule = (id: string) =>
request.delete(`/ssw/sys/Module/Delete?id=${id}`);
// 统一授权(角色→菜单,对齐 JNPF PUT /api/permission/Authority/Data/{objectId})
// module 是一维 String[](官方 AuthorizeDataUpForm.module = String[]);
// 半选节点由调用方合并进同一数组(对齐 MenuAuth.vue: [...checkedKeys, ...halfCheckedKeys])
export const saveRoleModules = (roleId: string, moduleIds: string[]) =>
request.put(`/permission/Authority/Data/${roleId}`, {
objectType: 'role',
module: moduleIds,
});
+12
View File
@@ -0,0 +1,12 @@
import React from 'react';
import ReactDOM from 'react-dom/client';
import { BrowserRouter } from 'react-router-dom';
import App from './App';
ReactDOM.createRoot(document.getElementById('root')!).render(
<React.StrictMode>
<BrowserRouter>
<App />
</BrowserRouter>
</React.StrictMode>,
);
+26
View File
@@ -0,0 +1,26 @@
import CryptoJS from 'crypto-js';
/**
* 登录密码加密 —— 与 JNPF 后端 LiteLoginController / dacli / ssw-jnpf-lite(Vue) 完全一致。
* 检验向量:encryptPassword('123456') ===
* 'd4958348e22108119b3ef57b022c83f4bf857dd0b247eaab15b9a43d47ee3c503900f7135bf0de255bc33620c3cdc02b'
*/
const CIPHER_KEY = 'EY8WePvjM5GGwQzn';
function md5(str: string): string {
return CryptoJS.MD5(str).toString();
}
export function encryptPassword(plain: string): string {
const key = CryptoJS.enc.Utf8.parse(md5(CIPHER_KEY));
const src = CryptoJS.enc.Utf8.parse(md5(plain));
return CryptoJS.AES.encrypt(src, key, {
mode: CryptoJS.mode.ECB,
padding: CryptoJS.pad.Pkcs7,
})
.ciphertext.toString(CryptoJS.enc.Hex);
}
export function md5Hex(str: string): string {
return md5(str);
}
+155
View File
@@ -0,0 +1,155 @@
import { useEffect, useState } from 'react';
import { listBooks, saveBook, deleteBook } from '../api/book';
import { wrap, card, btn, btnDanger, input as inputStyle, tableStyle, th, td } from './ui';
// 字段用去前缀名:id / title / author / isbn / category / price / stock
// (JNPF 后端 Jackson 会剥掉 f_ 前缀)
interface Book {
id: string;
title?: string;
author?: string;
isbn?: string;
category?: string;
price?: string;
stock?: number;
}
export default function Books() {
const [items, setItems] = useState<Book[]>([]);
const [form, setForm] = useState({
title: '',
author: '',
isbn: '',
category: '',
price: '',
stock: '',
});
async function load() {
const data = await listBooks();
setItems(data || []);
}
useEffect(() => {
load();
}, []);
function update(k: keyof Book, v: string) {
setForm((f) => ({ ...f, [k]: v }));
}
async function add() {
if (!form.title) return;
await saveBook({
title: form.title,
author: form.author || undefined,
isbn: form.isbn || undefined,
category: form.category || undefined,
price: form.price || '0.00',
stock: form.stock ? Number(form.stock) : 0,
});
setForm({ title: '', author: '', isbn: '', category: '', price: '', stock: '' });
load();
}
async function del(id: string) {
await deleteBook(id);
load();
}
return (
<div style={wrap}>
<div style={card}>
<h2 style={{ margin: 0 }}>图书超市</h2>
<div
style={{
display: 'grid',
gridTemplateColumns: 'repeat(3, minmax(140px, 1fr))',
gap: 8,
margin: '12px 0',
}}
>
<input
value={form.title}
onChange={(e) => update('title', e.target.value)}
placeholder="书名"
style={inputStyle}
/>
<input
value={form.author}
onChange={(e) => update('author', e.target.value)}
placeholder="作者"
style={inputStyle}
/>
<input
value={form.isbn}
onChange={(e) => update('isbn', e.target.value)}
placeholder="ISBN"
style={inputStyle}
/>
<input
value={form.category}
onChange={(e) => update('category', e.target.value)}
placeholder="分类"
style={inputStyle}
/>
<input
value={form.price}
onChange={(e) => update('price', e.target.value)}
placeholder="价格"
style={inputStyle}
/>
<input
value={form.stock}
onChange={(e) => update('stock', e.target.value)}
placeholder="库存"
style={inputStyle}
/>
</div>
<div style={{ display: 'flex', gap: 8 }}>
<button style={btn} onClick={add}>
新增
</button>
<button style={{ ...btn, background: '#2a3340' }} onClick={() => history.back()}>
返回
</button>
</div>
<table style={tableStyle}>
<thead>
<tr>
<th style={th}>书名</th>
<th style={th}>作者</th>
<th style={th}>ISBN</th>
<th style={th}>分类</th>
<th style={th}>价格</th>
<th style={th}>库存</th>
<th style={th}>操作</th>
</tr>
</thead>
<tbody>
{items.map((it) => (
<tr key={it.id}>
<td style={td}>{it.title}</td>
<td style={td}>{it.author}</td>
<td style={td}>{it.isbn}</td>
<td style={td}>{it.category}</td>
<td style={td}>¥{it.price}</td>
<td style={td}>{it.stock}</td>
<td style={td}>
<button style={btnDanger} onClick={() => del(it.id)}>
删除
</button>
</td>
</tr>
))}
{items.length === 0 && (
<tr>
<td style={td} colSpan={7}>
暂无数据
</td>
</tr>
)}
</tbody>
</table>
</div>
</div>
);
}
+64
View File
@@ -0,0 +1,64 @@
import { useEffect, useState } from 'react';
import { useNavigate } from 'react-router-dom';
import { currentUser } from '../api/auth';
import { clearToken } from '../api/request';
import { wrap, card, btnGhost, btn } from './ui';
interface MenuNode {
id: string;
fullName: string;
urlAddress?: string;
icon?: string;
parentId: string;
children: MenuNode[];
}
export default function Dashboard() {
const nav = useNavigate();
const [menu, setMenu] = useState<MenuNode[]>([]);
const [user, setUser] = useState<any>(null);
useEffect(() => {
currentUser()
.then((d) => {
setMenu(d.menuList || []);
setUser(d.userInfo);
})
.catch(() => {});
}, []);
function goto(addr?: string) {
if (addr) nav('/' + addr);
}
function logout() {
clearToken();
location.reload();
}
return (
<div style={wrap}>
<div style={card}>
<h2>SSW JNPF Lite · React</h2>
<div style={{ color: '#9aa7b5' }}>
{user?.userAccount} {user?.isAdministrator ? '(管理员)' : ''}
</div>
<h3 style={{ marginTop: 16 }}>功能菜单</h3>
{menu.map((node) => (
<div key={node.id} style={{ marginBottom: 10 }}>
<div style={{ color: '#9aa7b5', fontSize: 12 }}>{node.fullName}</div>
<div style={{ display: 'flex', gap: 8, flexWrap: 'wrap', marginTop: 4 }}>
{node.children.map((c) => (
<button key={c.id} style={btnGhost} onClick={() => goto(c.urlAddress)}>
{c.fullName}
</button>
))}
</div>
</div>
))}
<button style={{ ...btn, background: '#712b13', marginTop: 12 }} onClick={logout}>
退出
</button>
</div>
</div>
);
}
+101
View File
@@ -0,0 +1,101 @@
import { useEffect, useState } from 'react';
import request from '../api/request';
// 注意:字段用去前缀名(title/status/id),与 JNPF 后端 Jackson 的 f-前缀剥离一致
interface DemoItem {
id: string;
title?: string;
status?: string;
}
export default function DemoItem() {
const [items, setItems] = useState<DemoItem[]>([]);
const [title, setTitle] = useState('');
async function load() {
const data = await request.get('/ssw/demo/DemoItem/List');
setItems(data || []);
}
useEffect(() => {
load();
}, []);
async function add() {
if (!title) return;
await request.post('/ssw/demo/DemoItem/Save', { title, status: '草稿' });
setTitle('');
load();
}
async function del(id: string) {
await request.delete(`/ssw/demo/DemoItem/Delete?id=${id}`);
load();
}
return (
<div style={wrap}>
<div style={card}>
<h2>DemoItem</h2>
<div style={{ display: 'flex', gap: 8 }}>
<input
value={title}
onChange={(e) => setTitle(e.target.value)}
placeholder="标题"
style={input}
/>
<button style={btn} onClick={add}>
新增
</button>
</div>
<ul>
{items.map((it) => (
<li key={it.id} style={{ display: 'flex', gap: 12, alignItems: 'center' }}>
<span>
{it.title}({it.status})
</span>
<button style={{ ...btn, background: '#712b13' }} onClick={() => del(it.id)}>
删除
</button>
</li>
))}
</ul>
<button style={link} onClick={() => history.back()}>
返回
</button>
</div>
</div>
);
}
const wrap: React.CSSProperties = { minHeight: '100vh', padding: 40, background: '#0f1419', color: '#eee' };
const card: React.CSSProperties = {
display: 'flex',
flexDirection: 'column',
gap: 12,
padding: 24,
background: '#1a1f26',
borderRadius: 12,
minWidth: 360,
};
const input: React.CSSProperties = {
padding: 8,
borderRadius: 6,
border: '1px solid #333',
background: '#0f1419',
color: '#eee',
};
const btn: React.CSSProperties = {
padding: 8,
borderRadius: 6,
border: 0,
background: '#185fa5',
color: '#fff',
cursor: 'pointer',
};
const link: React.CSSProperties = {
padding: 8,
background: 'transparent',
border: 0,
color: '#85b7eb',
cursor: 'pointer',
textAlign: 'left',
};
+81
View File
@@ -0,0 +1,81 @@
import { useState } from 'react';
import { useNavigate, useLocation } from 'react-router-dom';
import { login } from '../api/auth';
import { setToken } from '../api/request';
import { encryptPassword } from '../utils/cipher';
export default function Login() {
const [account, setAccount] = useState('admin');
const [password, setPassword] = useState('123456');
const [err, setErr] = useState('');
const nav = useNavigate();
const loc = useLocation();
async function onSubmit(e: React.FormEvent) {
e.preventDefault();
setErr('');
try {
const hex = encryptPassword(password);
const res = await login(account, hex);
setToken(res.token);
const next = (loc.state as any)?.from?.pathname || '/';
nav(next);
} catch (e: any) {
setErr(e.message || '登录失败');
}
}
return (
<div style={wrap}>
<form onSubmit={onSubmit} style={card}>
<h2>SSW JNPF Lite · React</h2>
<input value={account} onChange={(e) => setAccount(e.target.value)} placeholder="账号" style={input} />
<input
value={password}
onChange={(e) => setPassword(e.target.value)}
type="password"
placeholder="密码"
style={input}
/>
{err && <div style={{ color: '#e24b4a' }}>{err}</div>}
<button type="submit" style={btn}>
登录
</button>
<div style={{ fontSize: 12, color: '#888' }}>默认 admin / 123456</div>
</form>
</div>
);
}
const wrap: React.CSSProperties = {
minHeight: '100vh',
display: 'flex',
alignItems: 'center',
justifyContent: 'center',
background: '#0f1419',
color: '#eee',
};
const card: React.CSSProperties = {
display: 'flex',
flexDirection: 'column',
gap: 12,
padding: 24,
background: '#1a1f26',
borderRadius: 12,
width: 300,
};
const input: React.CSSProperties = {
padding: 8,
borderRadius: 6,
border: '1px solid #333',
background: '#0f1419',
color: '#eee',
};
const btn: React.CSSProperties = {
padding: 10,
borderRadius: 6,
border: 0,
background: '#185fa5',
color: '#fff',
cursor: 'pointer',
};
+155
View File
@@ -0,0 +1,155 @@
import { useEffect, useState } from 'react';
import * as api from '../api/sys';
import { wrap, card, btn, btnDanger, btnGhost, input, tableStyle, th, td } from './ui';
export default function MenuManage() {
const [rows, setRows] = useState<any[]>([]);
const [editing, setEditing] = useState<any>(null);
const [form, setForm] = useState({
fullName: '',
urlAddress: '',
parentId: '0',
type: 2,
icon: '',
sortCode: 0,
});
async function load() {
setRows(await api.listModules());
}
useEffect(() => {
load();
}, []);
const nameOf = (id: string) =>
id === '0' ? '(根)' : (rows.find((r) => r.id === id)?.fullName ?? id);
function openEdit(r?: any) {
if (r)
setForm({
fullName: r.fullName,
urlAddress: r.urlAddress || '',
parentId: r.parentId || '0',
type: r.type ?? 2,
icon: r.icon || '',
sortCode: r.sortCode ?? 0,
});
else setForm({ fullName: '', urlAddress: '', parentId: '0', type: 2, icon: '', sortCode: 0 });
setEditing(r || {});
}
async function submit() {
if (!form.fullName) return alert('菜单名必填');
await api.saveModule({ ...form, id: editing?.id });
setEditing(null);
await load();
}
async function del(id: string) {
if (!confirm('确认删除该菜单?')) return;
await api.deleteModule(id);
await load();
}
return (
<div style={wrap}>
<div style={card}>
<h2>菜单管理</h2>
<button style={btn} onClick={() => openEdit()}>
新增菜单
</button>
<table style={tableStyle}>
<thead>
<tr>
<th style={th}>名称</th>
<th style={th}>地址(key)</th>
<th style={th}>上级</th>
<th style={th}>排序</th>
<th style={th}>操作</th>
</tr>
</thead>
<tbody>
{rows.map((r) => (
<tr key={r.id}>
<td style={td}>{r.fullName}</td>
<td style={td}>{r.urlAddress}</td>
<td style={td}>{nameOf(r.parentId)}</td>
<td style={td}>{r.sortCode}</td>
<td style={td}>
<button style={btnGhost} onClick={() => openEdit(r)}>
编辑
</button>{' '}
<button style={btnDanger} onClick={() => del(r.id)}>
删除
</button>
</td>
</tr>
))}
</tbody>
</table>
{editing && (
<div style={{ ...card, marginTop: 16 }}>
<h3>{editing.id ? '编辑' : '新增'}菜单</h3>
<div style={{ display: 'flex', gap: 8, flexWrap: 'wrap' }}>
<input
style={input}
placeholder="菜单名"
value={form.fullName}
onChange={(e) => setForm({ ...form, fullName: e.target.value })}
/>
<input
style={input}
placeholder="地址(key) 如 system/User"
value={form.urlAddress}
onChange={(e) => setForm({ ...form, urlAddress: e.target.value })}
/>
<select
style={input}
value={form.parentId}
onChange={(e) => setForm({ ...form, parentId: e.target.value })}
>
<option value="0">(根)</option>
{rows
.filter((r) => r.id !== editing?.id)
.map((r) => (
<option key={r.id} value={r.id}>
{r.fullName}
</option>
))}
</select>
<select
style={input}
value={form.type}
onChange={(e) => setForm({ ...form, type: +e.target.value })}
>
<option value={1}>目录</option>
<option value={2}>页面</option>
<option value={3}>按钮</option>
</select>
<input
style={input}
placeholder="图标"
value={form.icon}
onChange={(e) => setForm({ ...form, icon: e.target.value })}
/>
<input
style={input}
type="number"
placeholder="排序"
value={form.sortCode}
onChange={(e) => setForm({ ...form, sortCode: +e.target.value })}
/>
</div>
<div style={{ marginTop: 12, display: 'flex', gap: 8 }}>
<button style={btn} onClick={submit}>
保存
</button>
<button style={btnGhost} onClick={() => setEditing(null)}>
取消
</button>
</div>
</div>
)}
</div>
</div>
);
}
+112
View File
@@ -0,0 +1,112 @@
import { useEffect, useState } from 'react';
import * as api from '../api/sys';
import { wrap, card, btn, btnDanger, btnGhost, input, tableStyle, th, td } from './ui';
export default function OrganizeManage() {
const [rows, setRows] = useState<any[]>([]);
const [editing, setEditing] = useState<any>(null);
const [form, setForm] = useState({ fullName: '', parentId: '0' });
async function load() {
setRows(await api.listOrganize());
}
useEffect(() => {
load();
}, []);
const nameOf = (id: string) =>
id === '0' ? '(根)' : (rows.find((r) => r.id === id)?.fullName ?? id);
function openEdit(r?: any) {
if (r) setForm({ fullName: r.fullName, parentId: r.parentId || '0' });
else setForm({ fullName: '', parentId: '0' });
setEditing(r || {});
}
async function submit() {
if (!form.fullName) return alert('机构名必填');
await api.saveOrganize({ ...form, id: editing?.id });
setEditing(null);
await load();
}
async function del(id: string) {
if (!confirm('确认删除该机构?')) return;
try {
await api.deleteOrganize(id);
} catch (e: any) {
return alert(e.message || '删除失败');
}
await load();
}
return (
<div style={wrap}>
<div style={card}>
<h2>机构管理</h2>
<button style={btn} onClick={() => openEdit()}>
新增机构
</button>
<table style={tableStyle}>
<thead>
<tr>
<th style={th}>名称</th>
<th style={th}>上级</th>
<th style={th}>操作</th>
</tr>
</thead>
<tbody>
{rows.map((r) => (
<tr key={r.id}>
<td style={td}>{r.fullName}</td>
<td style={td}>{nameOf(r.parentId)}</td>
<td style={td}>
<button style={btnGhost} onClick={() => openEdit(r)}>
编辑
</button>{' '}
<button style={btnDanger} onClick={() => del(r.id)}>
删除
</button>
</td>
</tr>
))}
</tbody>
</table>
{editing && (
<div style={{ ...card, marginTop: 16 }}>
<h3>{editing.id ? '编辑' : '新增'}机构</h3>
<div style={{ display: 'flex', gap: 8 }}>
<input
style={input}
placeholder="机构名"
value={form.fullName}
onChange={(e) => setForm({ ...form, fullName: e.target.value })}
/>
<select
style={input}
value={form.parentId}
onChange={(e) => setForm({ ...form, parentId: e.target.value })}
>
<option value="0">(根)</option>
{rows
.filter((r) => r.id !== editing?.id)
.map((r) => (
<option key={r.id} value={r.id}>
{r.fullName}
</option>
))}
</select>
</div>
<div style={{ marginTop: 12, display: 'flex', gap: 8 }}>
<button style={btn} onClick={submit}>
保存
</button>
<button style={btnGhost} onClick={() => setEditing(null)}>
取消
</button>
</div>
</div>
)}
</div>
</div>
);
}
+93
View File
@@ -0,0 +1,93 @@
import { useEffect, useState } from 'react';
import { listProducts, saveProduct, deleteProduct } from '../api/product';
import { wrap, card, btn, btnDanger, input as inputStyle, tableStyle, th, td } from './ui';
// 字段用去前缀名:id / title / price(后端 Jackson 会剥掉 f_ 前缀)
interface Product {
id: string;
title?: string;
price?: string;
}
export default function Product() {
const [items, setItems] = useState<Product[]>([]);
const [title, setTitle] = useState('');
const [price, setPrice] = useState('');
async function load() {
const data = await listProducts();
setItems(data || []);
}
useEffect(() => {
load();
}, []);
async function add() {
if (!title) return;
await saveProduct({ title, price: price || '0.00' });
setTitle('');
setPrice('');
load();
}
async function del(id: string) {
await deleteProduct(id);
load();
}
return (
<div style={wrap}>
<div style={card}>
<h2 style={{ margin: 0 }}>产品管理</h2>
<div style={{ display: 'flex', gap: 8, margin: '12px 0' }}>
<input
value={title}
onChange={(e) => setTitle(e.target.value)}
placeholder="产品名称"
style={inputStyle}
/>
<input
value={price}
onChange={(e) => setPrice(e.target.value)}
placeholder="价格"
style={{ ...inputStyle, width: 100 }}
/>
<button style={btn} onClick={add}>
新增
</button>
<button style={{ ...btn, background: '#2a3340' }} onClick={() => history.back()}>
返回
</button>
</div>
<table style={tableStyle}>
<thead>
<tr>
<th style={th}>名称</th>
<th style={th}>价格</th>
<th style={th}>操作</th>
</tr>
</thead>
<tbody>
{items.map((it) => (
<tr key={it.id}>
<td style={td}>{it.title}</td>
<td style={td}>¥{it.price}</td>
<td style={td}>
<button style={btnDanger} onClick={() => del(it.id)}>
删除
</button>
</td>
</tr>
))}
{items.length === 0 && (
<tr>
<td style={td} colSpan={3}>
暂无数据
</td>
</tr>
)}
</tbody>
</table>
</div>
</div>
);
}
+153
View File
@@ -0,0 +1,153 @@
import { useEffect, useState } from 'react';
import * as api from '../api/sys';
import { wrap, card, btn, btnDanger, btnGhost, input, tableStyle, th, td } from './ui';
export default function RoleManage() {
const [rows, setRows] = useState<any[]>([]);
const [modules, setModules] = useState<any[]>([]);
const [editing, setEditing] = useState<any>(null);
const [form, setForm] = useState({ fullName: '', enCode: '', description: '' });
// 授权面板
const [authRoleId, setAuthRoleId] = useState('');
const [checked, setChecked] = useState<string[]>([]);
async function load() {
setRows(await api.listRoles());
setModules(await api.listModules());
}
useEffect(() => {
load();
}, []);
function openEdit(r?: any) {
if (r) setForm({ fullName: r.fullName, enCode: r.enCode || '', description: r.description || '' });
else setForm({ fullName: '', enCode: '', description: '' });
setEditing(r || {});
}
async function submit() {
if (!form.fullName) return alert('角色名必填');
await api.saveRole({ ...form, id: editing?.id });
setEditing(null);
await load();
}
async function del(id: string) {
if (!confirm('确认删除该角色?')) return;
await api.deleteRole(id);
await load();
}
async function openAuth(roleId: string) {
setAuthRoleId(roleId);
const ids = (await api.roleModules(roleId)) || [];
setChecked(ids);
}
async function saveAuth() {
await api.saveRoleModules(authRoleId, checked);
alert('授权已保存');
}
return (
<div style={wrap}>
<div style={card}>
<h2>角色管理</h2>
<button style={btn} onClick={() => openEdit()}>
新增角色
</button>
<table style={tableStyle}>
<thead>
<tr>
<th style={th}>角色名</th>
<th style={th}>编码</th>
<th style={th}>操作</th>
</tr>
</thead>
<tbody>
{rows.map((r) => (
<tr key={r.id}>
<td style={td}>{r.fullName}</td>
<td style={td}>{r.enCode}</td>
<td style={td}>
<button style={btnGhost} onClick={() => openEdit(r)}>
编辑
</button>{' '}
<button style={btnGhost} onClick={() => openAuth(r.id)}>
授权菜单
</button>{' '}
<button style={btnDanger} onClick={() => del(r.id)}>
删除
</button>
</td>
</tr>
))}
</tbody>
</table>
{editing && (
<div style={{ ...card, marginTop: 16 }}>
<h3>{editing.id ? '编辑' : '新增'}角色</h3>
<div style={{ display: 'flex', gap: 8, flexWrap: 'wrap' }}>
<input
style={input}
placeholder="角色名"
value={form.fullName}
onChange={(e) => setForm({ ...form, fullName: e.target.value })}
/>
<input
style={input}
placeholder="编码"
value={form.enCode}
onChange={(e) => setForm({ ...form, enCode: e.target.value })}
/>
<input
style={input}
placeholder="描述"
value={form.description}
onChange={(e) => setForm({ ...form, description: e.target.value })}
/>
</div>
<div style={{ marginTop: 12, display: 'flex', gap: 8 }}>
<button style={btn} onClick={submit}>
保存
</button>
<button style={btnGhost} onClick={() => setEditing(null)}>
取消
</button>
</div>
</div>
)}
{authRoleId && (
<div style={{ ...card, marginTop: 16 }}>
<h3>角色菜单授权({authRoleId})</h3>
<div style={{ display: 'flex', flexDirection: 'column', gap: 6 }}>
{modules.map((m) => (
<label key={m.id}>
<input
type="checkbox"
checked={checked.includes(m.id)}
onChange={(e) =>
setChecked((prev) =>
e.target.checked
? [...prev, m.id]
: prev.filter((x) => x !== m.id),
)
}
/>{' '}
{m.fullName}
<span style={{ color: '#7a8794' }}> ({m.urlAddress})</span>
</label>
))}
</div>
<div style={{ marginTop: 12, display: 'flex', gap: 8 }}>
<button style={btn} onClick={saveAuth}>
保存授权
</button>
<button style={btnGhost} onClick={() => setAuthRoleId('')}>
关闭
</button>
</div>
</div>
)}
</div>
</div>
);
}
+148
View File
@@ -0,0 +1,148 @@
import { useEffect, useState } from 'react';
import * as api from '../api/sys';
import { wrap, card, btn, btnDanger, btnGhost, input, tableStyle, th, td } from './ui';
export default function UserManage() {
const [rows, setRows] = useState<any[]>([]);
const [roleOptions, setRoleOptions] = useState<any[]>([]);
const [editing, setEditing] = useState<any>(null);
const [form, setForm] = useState({
account: '',
realName: '',
password: '',
isAdministrator: false,
roleIds: [] as string[],
});
async function load() {
setRows(await api.listUsers());
setRoleOptions(await api.listRoles());
}
useEffect(() => {
load();
}, []);
function openEdit(r?: any) {
if (r)
setForm({
account: r.account,
realName: r.realName || '',
password: '',
isAdministrator: r.isAdministrator === 1,
roleIds: r.roleIds || [],
});
else setForm({ account: '', realName: '', password: '', isAdministrator: false, roleIds: [] });
setEditing(r || {});
}
async function submit() {
if (!form.account) return alert('账号必填');
await api.saveUser({ ...form, id: editing?.id });
setEditing(null);
await load();
}
async function del(id: string) {
if (!confirm('确认删除该用户?')) return;
await api.deleteUser(id);
await load();
}
return (
<div style={wrap}>
<div style={card}>
<h2>用户管理</h2>
<button style={btn} onClick={() => openEdit()}>
新增用户
</button>
<table style={tableStyle}>
<thead>
<tr>
<th style={th}>账号</th>
<th style={th}>姓名</th>
<th style={th}>角色</th>
<th style={th}>管理员</th>
<th style={th}>操作</th>
</tr>
</thead>
<tbody>
{rows.map((r) => (
<tr key={r.id}>
<td style={td}>{r.account}</td>
<td style={td}>{r.realName}</td>
<td style={td}>{(r.roleNames || []).join(',')}</td>
<td style={td}>{r.isAdministrator === 1 ? '是' : '否'}</td>
<td style={td}>
<button style={btnGhost} onClick={() => openEdit(r)}>
编辑
</button>{' '}
<button style={btnDanger} onClick={() => del(r.id)}>
删除
</button>
</td>
</tr>
))}
</tbody>
</table>
{editing && (
<div style={{ ...card, marginTop: 16 }}>
<h3>{editing.id ? '编辑' : '新增'}用户</h3>
<div style={{ display: 'flex', gap: 8, flexWrap: 'wrap', alignItems: 'center' }}>
<input
style={input}
placeholder="账号"
value={form.account}
onChange={(e) => setForm({ ...form, account: e.target.value })}
/>
<input
style={input}
placeholder="姓名"
value={form.realName}
onChange={(e) => setForm({ ...form, realName: e.target.value })}
/>
<input
style={input}
placeholder="密码(留空不改)"
type="password"
value={form.password}
onChange={(e) => setForm({ ...form, password: e.target.value })}
/>
<label>
<input
type="checkbox"
checked={form.isAdministrator}
onChange={(e) => setForm({ ...form, isAdministrator: e.target.checked })}
/>{' '}
管理员
</label>
<select
multiple
style={input}
value={form.roleIds}
onChange={(e) =>
setForm({
...form,
roleIds: Array.from(e.target.selectedOptions).map((o) => o.value),
})
}
>
{roleOptions.map((r) => (
<option key={r.id} value={r.id}>
{r.fullName}
</option>
))}
</select>
</div>
<div style={{ marginTop: 12, display: 'flex', gap: 8 }}>
<button style={btn} onClick={submit}>
保存
</button>
<button style={btnGhost} onClick={() => setEditing(null)}>
取消
</button>
</div>
</div>
)}
</div>
</div>
);
}
+46
View File
@@ -0,0 +1,46 @@
import { CSSProperties } from 'react';
export const wrap: CSSProperties = {
minHeight: '100vh',
padding: 24,
background: '#0f1419',
color: '#eee',
fontFamily: 'system-ui, sans-serif',
};
export const card: CSSProperties = {
background: '#1a1f26',
borderRadius: 12,
padding: 20,
};
export const btn: CSSProperties = {
padding: '8px 14px',
borderRadius: 6,
border: 0,
background: '#185fa5',
color: '#fff',
cursor: 'pointer',
};
export const btnDanger: CSSProperties = { ...btn, background: '#a1322b' };
export const btnGhost: CSSProperties = { ...btn, background: '#2a3340' };
export const input: CSSProperties = {
padding: 8,
borderRadius: 6,
border: '1px solid #333',
background: '#0f1419',
color: '#eee',
};
export const tableStyle: CSSProperties = {
width: '100%',
borderCollapse: 'collapse',
marginTop: 12,
};
export const th: CSSProperties = {
textAlign: 'left',
padding: '8px',
borderBottom: '1px solid #2a3340',
color: '#9aa7b5',
};
export const td: CSSProperties = {
padding: '8px',
borderBottom: '1px solid #1f2630',
};
+20
View File
@@ -0,0 +1,20 @@
{
"compilerOptions": {
"target": "ES2020",
"useDefineForClassFields": true,
"lib": ["ES2020", "DOM", "DOM.Iterable"],
"module": "ESNext",
"skipLibCheck": true,
"moduleResolution": "bundler",
"allowImportingTsExtensions": true,
"resolveJsonModule": true,
"isolatedModules": true,
"noEmit": true,
"jsx": "react-jsx",
"strict": false,
"noUnusedLocals": false,
"noUnusedParameters": false,
"esModuleInterop": true
},
"include": ["src"]
}
+15
View File
@@ -0,0 +1,15 @@
import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';
export default defineConfig({
plugins: [react()],
server: {
host: '127.0.0.1', // macOS 上 vite 默认只 bind ::1 (IPv6),强制 IPv4 避免 127.0.0.1 被 reset
port: 5173,
strictPort: true, // 端口被占直接报错而不是自动换端口(让 perm-smoke 端口断言稳定)
proxy: {
// 所有 /api 请求转发到 NestJS 后端(30010),与 JNPF 网关代理一致
'/api': 'http://127.0.0.1:30010',
},
},
});