feat: Add Debian packaging script, enhance configuration loading with multi-path support, and enable config saving.

README.md

@@ -1,3 +1,53 @@
-# C2LInspecz
+# C2LInspecz - Automated Smartsales System Health
 
-Smartsales System Diagnosis tool
+**C2LInspecz** is the official diagnostic and health-monitoring utility by **Code2Lab**. It is a modern, high-performance GUI application designed to identify, troubleshoot, and resolve issues within the Smartsales POS ecosystem.
+
+## 🚀 Core Features
+
+### 1. Automated System Audit
+A comprehensive "One-Click" audit that analyzes your shop's infrastructure in real-time:
+- **Network Integrity**: Verifies LAN connectivity, Internet access, and Shop Server reachability.
+- **Printer Ecosystem**:
+    - **USB Printers (Cashier)**: Scans the physical USB bus to ensure local receipt printers are connected.
+    - **Network Printers (Kitchen/Bar)**: Pings remote printers to verify they are online and responding.
+- **Hardware Health**: Monitors CPU load, RAM usage, and Disk space.
+
+### 2. The "Spooler Shield" (Auto-Fix)
+The tool monitors the internal print queue for "Stuck" jobs that often freeze cashier operations. If glitches are detected, the user can purge the queue with a single click to restore normal printing.
+
+### 3. Integrated Settings Wizard
+No more manual JSON editing. Shop managers can use the **⚙️ Settings** tab directly in the app to:
+- Update the Shop Server IP.
+- Add, Edit, or Remove Network and USB printers.
+- Save configurations instantly to the system path.
+
+### 4. Smart Escalation
+Guides users through self-repair (e.g., "Check power cable"). If a failure is unresolvable locally, the tool packages diagnostic logs into a support ticket for the Code2Lab team.
+
+## 📦 Installation
+
+C2LInspecz is distributed as a native Debian package for seamless POS integration.
+
+1. Download the latest `.deb` package.
+2. Install via terminal:
+   ```bash
+   sudo dpkg -i c2linspecz_0.1.0_amd64.deb
+   ```
+3. Launch **"C2LInspecz"** from your system's Applications menu.
+
+## 🛠 Developer Guide
+
+### Build Requirements
+- Rust (Cargo)
+- `dpkg-deb` tool
+
+### Packaging the Installer
+To generate a new release installer:
+```bash
+cargo build --release
+./scripts/build_deb.sh
+```
+The final package will be ready at `target/c2linspecz_0.1.0_amd64.deb`.
+
+---
+© 2026 **Code2Lab Team** | [support@code2lab.com](mailto:support@code2lab.com)