Release Notes: Jobcard Manager Pro

Version: v1.0.2 (Mobile UI & Compliance Update) Release Date: May 2026

Version 1.0.2 is a targeted enhancement update focusing on improving the mobile experience for field technicians operating on smaller screens, alongside the rollout of our official documentation and compliance frameworks.

📱 Mobile UI & UX Enhancements

• Smart DataTables Search Popup: Redesigned the default data table search interface for mobile devices. The bulky search input has been replaced with a sleek, floating magnifying glass icon. Tapping the icon now triggers a clean, absolute-positioned search popup, freeing up critical vertical screen real estate on smartphones.

• Pinned Action Columns: Overrode the default responsive collapsing behavior of data tables. The final "Actions" column (containing View, Edit, and Delete buttons) is now strictly enforced to display as a table cell at all times. Technicians no longer need to click the green expansion icon to access core functions on small screens.

• Global "Zero-Breakage" Application: Both the mobile search popup and the pinned action columns were injected globally via the application footer footprint. This ensures all current and future data tables across the entire application inherit these mobile optimizations automatically, without modifying a single core view file.

📝 Documentation & Legal Compliance

• Official Installation Guide: Deployed the step-by-step visual installation documentation, precisely mapped to the v1.0.1 interactive setup wizard, including updated server requirements (PHP 8.0+, ZIP extensions).

• POPIA-Compliant Privacy Policy: Formally updated the Privacy Policy to comply with South African data protection laws, specifically covering the handling of physical service addresses, digital on-site signatures, and partner agency data sharing.

• Updated Terms of Service: Revised the Terms of Service to explicitly govern the usage of the application by direct clients, field technicians, and subcontracted partner agencies, while removing legacy accounting provisions.

• Knowledge Base Expansion: Added a comprehensive, 10-point Frequently Asked Questions (FAQ) module to address self-hosting queries, digital signature mechanics, and asynchronous background processing capabilities.

Release Notes: Jobcard Manager Pro

Version: v1.0.1 (Initial Release) Release Date: May 4, 2026

We are thrilled to announce the official v1.0.1 release of Jobcard Manager Pro. Built on a robust, native PHP Model-View-Controller (MVC) architecture, this platform is engineered to streamline field service operations, enhance subcontractor communication, and automate administrative workflows with zero UI latency.

🚀 Core Highlights & Features

1. Automated Deployment Engine

• Zero-Touch Installer: Introduced a 5-step interactive GUI installer that automatically intercepts traffic on unconfigured systems.

• Smart Environment Configuration: The installer validates server dependencies (PHP 8.0+, PDO, ZIP), provisions the database schema, executes structural migrations, and securely generates the .env and license.key files.

• Server Fallback Protocol: Added intelligent permission handling that provides users with exact copy-paste payloads if strict server environments block automated file creation.

2. Multi-Tier Role-Based Access Control (RBAC)

• Distinct Workspaces: Deployed dedicated, secure dashboard views for Administrators, Staff (Technicians), Direct Clients, and Partner Agencies.

• Partner Subcontracting Matrix: Agencies can now be onboarded with their own localized logins. Jobcards assigned to partners automatically utilize custom, agency-specific numbering sequences (e.g., AGT-0001) and apply agency co-branding.

• Admin Impersonation: Administrators can temporarily assume the session of any user to troubleshoot issues or verify portal configurations.

3. Field Execution & Time Tracking

• Live Operational Timers: Technicians utilize a responsive, live-updating timer that tracks exact on-site duration from the moment they click "Start Job" to final completion.

• Materials Management: Implemented an in-line matrix allowing technicians to actively log parts and materials utilized during the service call.

• Immutable State Locking: Once a job is marked completed, the timeline and materials matrices are locked to protect data integrity prior to signature collection.

4. Digital SignOffs & Automated PDF Generation

• Canvas Signatures: Integrated touch-friendly, HTML5 digital signature pads for both the Client and Technician to sign off on completed work directly on the device.

• Dompdf Engine Integration: Engineered a pixel-perfect, automated PDF generator that compiles the jobcard timeline, work performed, materials used, and digital signatures into a clean, 50/50 split layout.

• Dynamic Header Generation: PDFs intelligently render system owner details or partner agency co-branding (including logos and physical addresses) depending on the jobcard origin.

5. Asynchronous Background Processing

• Non-Blocking Email Queue: All outbound communications are now routed through a robust database queue, ensuring the frontend UI never hangs while waiting for SMTP server handshakes.

• Automated PDF Dispatch: Upon successful sign-off, the system silently generates the PDF to the local disk, registers it as an attachment payload in the email queue, and automatically dispatches it to all involved parties.

• Cron Dispatcher: Implemented a secure, tokenized cron endpoint to process the email queue in batches, with a built-in cleanup mechanism to safely delete temporary PDF attachments only after all queued instances are dispatched.

🛠 Technical Specifications

• Architecture: Native PHP (Strict MVC), Granular File Structure

• Frontend: Fully responsive Mobile/Desktop layout utilizing Light/Dark theme switchers.

• Database: Optimized MySQL/PDO queries with robust foreign key constraints and cascade deletion rules.