InspectionProX

InspectionProX is a professional desktop application designed for managing inspection reports efficiently. Built with PyQt6 and SQLite, it offers a secure, intuitive interface for recording, editing, searching, importing/exporting, analyzing, and visualizing inspection data.

Key Features

• Secure role-based authentication (Admin, Editor, Viewer)
• Advanced reports table with powerful filters (Discipline, Area, Tag, Result)
• Dynamic, type-aware form for creating/editing reports
• Import/export support for CSV and Excel with progress feedback
• Interactive analytics dashboard with matplotlib charts
• User management and customizable report headers (Company & Project)
• Database switching, backup, and publish functionality
• Clickable hyperlinks in reports
• Modern UI with custom styling and high-DPI support

Requirements

• Python 3.8+
• PyQt6
• SQLAlchemy
• pandas & openpyxl (for Excel import)
• matplotlib (optional, for charts)

Installation & Running

1. Clone the repository: ```bash git clone https://github.com/yourusername/InspectionProX.git cd InspectionProX

Install dependencies:Bashpip install -r requirements.txtExample requirements.txt:textPyQt6 sqlalchemy pandas openpyxl matplotlib Run the application:Bashpython app.py

Project Structure textinspectionpro_x/ ├── app.py # Main entry point of the application ├── config.py # Application configuration (org name, app name, default paths) ├── requirements.txt # Python dependencies ├── app.ico # Application icon (for Windows executable) ├── core/ │ ├── init.py │ └── logging_config.py # Centralized logging setup ├── db/ │ ├── init.py │ ├── models.py # SQLAlchemy models (Report, User) │ └── manager.py # Database connection and CRUD operations ├── security/ │ ├── init.py │ ├── passwords.py # Password hashing utilities │ ├── session.py # User session management │ └── permissions.py # Permission checks based on user role ├── services/ │ ├── init.py │ ├── analytics.py # Analytics and reporting logic (counts, charts data) │ └── import_export.py # Import/export services for CSV/Excel ├── ui/ │ ├── init.py │ ├── style.py # Global stylesheet (QSS) │ ├── login_dialog.py # Login dialog │ ├── report_dialog.py # Report create/edit dialog │ ├── user_admin_dialog.py # User management dialog │ ├── reports_dialog.py # Reports center dialog (advanced search) │ ├── chart_dialog.py # Analytics dashboard with charts │ └── main_window.py # Main application window └── README.md # This file Database

Type: SQLite (local file-based) Default Path: ~/.local/share/InspectionProX/inspection_reports_local.db Main Tables: reports, users

User Roles

RolePermissionsAdminFull access: manage users, publish DB, all operationsEditorCreate, edit, delete reportsViewerRead-only access, search, export, view reports User Guide A comprehensive bilingual (Persian & English) user guide is available as user-guide.html in the project root or can be opened directly in a browser. Support

Contact: +989160684552 (WhatsApp) Last Updated: December 22, 2025

License MIT License Built with ❤️ for efficient inspection management. textThis README is clean, professional, and fully in English. It accurately reflects the provided project structure