qdr.app.studiou.orders2printpack

StudioU Orders2PrintPack

Verze 1.3.4 · Quadarax © 2025

Proprietární desktopová aplikace (Windows Forms, .NET 9) pro online tiskovou službu StudioU. Zpracovává exporty objednávek z WooCommerce a převádí je na podklady připravené k tisku, katalog produktů, tiskové štítky a e-mailové odesílání digitálního obsahu.

Uživatelské rozhraní, názvy sloupců CSV i texty jsou v češtině.

---

Hlavní funkce

Aplikace se spouští úvodní obrazovkou (FormLauncher), ze které jsou dostupné čtyři samostatné moduly a editor konfigurace.

1. Příprava balíčků k tisku (FormBatch)

Hlavní pracovní postup „objednávky → balíček k tisku":

• Načte CSV export objednávek z WooCommerce.
• Prohledá složku se zdrojovými (RAW) soubory a podle názvu souboru spáruje každý řádek objednávky s lokálním obrázkem.
• Zkopíruje a přejmenuje soubory do výstupní složky podle masky OutputFileMask (tokeny {order_no}, {prod_name}, {ordinal}, {ext} a libovolný sloupec CSV).
• Množství (qty) se rozkopíruje do číslovaných kopií.
• Řádky odpovídající formátu digitálního obsahu (FormatDigitalContains) s vyplněným e-mailem se směrují do podsložky podle e-mailu místo tisku.
• Umožňuje vygenerovat protokol (.csv) s číslem a datem externí objednávky.

2. Editace produktů (FormProductEdit)

Editace a import katalogu produktů a variant:

• Produkt (variable) nebo varianta (variation) navázaná na rodiče přes SKU.
• Generování URL a popisů z šablon (ImportTpl*).
• Kontrola validity a duplicit, editace hodnot Minimum/Maximum množství.

Číselník variant a ceny. Pravý panel obsahuje číselník variant (sloupce Jméno, Cena, Min. Počet, Max. Počet). Tento číselník slouží jako referenční ceník a ukládá se mezi spuštěními do uživatelské konfigurace (PredefinedVariants); při otevření okna se z ní obnoví.

Doporučený postup pro ceny:

1. Import ze složkové struktury (kategorie/varianta/soubor) vytvoří produkty a varianty. Importované varianty vznikají s cenou 0 (cena se z importu nepřebírá).
2. Cenu nastavíte v číselníku variant a tlačítkem Použít ji hromadně přenesete na všechny produktové varianty se shodným názvem.

Číselník variant si ceny drží i při importu – produkt s nulovou (nenastavenou) cenou referenční cenu nepřepíše. Skutečná nenulová cena zadaná na produktu se do číselníku naopak promítne.

3. Tisk štítků (FormLabelPrint)

Generování tiskových štítků z CSV do souboru .xlsx (Excel, přes OpenXML — bez nutnosti Office):

• Agregace řádků podle LabelAggregateColumns a tvorba počítaných sloupců (LabelAggegationDataExpression).
• Rozvržení štítků do mřížky N×M na stránku A4.
• Šablona LabelTemplate podporuje zástupné symboly {nazevSloupce} a jednoduché formátování: **tučně**, __kurzíva__, _podtržení_, ^^velikost^text^^ a {cr} pro nový řádek.

4. Odeslání digitálních dat (FormDigitalSend / EmailStorageProcessor)

Odesílání odkazů ke stažení pro digitální objednávky:

• Každá podsložka vstupního adresáře = jeden příjemce (název složky = e-mail).
• Stavový automat ukládaný do metadata.json: Ready → Processing → Uploading → Sending → Sent (případně Error).
• Pro každou položku: zabalí JPG do ZIP, nahraje do Temporary Shared Storage (TSS), vygeneruje heslo a permalink ke stažení, personalizuje e-mailovou šablonu ({{DOWNLOAD_LINK}}, {{PASSWORD}}, {{RECIPIENT}}, {{ORDERS}}) a odešle přes SMTP.
• ZIP soubory procházejí skrytými adresáři .processing/ → .sending/ → .sent/.

---

Požadavky

