Files
shrimp-server/examples/basic-admin/index.ts
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

90 lines
3.6 KiB
TypeScript

/**
* Shrimp basic-admin demo
*
* 用 MemoryShrimpCrud 跑一个零依赖的 admin server,展示:
* - Shrimp 核心(模块注册 / RPC dispatch / 权限树)
* - ShrimpTableModule + MemoryShrimpCrud 的 CRUD 自动事件
* - 通过 Express 暴露成 HTTP RPC
*
* 不使用 ShrimpServer/Mongoose/JWT,刻意暴露 ShrimpServer 把太多东西耦合在
* Express+Mongo+Auth 一起的事实,作为后续重构的对照样本。
*/
import express from "express"
import {
Shrimp,
ShrimpTableModule,
MemoryShrimpCrud,
ShrimpFieldTypes,
ShrimpError,
ShrimpCode,
} from "shrimp-server"
import type { IFieldConfig, WithId } from "shrimp-server"
interface ITag { _id: string; name: string }
interface IProduct { _id: string; code: string; name: string; price: number; tagIds: string[] }
const tagFields: IFieldConfig[] = [
{ key: "name", label: "标签名", type: ShrimpFieldTypes.String, required: true, searchable: true },
]
const productFields: IFieldConfig[] = [
{ key: "code", label: "编码", type: ShrimpFieldTypes.String, required: true, editable: "addOnly" },
{ key: "name", label: "名称", type: ShrimpFieldTypes.String, required: true, searchable: true },
{ key: "price", label: "价格", type: ShrimpFieldTypes.Number, required: true },
{
key: "tagIds", label: "标签", type: ShrimpFieldTypes.Relation,
relation: { moduleKey: "tag", labelKey: "name" }, multiple: true, defaultValue: [],
},
]
async function bootstrap() {
const shrimp = new Shrimp()
const tagCrud = new MemoryShrimpCrud<WithId<ITag>>()
new ShrimpTableModule(shrimp, "tag", tagCrud, tagFields, "标签管理").initCrud()
const productCrud = new MemoryShrimpCrud<WithId<IProduct>>()
new ShrimpTableModule(shrimp, "product", productCrud, productFields, "商品管理").initCrud()
// 种子数据
const t1 = await tagCrud.add({ name: "热门" } as any)
const t2 = await tagCrud.add({ name: "促销" } as any)
await productCrud.add({ code: "P001", name: "苹果", price: 5, tagIds: [t1._id] } as any)
await productCrud.add({ code: "P002", name: "香蕉", price: 3, tagIds: [t1._id, t2._id] } as any)
const app = express()
app.use(express.json())
// 简化的 RPC dispatch: POST /api/<...path> body 是参数数组
app.post(/^\/api\/.+/, async (req, res) => {
const path = req.path.replace(/^\/api\//, "").split("/").filter(Boolean)
const args = Array.isArray(req.body) ? req.body : []
try {
const data = await shrimp.call(path, ...args)
res.json({ code: ShrimpCode.OK, data })
} catch (e: any) {
if (e instanceof ShrimpError) {
res.json({ code: e.code, tip: e.tip })
} else {
console.error(e)
res.json({ code: ShrimpCode.SERVER_ERROR, log: String(e?.message || e) })
}
}
})
const port = 3100
app.listen(port, () => {
console.log(`Shrimp basic-admin demo: http://localhost:${port}`)
console.log("")
console.log("# 试试:")
console.log(` curl -s -X POST http://localhost:${port}/api/product/list -H 'content-type: application/json' -d '[{}]' | jq`)
console.log(` curl -s -X POST http://localhost:${port}/api/tag/list -H 'content-type: application/json' -d '[{}]' | jq`)
console.log(` curl -s -X POST http://localhost:${port}/api/product/add -H 'content-type: application/json' -d '[{"code":"P003","name":"橙子","price":4,"tagIds":[]}]' | jq`)
})
}
bootstrap().catch(err => {
console.error("bootstrap failed:", err)
process.exit(1)
})