# Saleculator 4.5.1 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`.
- 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.
- The 4.5 database upgrade script is idempotent for existing `event.close` resources, preventing duplicate-resource upgrade failures.
- `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.
- 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.
