<!--
 Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 SPDX-License-Identifier: GPL-3.0-or-later
-->

# MokoSuite Marina

Slip inventory, vessel registration, fuel tracking, seasonal contracts, and launch service module for MokoSuite on Joomla 6.

## Overview

MokoSuiteMarina is a Layer 2 module in the MokoSuite platform, building on MokoSuiteClient (Layer 0) and MokoSuiteCRM (Layer 1) to provide complete marina operations management.

## Package Contents

| Extension | Type | Description |
|---|---|---|
| plg_system_mokosuitemarina | System Plugin | Schema, configuration, event handling |
| com_mokosuitemarina | Component | Admin views for marina management |
| plg_webservices_mokosuitemarina | Webservices Plugin | REST API routes |

## Features

- **Dock Management** -- fixed, floating, dry storage, mooring, and transient dock types
- **Slip Inventory** -- dimensioned slips with multi-tier rate schedules
- **Vessel Registration** -- hull ID, registration, insurance tracking linked to CRM contacts
- **Seasonal Contracts** -- daily/weekly/monthly/seasonal/annual terms with auto-renew
- **Fuel Tracking** -- gasoline, diesel, ethanol-free with per-gallon pricing and pump tracking
- **Launch Service** -- launch, haul-out, move, and inspection scheduling with crew assignment
- **Waitlist** -- position-tracked waitlist with preferred dock/slip type
- **Billing** -- charge tracking for slip rental, fuel, launch, power, water, and more

## Database Schema

| Table | Description |
|---|---|
| #__mokosuitemarina_docks | Dock structures and amenities |
| #__mokosuitemarina_slips | Individual slip inventory with rates |
| #__mokosuitemarina_vessels | Registered vessels with owner links |
| #__mokosuitemarina_contracts | Slip rental contracts |
| #__mokosuitemarina_fuel_log | Fuel dispensing records |
| #__mokosuitemarina_launch_log | Launch/haul-out service log |
| #__mokosuitemarina_waitlist | Slip waitlist queue |
| #__mokosuitemarina_charges | Billing charges and payments |

## Requirements

- Joomla 6.x
- PHP 8.3+
- MokoSuiteClient (Layer 0)
- MokoSuiteCRM (Layer 1)

## Installation

Install via Joomla Extension Manager using the package file `pkg_mokosuitemarina.zip`.

Updates are delivered via [MokoGitea update server](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteMarina/updates.xml).

## License

GNU General Public License v3.0 or later -- see [LICENSE](LICENSE).

## Links

- [Documentation](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteMarina/wiki)
- [Issues](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteMarina/issues)
- [MokoSuite Platform](https://mokoconsulting.tech)