Lube Oil Analysis Module
End-to-end lube oil management for maritime fleets — from PDF upload to shore analysis, communication, and defect resolution — all in one unified platform. Built on FastAPI (Python) + React.
Two deployment modes: Vessel (100% offline capable) and Shore (cloud-based multi-vessel fleet management). Powered by StaunchTec.
- Zero manual data entry — full PDF auto-extraction
- 100% offline ready — vessel independent
- Fleet-wide dashboard — all vessels, one screen
- 5-layer vessel-to-shore communication
Request a Lube Oil Module Consultation
Discuss architecture, vessel configuration, offline sync, and fleet onboarding with our maritime platform specialists.
What Is the Lube Oil Module?
A purpose-built maritime platform covering the complete lube oil lifecycle — from intelligent PDF extraction to fleet-wide analytics and structured vessel-to-shore communication.
Two Deployment Modes
Vessel (Offline): installed on vessel server — 100% offline capable. Shore (Online/Cloud): multi-vessel fleet management for shore superintendents.
Lab Supported
Shell LubeAnalyst — extensible to other labs. Email auto-sync pulls reports daily on shore at 08:00, no manual download needed.
FastAPI + React
Built on FastAPI (Python) backend with React frontend. Azure PostgreSQL + Blob Storage on shore. Local PostgreSQL + Azurite on vessel.
Complete Lifecycle
Upload → Auto-Extract → Analyse → Communicate → Resolve. Every stage tracked, audited, and synced between vessel and shore.
Upload PDF
Auto Extract
Analyse
Communicate
Resolve
Vessel & Shore Architecture
Three-environment architecture: Vessel (offline), Sync Bridge (bidirectional), and Shore (cloud) — working seamlessly together.
Vessel (Offline)
- Local PostgreSQL on vessel server
- Nginx-served React UI for crew
- Azurite for local blob storage
- Changes queued locally for sync
- Local username/password auth
Sync Bridge
- Bidirectional automatic sync
- /api/sync/* endpoints
- Version-controlled conflict resolution
- Origin field: VESSEL / SHORE
- Background worker with retry
Shore (Cloud)
- Azure PostgreSQL (cloud database)
- Azure Blob Storage for PDFs
- Multi-vessel fleet view
- Azure AD SSO authentication
- Email auto-sync daily 08:00
Intelligent PDF Upload & Auto-Extraction
Zero manual data entry. Upload a Shell LubeAnalyst PDF — the system extracts every parameter, diagnosis, and equipment hour automatically.
What Is Extracted Automatically
Vessel Info
Vessel name, IMO number, lab name, report date, oil source
Chemistry Data
Viscosity, TAN, TBN, Flash Point, all wear metals, contamination, additives — per equipment
Lab Diagnosis
Health status and diagnosis text extracted from PDF narrative section
Equipment Hours
Operational hours at time of sampling, per machinery
JSON Backup
Complete raw extraction stored in JSONB column for future audit and re-processing
Storage & Safety
Azure Blob Storage
Secure 24-hour SAS URLs — no permanent public links ever exposed
Duplicate Prevention
Unique constraint on IMO + file name prevents accidental re-uploads
Bulk Upload
Batch upload supported — onboard entire vessel history at once
Shore Email Auto-Sync
Shell reports pulled every morning at 08:00 — no manual download needed
Drag-and-Drop UI
Crew upload via simple drag-and-drop interface on vessel, no training needed
Full Chemistry Parameter Coverage
Every critical lube oil parameter captured automatically — across all four parameter groups — per equipment, per sample.
Physical Characteristics
- Viscosity @ 40°C & 100°C (cSt)
- Total Acid Number — TAN
- Total Base Number — TBN
- Flash Point (°C)
Wear Metals (ppm)
- Iron (Fe), Chromium (Cr)
- Tin (Sn), Lead (Pb)
- Copper (Cu), Aluminium (Al)
- Vanadium (V), Nickel (Ni)
- Wear Particle Index (WPI)
Contamination
- Water Content (%)
- Sodium (Na), Silicon (Si)
- Soot (%)
- IC Index
Additives
- Calcium (Ca), Zinc (Zn)
- Phosphorus (P)
- Magnesium (Mg), Boron (B)
- Molybdenum (Mo), Barium (Ba)
Fleet Dashboard — All Vessels at a Glance
Shore only. Matrix grid view: rows = vessels, columns = equipment types. Instant fleet health snapshot at a single glance.
Matrix Grid View
Rows = Vessels, Columns = Equipment Types. Each cell shows: status + sample date + days elapsed. Click any cell to drill into full detail.
Smart Filters
Multi-vessel selector, equipment grouping, column sort, vessel name search. Overdue cells auto-flag with pulse animation for pending approvals.
Summary Bar
Fleet totals: Normal | Warning | Critical count — instant health snapshot at top of screen for superintendent overview.
Drill-Down Modal
Click any cell to open full sample detail — chemistry table, PDF viewer, lab diagnosis, status history, and communications thread.
3-Year Trend Charts
Historical trend analysis for all 4 parameter groups over a 3-year rolling window — detect deterioration before critical failure.
Vessel View (Offline)
Same matrix layout scoped to vessel only. Crew sees only their vessel. All features work 100% without internet connection.
Six-Level Health Status System
Auto-extracted from lab PDF — manually updatable with full audit log. Every change triggers live feed event and targeted notifications.
All parameters within acceptable limits — equipment operating correctly.
One or more parameters trending toward limit — increased monitoring recommended.
Monitor closely — borderline readings detected. Early intervention may prevent escalation.
Immediate attention required — investigate cause and take corrective action now.
Lab has flagged a specific measurable abnormality requiring documented response.
Severe condition — maintenance action is mandatory. Shore sign-off required for closure.
5-Layer Communication — Vessel to Shore
Structured, permanent, and role-isolated communication at every sample level. No separate email or messaging tool required.
Lab Diagnosis
Objective lab findings automatically parsed from the Shell LubeAnalyst PDF report — no manual typing.
Officer Remarks
What crew observed, actions taken on board, maintenance activities performed. Written by vessel crew.
Office Remarks
Shore instructions and feedback to vessel — forms the official communication record between office and ship.
Internal Remarks
Private notes for the internal shore team only. Never visible to vessel crew — enforced at API level.
Status Change Log
Timestamped audit trail: [Date] User: Message. Full decision history, permanent record, cannot be deleted.
@Mention Notifications
Tag a user in remarks — instant targeted notification sent to them
Evidence Attachment
Image or PDF linked directly to the sample (required for some closures)
Quality Enforcement
Resolution remarks require 50+ characters — ensures thorough documentation
Permanent Record
All remarks preserved permanently — no edits or deletions allowed
Structured Defect Resolution Workflow
Every closure requires vessel action, evidence, and shore approval — with a full immutable audit trail at every step.
Vessel Officer Action
- Updates sample status
- Uploads evidence (photo/PDF)
- Writes 50+ char resolution remarks
- Submits for shore approval
Shore Superintendent Review
- Receives notification with vessel + equipment context
- Reviews evidence attachment
- Reviews all remarks layers
✅ ACCEPT
is_resolved = True. Case closed permanently.
❌ DECLINE
Sample stays open. Decline reason logged to chat.
Full Audit Trail
- Every action timestamped with username
- status_change_log permanent history
- Cannot be deleted or modified
- Acceptance: is_resolved = True
- Full trail visible to shore
Platform Features at a Glance
Everything from real-time alerts to smart configuration — built for the operational realities of maritime fleet management.
Automated Overdue Detection
Each equipment has a configured sampling interval (3 or 6 months). WARNING at due date, CRITICAL at +30 days. 15-day cooldown between alerts prevents spam. Alerts logged to Live Feed + notification to shore users.
3-Year Historical Trend Analysis
Detect deterioration trends before they become critical failures. All 4 parameter groups charted over time. Status changes overlaid on timeline. Navigate between samples from chart view.
Live Feed — Real-Time Activity Stream
Single view of all fleet activity: NEW_REPORT, STATUS_CHANGE, EVIDENCE_UPLOAD, OVERDUE, MANDATORY. Per-user read state, deep-link navigation to any sample, priority badges (CRITICAL / WARNING / INFO / SUCCESS).
Targeted Notification System
Bell icon with live unread badge. Types: mention (someone @mentioned you), status_change (vessel health update), mandatory (action flagged). Syncs across offline/online environments — no notification is ever lost.
Vessel Config — Admin Control Panel
Vessel registration (IMO, name, lab code), equipment type management, vessel-equipment mapping, name mapping (PDF translator for lab-specific naming), Excel bulk import for fleet onboarding.
Smart Auto-Flags
is_resampling_required — triggers fresh sample reminder. is_image_required — blocks closure until evidence uploaded. is_approval_pending — awaiting shore sign-off. is_resolved — fully closed with maintenance confirmed.
Role-Based Access Control & Security
Three roles — Vessel Crew, Shore Superintendent, Admin — each scoped precisely to what they need. Authentication: Azure AD SSO (shore) | Local auth (vessel) | JWT token sessions.
🛳️ Vessel Crew
On-board officers & engineers
- View own vessel only (admin assigned)
- Upload lube oil reports (PDF)
- Add officer remarks and evidence
- Request sample closure (approval required)
- Submit overdue justification
- View chemistry data and trend charts
🏢 Shore Superintendent
Fleet manager / superintendent
- View all assigned vessels (multi-vessel)
- Full fleet dashboard access
- Approve or decline sample closures
- Add office and internal (private) remarks
- Override and close samples directly
- Access live feed and notifications
👑 Admin
System administrator
- Full access — all vessels, all data
- User management (activate/deactivate)
- Assign vessels to users
- Module permission management
- Vessel config and equipment management
- Data sync controls and email triggers
Offline-First Architecture with Smart Sync
The vessel runs an identical backend locally. All features work without internet. Sync happens automatically when connectivity is restored.
What is synced: LuboilReport, LuboilSample, Notifications, LuboilEvent (live feed), Event read states, Vessel equipment config. Endpoints: /api/sync/luboil-report, /api/sync/luboil-sample, /api/sync/notification, /api/sync/luboil-event.
Internet Lost at Sea
All operations continue — data written to local PostgreSQL on vessel.
Crew Works Normally
Upload reports, add remarks, change status — every action queued in SyncQueue.
Changes Queued
Background worker manages queue with retry on failure (exponential backoff).
Internet Restored
Sync worker detects connectivity and begins processing queue automatically.
Vessel Pushes to Shore
All queued records sent to shore backend via /api/sync/* endpoints.
Conflict Resolution
Version number tracked. Higher version wins — origin field tracks VESSEL vs SHORE. No data ever lost.
Why the Lube Oil Module?
Four pillars that make this platform essential for any maritime fleet managing lube oil compliance and equipment health.
- Zero Manual Entry — full PDF auto-extraction
- 100% Offline Ready — vessel independent
- Early Warning — automated overdue/wear alerts
- Fleet Visibility — all vessels on one screen
- Full Audit Trail — every change timestamped
- Evidence-Based Closure — mandatory uploads
- 5-Layer Communication — formal vessel to shore
- Status History — complete decision record
- Email Auto-Intake (Shore) — daily Shell sync
- Batch Downloads — ZIP export one click
- Trend Analysis — 3-year predictive view
- Live Feed — real-time fleet activity stream
- Azure Blob PDF storage with secure SAS URLs
- Version-controlled conflict-free sync
- Role-based access — right data to right person
- Scalable: unlimited vessels and equipment
Implementation Methodology
Structured four-phase approach ensuring successful deployment and long-term operational reliability for your fleet.
Fleet Assessment & Planning
Evaluate vessel hardware, connectivity patterns, equipment types, lab partnerships, and compliance requirements.
Architecture Design & Configuration
Set up vessel-side local stack, Azure shore environment, equipment codes, name mapping, and user roles.
Deployment & Vessel Onboarding
Install vessel backend, configure sync engine, bulk import historical data via Excel, onboard crew with training.
Monitoring, Testing & Support
Continuous sync health monitoring, overdue alert tuning, periodic recovery testing, and long-term AMC support.
Frequently Asked Questions
Discuss the Lube Oil Module on WhatsApp
Get quick answers on architecture, offline sync, vessel configuration, and fleet onboarding for your maritime organisation.
Available during business hours • Fleet & maritime enterprise enquiries welcome
Ready to See the Lube Oil Module in Action?
Speak with our maritime platform specialists to understand deployment, configuration, and live demo options for your fleet organisation.
