CSV_TO_PDF_REPORT/project_config.md

Project Configuration

Seeded from Envelope_Report_Generator_Requirements.md on 2026-09-04 as the onboarding baseline. Items marked as decisions or assumptions should be confirmed during backlog refinement before implementation begins.

• Project name: Envelope Printing Report Generator
• Primary user / vision: Non-technical print operators can visually design envelope layouts, map CSV data, preview records, and generate print-ready PDFs without developer intervention.
• Tech stack: Native Windows desktop application using C# on .NET 10; desktop UI framework still to be confirmed; fixed integration points are Debenu Quick PDF Library 10.13 (64-bit DLL), XML-based templates, CSV input with header rows, and support for local plus UNC file paths. CSV parsing uses CsvHelper (chosen by dev-team during Sprint 1, Batch 2 — the real sample data has quoted commas in address fields, which a naive split would break). Rendering requires a Debenu license key at runtime (DEBENU_LICENSE_KEY); see code/CLI_CONTRACT.md.
• Test framework(s): xUnit (chosen by dev-team during Sprint 1, Batch 1 — the standard default for .NET SDK-style projects, no reason to deviate). Minimum validation baseline from the requirements is self-tested sample CSV/render scenarios, including overflow, missing-font, missing-image, and high-volume render checks.
• Code review process: Formal reviewer is not defined in the requirements; until a team process is set, changes require self-review against acceptance criteria and Definition of Done before being considered complete.
• CI pipeline: No CI pipeline is defined in the requirements; initial expectation is local build and verification gates, with CI setup to be planned as part of early delivery work.
• Sprint length: 1 week
• Hard constraints: Windows desktop environment; target users are non-technical operators; GUI must stay responsive while the CLI renders in the background; support up to 1,000,000 CSV records; render 100,000 records at 300 DPI in under 10 minutes; final PDF under 2 GB; PDF 1.4+ in RGB using uncompressed or Flate compression; Windows login only, no app-level auth; support local and UNC image/template paths.
• Delivery slicing guidance: Vertical slices preferred: text-only end-to-end first, then images, then shapes and advanced tooling.
• Open product questions captured from requirements: Decide whether template image/logo references should be absolute or relative; define timeout/retry behavior for slow UNC network shares.
• Seed project assets: Sample CSV at code/sample-data/87700 - 999999 - Wilson Township.csv; Debenu interop source at code/vendor/debenu/interop/DebenuPDFLibraryDLL1013.cs; native DLLs at code/vendor/debenu/x64/ and code/vendor/debenu/x86/.