Metadata-Version: 2.5
Name: pdfwright-web
Version: 0.2.0
Summary: pdfwright 的无状态 Web 服务：可视化配置编辑器 + HTML/PDF 预览 + 对外渲染 API（不存储任何数据与内容）
License: Proprietary
Requires-Python: >=3.12
Requires-Dist: fastapi>=0.115
Requires-Dist: pdfwright>=0.2.0
Requires-Dist: pydantic>=2.9
Requires-Dist: python-multipart>=0.0.9
Requires-Dist: uvicorn>=0.30
Description-Content-Type: text/markdown

# pdfwright-web — 无状态 Web 服务

为 pdfwright 提供的配置 / 预览 / 对外渲染服务：

- **不存储任何数据与内容**（无数据库、无文件持久化），外部传入 JSON，回传 PDF / HTML / 校验结果。
- 提供可视化配置编辑器（Vue3 + TS + Element Plus 前端，构建产物内嵌于本包）。
- 依赖基础库 [`pdfwright`](../pdfwright/)。

## 启动

```bash
uv run uvicorn pdfwright_web.app:app --host 0.0.0.0 --port 8765
```

## API（骨架规划）

| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/validate | schema 校验（返回错误列表） |
| POST | /api/render/html | schema + data → HTML 预览 |
| POST | /api/render/pdf | schema + data → PDF 二进制 |
| GET | /api/meta/components | 组件注册表（编辑器调色板/属性面板驱动） |
| POST | /api/options/fetch | 接口选项代理（动态下拉，解决 CORS） |
| POST | /api/convert/docx | DOCX → schema（高保真 + 自动字段 key） |
| POST | /api/convert/xlsx | Excel → schema |

详细实现见后续迭代（当前为骨架）。