Papermake - Máy chủ tạo tài liệu PDF tự host dựa trên Typst

Papermake là máy chủ tạo tài liệu dựa trên HTTP để tạo PDF bằng các mẫu Typst.

Mục đích

• Quản lý tập trung các mẫu Typst
• Tạo PDF thông qua REST API
• Quản lý phiên bản mẫu
• Quản lý lịch sử tạo (Audit Trail)
• Cung cấp kho lưu trữ mẫu tương tự Docker Registry

Tính năng chính

• Mẫu được quản lý như mã (Templates as Code)
  • Mẫu hỗ trợ cả phiên bản bất biến (Immutable) và thẻ có thể thay đổi (Mutable).
  • Ví dụ, invoice:v1.0.0 sau khi được tạo sẽ không thay đổi, còn invoice:latest có thể được cập nhật để trỏ tới phiên bản mới nhất.
• Kết xuất phía máy chủ (Server-side Rendering)
  • Không cần cài Typst trong môi trường client.
  • Chỉ cần gọi HTTP API là máy chủ sẽ kết xuất PDF và trả về.
• Kho lưu trữ định địa chỉ theo nội dung (Content-addressable Storage)
  • Mẫu được lưu trữ dựa trên hàm băm SHA-256.
  • Các mẫu giống nhau sẽ không bị lưu trùng lặp, giúp quản lý dung lượng lưu trữ hiệu quả theo cách tương tự Git.
• Audit Trail đầy đủ
  • Với mọi tác vụ kết xuất, hệ thống ghi lại hàm băm của dữ liệu đầu vào và kết quả đầu ra.
  • Có thể truy vết chính xác mọi PDF đã tạo được sinh ra từ mẫu nào và dữ liệu nào.
• Tự host (Self-hostable)
  • Có thể tự xây dựng và vận hành chỉ với một file thực thi duy nhất viết bằng Rust, bộ nhớ đối tượng tương thích S3 và ClickHouse.