> ## Documentation Index
> Fetch the complete documentation index at: https://www.siya.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TMSA Compliance Tracker

> Advanced Tanker Management and Self Assessment system with task modules for comprehensive maritime fleet management and OCIMF compliance

## System Overview

Advanced maritime fleet management platform integrating with ShipPalm ERP for comprehensive tanker operations and OCIMF TMSA 3rd Edition compliance.

<img src="https://mintcdn.com/siya-6e67d02e/W6g_Ki8M7xLfD1eQ/assets/TMSA_image.png?fit=max&auto=format&n=W6g_Ki8M7xLfD1eQ&q=85&s=78a2ef42f40a44d8aeb1fb8bc01cc467" width="1506" height="1190" data-path="assets/TMSA_image.png" />

***

## Core System Architecture

```mermaid theme={null}
flowchart TB
    
    
    %% Core ERP System
    subgraph ShipPalm ["ERP System"]
        
        PMS[PMS Module]
        DEF[Defect Management]
        OPS[Operations Data]
    end
    
    %% TMSA Core
    subgraph TMSA ["TMSA Core"]
        DI[Data Ingestion]
        DB[MongoDB Collections]
        AI[TMSA Analytics]
        COMP[Compliance Engine]
    end
    
    %% Task Management
    subgraph Tasks ["Task Modules"]
        NAV[Navigation & Safety]
        MAINT[Maintenance Excellence]
        COMPLIANCE[Compliance & Audits]
        OPS_EX[Operational Excellence]
        ANALYTICS[Analytics & Reporting]
    end
    
    %% Output Systems
    subgraph Output ["Output & Reporting"]
        
        REPORTS[Compliance Reports]
        ALERTS[Alert System]
        API[API Gateway]
        WEB[Web Interface]
    end
    
    %% Data Flow
   

    AI --> Tasks
   
    COMP --> Tasks

    Tasks --> API
    Tasks --> WEB
    
    %% Internal Connections
    
    PMS --> DI
    DEF --> DI
    OPS --> DI
    
    DI --> DB
    DB --> AI
    
    AI --> COMP
    
    
    COMP --> REPORTS
    AI --> ALERTS
    
    %% Styling
    classDef external fill:#ffebee,stroke:#c62828,stroke-width:2px
    classDef erp fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
    classDef tmsa fill:#f3e5f5,stroke:#7b1fa2,stroke-width:3px
    classDef tasks fill:#e8f5e8,stroke:#2e7d32,stroke-width:2px
    classDef output fill:#fff3e0,stroke:#f57c00,stroke-width:2px
    
   
    class V2,V3,PMS,DEF,OPS erp
    class DI,DB,AI,COMP tmsa
    class NAV,MAINT,COMPLIANCE,OPS_EX,ANALYTICS tasks
    class DASH,REPORTS,ALERTS,API,WEB output
```

***

## Data Processing Pipeline

```mermaid theme={null}
flowchart LR
    %% Data Sources
    subgraph Sources ["Data Sources"]
        ERP[ShipPalm ERP]
        PMS[PMS Data]
        DEF[Defect Data]
        OPS[Operational Data]
    end
    
    %% Processing Stages
    subgraph Extraction ["Data Extraction"]
        EX1[MongoDB Queries]
        EX2[API Calls]
        EX3[Data Validation]
    end
    
    subgraph Transformation ["Data Transformation"]
        TR1[Data Cleaning]
        TR2[Normalization]
        TR3[Business Logic]
    end
    
    subgraph Processing ["Business Processing"]
        PR1[KPI Calculations]
        PR2[Compliance Rules]
        PR3[TMSA Scoring]
    end
    
    subgraph Output ["Output Generation"]
        OUT1[HTML Reports]
        OUT2[Dashboard Updates]
        OUT3[Alert Notifications]
    end
    
    %% Data Flow
    Sources --> Extraction
    Extraction --> Transformation
    Transformation --> Processing
    Processing --> Output
    
    %% Internal Flows
    EX1 --> EX2 --> EX3
    TR1 --> TR2 --> TR3
    PR1 --> PR2 --> PR3
    OUT1 --> OUT2 --> OUT3
    
    %% Styling
    classDef source fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
    classDef extract fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
    classDef transform fill:#e8f5e8,stroke:#388e3c,stroke-width:2px
    classDef process fill:#fff3e0,stroke:#f57c00,stroke-width:2px
    classDef output fill:#fce4ec,stroke:#c2185b,stroke-width:2px
    
    class ERP,PMS,DEF,OPS source
    class EX1,EX2,EX3 extract
    class TR1,TR2,TR3 transform
    class PR1,PR2,PR3 process
    class OUT1,OUT2,OUT3 output
```

***

## Task Management System

