Files
liandong-crm/DEPLOY.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

173 lines
4.6 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 15 + Prisma + MySQL)生产部署指南。应用与数据库部署在**同一地域**,避免跨区延迟。
---
## 一、服务器要求
| 项 | 要求 |
|---|---|
| 系统 | 腾讯云 CVM / 轻量应用服务器(CentOS / Ubuntu 均可) |
| Node | **18.18+ / 20 LTS**(推荐 20) |
| 内存 | ≥ 2G |
| 数据库 | MySQL 5.7+(当前自建 `124.223.187.95`),与应用**同地域** |
| 端口 | 应用监听 `3100`,由 Nginx 反代到 80/443 |
安装 Node(以 nvm 为例):
```bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 20 && nvm use 20
npm i -g pm2
```
---
## 二、环境变量
在项目根目录建 `.env`(**不要提交到 git**):
```bash
# 生产数据库(建议 crm,不是 crm_dev);带连接池参数缓解远程断连
DATABASE_URL="mysql://用户:密码@数据库内网IP:3306/crm?connection_limit=10&pool_timeout=20&connect_timeout=15"
# 会话密钥:openssl rand -base64 32
AUTH_SECRET="<生成的随机串>"
# 生产站点地址(必须设为真实域名/IP)
AUTH_URL="https://crm.yourdomain.com"
```
> 同地域内网连库(内网 IP)比公网更快更稳。若仍偶发 `server has gone away`,已由上面的连接池参数缓解。
---
## 三、部署方式 A:PM2(推荐,简单)
```bash
# 1. 拉代码
git clone <仓库地址> /var/www/crm && cd /var/www/crm
# 2. 装依赖 + 生成 Prisma Client
npm ci
npx prisma generate
# 3. 构建
npm run build
# 4. 用 PM2 启动(读取 .env,监听 3100)
pm2 start npm --name crm -- start
pm2 save # 保存进程列表
pm2 startup # 生成开机自启(按提示执行输出的命令)
```
常用运维:
```bash
pm2 logs crm # 看日志
pm2 restart crm # 重启
pm2 status # 状态
```
---
## 四、部署方式 B:Docker(standalone)
**先启用 standalone 产物** —— 打开 `next.config.ts`,取消注释:
```ts
output: "standalone",
```
`Dockerfile`:
```dockerfile
FROM node:20-alpine AS deps
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npx prisma generate && npm run build
FROM node:20-alpine AS runner
WORKDIR /app
ENV NODE_ENV=production
# standalone 产物 + 静态资源(关键:必须拷贝 static 与 public,否则样式丢失)
COPY --from=deps /app/.next/standalone ./
COPY --from=deps /app/.next/static ./.next/static
COPY --from=deps /app/public ./public
EXPOSE 3100
ENV PORT=3100
CMD ["node", "server.js"]
```
构建运行:
```bash
docker build -t crm .
docker run -d --name crm -p 3100:3100 --env-file .env crm
```
> ⚠️ standalone 模式必须手动拷贝 `.next/static` 和 `public`,否则页面 HTML 出来但 CSS/JS 404("样式没了")。本地开发不要开 standalone。
---
## 五、Nginx 反向代理
`/etc/nginx/conf.d/crm.conf`:
```nginx
server {
listen 80;
server_name crm.yourdomain.com;
client_max_body_size 20m; # 允许 Excel 上传
location / {
proxy_pass http://127.0.0.1:3100;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
```
```bash
nginx -t && nginx -s reload
```
HTTPS 建议用腾讯云免费证书或 certbot 配置 443。
---
## 六、数据库准备
生产库结构与 `crm_dev` 一致(`customers`/`admins`/`roles`/`permissions` 等)。Prisma 采用**映射现有库**、不建表:
```bash
# 首次可校准 schema 与现有库一致(可选)
npx prisma db pull
npx prisma generate
```
> Prisma 不会改动生产表结构。日期字段清洗(`*_raw`)等历史处理为独立步骤,与部署无关。
---
## 七、更新与回滚
```bash
# 更新
cd /var/www/crm
git pull
npm ci && npx prisma generate && npm run build
pm2 restart crm
# 回滚(切到上个提交后重建重启)
git checkout <上个commit>
npm run build && pm2 restart crm
```
---
## 八、常见问题
| 现象 | 原因 / 解决 |
|---|---|
| 页面没样式 | standalone 模式没拷贝 `.next/static` 与 `public`;或本地误开了 `output: standalone` |
| 登录报 Configuration / PrismaClientInitializationError | 连不上数据库:检查 `DATABASE_URL`、内网连通、连接池参数 |
| 上传 Excel 失败 | Nginx `client_max_body_size` 太小;应用侧已放宽到 10mb |
| 老账号登不上 | 无需处理,`$2y$` bcrypt 密码由应用直接校验,原样可登录 |
| 退出/跳转到错误端口 | 生产必须设 `AUTH_URL` 为真实域名 |