Cloudtreno FSM

Fleet & Service Management System Architecture

An end-to-end synchronized ecosystem featuring a Secure Web Admin Panel, Live Map Telemetry, and a Hardware-Integrated Mobile App.

🌐 3-Tier Connected Ecosystem

How data flows securely across all three platforms in real-time:

1. Mobile Client (Flutter)

Ground Telemetry

Requests hardware GPS position
Captures camera work proofs
Syncs live coordinates every 2 mins
Retrieves targeted tasks and broadcasts

➡️

2. Secure Backend (Python/Flask)

API Gateway & Logic

Reverse proxy routing via Nginx (Port 80)
Encrypted communication via SSL (HTTPS)
Database connection pooling
CSV reporting parsers (Import/Export)

➡️

3. Database (PostgreSQL)

Relational Storage

Strict cascading data integrity
Live session & credentials validation
Dynamic geographical spatial points
Automated sequential primary keys

📋 Admin Control Center (Web)

The central dashboard provides total control over projects, staff, and system records:

✔ Persistent Login Sessions: Handled securely via LocalStorage. Refreshes won't trigger log-out.
✔ Background Auto-Sync: Silently updates tables, active check-ins, and stats every 10 seconds.
✔ Live Broadcast System: Send immediate notification bulletins directly to all field devices.

Operational Modules

🏢 Projects Management
Add projects and assign geofence areas.

👥 Employees Management
Create staff credentials and unique passwords.

📅 Attendance Logs
Check-In / Out records with edit and delete capabilities.

📊 Excel CSV Reports
Bulk data upload templates and structured report downloads.

📱 Employee Mobile App (Flutter)

Device Hardware Integration

📍

Real Device GPS: Uses Geolocator to verify exact coordinate telemetry on check-in. No more fake positions.

📸

Camera Work Proofs: Built-in image-picker enforces uploading photos before tasks can be marked completed.

🔐

Persistent Sessions: SharedPreferences keeps employees logged in, avoiding password prompts on app restart.

A streamlined and secure tool for field technicians:

✔ IndexedStack Layout: Preserves local state on tab switches, protecting checked-in states and inputs.
✔ Secure Filtering: Employees can only view tasks assigned directly to their employee ID.
✔ Remarks and Status Sync: Enter progress remarks and set states ('Pending', 'In Progress', 'Completed') in real-time.

🗺️ Live Map Tracking & Telemetry

The Map Engine utilizes Leaflet.js to plot coordinates with maximum reliability:

📍 Check-In Hubs (Blue Pins): Plots static check-in points showing the location name (Lat/Lng), timestamps, and employee name.
🟢 Live Tracking Dots (Green Circles): Rendered as native SVG circle vectors. It never fails to load and stays immune to browser adblocker policies.
⏱️ Offline Auto-Cleanup: The backend filters and removes employees from the live tracker if their location sync hasn't been updated in over 10 minutes.

Tracking Telemetry Cycle

Device GPS (High Accuracy)

➔

2-Min API Post Sync

➔

Nginx Reverse Proxy

⬇

Leaflet Vector Circles Renderer

⮠

PostgreSQL Spatial Upsert

⚙️ Production Security & Stability

🔒

SSL Encryption

All data transfers between Web Admin, Mobile App, and Database run over encrypted HTTPS pipelines managed by Let's Encrypt certificates.

⚡

Gunicorn & Nginx

Built-in development servers are bypassed. The application runs on Gunicorn WSGI workers behind Nginx reverse proxy gates for load handling.

🛡️

Cascading Integrity

Database triggers handle referential deletions securely. Deleting an employee safely clears associated tasks and logs, preventing system crashes.