# GoOfficePH Groupware Release Notes

SPDX-FileCopyrightText: 2026 Arnold Bagabaldo
SPDX-License-Identifier: LicenseRef-GoOffice-Proprietary

## Version 0.2.0

GoOfficePH Groupware is the managed native app family for GoOfficePH Mail, GoOfficePH Suite, GoOfficePH Calendar, and GoOfficePH Contacts. This release establishes a reproducible Tauri desktop wrapper source inside the GoOfficePH repository so future desktop releases can be built, validated, packaged, and recorded from a traceable source tree.

This build publishes macOS Apple Silicon and Linux x64 packages. Linux 0.2.0 is available as AppImage, DEB, and RPM packages built on a native Ubuntu x64 runner. Windows MSI/EXE packaging has a source-controlled runner script and should be produced on a trusted Windows build host before public Windows 0.2.0 publication.

## Additions

- Reproducible Tauri desktop shell for GoOfficePH Groupware.
- macOS app bundle target using the GoOfficePH icon and GoOfficePH Groupware product name.
- Customer-facing macOS DMG installer with an Applications shortcut and packaged Release Notes.
- Linux x64 AppImage package for portable desktop use.
- Linux x64 DEB package for Debian and Ubuntu family systems.
- Linux x64 RPM package for RPM-based distributions.
- Windows native build-runner script for MSI and EXE publication on a trusted Windows host.
- Local fallback screen that directs users back to the GoOfficePH Groupware web entry point if the online workspace cannot load.
- Release ledger schema for future release notes, artifacts, checksums, validation events, and known release changes.

## Improvements

- Desktop release naming now follows GoOfficePH Groupware instead of the older GoOfficePH Offline Workspace label.
- Release records are now structured for future public download pages, support references, audits, and version history.
- The desktop wrapper keeps proprietary workflow decisions in GoOfficePH APIs while the app remains a thin, managed native shell.

## Fixes

- Establishes a source-controlled build path for the native wrapper instead of relying only on previously published binary artifacts.

## Installation

1. Download the package for your operating system from the GoOfficePH Groupware downloads page.
2. On macOS, open the DMG package and drag `GoOfficePH Groupware.app` to `Applications`.
3. Launch the app and sign in with your GoOfficePH ID.
4. Confirm your account has an active GoOfficePH Groupware subscription or staff-issued activation code.

## Validation Checklist

- Package builds from the local repository.
- macOS app launches locally.
- App opens the GoOfficePH Groupware entry point.
- Linux AppImage, DEB, and RPM packages build successfully on native Ubuntu x64.
- Linux package checksums validate successfully.
- Linux DEB and RPM package metadata identify GoOfficePH Groupware 0.2.0.
- Public download page lists the new version, retained previous versions, and SHA-256 checksums.
- Release ledger contains the version, changes, artifacts, and validation results.

## Known Notes

The macOS package is signed locally for internal validation. Public production distribution should use an Apple Developer ID certificate and notarization before broad customer rollout.

Windows MSI/EXE packages must be built on a matching trusted Windows host or CI runner because the local macOS Tauri runner does not expose Windows MSI/NSIS bundle targets. The older Windows 0.1.0 ZIP remains published for continuity until the Windows 0.2.0 installers are produced and validated.