# Saleculator 4.5 u3 Release Notes

Release channel: https://www.saleculator.com/releases/

## Distribution

- Customer installers and runtime packages are published through saleculator.com.
- Customers can download their licensed/versioned installer, install it locally, configure MySQL and devices, and start using Saleculator without cloud dependency.
- Release notes are published with each version so customers and technicians can review changes before installation.

## Highlights

- Final application JAR is `Saleculator.jar`.
- Release JAR is obfuscated with ProGuard.
- Runtime package supports Windows, Linux, and Raspberry Pi/minimal Debian appliance deployments.
- Database support is MySQL only.
- Same installation supports standalone and network POS setups by changing `db.URL`.
- Online orders now calculate and persist tax lines before billing, so Yaadro online-order taxes appear in close cash and tax reports.
- Close cash report handling has been updated for the current 4.5 u3 workflow.
- Remote access configuration and diagnostics have been improved for Dyn/web access setup.
- Receipt printing support includes the current printer and template updates used by 4.5 u3 deployments.
- Restaurant menu items can now be marked **out of stock** without removing them from the catalog.
- Out-of-stock items remain visible on the sales catalog but are disabled, preventing waiters/cashiers from adding them to a bill or taking an order for them.
- Products removed from catalog with existing `In catalog`/category catalog actions continue to stay hidden from the sales screen.
- Product maintenance includes a new **In stock** setting for quickly bringing temporarily unavailable items back.
- Windows installer and runtime ZIP now include a first-run setup assistant.
- 30 day trial flow is available from the activation screen's **START TRIAL** action.
- First-run business setup collects business name, address, tax ID, receipt paper, and receipt footer without XML editing.
- Business profile values are stored in shared MySQL resource `Business.Profile` when a database is available, so network counters use the same receipt identity.
- The database failure screen now opens a clearer setup path with local MySQL, network MySQL, and connection-test actions.
- `AI-INSTALLATION-GUIDE.md` is included so support staff, technicians, and AI assistants can install/setup Saleculator consistently.
- `RELEASE-CHECKLIST.md` and `PUBLIC-RELEASE-PAGE.md` are included to make publishing and customer download pages repeatable.

## Installation Notes

- Use the Windows installer when available from saleculator.com for layman installation.
- Existing databases are upgraded with a new `PRODUCTS.INSTOCK` column; existing products default to in stock.
- After installing, run **First Run Setup** to choose standalone/main POS or network-client setup.
- New customers can request a 30 day trial key from the activation screen using **START TRIAL**.
- If MySQL is not reachable, use **Database Settings** from the startup error screen.
- Technical/vendor deployment can still use the runtime ZIP.
- Runtime ZIP users can run `scripts\setup-saleculator.bat` on Windows or `scripts/setup-saleculator.sh` on Linux/Raspberry Pi.
- For network POS deployments, install/configure MySQL on the main POS or database server, then point all counters to that same database host.
- For Linux/Raspberry Pi appliances, use the bundled appliance setup script after unpacking the runtime ZIP.
