Yacht Manager User Manual

Introduction

Welcome to Yacht Manager! This application is a comprehensive tool designed to help you manage every aspect of your vessel. From tracking your voyages with a detailed logbook to maintaining a complete inventory of parts, scheduling essential maintenance, and storing important documents, Yacht Manager provides all the tools you need in one secure, easy-to-use platform.

Getting Started

Logging In

Access to Yacht Manager is handled through your existing Google account for a secure and password-free experience. The first user to ever register with the application automatically becomes an Administrator.

  1. Navigate to the login page.
  2. Click the "Sign in with Google" button.
  3. Follow the on-screen prompts to authorize the application with your Google account.

The Main Interface

The main interface is designed to be intuitive and consistent across all pages.

Header Navigation

  • Navigation Links: Switch between the Logbook, Inventory, Maintenance, Documents and Admin pages. The active page will be highlighted. On smaller screens, this menu is accessible via the "hamburger" (?) icon.
  • Yacht Selector: A dropdown menu to select which of your yachts you are currently viewing or managing.
  • Manage Yachts: A button that opens a pop-up window where you can add new yachts, edit existing ones, or delete them.
  • Welcome Message & Logout: Displays your name and a link to securely log out of the application.

Managing Your Yachts

Before you can add any logs or inventory, you must add a yacht.

  1. Click the "Manage Yachts" button.
  2. In the pop-up, fill in the Yacht Name and Model/Type.
  3. You can optionally upload a picture of your yacht.
  4. Click "Add Yacht".
  5. Your new yacht will appear in the list and will be available in the main yacht selector dropdown in the header.

The Logbook Page

The Logbook is the core of your voyage tracking.

Creating a Log Entry

  • Get GPS: Use this button to automatically populate the Date/Time and position fields from your device's GPS.
  • Fill in all relevant details about your position, course, speed, engine status, and weather conditions.
  • Attachments: You can upload multiple photos or documents (e.g., receipts, screenshots of charts) to any log entry.
  • Click "Add Entry" to save.

Managing Entries

  • Edit: Click the pencil icon to load an entry's data back into the form for editing.
  • Duplicate: Click the copy icon to populate the form with an entry's data, ready to be saved as a new entry with the current timestamp.
  • Delete: Click the trash can icon to permanently remove an entry and all its attachments.
  • View Attachments: Click the paperclip icon to view all files attached to an entry.

Exporting Log Entries

  1. Use the checkboxes on the left side of the table to select one or more log entries.
  2. Click the "Export Selected" button.
  3. In the pop-up, choose your desired format: CSV, JSON, or a user-friendly Printable page.

The Inventory Page

Keep a detailed record of all parts, spares, and supplies on board.

Adding an Inventory Item

  • Descriptors: Use the three-level descriptor system (Category > System > Item Title) to organize your inventory logically. The form will auto-suggest previously used categories to maintain consistency.
  • Quantity: Record how many units of the item you have on board.
  • Add any relevant notes and upload documents like manuals or receipts.

Replenishment & Shopping List

  • Flag for Replenishment: Click the shopping cart icon next to an item to highlight it in yellow. This marks it as needing to be purchased. Click the icon again to unmark it.
  • Export Shopping List: Once you have items marked, click the "Shopping List" button in the header of the inventory list. You can export a clean, printable worklist (with quantities and notes) or a CSV file of all items that need replenishing.

The Maintenance Page

Track all your vessel's maintenance tasks, from planned jobs to completed work.

Managing Maintenance Tasks

  • Organize Tasks: Use the same descriptor system as the inventory to categorize your maintenance jobs (e.g., Engine > Cooling System > Replace Impeller).
  • Track Details: Record the date and engine hours when the service was performed.
  • Set Status: Assign a status of "Planned", "Underway", or "Complete" to each task. The list is automatically grouped by status to give you a clear overview of what needs to be done.
  • Export Worklist: Click the "Export Planned" button to generate a printable worklist or a CSV file of all tasks currently marked as "Planned".

Important Documents

Keep a digital library of all your essential yacht documents, such as insurance certificates, registration papers, and equipment manuals.

Managing Your Documents

  • Organize: Use the category and sub-category fields to group your documents logically (e.g., Official Papers > Registration, or Equipment > Engine Manual).
  • Upload Files: Attach the actual document files (PDFs, images, etc.) to each entry for secure storage and easy access.
  • Add Notes: Use the notes field to record important information like expiry dates, policy numbers, or service contacts related to the document.

Admin Panel

The Admin Panel is a special page visible only to users with the 'admin' role. The first user to ever register automatically becomes the administrator.

User Management

  • View Users: See a list of all users registered in the system.
  • Change Roles: Promote other users to an 'admin' role or demote them back to a 'user' role using the dropdown menu.
  • Delete Users: Permanently delete a user and all their associated data (yachts, logs, inventory, etc.). This action is irreversible and requires confirmation.

Troubleshooting

  • GPS Not Working: Ensure you are accessing the website via a secure `https://` connection and that you have granted the site location permissions when prompted by your browser.
  • Data Not Loading: If a page appears blank or stuck on "Loading...", the first step is always to ensure you have at least one yacht created and selected via the "Manage Yachts" modal.
  • Login Issues: If you are unable to log in, try clearing your browser's cache and cookies for the site and attempt to log in again.