🏗️ Platform Architecture | Updated: 2025-10-25 | Version: v2.3.0

Agentic Maintenance OS Architecture

AI-Powered Maintenance Operating System architecture: autonomous agents for task automation, predictive maintenance engine, intelligent scheduling algorithms, self-evolving learning capabilities, and cross-fleet intelligence

🏗️ Technology Stack (Production-Verified)

Frontend Architecture

Technology Version Purpose & Implementation
React 18.3.1 Modern concurrent rendering with Suspense boundaries for code splitting
TypeScript 5.5.3 (strict mode) 100% type safety across codebase, zero any types policy
Vite 5.4.1 Lightning-fast HMR during development, optimized production builds with 38% bundle reduction
TanStack Query 5.56 (React Query) Advanced server state management with maritime domain-specific caching strategies
shadcn/ui + Radix UI Latest Enterprise-grade accessible component library with ARIA compliance
Tailwind CSS 3.4 Utility-first styling with custom maritime design tokens and responsive breakpoints
React Router 6.x Client-side routing with code-split lazy loading for optimal performance
react-window Latest Virtualization for efficient rendering of large equipment and task lists

Backend Infrastructure

Component Technology Implementation Details
Database Supabase PostgreSQL Enterprise-grade database with advanced indexing and materialized views
Authentication Supabase Auth Secure JWT-based authentication with multi-tenant user management
Row-Level Security PostgreSQL RLS Comprehensive data isolation with dual-access patterns (system admin + org users)
Real-Time WebSocket Subscriptions Live data synchronization with <200ms latency, selective org filtering
Storage Supabase Storage Secure file management with organization-based access control, orphan protection
Edge Functions Deno runtime Serverless compute for log ingestion and custom business logic
Connection Pooling PgBouncer Efficient database connection management for scalability

🗄️ Database Architecture: 5-Schema Design

Schema 01: Multi-Tenant Organization Structure

Purpose: Root-level organization hierarchy with complete data isolation

Schema 02: Vessel & Fleet Management

Schema 03: PMS (Planned Maintenance System) ⭐ Revolutionary

Industry First: Schedule-specific hours tracking with independent baselines per maintenance activity

Schema 04: Events & Incidents Management

Schema 05: Storage & File Management

🤖 AI Assistant: Learn the Platform Conversationally

Never Read Documentation Again: The fleetcore AI assistant knows every platform feature. Ask how to do something, get instant answers with examples.

Platform Help & Guidance

What You're Trying To Do Just Ask the AI What You Get
Set up a new vessel "How do I add a new vessel to the system?" Step-by-step walkthrough of vessel setup, required fields, best practices
Configure maintenance schedule "How do I create a 500-hour oil change schedule?" Explanation of schedule-specific hours, intervals, alert thresholds, with screenshots references
Understand alert system "Why am I getting a critical alert?" Explanation of alert triggers, how to clear them, when to reset hours
Track parts inventory "How does parts consumption tracking work?" Guide to recording parts used, reorder points, cost tracking per task
Export compliance report "How do I generate a report for PSC inspection?" Instructions for filtering data, exporting maintenance logs, audit trail access

Maritime Knowledge + Technical Specs

Beyond Platform Help: The AI also answers maritime technical questions while you work:

Intelligent Research for Vessel Data

Enable "Online Research" toggle when you need current vessel or equipment information:

Scenario How AI Helps
Adding a vessel you're taking over management for Ask: "What are the specifications for MV [Vessel Name]?" - AI searches 28 optimized maritime sources (vessel registries, class societies) and gives you dimensions, DWT, equipment list with citations
Need OEM part numbers for procurement Ask: "Wärtsilä 32 fuel injector part number" - AI finds manufacturer catalogs and cross-references
Comparing equipment for specification Ask: "Compare Caterpillar vs MAN B&W auxiliary generators" - AI analyzes multiple sources and gives factual comparison
Fleet benchmarking research Ask: "What vessels does [Competitor] operate?" - AI finds fleet lists, vessel types, and operational data

Why 28 Sources Are Optimal

We don't search the entire web randomly. We use highly optimized search criteria targeting 28 carefully selected authoritative maritime sources:

Result: Fast, accurate, verified answers - not overwhelming you with 100+ random web pages.

Real Operational Scenarios

Available Everywhere

Chat icon visible on every page. Working on maintenance schedules? Ask a question. Reviewing compliance? Ask a question. Planning procurement? Ask a question. Your maritime expert is always there.

🔄 Real-Time System Architecture

WebSocket Subscriptions

Data Type Update Latency Filtering Strategy
Equipment Hours <200ms Organization + vessel filtering
Maintenance Task Status <200ms Organization + assignment filtering
Alert Generation <200ms Organization + severity filtering
File Attachments <200ms Organization + task filtering
AI Assistant Responses <1s first token Streaming SSE with chunk delivery

Intelligent Cache Management

Maritime Domain-Specific Caching Strategy optimized for vessel operations data access patterns

Data Type Stale Time Cache Time Rationale
Vessels 5 minutes 30 minutes Vessel data changes infrequently, keep cached for quick access
Equipment 2 minutes 15 minutes Moderate change frequency, balance freshness vs performance
Maintenance Tasks 1 minute 10 minutes High change frequency, aggressive refetch for critical operational data
Organizations 15 minutes 2 hours Very stable data, long-term cache with manual invalidation
Compliance Data 10 minutes 60 minutes Important but stable regulatory tracking data

🔒 Security Architecture

Row-Level Security (RLS) Implementation

Dual-Access Pattern: System admins (global oversight) + Organization users (isolated access)

Standard RLS Policy Pattern (All Tables)

CREATE POLICY "organization_access" ON table_name
FOR ALL TO authenticated
USING (
  -- System Admin: Global access for support
  EXISTS (
    SELECT 1 FROM system_users 
    WHERE id = auth.uid() 
    AND role = 'system_admin'
    AND can_access_all_data = true
  )
  OR
  -- Organization User: Isolated to assigned org
  organization_id IN (
    SELECT organization_id FROM organization_users
    WHERE auth_user_id = auth.uid()
  )
);

Security Features

⚡ Performance Optimization

Frontend Performance

Database Performance

Performance Targets (Production)

Metric Target Measurement Method
First Contentful Paint <1.2 seconds Lighthouse audit
Largest Contentful Paint <2.5 seconds Lighthouse audit
Cumulative Layout Shift <0.1 Lighthouse audit
Lighthouse Score >95 Google Lighthouse
API Response Time <100ms (95th percentile) Application monitoring
Database Query Time <50ms (average) Database monitoring
Real-Time Update Latency <200ms WebSocket monitoring
Uptime SLA 99.99% Infrastructure monitoring

📈 Scalability Architecture

Horizontal Scaling Capabilities

Multi-Tenant Design Benefits

🛠️ Automated Database Triggers

Maintenance Workflow Automation

📊 Analytics & Reporting

Real-Time Analytics Dashboard

🚀 Enterprise Architecture Value

Platform Status

Contact: https://fleetcore.ai/contact

Technical Documentation: Available upon request for enterprise prospects