鲜选商城(Fresh Select)— 全栈电商管理平台
核心职责与技术亮点
1. Monorepo 架构与工程化体系搭建
使用 pnpm Workspace 管理 admin、mobile、server、packages/types、packages/utils 五个子包,通过 workspace 协议实现跨包依赖共享
配置 Husky + Commitlint + lint-staged 提交拦截链路,确保代码质量;引入 Playwright 实现核心流程 E2E 测试覆盖
Vite 构建环节集成 vite-plugin-compression Gzip 压缩 + rollup-plugin-visualizer 打包分析,Element Plus(~292KB gzipped)、ECharts(~295KB gzipped)独立分包,按需加载
2. RBAC 权限体系与动态路由
后端实现 User → UserRole ← Role ← permissions 模型,通过自定义 @Permissions() 装饰器 + PermissionsGuard 守卫,结合 Reflector + JwtService 实现接口级权限拦截,支持通配符 * 超级权限
前端基于 Pinia permission store 存储当前用户权限列表,登录后调用 generateRoutes() + router.addRoute() 动态注入路由;v-permission 指令实现按钮级元素显隐控制
3. 高性能通用组件设计
ProTable:Schema 驱动的高级表格组件,内置搜索筛选、分页、批量选择、Excel 导出(xlsx)、Tag 状态映射、图片预览等能力,单组件服务 15+ 业务列表页
ProForm:配置化高级表单,支持校验规则联动、异步选项加载、提交防重复点击
useTable / useForm / usePermission composables:封装通用数据请求、表单提交逻辑,消除 80% 重复样板代码
4. Prisma ORM 数据层重构与性能优化
从内存数组 Mock 全量迁移至 Prisma v6 + SQLite,定义 17 个数据模型(User、Role、Menu、Product、Order、Coupon 等),利用 Prisma 自动生成类型消除全项目 any 类型(后端零 any,前端通过 @fresh/types 共享类型)
手写 enrichRoles / enrichCategories 批量关联逻辑,通过 Map 预加载避免 N+1 查询,将角色列表接口关联查询从 O(n×m) 优化至 O(n+m)
5. 移动端多端适配
UniApp 一套代码同时产出 H5 和微信小程序,集成 china-division 实现地址三级联动,Pinia 管理购物车 / 用户 / 地址状态
Skeleton 骨架屏 + 图片懒加载,优化弱网体验
6. 全局监控与主题定制
实现全局错误监控面板:通过 app.config.errorHandler + window.onerror + unhandledrejection 捕获 Vue 组件 / Promise / 资源加载三类异常,Navbar 铃铛图标实时展示
ThemeSwitcher 支持亮色/暗色主题切换 + 自定义主题色变量注入