Documentation

🚀 Getting Started

Wellbeing Log is a professional iOS application designed for educational institutions to track student wellbeing, attendance, and room management with real-time CloudKit synchronization.

System Requirements

• iOS Version: 15.0 or later
• Devices: iPhone and iPad (optimized for both)
• Storage: 50 MB minimum for app and data
• iCloud Account: Required for CloudKit sync functionality
• Internet Connection: For real-time synchronization

Installation

1. Download Wellbeing Log from the App Store
2. Launch the app and grant necessary permissions
3. Sign into your iCloud account when prompted
4. Your 30-day free trial starts automatically
5. Explore all features during the trial period

💎 Simple Trial Model

Wellbeing Log operates on a simple trial model that allows users to experience the full value before committing to a purchase.

30-Day Free Trial

• Duration: 30 days from first app launch
• Features: Full access to all premium features
• Credit Card: Not required
• Automatic Start: Trial begins when app is first launched
• Upgrade Option: Can upgrade to premium at any time

Premium Upgrade

• Price: $9.99 USD one-time purchase
• Recurring Fees: None
• Lifetime Access: All features unlocked permanently
• Cross-Device: Premium status syncs across all devices
• Restore Purchases: Available for all users

📱 Core Features

Real-Time Head Counts

Monitor current student counts across multiple support rooms with live updates and detailed student lists.

• Wellbeing Room: Track emotional support and wellbeing activities
• Diverse Learners Room: Monitor learning support and accommodations
• Lunch Room: Track attendance and meal participation
• Live Updates: Real-time count changes across all devices

Student Management

Comprehensive student database with advanced search, filtering, and detailed tracking capabilities.

• Student Profiles: Complete information including photos and notes
• Search & Filter: Find students quickly by name, year, or teacher
• Movement Tracking: Monitor entry/exit patterns and support needs
• History Log: Complete audit trail of all student activities

Advanced Statistics & Reporting

Generate comprehensive reports and insights for data-driven decision making.

• Room Usage Analytics: Track patterns and peak usage times
• Student Trends: Identify wellbeing patterns and support needs
• Export Functionality: CSV export for external analysis
• Custom Reports: Generate reports for specific time periods

☁️ CloudKit Integration

Professional Apple infrastructure for reliable cross-device synchronization with automatic conflict resolution.

Real-Time Sync

• Update Speed: Changes appear on all devices within 30 seconds
• Automatic Sync: No manual intervention required
• Conflict Resolution: Intelligent handling of simultaneous changes
• Offline Support: Changes sync when connection is restored

Security & Privacy

• Apple Infrastructure: All data stays within Apple's secure CloudKit
• No External Servers: Complete privacy and security
• iCloud Integration: Uses your existing iCloud account
• Data Control: User control over sync preferences

🔧 Technical Implementation

Professional Interface System

The professional interface is built using custom SwiftUI views that provide a clean and engaging user experience for educational institutions.

• Custom Views: PremiumBadgeView.swift with responsive design
• Multiple Sizes: 180x180, 120x120, and 80x80 variants
• Professional Design: Crown, heart logo, premium text, and feature icons
• Visual Effects: Blue-to-purple gradient with shine animations
• Performance: Optimized for smooth rendering and animations

Purchase Management

Professional purchase handling with StoreKit 2 integration and comprehensive trial management.

• StoreKit 2: Modern in-app purchase framework
• Trial Logic: UserDefaults-based trial tracking
• Purchase Flow: Seamless upgrade experience
• Restore Functionality: Cross-device purchase restoration