# Flawless 365 — Alpha Test Build Changelog

All notable changes and distribution binary metadata for the Flawless 365 mobile application are documented in this file.

---

## [1.04] - 2026-09-09 (Current Alpha Release)

### 🚨 Critical Fixes & Enhancements
- **Resolved Login & Supabase Database Connectivity Failure**:
  - Fixed authentication handshake error that blocked user sign-in and session persistence on cold boot.
  - Rectified Supabase client initialization sequence in `supa_base-service.dart` to ensure environment credentials and JWT refresh tokens load prior to route navigation.
  - Resolved RLS (Row Level Security) query timeouts against `profiles`, `member_levels`, and `experience_themes` tables.
- **Session & Offline Token Persistence**:
  - Implemented secure local storage fallback for user auth tokens, preventing unexpected session invalidation upon app resume.
  - Patched SQLite cache hydration to prevent deadlock when offline cache transitions to remote database sync.
- **Error Boundaries & Logging**:
  - Added user-friendly database connection failure banners instead of uncaught asynchronous exceptions.
  - Enhanced internal logging in debug builds to trace database latency and API status codes.

### 📦 Build Artifacts
| Package File | Type | File Size | SHA-1 Checksum |
| :--- | :--- | :--- | :--- |
| `app-release.apk` | Production Release (Signed, R8 Minified) | 74.5 MB | `4e9bfddd0898e6ae88fb96f2ae5dbfbcf290c160` |
| `flawless_365_v1.04.apk` | Production Release Named Mirror | 74.5 MB | `4e9bfddd0898e6ae88fb96f2ae5dbfbcf290c160` |
| `app-debug.apk` | Diagnostics & Verbose Logcat | 145.9 MB | `bed1f843fc2198d0c27a9612239a6e50f35d3ef1` |

---

## [1.03] - 2026-09-09

### Added & Improved
- **REST API Client Integration**: Integrated native Flutter REST API client handlers for dynamic server sync.
- **Asset Optimizations**: Compressed high-resolution samurai artwork assets and reduced APK memory footprint.
- **Calendar Stability**: Improved calendar view synchronization and event CRUD responsiveness.

### 📦 Build Artifacts
| Package File | Type | File Size | SHA-1 Checksum |
| :--- | :--- | :--- | :--- |
| `app-release.apk` | Production Release | 74.1 MB | `dd3a49dde95b41805f357218761a835b29008b0f` |
| `flawless_365_v1.03.apk` | Production Release Named Mirror | 74.1 MB | `dd3a49dde95b41805f357218761a835b29008b0f` |

---

## [1.02] - 2026-09-09

### Added & Improved
- **Initial Supabase Client**: Added foundational database models and Supabase client SDK integration.
- **18+ Verification Gate**: Age-gating picker and verification protocol enforced during member onboarding.
- **Media Cache**: Initial offline caching mechanism for monthly experience themes and choreo videos.

### 📦 Build Artifacts
| Package File | Type | File Size | SHA-1 Checksum |
| :--- | :--- | :--- | :--- |
| `flawless_365_v1.02.apk` | Production Release | 74.0 MB | `93b5b03953823af1ce2b8edf5ff69cb36158f390` |

---

## [1.01] - 2026-09-09

### Initial Alpha Release
- Initial Flutter mobile build compiled for Android QA test distribution.
- Base splash screen, theme engine, navigation shell, and verbose Logcat diagnostic utilities.