🏗️ GMECH Tracker

Workforce tracking and attendance management system built with Flutter.

---

📱 Screenshots

---

✨ Features

👨‍🔧 Employee Management

• Add and manage employees
• Track employee status:
  • Active
  • Vacation
  • Resigned
• Join date tracking
• Employee assignment handling

---

🏢 Work Site Planning

• Create and manage work sites
• Assign employees to specific sites
• Configure work timings
• Detect assignment conflicts

---

📅 Attendance System

• Daily attendance tracking
• Present / Absent / Vacation status
• Check-in & check-out logging
• Work hours calculation
• Overtime tracking

---

⏱️ Overtime & Leave

• Overtime entry system
• Vacation management
• Holiday management
• Monthly overtime summaries

---

📦 Materials Tracking

• Track materials per work site
• Date-based material history
• Organized material records

---

📊 Reports & Analytics

• Monthly reports
• Employee calendar view
• Attendance analytics
• Work summaries
• PDF export support

---

💾 Backup & Restore

• JSON backup support
• ZIP backup with optional password protection
• Restore from file or custom path
• Local archive management

---

📥 Download

If you only want to use the app, download the APK from the repository releases section.

You do not need to build the project manually unless you're developing or modifying the application.

---

⚙️ Developer Information

This section is intended for developers only.

GMECH Tracker is a local-first application built for operational workforce management.

All data is stored directly on-device using SQLite.

Application Workflow

1. Add employees
2. Create work sites
3. Assign employees to sites
4. Mark attendance
5. Add overtime or leave entries
6. Generate reports and exports
7. Create backups from settings

---

🛠️ Tech Stack

Framework

• Flutter
• Dart

Database

• SQLite (sqflite)

Libraries

• fl_chart
• pdf
• shared_preferences
• file_picker
• share_plus
• url_launcher
• archive
• intl

---

🗄️ Database Structure

Main tables used in the application:

Table	Purpose
employees	Employee records
sites	Work site management
attendance	Attendance tracking
materials	Material logs
vacation_entries	Vacation records
holidays	Holiday management
app_settings	App preferences
warning_preferences	Conflict warnings

---

📂 Project Structure

lib/
  database/      # SQLite access and migrations
  models/        # Application models
  screens/       # UI screens
  services/      # App services and settings
  utils/         # Utility helpers
  widgets/       # Reusable widgets

---

🚀 Setup & Run

Prerequisites

• Flutter SDK
• Dart SDK (sdk: ^3.11.4)

---

Install dependencies

flutter pub get

---

Run the app

flutter run

---

✅ Quality Checks

Static analysis

flutter analyze

Run tests

flutter test

---

📤 Export Features

Supported export styles:

• Classic
• Nested
• Divider
• Comma Separated

Exports can be:

• Shared
• Copied
• Saved locally
• Exported as PDF

---

🔒 License

Copyright © 2026 Sriji

All rights reserved.

This source code is proprietary and confidential.

You may not:

• Copy
• Modify
• Redistribute
• Reupload
• Sell
• Use commercially

without explicit written permission from the author.

---

👨‍💻 Author

Built by Sriji