Skip to content

Latest commit

 

History

12 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

🏗️ SMASCO Workforce Explorer

Version License: MIT Made with ❤️

A powerful single‑page web application to explore, manage, and validate SMASCO workforce data.


📖 Table of Contents


🧭 Overview

SMASCO Workforce Explorer is a client‑side dashboard for browsing contracts, projects, and worker details. It provides a clean interface for:

  • Browsing all workforce data with advanced filtering and sorting.
  • Drilling down into individual worker profiles with document expiry tracking.
  • Generating payslips on‑demand by selecting a worker and period.
  • Validating document expiry and viewing status distributions.
  • Exporting the full dataset to Excel.

All data is cached locally using IndexedDB, enabling offline access and fast reloads.


✨ Features

Feature Description
🔐 Secure Authentication Log in using your SMASCO customer portal credentials.
📂 Project/Contract Tree Navigate your data hierarchy; collapse/expand contracts and projects.
👷 Worker Grid Sort, filter, and search workers by name, ID, passport, profession, etc.
👤 Worker Profile Modal View detailed personal, document, and project information.
📄 Payslip Lookup Select a worker and a period (year/month) to request and view payslips.
🖨️ Print Payslip Print or save a payslip as PDF from the viewer.
✅ Validation Dashboard Overview of expired/expiring documents and worker status distribution.
📊 Excel Export Generate a master Excel file of all filtered workers.
⚡ Parallel Extraction Concurrent data fetching for faster population.
💾 IndexedDB Cache All worker details and summaries are cached locally for fast reloads.
📱 Offline Support Service worker and cache provide basic offline functionality.

🧰 Tech Stack

  • HTML5 / CSS3 – semantic markup, TailwindCSS for styling.
  • JavaScript (ES6+) – Vanilla JS with async/await.
  • IndexedDB – local persistence via a custom wrapper.
  • SheetJS (XLSX) – Excel export.
  • jsPDF / html2canvas – (optional for PDF export, currently uses print).
  • Lucide Icons – beautiful icon set.
  • TailwindCSS – utility‑first CSS framework.
  • Service Worker – basic offline caching.

🚀 Getting Started

Prerequisites

  • A modern web browser (Chrome, Edge, Firefox, Safari).
  • Valid SMASCO customer portal account credentials (username/password).

Installation

This is a single HTML file – no build tools needed!

Download index.html and open it directly in your browser.

About

SMASCO Workforce Explorer — single-page web app to browse contracts, projects, worker profiles, validate documents, view payslips, and export payroll data. Works offline with IndexedDB caching.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages