Crew Ranks

Database → Crew Ranks is the company's list of ranks, together with each rank's departments and the starting point it gives a crew member: the documents they are expected to hold and the permissions they are offered when invited to a yacht. Yachts take their own ranks from this list.

The list

The table shows the Rank Name, its Departments, the Default documents it carries, and the row actions (Edit and Delete). Above the table are a Ranks count, an Add Rank button, and a search box that matches the rank name or any of its departments.

The built-in Captain role always appears as a row in the table so you can set default required documents for captains across the fleet. Because Captain is a built-in role rather than a company rank, its Delete button is disabled.

A new company starts with a set of common yacht ranks, most of them already assigned to departments, which you can edit or delete like any other.

Adding a rank

Click Add Rank. The panel that opens has:

• Rank Name — required, and unique within your company (capitalisation is ignored when checking). Captain cannot be used: it is a built-in role rather than a rank you define.
• Departments — optional. Pick one or more departments that other ranks already use, or type new ones; a typed name that differs only in capitalisation from an existing one takes the existing spelling.
• Default required documents — the crew documents a holder of this rank should have, picked from Database → Crew Documents. Click Add requirement to add a requirement row; when any of several documents is acceptable (for example II/2 or Master (Y) <3000GT), put them in the same requirement row as alternatives.
• Default Permissions — the same permission matrix used when inviting somebody to a yacht. As the panel notes, these can be edited on the vessel when inviting the user.

Save with Save; Cancel discards what you entered.

Editing a rank and Captain's default documents

Clicking Edit on a company rank opens Edit Rank — followed by the rank's name. The Rank Name field is not shown: a rank's name cannot be changed once it exists. Its Departments, Default required documents and Default Permissions can all be updated. If you have unsaved changes, Cancel warns you before discarding them.

Clicking Edit on the Captain row opens Edit Rank — Captain, which contains Default required documents for Captain. Because Captain is a built-in role with full vessel access, it has no department or permission matrix to configure here.

How a rank reaches a yacht

There is no "default rank" setting. A yacht has its own rank list, in Vessel Settings → Crew → Ranks and Departments, and ranks get there in only two ways, both picking from this company list:

• When the yacht is created with a vessel profile — the ranks ticked in that profile are copied in. A yacht created without a profile starts with no ranks.
• Afterwards, from the yacht — Add New Rank in Ranks and Departments offers the company ranks the yacht does not have yet.

Either way the yacht then owns its copy. Changing or deleting the rank here later does not remove it from yachts that already have it.

Departments — used when a yacht is created

A rank's default departments matter when a yacht is created from a vessel profile: the yacht's departments are created from the profile's ranks, grouping ranks that share a department name (capitalisation ignored) and leaving ranks without one out. A rank with several departments is placed into each of them on the new yacht. After that, the yacht manages its own departments in Vessel Settings → Crew → Ranks and Departments, so changing a rank's departments here does not change any existing yacht, and ranks added to a yacht later are not placed in a department automatically.

Default required documents — copied once

For company ranks, default required documents are copied onto a yacht at the moment the rank is added to that yacht (either via a vessel profile when the yacht is created, or later in Ranks and Departments). Yachts that already have the rank are not changed, and editing the requirements here afterwards does not reach back to them.

For Captain, default required documents are copied to every new yacht when it is created (whether or not a vessel profile is used); existing yachts are not changed.

When the copy happens:

• Each requirement row (including any alternative documents in that row) is created on the yacht under the matching crew document category, ignoring capitalisation. If a requirement combines alternatives from different categories, the first document's category is used. Anything with no matching category on that yacht is skipped rather than a category being created for it.
• A requirement that already exists on the yacht for that rank and the same document set is left alone, so nothing is duplicated.
• When ranks are added manually in Ranks and Departments, a message confirms how many document requirements were copied and lists any that were skipped for want of a matching category.

Default Permissions — read live

Default permissions work the other way round. When somebody is invited to a yacht with a particular rank, the permission matrix is pre-filled from the company rank of the same name (again ignoring capitalisation). It is a starting point only — whoever sends the invitation can change it before inviting.

So editing a rank's default permissions here changes what future invitations start from on every yacht, immediately. People already invited keep the permissions they were given.

Deleting a rank

Delete removes the rank from the company list after a confirmation. It is refused while any vessel profile still includes the rank — the message names the profiles; untick the rank in them first under Database → Vessel Profiles.

Yachts that already have a rank of that name keep it, along with the crew assigned to it. With no company rank behind it, though, the rank no longer supplies default permissions to new invitations, and it is no longer offered when adding ranks to a yacht.

Removing a rank from a single yacht is a separate action, done in Vessel Settings → Crew → Ranks and Departments. It is refused while the rank is still used there by crew assignments, departments, safe manning, policies or crew document requirements.

Who can change it

Company and vessel accounts can read the rank list, since the yachts need it. Adding, editing and deleting ranks requires a Management Admin or Management User account; a Management Viewer can open a rank or Captain in read-only view, and any delete attempt is refused.