Bases
Manage operational bases where aircraft and crew are stationed.
1 What's on this page
The Bases page allows administrators to manage the organisation's operational bases. Each base represents a physical location where aircraft and crew operate from, and must be associated with a specific airport.
Page Structure
- Search bar: Filter bases by name, airport, IATA, or ICAO code
- View toggle: Switch between Active and Deactivated bases
- Table view: Sortable columns with base details
- Pagination: Appears when more than 15 bases exist
Key Actions
- Add New Base: Create a new operational base
- Edit: Update base name or airport assignment
- Deactivate/Activate: Soft delete or restore bases
Who uses this page: System administrators with base management permissions (Bases policy).
Bases are fundamental to the system's organisational structure. They're referenced throughout Musket for crew assignments, flight operations, maintenance tracking, and quality/safety reporting.
2 Primary workflows
2.1 Create a new base
When to use this
Create a new base when opening a new operational location or establishing a crew/aircraft hub at an airport.
Steps
- Click "Add New Base" in the top-right corner of the page
- Enter base name: Provide a descriptive name (e.g., "Johannesburg Main Base", "Cape Town Hub")
- Select airport: Use the airport search field to find and select the associated airport
- Review validation: The system checks that the selected airport doesn't already have a base assigned
- Click "Submit": Save the new base
Result
The new base appears in the Active Bases table and is immediately available for use in crew scheduling, flight operations, and other modules. The base inherits its timezone from the associated airport.
Notes & rules
- One airport per base: Each airport can only be assigned to one base. If you try to select an airport that already has a base, an error message appears
- Base name is required: You cannot submit without entering a base name
- Airport is required: You must select an airport from the search field
- No duplicates: The system prevents creating multiple bases for the same airport
2.2 Edit an existing base
When to use this
Edit a base to rename it or reassign it to a different airport (if the current airport needs to change).
Steps
- Locate the base: Use search or scroll through the Active Bases table
- Click the blue Edit button (pencil icon) in the Edit column
- Update fields: Modify the base name or airport as needed
- Review validation: If changing the airport, ensure it doesn't already have another base assigned
- Click "Submit": Save your changes
Result
Changes are saved immediately. The table refreshes to show the updated base name or airport. If the airport changed, the timezone updates automatically to match the new airport's timezone.
Notes & rules
- Same validation as creation: Airport must not already have a base assigned to it
- Related data remains linked: Crew assignments, reports, and other data linked to this base remain unchanged
- Cancel discards changes: Click "Cancel" to close the window without saving
2.3 Deactivate a base
When to use this
Deactivate a base when it's no longer in use but historical data must be preserved (e.g., closing an operational location temporarily or permanently).
Steps
- Find the base in the Active Bases table
- Click the yellow Deactivate button (ban icon) in the Deactivate column
- Confirm the action in the dialog that appears
Result
The base moves from the Active Bases table to the Deactivated Bases view. It's no longer available for new assignments or operations, but historical data (reports, audits, crew assignments) remains intact.
Notes & rules
- Soft delete only: Deactivation is reversible—use the Activate button in the Deactivated view to restore
- Historical data preserved: Past reports, audits, and crew records remain linked to the base
- Not available for new use: Deactivated bases won't appear in dropdowns for new crew assignments or flight operations
2.4 Activate a deactivated base
When to use this
Activate a previously deactivated base to restore it for operational use.
Steps
- Switch to "Deactivated" view using the radio buttons
- Locate the base in the Deactivated Bases table
- Click the green Activate button (plus icon)
Result
The base moves back to the Active Bases table and becomes immediately available for crew scheduling, flight operations, and all other modules.
3 Feature reference
3.1 Search and filtering
The search bar filters bases in real-time as you type. It searches across:
- Base name
- Airport name (full display name)
- IATA code (e.g., JNB, CPT)
- ICAO code (e.g., FAOR, FACT)
Hover over the info icon next to the search bar to see a reminder of searchable terms.
3.2 Active Bases table
The Active Bases table shows all operational bases currently in use. Columns are:
Active Bases Columns
| Column | Meaning | Sortable? | Notes |
|---|---|---|---|
| Edit | Opens the edit window for this base | No | Blue pencil button. Requires edit permissions. |
| Base Name | The descriptive name of the base | Yes | Click column header to sort alphabetically |
| Airport name | Full display name of the linked airport | Yes | Click to sort by airport name |
| Airport details | Badge with airport info popover | No | Hover over the green tower icon to see IATA/ICAO codes, coordinates, and other airport details |
| Timezone | Airport's timezone (e.g., "UTC+02:00") | Yes | Inherited from the airport. Used for crew scheduling and local time conversions. |
| Deactivate | Soft-delete this base | No | Yellow ban button. Requires edit permissions. Opens confirmation dialog. |
Row actions
- Edit button: Opens the base editing window
- Deactivate button: Moves the base to the Deactivated view
Default sort
Bases appear in the order they were created. Click any sortable column header to reorder.
3.3 Deactivated Bases table
The Deactivated Bases table shows bases that have been soft-deleted. It displays:
- Base Name (sortable)
- Airport (sortable by airport name)
- Activate button: Green plus icon to restore the base to Active status
The table is simpler than the Active view because deactivated bases can't be edited until they're reactivated.
3.4 Add/Edit window
Purpose
The add/edit window is a shared component used both for creating new bases and updating existing ones. The window title changes to reflect the action: "Add new aircraft base" or "Edit aircraft base" (the term "aircraft base" is used in the window to emphasise that these are operational locations for aircraft and crew).
Fields
Base name
Type: Text input (required)
Descriptive name for the base (e.g., "Johannesburg Main Base"). Must be unique and meaningful.
Select airport
Type: Search input (required)
Search and select the airport where this base is located. The search looks up airports by name, IATA, or ICAO code.
Validation rules
- Base name is required: Cannot be empty
- Airport is required: Must select an airport from the search results
- Unique airport assignment: If the selected airport already has a base, a red alert appears: "This airport already has a base."
Buttons
- Submit: Saves the base (adds new or updates existing). Shows a spinner while processing.
- Cancel: Closes the window and discards any unsaved changes
3.5 Pagination
Pagination appears automatically when either the Active or Deactivated list contains 16 or more bases. You can choose to display 15, 30, or 60 bases per page using the "Items per page" dropdown.
Page controls show at the bottom of the table. Click page numbers or use Previous/Next arrows to navigate.
4 Permissions & access control
Access to the Bases page is controlled by the Base Management policy (Bases). There are two levels:
View Access
Required permission: Bases - View
What you can do: View the Active and Deactivated bases tables, search, sort, and see base details.
What you can't do: Add, edit, or deactivate bases. Action buttons appear disabled with "Not Authorized" labels.
Edit Access (Bases - Edit)
What you can do: All view capabilities plus add new bases, edit existing bases, and deactivate/activate bases.
Who typically has this: System administrators and operations managers.
No access: If you don't have at least one Bases permission (Bases - View or Bases - Edit), the page displays a "Not Authorized" message with an animated icon, and no data loads.
5 Troubleshooting
Why can't I see the "Add New Base" button?
Cause: You have view-only permissions (Bases - View) but not edit permissions (Bases - Edit).
Solution: Contact your system administrator to request Bases - Edit permission if you need to create or modify bases.
Why does it say "This airport already has a base"?
Cause: Each airport can only be assigned to one base. The airport you selected is already linked to another base.
Solution: Choose a different airport, or if you need to reassign the airport, first edit the existing base to unlink it (by assigning it to a different airport), then assign it to your new base.
Why are my search results empty?
Cause: Your search term doesn't match any base names, airport names, IATA codes, or ICAO codes in the current view (Active or Deactivated).
Solution: Check your spelling, try a different search term, or switch to the other view. If the base was deactivated, it will only appear in the Deactivated view.
What happens to crew and flights when I deactivate a base?
Answer: Historical data (past crew assignments, reports, audits) remains intact and visible. However, the deactivated base won't appear in dropdowns for new crew assignments, flight operations, or scheduling. Reactivate the base if it needs to be operational again.