• Windows (Windows Forms, cíl net9.0-windows7.0)
• .NET 9 SDK
• Externí NuGet závislosti:
  • qdr.fnd.core — sdílená knihovna (logování, prohledávání souborů, CSV, ParameterizedString)
  • qdr.app.tss.client — REST klient pro Temporary Shared Storage
  • DocumentFormat.OpenXml — generování .xlsx štítků

Sestavení a spuštění

# Sestavení celého řešení
dotnet build qdr.app.studiou.orders2printpack.sln

# Spuštění aplikace
dotnet run --project App

# Spuštění testů (NUnit)
dotnet test

Instalátor (Setup/Setup.vdproj) je projekt Visual Studio Installer — lze sestavit pouze ve Visual Studiu s rozšířením pro instalační projekty, ne přes dotnet.

Konfigurace

Veškeré nastavení je uloženo v uživatelské konfiguraci (Properties/AppSettings) a edituje se za běhu přes dlgSettings / dlgEditCfg. Klíčové skupiny:

• Mapování sloupců (MapCol*) — propojení logických polí s názvy sloupců v CSV. Při jiné struktuře exportu se mění zde, ne v kódu.
• Šablony výstupních souborů, importu, štítků.
• TSS — TSSApiKey, TSSUri, TSSChunkSizeBytes.
• SMTP — server, port, přihlášení, SSL.

Tlačítko „Reset konfigurace" na úvodní obrazovce obnoví výchozí hodnoty.

---

Changelog

1.3.4 (2026-06-09)

• Oprava: import produktů již nepřepisuje ceny v číselníku variant na 0. Předdefinované ceny variant (sloupec Cena) zůstávají po importu zachovány a není nutné je zadávat znovu ručně.

1.3.3 (2025-06)

• Přidán tag pro zpracování e-mailu (processing email) při tisku štítků

1.3.2

• Oprava agregace množství (quantity) při generování štítků

1.3.1

• Přidán sloupec „Vlastnost 1 varianta" ([CsvColumn("Vlastnost 1 varianta")])

1.3.0 (2025-05-26)

• Přidán TSS REST API client (v.1.0.0)
• Rozšíření konfigurace o hodnoty pro TSS REST API client
• Přidána obrazovka „Odeslání digitálních dat"

1.2.4 (2025-05-19)

• Rozšíření podpory přípravy balíčků k tisku o generování digitálního obsahu podle cílového e-mailu
• Přidán do konfigurace e-mail a identifikace formátu digitálního obsahu

1.2.3 (2025-04-28)

• Editace hodnot Minimum/Maximum na Produktu a Variantě
• Editace RAW hodnot pro Kategorie produktu, variant a mapování Batch CSV sloupců + delimiter
• Kontrola duplicit source souborů v importu Batch CSV

1.2.2 (2025-04-01)

• Při importu produktů se nastavuje fixní ShortDescription a Description pro produkt
• Přidány sloupce Maximum/Minimum quantity pro varianty

1.2.1 (2025-04-01)

• Přidána možnost definovat agregaci při generování štítků a přidávání kalkulovaných sloupců
• Rozšíření nastavení (konfigurace) tisku štítků

1.2.0 (2025-03-13)

• Upgrade na .NET 9.0
• Přidána podpora pro tisk štítků podle importovaného .CSV do xlsx (Excel)
• Přidána funkce generování repository v Editaci Produktů

1.1.1 (2025-03-13)

• Opraveno, Nový a Uložit otevře dialog pro uložení
• Oprava importu produktů, měsíc importu v Url je formátován na dvě číslice
• Oprava importu produktů, při importu se SKU složí ze jména importovaného souboru bez koncovky
• Oprava výchozího mapování sloupců

1.1.0 (2024-10-16)

• Přidán launch screen
• Přidána obrazovka Editace produktů s podporou importu ze struktury

1.0.2 (2024-10-05)

• Úprava mapování na sloupečky CSV, nastavení defaultů
• Přidáno nastavení pro promazání výstupního adresáře, včetně nastavení

1.0.1 (2024-09-27)

• Přidána podpora generování protokolu (.csv)
• Rozšíření datové struktury o položky OutputFileName, ExternalOrder, ExternalOrderDate
• Oprava chyb UI

1.0.0 (2024-09-27)

• První verze