// readme

Office Tracker

A web application designed to track compliance with Return-to-Office (RTO) mandates, featuring a user-friendly calendar interface for logging office presence and generating comprehensive summary statistics and reports for compliance assessment.

Features

  • 📊 Track daily office presence on a monthly basis
  • 🔄 Real-time updates and synchronization
  • 📱 Responsive web interface
  • 📊 Export reports in CSV and PDF formats
  • 🔐 GitHub OAuth authentication (in integrated mode)
  • 🚀 Multiple deployment options (standalone or integrated)
  • 🐳 Docker support for easy deployment
  • 🤖 Model Context Protocol (MCP) support for AI assistant integration

Deployment Options

Integrated Mode

The integrated mode offers a full-featured experience with:

  • Cloud PostgreSQL database storage
  • Redis caching
  • GitHub OAuth authentication
  • Multi-user support

Prerequisites

  • Docker and Docker Compose
  • GitHub OAuth credentials
  • PostgreSQL database
  • Redis instance

Configuration

  1. Copy the sample configuration:
cp config/sample.env config/local.env
  1. Configure your local.env with required credentials and settings

Running with Docker…