Issue #34: Unify app framework with Android MVP implementation

.github/workflows/android.yml

@@ -0,0 +1,31 @@
+name: Android CI
+on:
+  push:
+    branches: [ main, mvp-android ]
+    paths:
+      - 'android/**'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'android/**'
+
+jobs:
+  android-build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v3
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+
+      - name: Setup Gradle
+        uses: gradle/gradle-build-action@v2
+
+      - name: Build and Test
+        run: |
+          cd android
+          chmod +x gradlew
+          ./gradlew build test 

.gitignore

@@ -160,3 +160,75 @@ cython_debug/
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 #.idea/
+
+# Android
+*.iml
+.gradle/
+local.properties
+.idea/
+.DS_Store
+build/
+captures/
+.externalNativeBuild
+.cxx
+
+# Keystore files
+*.jks
+*.keystore
+!android/keystore/debug.keystore
+
+# Android Studio
+*.iws
+*.ipr
+.idea/
+out/
+
+# Gradle
+.gradle/
+build/
+gradle-app.setting
+!gradle-wrapper.jar
+.gradletasknamecache
+
+# Generated files
+bin/
+gen/
+
+# Log Files
+*.log
+
+# Android Studio Navigation editor temp files
+.navigation/
+
+# Android Studio captures folder
+captures/
+
+# IntelliJ
+.idea/workspace.xml
+.idea/tasks.xml
+.idea/gradle.xml
+.idea/assetWizardSettings.xml
+.idea/dictionaries
+.idea/libraries
+.idea/caches
+
+# VS Code
+.vscode/
+
+# Sonar
+.sonar/
+.scannerwork/
+
+# Test reports
+app/build/reports/
+app/build/test-results/
+
+# Detekt
+build/reports/detekt/
+
+# KtLint
+build/reports/ktlint/
+.gradle/
+
+# Android Studio
+.idea/

README.md

@@ -4,7 +4,10 @@
 
 # RunOn
 
