SOCDOF v21.6.0

🌟 Version 21.6.0 Updates (Offline EML Email Drafts, vCard 3.0 Contact Export, Product QR Labels, Margins & 1-Click Duplication)

1. RFC 822 EML Pre-Formatted Email Drafts

• 100% Local E-Mail Generation: Generates pre-formatted .eml files conforming to RFC 822 standards for instant opening in Microsoft Outlook, Mozilla Thunderbird, and Apple Mail without requiring external mail servers.
• Invoice Communication: Automatically attaches invoice recipient addresses, invoice totals, due dates, breakdown of line items, and SEPA bank details (IBAN, BIC, Bank Name).
• Contact Inquiries: Generates professional introduction and inquiry templates with company header and contact information.

2. Electronic Business Cards (vCard 3.0 / .vcf)

• Instant Address Book Export: Export contacts and business partners directly as standard .vcf vCards compatible with mobile smartphones (iOS / Android), Windows Contacts, and macOS Contacts.
• Comprehensive Fields: Encodes full name, company, job title, email, phone, street address, and internal notes.

3. Barcode & QR-Code Product Label Printing Hub

• Universal Label Generation: Generates printable label sheets and individual thermal roll tags for product inventory.
• Interactive Customizer: Select from standard formats including DIN A4 (3x8 grid, 24 labels), DIN A4 (2x5 grid, 10 labels), 62mm Brother thermal rolls, and 100x150mm shipping labels.
• High-Resolution Vector Codes: Crisp vector rendering of QR codes (with product SKU, name, price, web links) and Code 128 barcodes with real-time print preview.

4. Profit Margin Analytics & Catalog Duplication

• Dynamic Profit Margin Display: Real-time calculation and visualization of profit margin in currency units (€) and percentage (%) based on purchase cost (cost_price) and selling price (sale_price).
• 1-Click Invoice Duplication: Clone existing invoices into clean new drafts with freshly allocated sequential invoice numbers, resetting payment and dispatch statuses.
• 1-Click Product Duplication: Rapidly create variations or copies of existing catalog articles with auto-assigned SKU suffixes.

---

SOCDOF v21.5.1

🌟 Version 21.5.1 Updates (Mobile Sync Network Auto-Detection, Cloud Preview & Electron Background Server Bridge)

1. Multi-Target Network Mode Selector (Cloud Web vs. Local LAN vs. Custom)

• Cloud & Web Preview URL Support: In browser preview environments, SOCDOF automatically generates public HTTPS endpoint targets so mobile devices can transmit data globally over cellular data (LTE/5G) or external WiFi without requiring a shared local subnet.
• Local LAN Auto-Discovery & Priority Sorting: Filtered out link-local APIPA addresses (169.254.x.x), prioritizing real IPv4 local router subnets (192.168.x.x, 10.x.x.x, 172.x.x.x) for desktop use.
• Custom IP & Port Input: Ability to specify custom network gateways, VPN IPs, or forwarded ports.

2. Electron Native Background Mobile Sync Server

• Embedded HTTP Receiver: Integrated native Node.js HTTP listener on port 3000 in electron/main.cjs for standalone packaged Windows .exe installations.
• Instantaneous IPC Relay: Direct socdof:mobile-sync-received IPC channel relaying payload data directly into the active UI session without latency.

3. Diagnostics & Troubleshooting Help

• Interactive Connection Helper: Built-in troubleshooting guide explaining the difference between cloud preview testing and local offline desktop setups, providing clear instructions for firewall permissions and WiFi pairing.

---

SOCDOF v21.4.0

🌟 Version 21.4.0 Updates (Restaurant & POS Integration with ERP Invoicing, Clean Professional Redesign & GoBD Hospitality Receipts)

1. Seamless ERP Invoicing & POS Integration

