54 lines
2.9 KiB
Markdown
54 lines
2.9 KiB
Markdown
# CRM 后台重构(Next.js + TypeScript + Prisma)
|
||||
|
|
|
|||
|
|
老 Laravel 5.7 CRM 的重构版。当前对接测试库 `crm_dev`(数据已清洗:`birthday`/`report_date`
|
|||
|
|
已转为 `date` 类型,原始脏值保留在 `birthday_raw`/`report_date_raw` 备份列)。
|
|||
|
|
|
|||
|
|
## 技术栈
|
|||
|
|
- Next.js 15(App Router)+ React 19 + TypeScript
|
|||
|
|
- Prisma 6(映射现有 MySQL,物理表结构不动)
|
|||
|
|
- Auth.js v5(Credentials,复用老库 `admins` 的 Laravel bcrypt 密码)
|
|||
|
|
- Tailwind CSS v4 + 精简自绘 UI 组件
|
|||
|
|
|
|||
|
|
## 本次已输出
|
|||
|
|
```
|
|||
|
|
prisma/schema.prisma 映射 customers / admins / roles / permissions / spatie 关联表
|
|||
|
|
src/lib/{prisma,auth,utils}.ts Prisma 客户端、Auth.js、cn 工具
|
|||
|
|
src/middleware.ts 未登录拦截
|
|||
|
|
src/app/login 登录页
|
|||
|
|
src/app/(dashboard)/ 后台布局 + 侧边栏 + 控制台
|
|||
|
|
src/app/(dashboard)/customers/ 客户管理:列表(搜索/时间区间/分页) + 增改删
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 启动步骤
|
|||
|
|
```bash
|
|||
|
|
cd crm-new
|
|||
|
|
npm install
|
|||
|
|
cp .env.example .env # 填入真实 DATABASE_URL 与 AUTH_SECRET
|
|||
|
|
npx prisma db pull # (可选)从现有库反射校准 schema
|
|||
|
|
npx prisma generate
|
|||
|
|
npm run dev # http://localhost:3000
|
|||
|
|
```
|
|||
|
|
> 用老库任一后台账号(`admins` 表)即可登录,密码原样有效。
|
|||
|
|
|
|||
|
|
## 功能清单(已全部实现并对接 crm_dev 真实数据验证)
|
|||
|
|
- ✅ 现代化 CMS 界面:深色侧边栏 + 顶栏用户菜单 + 统一设计系统 + Toast 提示
|
|||
|
|
- ✅ 登录:老账号 `$2y$` bcrypt 密码由 bcryptjs 直接校验,会话 + RBAC 角色加载
|
|||
|
|
- ✅ 仪表盘:客户总数 / 本月新增 / 今日生日 / 账号数 统计 + 最近报单
|
|||
|
|
- ✅ 客户管理:列表(搜索 / 报单区间 / 分页)、新增、编辑、软删除
|
|||
|
|
- ✅ 生日提醒:阴阳历(`lunar-typescript`,口径与老 overtrue 库一致),当天 / 未来7天
|
|||
|
|
- ✅ Excel 导入 / 导出(SheetJS),导出→导入闭环 12/12 列对齐
|
|||
|
|
- ✅ RBAC:管理员 CRUD + 分配角色、角色 CRUD + 分配权限(复选树)、权限菜单树 CRUD
|
|||
|
|
- ✅ 个人中心:改昵称 + 改密码(校验原密码)
|
|||
|
|
- ✅ 生产构建通过(20 路由),全部页面运行时 200 + 真实数据渲染
|
|||
|
|
|
|||
|
|
## 尚未实现(后续可选)
|
|||
|
|
- [ ] 权限码级别的按钮/菜单动态控制(当前 RBAC 数据齐全,未做前端按钮级隐藏)
|
|||
|
|
- [ ] 废表清理:`users` / `sms` / `customers_copy` / `admin_customer`
|
|||
|
|
|
|||
|
|
> 注:开发时本机跨区连腾讯云 DB 偶发 `MySQL server has gone away`(网络抖动),
|
|||
|
|
> 生产部署与 DB 同区不受影响。如需可在 `DATABASE_URL` 加连接池参数缓解。
|
|||
|
|
|
|||
|
|
## 部署(腾讯云,与 DB 同区)
|
|||
|
|
`next.config.ts` 已开启 `output: "standalone"`,构建后用 PM2 或 Docker 运行 `node .next/standalone/server.js`,
|
|||
|
|
Nginx 反代即可。应用与 MySQL 同区,无跨境延迟。
|