+## Project Status
+
 [![Build and Test](https://github.com/fleXRPL/RunOn/actions/workflows/build.yml/badge.svg)](https://github.com/fleXRPL/RunOn/actions/workflows/build.yml)
+[![Android CI](https://github.com/fleXRPL/RunOn/actions/workflows/android.yml/badge.svg)](https://github.com/fleXRPL/RunOn/actions/workflows/android.yml)
 [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=fleXRPL_RunOn&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=fleXRPL_RunOn)
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=fleXRPL_RunOn&metric=coverage)](https://sonarcloud.io/summary/new_code?id=fleXRPL_RunOn)
 [![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=fleXRPL_RunOn&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=fleXRPL_RunOn)
@@ -24,6 +27,7 @@ RunOn helps runners find and participate in local running events by providing:
 ## Architecture
 
 ### Backend
+
 - **APIs**: 
   - Google Search API for event discovery
   - Google Calendar API for event management
@@ -33,30 +37,58 @@ RunOn helps runners find and participate in local running events by providing:
   - SonarCloud quality gates
 
 ### Android App
+
 - **Language**: Kotlin
 - **UI Framework**: Jetpack Compose
 - **Key Features**:
   - Material Design 3 implementation
   - Direct Google Calendar integration
   - Google Sign-in
 
+## Project Structure
+
+```bash
+RunOn/
+├── .github/
+│   └── workflows/
+│       └── build.yml       # CI/CD pipeline
+│       └── android.yml     # Android CI/CD pipeline
+├── android/                # Android mobile app
+│   ├── app/                # Main Android application
+│   └── docs/               # Android documentation
+├── backend/                # Core functionality
+│   ├── functions/          # Business logic
+│   ├── models/             # Data models
+│   ├── tests/              # Test suite
+│   └── scripts/            # Development tools
+```
+
 ## Development Setup
 
-1. Clone the repository:
+### Android Setup
+
 ```bash
+# Clone repository
 git clone https://github.com/fleXRPL/RunOn.git
-cd RunOn
+cd RunOn/android
+
+# Run Android setup script
+chmod +x scripts/setup.sh
+bash scripts/setup.sh
 ```
 
-2. Install dependencies:
+### Backend Setup
+
 ```bash
-cd backend
+# Clone repository
+git clone https://github.com/fleXRPL/RunOn.git
+cd RunOn/backend
+
+# Install dependencies
 pip install -r requirements.txt
 pip install -r requirements-dev.txt
-```
 
-3. Run tests:
-```bash
+# Run tests and checks
 bash scripts/format_and_lint.sh
 ```
 
@@ -69,7 +101,8 @@ bash scripts/format_and_lint.sh
 
 1. Ensure all tests pass with 100% coverage
 2. Follow PEP 8 style guide
-3. Run `format_and_lint.sh` before committing
+3. Run `format_and_lint.sh` before committing to backend
+4. Run `format_and_lint.sh` before committing to android
 
 ## License
 

android/README.md

@@ -1,103 +1,84 @@
-# RunOn Android Application
+# RunOn! Android App
 
-## Overview
+## MVP Features
 
-The RunOn Android application provides a native mobile interface for discovering and managing running events, with seamless calendar integration and user management features.
+- Event discovery integration
+- Google Calendar sync
+- Clean architecture implementation
 
 ## Project Structure
 
-```
+```bash
 android/
 ├── app/
 │   ├── src/
 │   │   ├── main/
-│   │   │   ├── kotlin/com/flexrpl/runon/
-│   │   │   │   ├── activities/         # Main UI activities
-│   │   │   │   ├── fragments/          # UI fragments
-│   │   │   │   ├── models/             # Data models
-│   │   │   │   ├── network/            # API client and services
-│   │   │   │   ├── services/           # Background services
-│   │   │   │   └── utils/              # Utility classes
-│   │   │   └── res/                    # Resources
-│   │   └── test/                       # Unit tests
-│   ├── build.gradle                    # App-level build config
-│   └── proguard-rules.pro              # ProGuard rules
-├── gradle/                             # Gradle wrapper
-├── build.gradle                        # Project-level build config
-└── settings.gradle                     # Project settings
+│   │   │   ├── kotlin/
+│   │   │   │   └── com/flexrpl/runon/
+│   │   │   │       ├── data/         # Data layer
+│   │   │   │       ├── domain/       # Business logic
+│   │   │   │       └── ui/           # Presentation layer
+│   │   │   └── res/                  # Resources
+│   │   └── test/                     # Unit tests
+│   └── build.gradle.kts
+└── build.gradle.kts
 ```
 
-## Technology Stack
-
-- **Language**: Kotlin
-- **UI Framework**: Jetpack Compose
-- **Architecture**: MVVM with Clean Architecture
-- **Dependencies**:
-  - Android Architecture Components
-  - Retrofit for API communication
-  - Room for local storage
-  - Hilt for dependency injection
-  - Material Design 3
-
 ## Development Setup
 
-1. Install Android Studio (latest version)
-2. Install JDK 17 or later
-3. Clone the repository
-4. Open the project in Android Studio
-5. Sync Gradle files
-6. Run the application
-
-## Building and Running
+### Quick Start
 
 ```bash
-# Build debug variant
-./gradlew assembleDebug
-
-# Run tests
-./gradlew test
-
-# Install on connected device
-./gradlew installDebug
+# From project root
+./android/scripts/setup.sh
 ```
 
-## Testing
+The setup script will:
+
+- Install required tools (via Homebrew)
+- Initialize Gradle
+- Set up permissions
+- Run initial build
+
+### Required Software
+
+- Android Studio Hedgehog | 2023.1.1
+- JDK 17
+
+## Core Dependencies
+
+```kotlin
+dependencies {
+    // Core Android
+    implementation("androidx.core:core-ktx:1.12.0")
+    implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.7.0")
+
+    // UI
+    implementation("androidx.activity:activity-compose:1.8.2")
+    implementation(platform("androidx.compose:compose-bom:2024.01.00"))
+
+    // Testing
+    testImplementation("junit:junit:4.13.2")
+    androidTestImplementation("androidx.test.ext:junit:1.1.5")
+}
+```
 
-- Unit Tests: `./gradlew test`
-- Instrumentation Tests: `./gradlew connectedAndroidTest`
-- UI Tests: `./gradlew connectedCheck`
+## Getting Started
 
-## CI/CD
+1. Clone the repository
+2. Open in Android Studio
+3. Sync Gradle files
+4. Run tests
+5. Build and run
 
-The project uses GitHub Actions for continuous integration and deployment:
+## Testing Requirements
 
-- Automated builds
-- Unit test execution
-- Code quality checks
-- Release management
+- Unit tests for all business logic
+- UI tests for critical paths
+- Integration tests for API communication
 
 ## Code Style
 
-The project follows the official Kotlin style guide and Android best practices:
-
-- Kotlin style guide
-- Android architecture components patterns
-- Material Design guidelines
-
-## Security
-
-- SSL pinning for API communication
-- Secure storage for user credentials
-- ProGuard optimization and obfuscation
-
-## Contributing
-
-1. Fork the repository
-2. Create a feature branch
-3. Commit your changes
-4. Push to the branch
-5. Create a Pull Request
-
-## License
-
-This project is licensed under the terms of the [LICENSE](../LICENSE) file in the root directory.
+- Follow Kotlin coding conventions
+- Use Compose best practices
+- Maintain clean architecture separation

android/android/app/src/main/kotlin/com/flexrpl/runon/domain/model/Event.kt

@@ -0,0 +1,9 @@
+package com.flexrpl.runon.domain.model
+
+data class Event(
+    val id: String,
+    val title: String,
+    val description: String,
+    val date: String,
+    val location: String
+)