SVM SeaVesselManager Support

SeaVesselManager

Enterprise Maritime Planned Maintenance System

v4.29.26.27-JAN
Released January 2026

SeaVesselManager is a modern, offline-first Planned Maintenance System (PMS) designed specifically for the maritime industry. Built for ship owners, fleet operators, and technical managers who need reliable maintenance tracking across distributed vessel operations.

The system operates on a distributed architecture where each vessel maintains a complete local database, synchronizing bi-directionally with the central office when connectivity permits. This ensures 100% operational capability even during extended periods at sea without internet access.

Whether you manage a single vessel or a fleet of 50+ ships, SeaVesselManager scales to meet your needs while maintaining full regulatory compliance with ISM Code, SOLAS, and class society requirements.

Who Is It For?

🏢

Ship Owners

Fleet-wide visibility, compliance reporting, cost analysis, and procurement management from a central dashboard.

⚙️

Technical Managers

Equipment lifecycle tracking, PM scheduling, class survey preparation, and maintenance history analysis.

👷

Vessel Crew

Offline-capable job execution, spare part consumption, inspection logging, and work order completion from any device onboard.

Core Features

🚢

Fleet Dashboard

Real-time vessel tracking with AIS integration (Datalastic, Marinesia, AISstream), weather overlays via Windy API, and maritime chart layers including sea markers, shipping lanes, and piracy zones.

🔧

Planned Maintenance

SFI-coded equipment registry, time and running-hours based PM schedules, automatic work order generation, job assignment, and complete maintenance history with 10-year retention.

📦

Inventory & Procurement

Spare parts management with stock levels, consumption tracking, requisition workflow, RFQ management, quotation comparison, and purchase order generation.

📋

Compliance & Certificates

Vessel and crew certificate tracking with expiry alerts, class survey scheduling, finding management, QHSE incident reporting, and ISM Code audit trails.

🔄

Offline-First Sync

Full functionality without internet. Local PostgreSQL on each vessel with queue-based sync to office. Works with Starlink, VSAT, or any intermittent connection. Zero data loss.

🤖

AIVA - AI Assistant

Artificial Intelligence Vessel Assistant for natural language queries. Ask questions like "Show overdue work orders for MV Nordic Star" or "Export maintenance costs for Q4".

System Architecture

O

Office Server (Cloud)

  • • Central hub for all fleet data
  • • Master data management (equipment, plans)
  • • Procurement and reporting
  • • Sync coordinator for all vessels
  • • User and role administration
V

Vessel Server (Onboard)

  • • Complete local database replica
  • • 100% offline operation
  • • Job execution and logging
  • • Spare part consumption
  • • Auto-sync when online
Data Flow
Office ← Master Data → Vessel ← Execution Logs → Office

Technology Stack

Frontend

Next.js 14 React TypeScript Tailwind CSS React Query Recharts PWA

Backend

NestJS TypeORM PostgreSQL 18 Redis WebSocket Docker

Regulatory Compliance

📜
ISM Code
Full audit trail
🛡️
SOLAS
Safety equipment logs
🏛️
Class Society
Survey management
🗄️
Data Retention
10+ years history

Platform Statistics

112
Database Entities
57
Backend Modules
50+
Frontend Pages
7
Sync-Enabled Tables
Scale: 10-50 vessels
Sync Latency: <5 min online
Offline: Unlimited duration

Quick Start Guide

Installation guides and getting started with SeaVesselManager.

Choose Your Deployment

🏢

Office / Cloud Installation

Central server for fleet management, reporting, and crew coordination. Recommended for ship owners and technical managers.

  • • Fleet-wide dashboard
  • • Multi-vessel management
  • • Procurement & reporting
  • • Sync hub for vessels
🚢

Vessel Installation

Onboard system with full offline capability. Perfect for vessels with limited or intermittent connectivity (Starlink/VSAT).

  • • Works 100% offline
  • • Local PostgreSQL database
  • • Auto-sync when online
  • • Crew job execution

System Requirements

Office Server (Production)

  • Cloud: DigitalOcean, AWS, Azure, or self-hosted
  • OS: Ubuntu 22.04+ / Debian 12+
  • RAM: 4GB minimum, 8GB recommended
  • Storage: 50GB SSD
  • Docker: Docker Engine 24+ with Compose
  • Database: PostgreSQL 16+ (managed or local)

Vessel Server (Onboard)

  • Hardware: Mini PC, laptop, or industrial PC
  • OS: Ubuntu Server or Windows Server
  • RAM: 4GB minimum
  • Storage: 128GB SSD
  • Network: LAN access for crew devices
  • Internet: Starlink/VSAT (for sync only)

