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

1.7 KiB

basic-admin demo

零外部依赖的 Shrimp demo,只用内存 CRUD,不依赖 MongoDB。

证明:Shrimp 的核心(模块注册 / RPC dispatch / 字段配置)在没有 mongoose、没有 JWT、没有用户表的情况下也能跑。

起服务

从 demo 目录起(本地链 shrimp-server):

cd examples/basic-admin
npm install
npm start

或者从仓库根目录直接 npm run demo(由根 package.json 提供)。

服务起在 http://localhost:3100。

试一下

# 列商品
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"这条路径