release: bump version to 0.44.0

docs/technical/en/earth-news-live-streams-collector-format.md

@@ -103,7 +103,7 @@ Goals:
 
 ## Collector Configuration
 
-`news_live_streams` does not need a separate new page; it reuses the existing data source configuration:
+`news_live_streams` does not need a separate new page; it reuses Collector Settings under `/settings`:
 
 - `endpoint`
   - Channel directory JSON API URL

docs/technical/en/manual.md

@@ -178,6 +178,7 @@ Earth is used to observe in a single globe view:
 - Satellites and orbital trails
 - Submarine cables and landing points
 - Compute centers
+- AIS vessels
 - Country borders, grid lines, HD texture, cloud layer, terrain
 - Live news streams and situational news
 - Search and focused object details
@@ -195,6 +196,7 @@ Common layers include:
 - Submarine cables
 - Compute centers
 - BGP observation
+- AIS vessels
 - Satellites
 - Orbital trails
 - Terrain
@@ -205,6 +207,21 @@ Some layers have dependencies:
 - Trails require Satellites
 - When HD texture is off, the globe shows the base map and edge glow effect
 
+### Legend
+
+The lower-left legend follows the currently focused or enabled layer.
+
+Current legend modes include:
+
+- Cables
+- Satellites
+- Country borders
+- Compute centers
+- BGP
+- AIS vessels
+
+AIS vessel legend entries are grouped by vessel type: cargo, tanker, passenger, fishing, military, anchored/slow, and other. Triangle markers represent moving vessels; dots represent anchored or slow vessels.
+
 ### Search
 
 Earth search finds current globe objects, such as:
@@ -233,6 +250,25 @@ The settings panel contains:
 
 These settings are stored in browser local storage. They revert to defaults if you switch browsers or clear site data.
 
+### View Controls
+
+Earth supports mouse, touchpad, and touchscreen interaction.
+
+Common controls:
+
+| Action | Result |
+| --- | --- |
+| Left-button drag | Rotates the globe |
+| One-finger drag | Rotates the globe on touch devices |
+| Mouse wheel | Zooms the view in or out |
+| Two-finger pinch | Zooms the view on touch devices |
+| Zoom buttons | Adjust zoom in fixed steps |
+| Click the zoom percent | Resets to the default zoom |
+
+When zooming, the top capsule briefly shows the current zoom level, for example `Zoom 180%`. This indicates view zoom only, not data loading progress. Loading status takes priority and will not be interrupted by zoom feedback.
+
+Drag sensitivity adjusts automatically based on the current zoom. Around the default view it keeps the normal rotation feel; when zoomed in, dragging becomes progressively finer for inspecting a region, vessel, satellite, or BGP event; when zoomed out, dragging is slightly faster for global browsing.
+
 ### Cruise Mode
 
 Cruise mode makes Earth automatically cycle through focus targets.
@@ -308,7 +344,7 @@ Common pages:
 | --- | --- | --- |
 | Dashboard | `/admin` | System overview |
 | Earth | `/earth` | Opens the public Earth page |
-| Data Sources | `/datasources` | Manage data sources and trigger collection |
+| Data Sources | `/datasources` | View data sources and trigger collection |
 | Collected Data | `/data` | View collected data |
 | BGP Observation | `/bgp` | BGP situational data |
 | System Alerts | `/alerts/system` | System-level alerts |
@@ -321,17 +357,21 @@ Common pages:
 
 ### Data Sources
 
-`/datasources` shows and manages collection sources.
+`/datasources` shows collection sources and triggers collection. It is now a data source directory that lists built-in and custom sources in one table.
 
 Common operations:
 
 - View data source status
 - Trigger collection
 - View recent collection tasks
-- Adjust configuration
+- Open the read-only detail drawer for endpoint, headers, runtime config, and built-in/custom source type
 
 If a category of objects is missing on Earth, start here to confirm the data source is available.
 
+The data source name opens an information drawer only. Endpoint, credentials, headers, and custom source configuration are maintained under `/settings` collector settings.
+
+When collection tasks are running, the progress area shows a clickable `Collecting N` pill. Clicking it opens a modal with each running task's phase, progress, and processed count.
+
 ### Collected Data
 
 `/data` shows the collected data table.
@@ -369,10 +409,50 @@ Current common uses:
 
 - System settings
 - TV live stream source configuration
-- Data source configuration entry points
+- Collector settings
+- External integrations and AI Provider configuration
 
 Available configuration depends on the current user's role.
 
+#### Collector Settings
+
+`/settings?tab=collector_credentials` is currently displayed as Collector Settings. It manages connection settings for all collectors, not only credentials.
+
+Use it to:
+
+1. Select a collector from the dropdown.
+2. Review tags such as `Requires credentials`, module, enabled state, and `Unchecked` / `Available` / `Unavailable`.
+3. Click the plug icon next to the selector to run a health check.
+4. Edit endpoint, request headers, timeout, and retry settings.
+5. Save the collector settings.
+
+Free collectors are checked by requesting their endpoint directly. Credentialed collectors use their credential provider. If endpoint or credential fingerprint changes after the last successful validation, the collector must be checked again.
+
+The system treats a collector as connected when the current configuration has either collected data successfully or passed the manual connection check.
+
+#### BarentsWatch AIS Credentials
+
+`BarentsWatch AIS` is a credentialed built-in collector. Its credential card appears above the basic configuration card.
+
+Configured fields:
+
+- `Client ID`
+- `Client Secret`
+- `Endpoint`
+
+If a secret is already configured, the input shows a masked preview. Keeping that preview unchanged preserves the stored secret; entering a new value replaces it.
+
+BarentsWatch AIS credentials can be read from:
+
+1. Collector settings saved in the console.
+2. Backend environment variables:
+   - `BARENTSWATCH_CLIENT_ID`
+   - `BARENTSWATCH_CLIENT_SECRET`
+   - historical spellings: `BARRENTSWATCH_CLIENT_ID`, `BARRENTSWATCH_CLIENT_SECRET`
+3. matching `export` lines in `~/.zshrc`.
+
+If connection fails, the page opens the credential guide. The guide can be regenerated through AI Provider or reset to the default guide. The default guide points users to the official BarentsWatch tutorial and emphasizes selecting `AIS - API`, not the regular `BarentsWatch - API`.
+
 ### System Logs
 
 `/logs` views system logs. If the menu item is not visible, the current user likely lacks the required role.

docs/technical/en/quickstart.md

@@ -73,6 +73,7 @@ Once in, verify:
 - The globe renders correctly
 - The right-side layer panel can toggle layers on/off
 - Search can find cables, satellites, compute centers, BGP events
+- Mouse drag, wheel zoom, and zoom percent feedback work correctly
 - Settings panel can switch cruise mode, day/night mode, satellite display style
 
 ## 4. Open the Console
@@ -87,7 +88,7 @@ The console manages data sources, collected data, situational observation, alert
 
 First-time inspection checklist:
 
-- `/datasources`: data source configuration and collection status
+- `/datasources`: data source directory and collection triggers; endpoint, headers, and credentials are configured under `/settings` collector settings
 - `/data`: collected data
 - `/bgp`: BGP situational view
 - `/alerts/system`: system alerts