在线文档格式转换系统是一套基于第三方转换 API 二次开发的在线文档处理平台，覆盖 PDF、Word、Excel、PPT、图片与常见电子书等三十余种格式的互转需求。系统由四个服务模块组成：后端 API 服务、管理后台、H5 移动端与 PC 桌面端，数据库使用 MySQL，前后端分离、可独立上线运营，也便于在此基础上继续扩展新格式与商业能力。
支持哪些文档格式互转？
系统格式能力分为三大类：
| 类别 | 格式范围 |
|---|---|
| PDF 转其他 | Word、Excel、PPT、图片（PNG/JPG/GIF 等）、HTML、纯文本、PDF/A 标准格式、AZW3 电子书 |
| 其他转 PDF | Word、Excel、PPT、图片、CAD、OFD、CAJ、TXT、RTF、ODT/ODS/ODP、EPUB、AZW3、EPS、Markdown |
| 其他互转 | Word 转文本、Excel 转文本、Markdown 转文本、Word 转 Markdown、Markdown 转 Word、文本转 Word、Excel 转 CSV |
另有几项常用高频能力被单独做成完整功能：图片批量转 PDF（一次最多 20 张，支持拖拽排序、页面大小 A3/A4/Letter/原尺寸、方向与边距设置、合并或逐张生成）、PDF 转多张图片（每页独立成图，可设输出格式与 DPI）、通过文件 URL 直接创建转换任务，以及基于 MD5 的文件去重秒传。
一次文档转换是如何完成的？
核心转换流程由七个环节组成：前端选择格式并上传文件 → 后端存储到服务器 upload/sources 目录 → 计算文件 MD5 命中已转换记录则直接返回结果（不消耗配额）→ 校验用户剩余配额与并发任务数（默认同时 3 个）→ 调用第三方转换 API 创建任务并入库为处理中 → 后端以 1 秒间隔轮询任务状态（单请求内上限 30 秒，超时转后台持续轮询），前端同步展示进度条 → 完成后下载结果到 uploads/results 并扣减配额，失败则不扣减、已扣自动退还。
用户与配额体系如何设计？
系统定义四类角色：普通用户、VIP 用户、管理员与超级管理员。注册支持用户名+密码+图形验证码；登录采用 JWT 双 Token 机制，access_token 2 小时、refresh_token 7 天，支持无感续期；登录注册行为记录 IP、客户端类型与结果。
配额规则：新用户赠送 10 次，每次成功转换消耗 1 个配额；VIP 配额为不限次数；游客每日可转 2 次（按 IP 限制）。配额扣减用数据库行锁保证原子性，管理员可单个或批量调整。另有忘记密码（邮箱验证码三步重置）、个人中心（资料/头像/配额/VIP 到期时间）、多端登录控制（可配单一设备登录使旧 Token 失效）与单用户并发任务数限制。
内容与运营管理支持哪些能力？
平台内置内容体系支撑日常运营：
- 文章系统：使用指南、常见问题、公告通知、教程四类；富文本编辑器图文混排，详情自动累加浏览量，支持分类筛选与搜索。
- 公告系统：通知/更新/维护三类，可设生效起止时间，支持置顶与首页轮播条展示，仅有效期内的公告对用户可见。
- 预置内容：附带”如何使用 PDF 转 Word""图片转 PDF 教程""转换失败怎么办""配额计算规则""如何成为 VIP”等示例文章，便于上线即用。
管理后台提供哪些管理能力？
管理后台按菜单组织，覆盖运营全链路：仪表盘（今日转换数、用户增长、转换趋势折线图、格式占比饼图、成功率/失败率、日活周活月活、第三方 API 调用统计与配额告警）；用户管理（搜索筛选、角色与状态调整、配额调整、启用禁用、强制下线）；任务管理（多维筛选、详情弹窗、在线预览源/结果文件、重试失败任务、CSV 导出）；文章与公告管理；格式配置管理（每条格式可配任务类型、图标、描述、算粒数、大小上限、热门标记与排序，控制前端展示）；系统配置（站点信息、注册开关、默认配额、API Key/Endpoint、文件保留天数、告警阈值、JWT 密钥等，变更留审计）；管理员账号管理（超管可见）、文件管理（类型/空间统计、过期清理、孤立文件一键清理）、数据备份导出与操作/登录日志检索。
H5 与 PC 双端分别有哪些能力？
H5 移动端采用底部三栏导航（首页/历史/我的）：首页 Banner 与格式卡片按近期使用和热门优先排列；转换页支持上传进度、类型即时校验、PDF/图片在线预览、加密密码与页面范围、转换进度条、结果下载、浏览器推送通知与二维码分享；图片批量转 PDF 支持拖拽排序与页面设置；转换历史支持下拉刷新、上拉分页、失败重试与删除。
PC 桌面端采用顶部导航布局：首页按三大格式类分组并标记热门；转换工作台左侧格式面板（近期使用置顶、可搜索），右侧拖拽上传与在线预览；支持多文件批量上传批量转换并打包 ZIP 下载、单文件失败重试；转换历史表格支持状态/格式/时间筛选与批量下载/批量删除；帮助中心与公告中心分类导航。个人中心为左侧菜单布局，可生成邀请二维码。
后端核心机制有哪些保障？
- 任务状态机：2 准备中→3 等待中→4 处理中→1 完成，及 -1 失败/-2 上传失败/-3 下载失败/-8 处理超时，单向流转不回退；失败任务可重试（上限 3 次）。
- 崩溃恢复：服务启动时扫描处理中的任务重新发起 API 轮询，重启不丢任务；定时器持续兜底。
- 定时任务：每 5 分钟标记超时任务（创建超 30 分钟仍处理中）、执行 API 健康检查（连续 3 次失败置为不可用并在前端提示）；每小时清理过期文件（结果默认保留 7 天、源文件 30 天）。
- 并发与安全：前端防重复提交、同文件同格式 5 分钟内幂等、单用户并发上限、事务+SELECT FOR UPDATE 行锁、密码 bcrypt 加密、MIME+扩展名校验上传（上限 100MB）、参数化查询防注入、富文本过滤防 XSS、资源按用户隔离、接口限流（登录 5 次/分、转换 10 次/分）。
- 数据设计：共 10 张表（用户、转换任务、文件、文章、系统配置、操作日志、格式配置、公告、登录日志、配置变更日志），均带索引，SQL 内置示例数据（7 个账号、32 种格式、11 篇文章、3 条公告）。
若你正在搭建文档处理类站点或需要接口二次开发参考，本系统是结构完整的起步模板。更多工具类系统可浏览在线工具与 SaaS 服务栏目。