🏢 Office Installation (15 minutes)

1

Provision Cloud Server

Create a Droplet (DigitalOcean) or VM with Docker pre-installed. Select 4GB RAM, Ubuntu 24.04.

ssh root@YOUR_SERVER_IP
2

Clone Repository & Configure

Download the application and set environment variables.

git clone https://github.com/singh92/SVMSeaVesselManager.git /opt/SVMSeaVesselManagercd /opt/SVMSeaVesselManagercp .env.example .env.productionnano .env.production # Configure DB, JWT secret, domain
3

Deploy with Docker Compose

Build and start all services (PostgreSQL, Redis, Backend, Frontend).

docker compose -f docker-compose.production.yml up -d --build
4

Configure SSL & Domain

Point your domain DNS to the server and obtain SSL certificate.

apt install certbot python3-certbot-nginxcertbot --nginx -d yourdomain.com

Access Your Installation

Visit https://yourdomain.com/app and login with default admin credentials.

🚢 Vessel Installation (Onboard Setup)

1

Prepare Vessel Hardware

Install Ubuntu Server on vessel PC. Connect to ship's LAN and configure static IP (e.g., 192.168.1.100).

2

Generate Vessel Snapshot (Office)

From the office system, generate a provisioning snapshot containing vessel data, equipment, and maintenance plans.

Admin → Fleet → Select Vessel → Export Provisioning Package
3

Deploy Vessel Application

Install Docker and deploy SeaVesselManager in vessel mode.

export SVM_MODE=VESSELexport OFFICE_URL=https://yourdomain.com/api/v1docker compose -f docker-compose.vessel.yml up -d
4

Import Provisioning Package

Upload the snapshot to initialize the vessel database with equipment, PM schedules, and spare parts.

POST /api/v1/provision/import-snapshot

Vessel Ready

Crew can access http://192.168.1.100:3000 from any device on ship's LAN. Works 100% offline.

🔄 Understanding Sync

Office → Vessel

Master data (equipment specs, PM plans, spare catalog) pushes to vessels via WebSocket or 30-min polling.

Vessel → Office

Execution data (job completion, measurements, spare consumption) syncs to office when connectivity available.

Offline Queue

All mutations queued locally. Syncs automatically when online. No data loss during network outages.

📋 First Steps After Installation

  1. 1
    Change Admin Password - Go to Profile → Security → Change Password
  2. 2
    Add Your Fleet - Fleet → Add Vessel → Enter IMO, MMSI, vessel details
  3. 3
    Import Equipment - Assets → Import → Upload SFI-coded equipment list (Excel template available)
  4. 4
    Set Up PM Schedules - Maintenance → PM Schedules → Create time/hour-based intervals
  5. 5
    Add Users & Roles - Admin → Users → Invite crew with appropriate permissions
  6. 6
    Provision Vessels - Generate snapshot packages for each vessel installation

Fleet Dashboard

Real-time vessel tracking, weather overlays, and fleet-wide KPIs.

Fleet Dashboard with Weather Overlay

Fleet Dashboard showing live vessel positions with Windy weather overlay enabled

Dashboard Overview

The Fleet Dashboard is your central command center for monitoring all vessels in real-time. It combines AIS tracking, weather data, and fleet KPIs in a single view.

🗺️ Interactive Map

Zoomable world map with vessel markers, click to select and view details.

📊 KPI Cards

Top bar shows: Active Vessels, In Port, Alerts, Maintenance Due, Fleet Efficiency, Telemetry.

📋 Vessel List

Right panel with all vessels, status badges, position coordinates, and quick actions.

🌤️ How to Enable Weather Overlay

The weather overlay powered by Windy API shows real-time wind patterns, waves, temperature, and more across the map.

1

Locate the Weather Panel

Look at the bottom-right corner of the map. You'll see a floating panel labeled "Weather".

2

Click the Provider Button

Click the 🌬️ Windy button to enable the weather layer.

3

Choose Weather Layer

Select from the available layers in the "WINDY LAYERS" section:

💨 Wind 🌊 Waves 🌡️ Temp 🌧️ Rain ☁️ Clouds 📊 Pressure

Weather Active

The map will now display animated weather patterns. Wind shows as flowing arrows, waves as color gradients showing wave height.

🎮 Map Controls

Top Toolbar

Show All Cards Display info cards for all vessels
Recenter View Reset map to show all vessels
Vessels Tracked Shows count of tracked vessels
Refresh Positions Manually refresh AIS data

Left Sidebar Layers

