Effective Office

Open source office automation, built with Kotlin Multiplatform (KMP).

Book meeting rooms, share office updates on TV screens, and route incoming SMS to your team's services. The Meeting Room app brings the project to iOS, Android, and Aurora OS.

Website · Documentation · Aurora OS branch

Aurora OS support for Meeting Room is currently available in the feature/aurora-compose-0.0.5 branch. The main branch contains the Android and iOS implementations. Platform availability varies by app.

Built with Kotlin Multiplatform

Effective Office shares Kotlin code across platforms in a modular codebase. The Meeting Room app uses Compose Multiplatform for its UI, with platform-specific integrations for Android, iOS, and Aurora OS. A Kotlin / Spring Boot backend connects the apps to calendars and other office services.

Apps

Meeting Room

Meeting room availability and booking for iOS, Android, and Aurora OS.

Features Overview

Feature	Description
Real-time Availability	Displays up-to-date status of meeting rooms
Quick Booking	Instantly reserve an available room with a single tap
Time-Specific Reservations	Book rooms for specific time slots
Booking Cancellation	Cancel existing reservations with ease
Early Room Release	Free up the room before the end of the reservation
Google Calendar Integration	Syncs all bookings with Google Calendar

TV App

Office news, events, photos, and leaderboards for Android TV.

Features Overview

Feature	Description
Stories Display	Shows employee birthdays, anniversaries, new hires, and congratulatory highlights.
Leaderboard	Displays stats for Duolingo, sports, and internal currency.
Events	Displays upcoming events with QR codes for registration.
Photo Slideshow	Displays corporate photos grouped by albums.
Autoplay	Automatically switches between screens in a slideshow.
Remote Control	Allows navigation and interaction using a remote control.

SMS Router

An Android app that forwards incoming SMS to configured webhooks.

Features Overview

Feature	Description
SMS Interception	Captures incoming SMS messages.
Webhook Forwarding	Sends SMS data to configured webhooks.
Per-SIM Configuration	Stores webhook settings for each SIM in SharedPreferences.
Delivery Logging	Logs SMS delivery status in Room database and provides a UI.
Settings UI	Allows configuration of webhook settings for each SIM.

Quick Start

Prerequisites

• Git
• Docker and Docker Compose
• JDK 17 or higher
• Gitleaks (for development)

Installation

1. Clone the repository:

   git clone https://github.com/effective-dev-opensource/Effective-Office.git
   cd Effective-Office

2. Install Git hooks for development:

   ./scripts/install.sh

3. Configure environment variables:

   cp backend/app/src/main/resources/env.example backend/app/src/main/resources/.env

   Edit the .env file with your configuration.

4. Set up required credentials:

   • Add google-credentials.json for Google Calendar API
   • Add firebase-credentials.json for Firebase notifications
   • Generate keystore files for Android applications

5. Run the backend (using Docker):

   cd deploy/dev
   docker-compose up -d

   Or run locally without Docker:

   # Start PostgreSQL
   docker run --name postgres-effectiveoffice -e POSTGRES_DB=effectiveoffice -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres -p 5432:5432 -d postgres:15-alpine
   
   # Run the backend
   ./gradlew :backend:app:bootRun --args='--spring.profiles.active=local'

Run Clients

1. Open the project in Android Studio or IntelliJ IDEA
2. Sync the Gradle project to download dependencies
3. Choose the appropriate run configuration in IDE
4. Run (Shift+F10 or Control+R)

For detailed installation instructions, including setting up credentials and running client applications, see our Getting Started Guide in the wiki.

Aurora OS

The Aurora OS implementation of Meeting Room is developed in a dedicated branch:

git switch feature/aurora-compose-0.0.5

It uses the Aurora version of Compose Multiplatform and the -PbuildVariant=aurora Gradle property. The build requires the Aurora toolchain and a local Maven repository configured through auroraMavenPath in local.properties.

See the Aurora client documentation and Meeting Room implementation notes for platform details.

Project Structure

effective-office/
├── backend/           # Server-side Spring Boot application with PostgreSQL
├── clients/           # Client applications
│   ├── tablet/        # Meeting Room App (Android / iOS; Aurora in its branch)
│   ├── tv/            # Company News & Photos TV App
│   ├── smsrouter/     # Android SMS Router & Webhooks
│   └── shared/        # Shared module for common functionality across clients
├── iosApp/            # iOS tablet application
├── deploy/            # Deployment configurations
│   ├── dev/           # Development environment
│   └── prod/          # Production environment
├── scripts/           # Utility scripts
│   ├── git-hooks/     # Git hooks for development
│   └── install.sh     # Installation script
└── build-logic/       # Build configuration

Documentation

For comprehensive documentation, please visit our Wiki.

Contributing

We welcome contributions! Please see our CONTRIBUTION.md file for guidelines.

Authors

• Alex Korovyansky
• Matvey Avgul
• Maxim Mishenko
• Tatyana Terleeva
• Stanislav Radchenko
• Vitaly Smirnov
• Viktoriya Kokh

License

The code is available as open source under the terms of the MIT LICENSE.