vamous-am/Habeshan-REMS-Project

Habeshan REMS is an Offline-first remote employee management system for Ethiopian outsourcing agencies. Tracks attendance, tasks, and timesheets with tamper-evident offline sync, giving managers real accountability without daily commutes. React/TypeScript + Go + PostgreSQL. # Habeshan REMS Habeshan REMS is an offline-first, multi-tenant web platform that gives Ethiopian outsourcing agencies and distributed teams verifiable visibility into attendance, task progress, and hours worked replacing spreadsheets, chat threads, and informal check-ins with a system managers can actually trust. Built by a team of 4 developers Release 1.0 (MVP) showcase. --- ## Table of Contents - Why This Exists - Core Features (Release 1.0 Scope) - Out of Scope for MVP - Tech Stack - System Architecture - Database Schema - Getting Started - Environment Variables - Project Structure - API Overview - Team & Ownership - Development Workflow - Testing - Offline-First Design Notes - Roadmap - Documentation - License --- ## Why This Exists # 🚖 The Problem Workers in Addis Ababa routinely lose **1.5 to 3 hours a day** just waiting in taxi queues and commuting. By the time they reach the office, they're already tired before they've done a single task. That’s lost productivity for the company, and lost time the person will never get back. --- ## 🏠 The Solution A lot of that commuting isn’t actually necessary. Many roles — developers, analysts, and other knowledge workers don’t need physical presence to do their job well. - Roles that genuinely require face‑to‑face presence (guards, secretaries, in‑person sales) stay office‑based. - Everyone else gets the option to **work from home**, freeing up commute time for rest, exercise, family, or skill‑building. This also helps companies: if they want to hire new staff but lack physical office space, remote work becomes a practical option. Employees can follow company rules strictly while working from home, ensuring discipline and accountability. --- ## 🔒 Why Habeshan REMS Remote work only works if companies can trust it’s actually happening. Without a way to verify attendance and task progress, *“work from home”* risks becoming *“disappear for the day.”* **Habeshan REMS** makes remote work safe and account …