Effective Office

Goal

The main goal of the project is the automation of various processes in the office and providing interesting statistics for employees.

Technical goal

The main technical task of the project is to create a multi-module application on Kotlin, trying to focus on the most modern and relevant solutions in this language. Throughout the project, we tried to use other languages and technologies as little as possible.

Meeting Room Tablet App

🔧 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

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

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'

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

Project Structure

effective-office/
├── backend/           # Server-side Spring Boot application with PostgreSQL
├── clients/           # Client applications
├── 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.

Roadmap

TV App

A TV application featuring a corporate news and photo feed, event announcements with external registration, Duolingo and sports leaderboards, and an internal currency tracker. Currently in development.

SMS Router

A service for automatic routing of incoming SMS messages to the appropriate channels and systems. Supports dual SIM and eSIM, operates in the background, and routes messages based on the recipient number — improving the security and reliability of the infrastructure. Currently in development.

Foosball Tracker

An application for tracking foosball match results. It allows users to log games, maintain leaderboards, and view statistics — all to encourage friendly competition in the office. Currently in development.

Authors

• Alex Korovyansky
• Matvey Avgul
• Tatyana Terleeva
• Stanislav Radchenko
• Vitaly Smirnov
• Victoria Maksimovna

License

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