• Direct Invoice Generation: Every finalized restaurant order and POS sale is automatically persisted as an official paid Invoice (GASTRO/2026/...) in db.invoices and db.pos_orders in a single transactional step.
• Real-Time Financial Sync: Gastro and POS revenues immediately flow into Dashboard KPI metrics (total invoiced, total paid), the Rechnungsjournal with dedicated Gastro and Kasse badges, and Accounting BWA.
• Inventory & Location Sync: Physical products are automatically decremented with stock move logs, while restaurant menu items are cleanly accounted for.

2. Professional, Authentic Touch-POS Interface

• Non-AI Design Language: Clean dark slate command bars, crisp typography, intuitive table floor plans, and zero generic buzzwords.
• Interactive Floor Plan: Area filtering for Innenbereich, Terrasse, Bar & Counter, and To-Go / Abholung, with live occupancy indicators and elapsed timers.
• Speed Order Taking: Touch category pills, allergen & prep time displays, per-dish preparation notes (e.g. Ohne Zwiebeln, Extra Schafskäse), and instant item quantity steppers.

3. Live Kitchen & Bar Display (KDS)

• Live Ticket Stream: Real-time kitchen monitor grouping open tickets chronologically with elapsed time tracking and color-coded urgency states.
• Stage Progression: 1-click status transitions between In Zubereitung, Servierbereit, and Erledigt.

4. Comprehensive Gastronomy Billing

• Payment Method Selection: Full support for Barzahlung (Cash), EC-/Girokarte, and NFC Contactless (Apple Pay / Google Pay).
• Tip & Change Calculator: Customizable tip buttons (0%, 2 €, 5 €, 10 €), instant change calculator with quick Euro note presets (Exakt, 20 €, 50 €, 100 €), and bill split helper.
• GoBD Bewirtungsbelege: Built-in creation of tax-compliant German hospitality receipts (§ 4 Abs. 5 Nr. 2 EStG) with host, occasion, and guest details.
• Daily Z-Report: Printable daily cash closing summary with revenue breakdowns by payment method and tax rates (7% vs 19%).

---

SOCDOF v21.3.1

🌟 Version 21.3.1 Updates (Google OAuth Multi-Account Selector & Firebase Auth Resilience)

1. Multi-Account Google Sign-In (prompt: 'select_account')

• Universal Google Account Selection: Updated the Google OAuth provider parameters to explicitly request select_account, allowing users to choose or switch between any Google account without automatic silent session locks.
• Firebase Auth Error Handling: Added resilient handling for popup closures (auth/popup-closed-by-user), browser popup blocking, cancelled requests, and network dropouts with clean user notifications.
• Calendar & Events Scope Verification: Confirmed Google Calendar scopes (calendar.events, calendar.readonly) and bidirectional event synchronization for invoices and custom calendar appointments.

---

SOCDOF v21.3.0

🌟 Version 21.3.0 Updates (Spotlight Command Palette, Showcase & Documentation Hub Portal & Global Keyboard Shortcuts)

1. Spotlight Command Palette (Ctrl+K / Cmd+K)

• Instant System-Wide Search & Command Launcher (CommandPaletteModal.tsx):
  • Activated via Ctrl + K, Cmd + K, or the new Windows 11 Taskbar search pill.
  • Search across all modules (Invoices, POS, CRM Contacts, Products, Accounting, Calendar, Stock, Purchases, Restaurant, iOS Billing, Settings, Showcase).
  • Quick action toggles: Dark/Light Mode, System Sound effects mute/unmute, Language modal switcher (DE, EN, FR, ES), and Documentation showcase launch.
  • Live query matching for existing database records (Invoices by number/customer, Contacts by name/email/city, Products by SKU/name).
  • Full keyboard navigation with Arrow Up, Arrow Down, Enter to execute/open, and Esc to close.

2. Multi-Page Showcase & Documentation Hub Portal (DocumentationApp.tsx)