```mermaid theme={null}
flowchart TD
    %% Main Categories
    subgraph Navigation ["Navigation & Safety"]
        T1[Task 1: Machinery Hours]
        T2[Task 2: Navigation Systems]
        T3[Task 3: Safety Equipment]
    end
    
    subgraph Maintenance ["Maintenance Excellence"]
        T4[Task 4: Cargo Systems]
        T5[Task 5: Ballast Management]
        T6[Task 6: Maintenance Planning]
        T7[Task 7: Spare Parts]
        T8[Task 8: Technical Forms]
    end
    
    subgraph Compliance ["Compliance & Audits"]
        T9[Task 9: Incident Investigation]
        T10[Task 10: PSC Inspections]
        T11[Task 11: SIRE Compliance]
        T12[Task 12: Certificate Management]
        T13[Task 13: External Audits]
        T14[Task 14: Internal Audits]
        T15[Task 15: Industry Benchmarking]
    end
    
    subgraph Operations ["Operational Excellence"]
        T16[Task 16: Performance Monitoring]
        T17[Task 17: KPI Tracking]
        T18[Task 18: Risk Assessment]
        T19[Task 19: Emergency Response]
    end
    
    subgraph Analytics ["Analytics & Reporting"]
        T20[Task 20: Data Analysis]
        T21[Task 21: AI Analytics Engine]
        T22[Task 22: Report Generation]
        T23[Task 23: Trend Analysis]
        T24[Task 24: Executive Dashboards]
        T25[Task 25: Compliance Reporting]
    end
    
    %% Data Flow
    Navigation --> Maintenance
    Maintenance --> Compliance
    Compliance --> Operations
    Operations --> Analytics
    
    %% Styling
    classDef nav fill:#e8f5e8,stroke:#2e7d32,stroke-width:2px
    classDef maint fill:#fff3e0,stroke:#f57c00,stroke-width:2px
    classDef comp fill:#fce4ec,stroke:#c2185b,stroke-width:2px
    classDef ops fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
    classDef analytics fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
    
    class T1,T2,T3 nav
    class T4,T5,T6,T7,T8 maint
    class T9,T10,T11,T12,T13,T14,T15 comp
    class T16,T17,T18,T19 ops
    class T20,T21,T22,T23,T24,T25 analytics
```

***

## System Components

### 1.ERP Integration

* **Dual Schema Support**: more compatibility
* **PMS Module**: Planned maintenance system data
* **Defect Management**: Incident tracking and resolution
* **Operations Data**: Real-time vessel performance

### 2. TMSA Core

* **Data Ingestion**: Centralized data collection
* **MongoDB Storage**: Optimized document database
* **TMSA Analytics**: Compliance element processing
* **KPI Engine**: Performance metric calculations
* **Compliance Engine**: Regulatory requirement tracking

### 3. Task Management System

* **Task Modules**: Comprehensive coverage
* **Category Organization**: Logical grouping by function
* **Workflow Integration**: Seamless task progression
* **Performance Tracking**: Continuous monitoring

***

## Process Flow

### 1. Data Collection

* **ERP Integration**: ERP data extraction
* **Maintenance Data**: PMS scheduling and execution records
* **Defect Tracking**: Incident and corrective action data
* **Operational Metrics**: Vessel performance and status data

### 2. Data Processing

* **Ingestion**: Centralized data collection and validation
* **Processing**: Business logic application and KPI calculations
* **Storage**: MongoDB document storage with optimized indexing

### 3. Analytics Generation

* **TMSA Analytics**: Compliance element tracking and scoring
* **KPI Monitoring**: Real-time performance metrics
* **Compliance Reports**: Regulatory requirement tracking
* **Alert System**: Critical issue notifications

### 4. Output Delivery

* **Performance Dashboards**: Real-time operational insights
* **Executive Reports**: Compliance and performance summaries
* **Critical Alerts**: Immediate issue notifications

***

## Technical Features

* **Batch Processing**: Efficient bulk data operations
* **Real-time Updates**: Continuous data synchronization
* **Error Handling**: Robust error management
* **Performance Optimization**: Indexed database queries
* **Scalable Architecture**: Support for multiple vessels
* **Multi-version Support**: multiple ERP compatibility

***

## Key Benefits

* **Centralized Management**: Single source of truth
* **Real-time Monitoring**: Continuous compliance tracking
* **Scalable Architecture**: Support for multiple vessels
* **Regulatory Compliance**: OCIMF TMSA 3rd Edition
* **Performance Optimization**: Efficient data processing
* **User Experience**: Intuitive interface design

***

*This comprehensive TMSA architecture provides complete maritime fleet management capabilities with integrated compliance tracking, real-time monitoring, and automated reporting for optimal operational excellence.*
