项目介绍
pangza-admin-express 是一套面向后台管理场景的 Express + TypeScript 装饰器框架:用 Controller / Service / Mapper 分层、IoC 注入和统一鉴权,快速搭建管理端 API。
仓库:https://gitee.com/liu-xu-xu/pangza-admin-express
核心能力
| 能力 | 说明 |
|---|---|
| Application 装饰器 | @Controller、HTTP 方法装饰器、参数注入、统一 ResponseData |
| Auth | 类 Sa-Token:多风格 Token / JWT、闲置超时、并发与共享、多端 device、内存/Redis 会话、AuthUtil |
| Validate | DTO 字段规则 + @Validate() 自动校验 |
| Json | @JsonFormat / ObjectMapper / convert |
| Exception | @ControllerAdvice 统一异常 |
| ORM | Entity、BaseMapper、QueryWrapper、字段级 @Select 关联填充 |
| Log | @Log 异步写操作日志 |
| 限流 / 防重 | @RateLimiter、@RepeatSubmit(Redis) |
| 加密传输 | AES 会话密钥 + 请求/响应加解密中间件 |
| 定时任务 | node-cron + ScheduleManager |
| IoC | @Component / @Resource / @Service / @Mapper |
技术栈
后端
- Node.js(CommonJS)+ TypeScript 装饰器
- Express 5、
cors、multer、node-cron - MySQL(自研 ORM)+ Redis
- 自研会话 Token(可接 Redis Store)
前端
目录:pangza-admin-express/pangza-admin-ui/(Vue 管理端)。见 管理端 UI。
适合做什么
- 后台管理 API:用户 / 角色 / 菜单 / 配置 / 日志 / 定时任务 / 微数据工具
- 学习装饰器 + IoC + ORM 在 Express 上的落地
当前阶段
核心框架与主要业务模块已可用。后续重点见 路线图。