# 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 is `WinForms` (confirmed by the user ahead of Sprint 1, Batch 4 — simplest fit for file pickers and a launch action, matches the team's scaffolding pace). 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/`.