report_generator.hpp

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 Povl Filip Sonne-Frederiksen
//
// SPDX-License-Identifier: GPL-3.0-or-later
 
#pragma once
 
// Server-side PDF generation for Ressourcekortlægning (#456).
//
// The generator assembles material passports, column definitions and thumbnail
// blobs from a ProjectDB, writes them to a temporary directory alongside the
// embedded Typst template, and invokes `typst compile` as a subprocess. The
// resulting PDF bytes are returned so the caller can store them in the DB and
// serve them over HTTP.
//
// Requires `typst` to be present in PATH at runtime. The devshell gains it via
// `pkgs.typst` in shell.nix; in production supply it in the process's PATH.
 
#include <cstdint>
#include <optional>
#include <vector>
 
namespace reusex {
 
class ProjectDB;

std::vector<std::uint8_t> generate_ressourcekortlaegning_pdf(
    ProjectDB &db,
    std::optional<std::int64_t> resource_template_id = std::nullopt);

int report_blocking_types(const ProjectDB &db);
 
} // namespace reusex