67 lines
2.7 KiB
Markdown
67 lines
2.7 KiB
Markdown
# C2LInspecz - Automated Smartsales System Health
|
|
|
|
**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 real-time Disk space.
|
|
|
|
### 2. The "Spooler Shield" & CUPS Watchdog
|
|
The tool actively monitors the printing subsystem to prevent shop downtime:
|
|
- **Queue Monitoring**: Detects "Stuck" jobs for both Local USB and Network printers.
|
|
- **Service Monitoring**: Real-time status check of the Linux CUPS service.
|
|
- **One-Click Recovery**: Purges jammed queues and restarts the print services instantly to restore operations.
|
|
|
|
### 3. Active Self-Healing (Storage)
|
|
To prevent system crashes due to full storage, C2LInspecz includes an automatic maintenance engine:
|
|
- **Disk Pressure Detection**: Triggers when available disk space drops below 2GB.
|
|
- **Temp Cleanup**: Automatically purges old PDF reports and temporary files to free up critical system space.
|
|
|
|
### 4. 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.
|
|
|
|
|
|
|
|
|
|
### 5. 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) |