• Showcase & ERP Features Matrix: Interactive visual cards with feature highlights, GoBD & DIN 5008 compliance badges, and quick launch triggers.
• Releases & Download Center: Release version badges, direct Windows .exe setup installer, GitHub release notes, system requirements.
• In-Depth User Manual & Step-by-Step Guides: Searchable guides for Invoicing, Contacts CRM, POS Cash Register, Double-Entry Accounting, Outlook/Google Calendar sync.
• Keyboard Shortcuts & Power Navigation Reference: Comprehensive cheat sheet for all desktop hotkeys (Ctrl+K, F1, Alt+1..9, Esc, Ctrl+Space).
• Security & Zero-Cloud Certification: Documentation on 100% offline data sovereignty, IndexedDB/SQLite persistence, and GDPR/DSGVO compliance.
• Community & Discord Hub: Direct links to the official Discord support server (discord.gg/QW85EaXTgB) and GitHub open-source repository.

3. Global Desktop Shortcuts Integration (DesktopWindowWorkspace.tsx)

• Ctrl + K / Cmd + K: Spotlight Command Palette
• F1: Open Documentation & Showcase Hub
• Alt + 1 through Alt + 9: Instant launch / focus of pinned taskbar applications
• Ctrl + Space: Toggle Windows Start Menu
• Esc: Close active modal dialogs, flyouts, and command palette

---

SOCDOF v21.0.0 (21.2.0)

SOCDOF v21.2.0

Automated build for SOCDOF v21.2.0.

SOCDOF v20.3.1

Version v20.3.1 (2026-08-26)

1. Language Persistence Fix & Startup Synchronization

• Robust Multi-Layer Persistence:
  • Fixed language initialization in i18n.ts, App.tsx, and IndexedDB (company_profile settings table).
  • Language selection (German, English, French, Spanish) is now reliably retained across desktop app closures, restarts, and reloads without reverting to English.
  • Eliminated automatic fallback resetting when dismissing dialogs or launching without pre-existing configuration.

2. Reactive Taskbar & Start Menu Language Switcher

• Live State Synchronization:
  • Updated Taskbar tray and Start menu quick action buttons to reactively reflect the active language via the useLanguage() reactive hook.
  • Enhanced LanguageSelectionModal with an automatic selection synchronization effect on opening, ensuring the currently active language is always pre-selected and highlighted.
  • Fixed modal close behavior so clicking the close (X) or cancel button preserves the active language choice.

3. Crisp Start Menu Icon Geometry & Asset Bundling

• Proportional Corner Radius & Layout:
  • Refined SocdofLogo component to use bundled asset imports (src/assets/socdof_icon.png) and exact proportional corner radiuses per size (rounded-lg for 28px taskbar start button, rounded-xl for dialogs and headers, rounded-2xl for large banners).
  • Eliminates visual stretching, excessive clipping, or blurry fallback artifacts across high-DPI displays.

---

SOCDOF v20.3.0

Version v20.3.0 (2026-08-26)

1. Italian E-Invoicing (FatturaPA 1.2.2 & SdI Full Lifecycle)

• FatturaPA 1.2.2 XML Generator:
  • Implemented compliant FatturaPA 1.2.2 XML generator supporting both FPR12 (private B2B/B2C transactions) and FPA12 (Pubblica Amministrazione).
  • Fully incorporates required Italian tax metadata: Codice Destinatario (7 characters or 6 for PA), PEC delivery addresses, tender codes (CIG & CUP), virtual stamp duty (Bollo Virtuale 2,00 €), tax regimes (RF01-RF19), and Natura exemption codes (N1-N7).
• SdI Receipt & Notification Parser:
  • Engineered parser for official Agenzia delle Entrate / Sistema di Interscambio notification receipts: RC (Ricevuta di Consegna), NS (Notifica di Scarto), MC (Mancata Consegna), NE (Notifica Esito Committente PA), DT (Decorrenza Termini), and AT (Attestazione Trasmissione).
  • Integrated SdI Error Code Catalog with descriptions and actionable troubleshooting hints across all 4 languages (DE, EN, FR, ES).
  • Intelligent file auto-detection distinguishing between FatturaPA invoice XMLs and SdI receipt notifications on upload.
