ERPTurbo_Poster/openspec/changes/add-cors-and-api-prefix-config/proposal.md
shenyifei dc940d2598 feat(api): 添加海报和PDF生成功能
- 新增海报生成接口,支持从网页URL或HTML内容生成海报图像
- 新增PDF生成接口,支持从网页URL或HTML内容生成PDF文档
- 添加Swagger API文档注释,完善接口描述和参数说明
- 实现HTML内容参数支持,允许直接传入HTML结构生成海报/PDF
- 添加输入验证和标准化响应格式
- 引入DOMPurify库对HTML内容进行安全过滤
- 更新环境变量配置,支持API密钥认证和CORS设置
- 优化上传逻辑,统一返回标准响应结构
- 添加构建脚本支持Docker镜像打包和推送
2025-11-20 17:51:35 +08:00

794 B
Raw Permalink Blame History

Change: 添加跨域配置和API前缀可配置功能

Why

当前项目缺乏跨域资源共享(CORS)配置限制了前端应用在不同域名下的访问能力。同时API路径前缀硬编码为/api/v1/,缺乏灵活性,无法根据不同部署环境或版本管理需求进行调整。

What Changes

  • 添加CORS中间件配置支持可配置的跨域访问策略
  • 添加API前缀配置功能允许通过环境变量自定义API路径前缀
  • 在.env.example中添加相关配置项
  • 更新服务器启动代码以应用新配置

Impact

  • Affected specs: server-config (新增)
  • Affected code: server.mjs, .env.example
  • BREAKING: API端点路径将发生变化如果配置了不同的前缀
  • 增强了项目的部署灵活性和安全性配置能力