Files
shrimp-server/examples/basic-admin/README.md
T
wc24 8548a1760a init: 从 cs-hand/hand-server-2/lib/shrimp 抽出独立仓
- 6 个框架源文件搬到 src/, 加 src/index.ts barrel 作为公共 API 入口
- package.json 标 private, main/types 指 src/index.ts (ts-node 消费方编译)
- 加 vitest + 22 条单元测试 (ILabel / MemoryShrimpCrud) 全通过
- examples/basic-admin/ 用 MemoryShrimpCrud 跑零 Mongo 依赖 demo

待办: ShrimpServer 强耦合 Mongo+JWT+Express, crudRegistry 用
.model 判断数据源, 这两个问题在 demo 中已暴露, 计划后续重构补到 90 分。
2026-05-23 15:07:55 +08:00

53 lines
1.7 KiB
Markdown

# basic-admin demo
零外部依赖的 Shrimp demo,**只用内存 CRUD,不依赖 MongoDB**。
证明:Shrimp 的核心(模块注册 / RPC dispatch / 字段配置)在没有 mongoose、没有 JWT、没有用户表的情况下也能跑。
## 起服务
从 demo 目录起(本地链 shrimp-server):
```sh
cd examples/basic-admin
npm install
npm start
```
或者从仓库根目录直接 `npm run demo`(由根 package.json 提供)。
服务起在 `http://localhost:3100`。
## 试一下
```sh
# 列商品
curl -s -X POST http://localhost:3100/api/product/list \
-H 'content-type: application/json' -d '[{}]' | jq
# 列标签
curl -s -X POST http://localhost:3100/api/tag/list \
-H 'content-type: application/json' -d '[{}]' | jq
# 新增商品
curl -s -X POST http://localhost:3100/api/product/add \
-H 'content-type: application/json' \
-d '[{"code":"P003","name":"橙子","price":4,"tagIds":[]}]' | jq
# 改某个商品
curl -s -X POST http://localhost:3100/api/product/edit \
-H 'content-type: application/json' -d '["1",{"price":99}]' | jq
# 删除商品
curl -s -X POST http://localhost:3100/api/product/delete \
-H 'content-type: application/json' -d '["1"]' | jq
```
请求体永远是参数数组,按位置传给事件 handler。
## 这个 demo 暴露了哪些 70→90 的问题
- **`Shrimp.ts:322` 的 `if ((dataSource as any).model)`** 让 MemoryShrimpCrud 不能注册到 `crudRegistry`,relation populate 自动联表对内存数据源不生效
- **没有现成的 RPC mount helper** — 这段 `app.post("/api/*splat", ...)` 应该是框架提供的,而不是 demo 里手写
- **要登录 / 鉴权要么自己写,要么用 ShrimpServer 强吃 Mongo+JWT**,中间没有"我只想要 RPC + 模块,自己接 auth"这条路径