ERPTurbo_Poster/README.md

ERPTurbo Poster

基于 Puppeteer 的海报生成服务，支持多种云存储后端。

目录结构

.
├── lib
│   ├── browser.js      # 浏览器管理模块
│   ├── storage.js      # 存储服务模块
│   ├── params.js       # 参数处理模块
│   ├── utils.js        # 工具类模块
│   ├── routes.js       # 路由处理模块
│   └── constants.js    # 常量定义模块
├── .env                # 环境变量配置文件
├── server.mjs           # 主应用入口
└── package.json        # 项目依赖配置

环境变量配置

项目使用 .env 文件配置环境变量，请根据需要修改 .env 文件中的配置项：

# 存储配置
STORAGE_TYPE=local  # 可选值: cos(腾讯云), oss(阿里云), local(本地存储)

# COS 配置 (腾讯云对象存储)
COS_SECRET_ID=
COS_SECRET_KEY=
COS_BUCKET=
COS_REGION=
COS_DOMAIN=

# OSS 配置 (阿里云对象存储)
OSS_REGION=oss-cn-hangzhou
OSS_ACCESS_KEY_ID=
OSS_ACCESS_KEY_SECRET=
OSS_BUCKET=

# 本地存储配置
LOCAL_DOMAIN=http://localhost:3000

# 上传路径配置
UPLOAD_PATH=uploads/posters

安装依赖

npm install

启动服务

npm run dev

接口说明

1. 健康检查接口

• URL: /status
• Method: GET
• Description: 检查服务运行状态

2. 海报生成接口

• URL: /api/v1/poster
• Method: POST
• Description: 生成海报并上传到云存储
• Request Body:

  {
    "webpage": "需要截图的网页URL",
    "device": "设备缩放因子",
    "width": "截图宽度",
    "height": "截图高度",
    "type": "图片类型(png/jpeg)",
    "encoding": "编码方式(binary/base64)"
  }
  

3. PDF下载接口

• URL: /api/v1/pdf
• Method: POST
• Description: 将网页保存为PDF并上传到云存储
• Request Body:

  {
    "webpage": "需要生成PDF的网页URL",
    "device": "设备缩放因子",
    "width": "页面宽度",
    "height": "页面高度",
    "encoding": "编码方式(binary/base64)"
  }
  

模块说明

browser.js

浏览器管理模块，负责:

• 浏览器实例的创建和销毁
• 页面资源的管理和复用
• 浏览器连接的维护

storage.js

存储服务模块，支持:

• 腾讯云COS对象存储
• 阿里云OSS对象存储
• 本地存储
• 统一的上传接口
• 自动根据配置选择存储类型

params.js

参数处理模块，负责:

• 处理截图参数
• 处理上传参数

utils.js

工具类模块，包含:

• 随机字符串生成函数

routes.js

路由处理模块，负责:

• 处理健康检查接口
• 处理海报生成接口
• 处理PDF下载接口

constants.js

常量定义模块，包含:

• 默认配置常量
• 样式定义常量
• HTTP状态码常量
• 字符串常量