Files
liandong-crm/README.md
T
luishouandClaude Opus 4.8 5d46afe439 feat: 联动支付 CRM 后台(Next.js + TS + Prisma 重构)
从旧 Laravel 5.7 重构为现代技术栈,对接现有 MySQL。

- 技术栈: Next.js 15 App Router + TypeScript + Prisma + Auth.js + Tailwind v4
- 认证: 复用旧库 admins 的 bcrypt 密码,Auth.js Credentials
- 客户管理: 列表(搜索/报单区间/分页)、增改删、Excel 导入导出
- 生日提醒: 阴阳历(lunar-typescript),口径对齐旧 overtrue 库
- RBAC: 管理员/角色/权限(菜单树) 完整 CRUD + 分配
- 控制台: 统计卡 + 月度新增报单柱状图
- 个人中心: 改昵称/改密码
- 现代 CMS 界面 + 联动支付品牌(logo/登录/底部/icon)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-08 15:02:03 +08:00

54 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 同区,无跨境延迟。