🧭 Full Nautical Mode - enable all maritime layers
🔦 Sea Markers - buoys, lighthouses, beacons
Harbours - major ports worldwide
⚠️ Danger Zones - piracy risk areas

🚢 Vessel Interactions

Click Vessel on Map

Shows info card with vessel name, type, MMSI, IMO, position, speed, and heading.

Click Vessel in List

Pans map to vessel location and selects it. Shows the same info card.

Double-Click Vessel

Opens the vessel detail page with full information, maintenance, certificates.

Status Badges

Each vessel shows status: Sailing Offshore Supply MMSI IMO

📡 AIS Data Sources

SeaVesselManager uses multiple AIS providers with automatic cascade fallback:

Datalastic
Primary source
Marinesia
Secondary fallback
AISstream
Tertiary fallback

Status shown in footer: ● AIS Connected indicates live data feed.

Available Map Layers

🧭 Full Nautical Mode 🔦 Sea Markers ⚓ Harbours 🚢 Shipping Lanes ⚠️ Danger Zones 🌊 Ocean Depth 🌤️ Weather (Windy)

Maintenance & PMS

Planned maintenance system with work orders.

Work Order Types

PMPlanned Maintenance

Recurring jobs with time/hours intervals. Auto-creates next on completion.

UnplannedOne-time Jobs

Ad-hoc work orders for repairs, defects, or non-recurring tasks.

Priority Levels

Critical
High
Medium
Low

Assets & Equipment

SFI-coded equipment registry.

SFI Classification

1xx Hull
2xx Cargo Equipment
3xx Ship Equipment
4xx Machinery
5xx Piping Systems
6xx Electrical
7xx Instrumentation
8xx Deck Equipment
9xx Common Systems

Spare Parts

Inventory management with stock tracking.

  • Stock Tracking - Quantity on hand, minimum levels, reorder points
  • Location Management - Track across vessels and warehouses
  • Equipment Links - Connect spares to specific equipment
  • Consumption History - Usage patterns for forecasting

Procurement

Purchase orders, requisitions, RFQs.

Workflow

📋
Requisition
Approval
📨
RFQ
💰
Quote
🛒
PO
📦
Received

Certificates

Vessel and crew certificate tracking.

Vessel Certificates

  • • SMC, ISSC, Load Line
  • • Safety Equipment/Radio
  • • Class Certificates

Crew Certificates

  • • CoC, STCW, Medical
  • • Passport, Seaman's Book
  • • Flag Endorsements

⚠️ Expiry Alerts

Automatic alerts for certificates expiring in 90, 60, 30, and 7 days.

Class Surveys

Classification society surveys and findings.

Annual - Yearly check
Intermediate - Mid-cycle
Special - 5-year comprehensive
Bottom - Underwater
Continuous - Machinery program
Occasional - Incident related

QHSE

Quality, Health, Safety & Environment.

Incidents

  • • Near miss reporting
  • • Accident documentation
  • • Root cause analysis
  • • Corrective actions

Inspections

  • • Safety inspections
  • • Finding documentation
  • • Follow-up tracking
  • • Risk assessments

Voyages

Track voyages, port calls, fuel consumption.

  • Port Calls - Arrivals, departures, berth info, expenses
  • Fuel - Bunker ROB, consumption rates, efficiency
  • Reports - Noon reports, arrival/departure, summaries

Crew Management

Crew assignments and certificates.

  • Roster - Current crew with positions and contact
  • History - Rotation, sign-on/sign-off dates
  • Certificates - Monitor crew certificate validity

Documents

Document management with version control.

ProceduresManualsDrawingsReportsFormsCertificates

AIVA - AI Vessel Assistant

Intelligent assistant for vessel management.

What AIVA Can Do

🔍 Query - "Show overdue work orders for MV Nordic Star"
📊 Reports - "Maintenance costs for last quarter"
📥 Export - "Export open work orders to Excel"
👥 Crew - "Who is Chief Engineer on MV Atlantic?"

Reports & Analytics

KPI dashboards and reporting.

Maintenance

  • • Work order status
  • • Cost trends
  • • Equipment breakdown

Compliance

  • • Certificate expiry
  • • Survey status
  • • Deficiency tracking

Export Formats

ExcelCSVPDF

Changelog

Latest updates to SeaVesselManager.

API Reference

RESTful API for integrations.

Base URL

https://seavesselmanager.com/api/v1

Authentication

JWT Bearer token:

Authorization: Bearer <token>
Open Swagger API Docs →

Contact Support

We're here to help.

📧

Email Support

Get help from our team.

support@seavesselmanager.com
📚

API Documentation

Interactive Swagger docs.

seavesselmanager.com/api/docs