新增PDF生成并发设置

docs/deployment-checklist.md

@@ -36,6 +36,7 @@ docker compose exec backend python -m app.cli init-db --admin-username admin --a
 
 - 项目代码已维护，例如 `DBY`、`QSX`。
 - 发证单位名称已确认。
+- 系统设置里的 `PDF 生成并发限制` 已确认，2 核 4G 建议保持默认 `2`。
 - Excel 导入模板已下载并试填。
 - 占位证书模板已确认可临时使用。
 

docs/usage-deployment-manual.md

@@ -44,7 +44,8 @@ reset-local-data.bat
 4. 进入“证书管理”，手动新增证书，支持单张预览、PDF 下载、作废、重置直达链接和导出。
 5. 进入“Excel 导入”，下载模板、上传 Excel、查看校验结果，确认后正式导入。模板只需要填写姓名、手机号、项目代码、发证日期；证书名称、课程名称、阶段名称、发证单位从项目配置自动带出。
    “确认导入”表示把已校验通过的临时数据正式写入学员和证书表。导入记录支持下载原文件、下载错误报告和删除；删除导入记录只删除上传文件、错误报告和批次记录，不删除已经生成的学员和证书。
-6. 进入“操作日志”，查看关键后台操作。日志动作已转成中文显示。
+6. 进入“系统设置”，确认 `PDF 生成并发限制`。2 核 4G 服务器建议保持默认值 `2`。
+7. 进入“操作日志”，查看关键后台操作。日志动作已转成中文显示。
 
 ## 公开查询流程
 
@@ -62,6 +63,8 @@ PDF 由服务端按需生成，并使用 30 天缓存。这样可以保证模板
 
 后台 PDF 下载不能用简单的 `window.location` 直接跳转，因为后台接口需要登录态。如果直接打开下载地址，浏览器不会自动带上前端保存的 Authorization token，容易出现下载失败。当前后台已改为通过带 token 的请求下载 blob 文件，再在浏览器里保存。
 
+首次生成 PDF 会占用 CPU。后台“系统设置”里的 `PDF 生成并发限制` 默认是 `2`，用于防止多人同时首次下载 PDF 时把 2 核 4G 服务器打满。前端下载和预览时会显示“PDF正在排队或生成”，避免用户误以为页面卡死。
+
 ## 正式部署准备
 
 - Linux 服务器，建议 2 核 4G 起步。

docs/正式部署操作手册.md

@@ -394,6 +394,7 @@ docker compose exec backend python -m app.cli init-db --admin-username admin --a
 - 创建基础角色。
 - 创建默认管理员。
 - 初始化默认项目配置。
+- 初始化系统设置，`PDF 生成并发限制` 默认值为 `2`。
 
 以后升级代码时，一般执行：
 

docs/阿里云正式部署详细操作手册.md

@@ -367,6 +367,7 @@ docker compose exec backend python -m app.cli init-db --admin-username admin --a
 - 创建基础角色。
 - 创建默认管理员。
 - 初始化默认项目配置。
+- 初始化系统设置，`PDF 生成并发限制` 默认值为 `2`。
 
 如果后续只是升级代码，一般执行：