Skip to content

a-dorgham/SiteTrack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

MATLAB SQLite License

SiteTrack O&M Management System

SiteTrack is a comprehensive MATLAB-based application designed to manage operations and maintenance (O&M) activities. It includes dedicated modules for warehouse inventory, road maintenance, and electrical infrastructure management. With an intuitive interface, SiteTrack simplifies work order tracking, materials management, and report generation.


Key Features

  • Manage roads, buildings, and electrical networks in one platform
  • Track inventory of materials and equipment
  • Log detailed work orders and maintenance activities
  • Monitor lighting, networks, and panel maintenance
  • Plot inventory trends and maintenance activity
  • Review records by day, week, or month
  • Export data to Word and Excel
  • Secure login for multi-user access
  • Attach before/after images for maintenance records

πŸ“ Project Structure

SiteTrack/
β”œβ”€β”€ SiteTrack.m                # Main application launcher
β”œβ”€β”€ assets/
β”‚   β”œβ”€β”€ data/                  # Configs and templates
β”‚   β”‚   β”œβ”€β”€ headingsRoads.txt
β”‚   β”‚   β”œβ”€β”€ maintenanceType.txt
β”‚   β”‚   β”œβ”€β”€ roadsTables.mat
β”‚   β”‚   └── warehouse.xlsx
β”‚   β”œβ”€β”€ databases/             # SQLite database files
β”‚   β”œβ”€β”€ icons/                 # UI icons
β”‚   β”œβ”€β”€ pictures/              # Work documentation photos
β”‚   └── templates/             # Report templates
└── utilities/
    β”œβ”€β”€ createDB.m             # Script to initialize database
    └── SplashScreen.m         # App splash screen component

Getting Started

Prerequisites

  • MATLAB R2021b or later
  • SQLite database generated with createDB.m

Setup Instructions

  1. Configure Data Files

    • Customize field names and types in assets/data/
    • Update warehouse.xlsx and warehouseElec.xlsx with your materials inventory
  2. Create Database

    • Run createDB.m from the utilities/ folder
    • Move the generated dbOandM.db to assets/databases/
  3. Launch Application

    • Open MATLAB
    • Run SiteTrack.m

Usage Overview

Login Screen

  • Enter employee ID and password (default: 0000, 0000)
  • Access levels vary by user type
login

Main Menu

  • Navigate to Roads, Buildings, or Electrical modules
  • Access warehouse and reporting functions
categories

Work Orders

  1. Choose module (e.g., Roads or Electrical)
  2. Input:
    • Work description
    • Location
    • Materials and equipment used
    • Attach images (before/after) log

Warehouse Management

  • View/edit inventory
  • Filter by category
  • Track material usage
  • Generate reports
warehouse

Data Review

  • Filter by date (daily/weekly/monthly)
  • Search entries
  • Export filtered data to reports
month_log

Reports

  • Generate reports in Word and Excel
  • Create summaries or inventory status reports
report_menu report

Module Details

Roads Maintenance

  • Log concrete, asphalt, and interlock works
  • Track infrastructure repairs, fencing, painting

Electrical Maintenance

  • Record lighting and panel maintenance
  • Log line hazards, lantern installs, and materials

Warehouse System

  • Track multiple material categories
  • Monitor stock levels and historical usage
  • Set low-stock alerts

Developer Notes

Database

  • Uses SQLite with schema defined in createDB.m
  • Extensible for future features

Customization

  • Update assets/data/ text files for labels and types
  • Modify roadsTables.mat, elecTables.mat for structure
  • Add icons to assets/icons/

Extensibility

  • Add new modules by expanding SiteTrack.m
  • Include additional templates in assets/templates/

License

This project is licensed under the MIT License.


Contact

For bug reports, feature requests, or collaboration:

About

A MATLAB-based system for managing O&M activities, including mechanical, civil, electrical, and warehouse maintenance with reporting and data tracking tools.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors