Projects & Workspaces Directory

Projects represent strict multi-tenant isolation boundaries in Omnismith. Every data model (Attributes, Templates, Entities), Automation, Dashboard, and Security permission is isolated within its tenant scope.

---

1. Projects Directory Overview

The Projects Directory (/project/search) provides a centralized command center to view, search, and navigate across all workspaces you own or collaborate on.

Key Capabilities

• Instant Search & Quick Filters: Filter projects using the real-time search bar or toggle quick filter pills (All Projects vs. Active Workspace).
• Workspace Status: The actively selected project is highlighted with an emerald border, gradient background, and an Active Workspace badge.
• Context Switching: Click Switch to Project on any card to immediately switch your global tenant context.
• Direct Navigation: Jump straight to the entity canvas via Open Workspace or configure workspace governance via Settings.

---

2. Multi-Tenant Architecture & Context Switching

Omnismith utilizes cryptographically signed JWT tokens and strict workspace data isolation:

graph TD
    User["Authenticated User ([email protected])"]
    Switcher["Project Context Switcher (POST /auth/switch-project)"]
    JWT["Signed JWT Token<br/>(Claims: sub, email, project_id)"]
    P1["Project Workspace: Server Monitoring<br/>(Isolated Tenant Data)"]
    P2["Project Workspace: IT Asset Management<br/>(Isolated Tenant Data)"]
    P3["Project Workspace: AI Agent Auditing<br/>(Isolated Tenant Data)"]

    User --> Switcher
    Switcher -->|Issues JWT with project_id| JWT
    JWT -->|Authorization: Bearer token| P1
    JWT -->|Authorization: Bearer token| P2
    JWT -->|Authorization: Bearer token| P3

💡 Multi-Tenant Isolation

Project context is cryptographically signed inside the JWT token (project_id claim) or resolved via Personal Access Tokens (omni_*). The backend validates authorization on every request, ensuring strict data isolation and preventing cross-workspace leakage.

---

3. Creating a New Project

To create a new workspace:

1. Navigate to Projects (/project/search) from the Launcher or left navigation.
2. Click the + Add button in the header toolbar.
3. Enter the Project Name and optional Description.
4. Click Create Project to generate a clean, isolated workspace canvas.
5. Alternatively, explore the Blueprint Marketplace to bootstrap ready-made industry templates.

---

4. Project Workbench Sub-Navigation

When opening Project Settings (/project/library/:id), a dedicated bottom sub-navigation bar provides access to all project tabs:

Project Tab	Route	Description
Settings	/overview	Basic workspace metadata, name, description, timezone, and deletion safeguards.
Users	/users	Team member directory, email invites, and assigned roles.
Roles & Permissions	/roles	Custom RBAC role definitions with 45 granular permissions and resource scopes.
Audit Log	/audit-log	Immutable audit trail tracking actors, timestamps, event types, and payloads.
Sessions	/sessions	Active user sessions, IP addresses, client devices, and remote session revocation.
Push Devices	/push-devices	Registered mobile & web push notification tokens and device statuses.

---

Explore Project Tabs

• Overview & Settings — Configure basic workspace details and metadata.
• Team Members — Invite team members and manage access.
• Roles & Permissions — Configure fine-grained RBAC permissions.
• Project Audit Log — Inspect compliance event trails.
• Active Sessions — Monitor security and active sessions.
• Push Devices — Manage push notification devices.