• Interactive FatturaPA & SdI Inspector Modal:
  • Dedicated inspection modal with live syntax-colored XML inspection, one-click clipboard copying, XML download, and SdI lifecycle tracking (Not Sent, Sent, Delivered, Rejected, Failed Delivery, PA Accepted, PA Refused).
  • Ability to manually upload or assign SdI receipt files directly to invoice records, automatically synchronizing delivery timestamps and error details.
• Enhanced Contacts & Settings Integration:
  • Added dedicated Italian SdI fields in Company Settings and Contact editor (Codice Destinatario, PEC, Tax ID / Codice Fiscale, Regime Fiscale, Bollo default), which auto-populate into new invoices.

2. Global Search & Command Palette Polish

• Harmonized Branding:
  • Replaced legacy labels with SOCDOF suite branding throughout the Command Palette (Ctrl+K).
• Comprehensive Entity Search:
  • Real-time search across CRM Contacts, Product SKUs, Invoices, and quick action shortcuts.

---

SOCDOF v20.2.0

Version v20.2.0 (2026-08-26)

1. Custom Brand Icon Assets Integration (.ico, .png, .svg)

• Authentic Brand Icon Integration:
  • Integrated official brand icon assets from src/assets/ (socdof_icon.ico, socdof_icon.png, socdof_icon.svg) across the entire application workspace.
  • Updated SocdofLogo component to render the high-resolution brand asset dynamically in the Start Menu button, header banners, and dialogs with graceful fallback.
• Windows Executable (.exe) Icon Configuration:
  • Updated electron-builder.json to assign public/socdof_icon.ico directly to Windows installer and binary build targets (win.icon: "public/socdof_icon.ico").
  • Updated Electron runtime window initialization (electron/main.cjs) to load the native .ico icon when running on Windows platforms and .png on cross-platform shells.
• PWA & Browser Favicon Alignment:
  • Attached official icons to public/socdof_icon.svg, public/socdof_icon.png, public/socdof_icon.ico, and public/favicon.svg for crisp rendering across all screen densities.

---

SOCDOF v20.1.1

Version v20.1.1 (2026-08-26)

1. Fixed Calendar Flyout Dimensions & Layout Stability

• Fixed 42-Day Matrix (6 Full Rows):
  • Fixed calendar days calculation to always generate exactly 42 grid cells (6 rows × 7 days) regardless of month length or starting weekday.
  • Prevents the calendar popup flyout window from resizing, jumping, expanding, or shrinking when navigating between different months.
• Stable Agenda Container:
  • Locked agenda and upcoming due invoices container to a fixed height (h-28) with smooth vertical scrolling, guaranteeing absolute UI stability.
• Multilingual Day & Month Localisation:
  • Dynamically localizes weekday headers (Mo, Di, Mi, Do, Fr, Sa, So / Mo, Tu, We, Th, Fr, Sa, Su / Lu, Ma, Me, Je, Ve, Sa, Di / Lu, Ma, Mi, Ju, Vi, Sá, Do), month names, and agenda status texts in all 4 supported languages.

2. Pre-Release vs. Full Release CI/CD Categorization

• Strict Pre-Release Classification for Minor/Patch Builds:
  • Updated scripts/prepare-release.cjs and .github/workflows/build-windows-exe.yml.
  • Only major milestone releases (e.g. v20.0.0, v21.0.0 where minor === 0 && patch === 0) are flagged as Latest Full Releases (prerelease: false, make_latest: true).
  • All incremental updates, patches, and minor enhancements (e.g. v20.0.9, v20.1.0, v20.1.1) are cleanly flagged as Pre-releases (prerelease: true, make_latest: false) on GitHub Releases, preventing them from overriding official milestone badges.

---