https://github.com/effective-dev-opensource/Effective-Office
https://github.com/effective-dev-opensource/Effective-Office
compose-ios compose-multiplatform gpio kotlin kotlin-multiplatform kotlin-native ktor-client ktor-server raspberry-pi raspberry-pi-3
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/effective-dev-opensource/Effective-Office
- Owner: effectivemade
- Created: 2022-12-03T12:58:08.000Z (about 3 years ago)
- Default Branch: develop
- Last Pushed: 2024-08-23T09:38:26.000Z (over 1 year ago)
- Last Synced: 2024-08-24T08:55:56.361Z (over 1 year ago)
- Topics: compose-ios, compose-multiplatform, gpio, kotlin, kotlin-multiplatform, kotlin-native, ktor-client, ktor-server, raspberry-pi, raspberry-pi-3
- Language: Kotlin
- Homepage:
- Size: 26.9 MB
- Stars: 65
- Watchers: 1
- Forks: 0
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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:
```bash
git clone https://github.com/effective-dev-opensource/Effective-Office.git
cd Effective-Office
```
2. Install Git hooks for development:
```bash
./scripts/install.sh
```
3. Configure environment variables:
```bash
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):
```bash
cd deploy/dev
docker-compose up -d
```
Or run locally without Docker:
```bash
# 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](https://github.com/effective-dev-opensource/Effective-Office/wiki/Getting-Started-with-Effective-Office) 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](https://github.com/effective-dev-opensource/Effective-Office/wiki).
## Contributing
We welcome contributions! Please see our [CONTRIBUTION.md](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](https://t.me/alexkorovyansky)
- [Matvey Avgul](https://t.me/matthewavgul)
- [Tatyana Terleeva](https://t.me/tatyana_terleeva)
- [Stanislav Radchenko](https://github.com/Radch-enko)
- [Vitaly Smirnov](https://github.com/KrugarValdes)
- [Viktoriya Kokh](https://t.me/the_koheskine)
## License
The code is available as open source under the terms of the [MIT LICENSE](LICENSE).