docs: Update documentation for v0.3.0 release

Author: AlexMercedCoder

deployment_assets/demo/evaluate_multi_tenant/README.md

@@ -50,6 +50,7 @@ You must create a Tenant and a specific Tenant Admin user to manage resources.
    - **Access Key**: `minioadmin`
    - **Secret Key**: `minioadmin`
    - **Vending Strategy**: `AWS Static` (Ensure "Use STS" is **UNCHECKED**)
+   - **Path Style Access**: `true`
    - Click **Create**
 3. Go to **Catalogs** → **Create Catalog**
    - **Name**: `acme_cat`

deployment_assets/demo/evaluate_single_tenant/README.md

@@ -30,6 +30,7 @@ Since the memory store starts empty, you must create a Warehouse and Catalog bef
    - **Access Key**: `minioadmin`
    - **Secret Key**: `minioadmin`
    - **Vending Strategy**: `AWS Static`
+   - **Path Style Access**: `true` (Add as property or check box if available)
    - Click **Create**.
 3. Go to **Catalogs** → **Create Catalog**
    - **Name**: `demo`
@@ -58,7 +59,8 @@ curl -X POST http://localhost:8080/api/v1/warehouses \
       "region": "us-east-1",
       "endpoint": "http://minio:9000",
       "access_key_id": "minioadmin",
-      "secret_access_key": "minioadmin"
+      "secret_access_key": "minioadmin",
+      "s3.path-style-access": "true"
     }
   }'
 

deployment_assets/demo/evaluate_single_tenant/demo_client.py

@@ -21,6 +21,7 @@ def main():
             # We rely on Pangolin's Vended Credentials for S3 access.
             # These point to 'http://minio:9000' which is accessible within the Docker network.
             # Do NOT override s3.endpoint here unless you are configuring /etc/hosts on your machine.
+            # Ensure your Warehouse creation step included "s3.path-style-access": "true" for MinIO.
         }
     )
 

docs/backend_storage/mongodb.md

@@ -120,6 +120,10 @@ Pangolin uses the following collections:
 - `branches` - Branching information
 - `tags` - Snapshot tags
 - `commits` - Commit history
+- `service_users` - API identities
+- `system_settings` - Global configuration
+- `merge_operations` - Merge tracking
+- `merge_conflicts` - Conflict resolution data
 db.tenants.createIndex({ "name": 1 }, { unique: true })
 
 // Warehouses

docs/backend_storage/postgresql.md

@@ -132,11 +132,14 @@ The comprehensive schema includes:
 
 **Governance & Security**:
 - `users` - Root and Tenant user accounts
+- `service_users` - Machine-to-machine API identities
 - `roles` - RBAC role definitions
 - `user_roles` - Role assignments to users
 - `permissions` - Direct (TBAC/RBAC) permission grants
 - `access_requests` - Data discovery access workflows
 - `audit_logs` - Comprehensive tamper-evident trail
+- `merge_operations` - Branch merge tracking
+- `merge_conflicts` - Conflict details for merges
 - `revoked_tokens` - Blacklisted JWT identifiers
 - `active_tokens` - (Internal) Session tracking for active tokens
 

docs/cli/admin-system-settings.md

@@ -0,0 +1,51 @@
+# System Settings Management
+
+The `pangolin-admin` tool provides commands to view and update global system configuration. These settings are stored in the backend database and override default environment variables where applicable.
+
+## Commands
+
+### `get-system-settings`
+
+Retrieve the current global system configuration.
+
+**Usage:**
+```bash
+pangolin-admin get-system-settings
+```
+
+**Output:**
+```json
+{
+  "allow_public_signup": false,
+  "default_warehouse_bucket": "warehouse",
+  "default_retention_days": 30,
+  "smtp_host": "smtp.example.com",
+  "smtp_user": "admin"
+}
+```
+
+### `update-system-settings`
+
+Update one or more global configuration parameters.
+
+**Usage:**
+```bash
+pangolin-admin update-system-settings \
+  --allow-public-signup true \
+  --default-retention-days 90
+```
+
+**Options:**
+- `--allow-public-signup <bool>`: Enable or disable public user registration.
+- `--default-warehouse-bucket <string>`: Default bucket name for new warehouses.
+- `--default-retention-days <int>`: Default data retention period.
+- `--smtp-host <string>`: SMTP server hostname.
+- `--smtp-port <int>`: SMTP server port.
+- `--smtp-user <string>`: SMTP username.
+- `--smtp-password <string>`: SMTP password (write-only).
+
+**Example:**
+```bash
+# Enable public signup and set default retention to 60 days
+pangolin-admin update-system-settings --allow-public-signup true --default-retention-days 60
+```

docs/cli/overview.md

@@ -18,6 +18,8 @@ Targeted at Root and Tenant Admins for infrastructure and identity management.
 | `create-catalog` | Provision Iceberg or Federated catalogs. | Admin |
 | `grant-permission`| Assign RBAC/TBAC roles and access levels. | Admin |
 | `list-audit-events`| Comprehensive forensic and security tracking. | Admin |
+| `create-service-user`| Manage machine-to-machine API identities. | Admin |
+| `update-system-settings`| Configure global platform defaults. | Root |
 
 ### 2. `pangolin-user` (The Data Tool)
 Targeted at Data Engineers and Analysts for discovery and versioning.

docs/features/audit_logs.md

@@ -63,7 +63,7 @@ Every log entry follows a standardized structure:
 | `user_id` | UUID of the actor. |
 | `username` | Readable name of the actor. |
 | `action` | The operation (e.g., `create_table`, `merge_branch`). |
-| `resource` | Path to the affected object (e.g., `catalog/ns/table`). |
+| `resource_name` | Path to the affected object (e.g., `catalog/ns/table`). |
 | `result` | `success` or `failure`. |
 | `timestamp` | UTC ISO8601 string. |
 | `metadata` | Action-specific JSON (e.g., old/new schema ID). |

docs/getting-started/configuration.md

@@ -6,7 +6,7 @@ Pangolin follow a "Configuration-over-Code" philosophy, allowing for flexible de
 
 Most settings are managed via **Environment Variables** at startup. This includes everything from the port number to the metadata persistence backend.
 
-- For a complete list of variables, see **[Environment Variables](./env_vars.md)**.
+- For a complete list of variables, see **[Environment Variables](../environment-variables.md)**.
 - For deployment-specific patterns, see **[Deployment Guide](./deployment.md)**.
 
 ## Client Configuration Discovery

scripts/build_docker_sequential.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+set -e
+
+echo "Starting Sequential Docker Build..."
+
+echo "--- Building API (1/3) ---"
+docker buildx build --platform linux/amd64,linux/arm64 -t alexmerced/pangolin-api:latest -t alexmerced/pangolin-api:0.3.0 --push -f pangolin/Dockerfile pangolin
+
+echo "--- Building CLI (2/3) ---"
+docker buildx build --platform linux/amd64,linux/arm64 -t alexmerced/pangolin-cli:latest -t alexmerced/pangolin-cli:0.3.0 --push -f pangolin/Dockerfile.tools pangolin
+
+echo "--- Building UI (3/3) ---"
+docker buildx build --platform linux/amd64,linux/arm64 -t alexmerced/pangolin-ui:latest -t alexmerced/pangolin-ui:0.3.0 --push -f pangolin_ui/Dockerfile pangolin_ui
+
+echo "All builds completed successfully."