Organization Model

​

Overview

​

Schema Structure

​

Core Fields

{
  name: string,              // Display name
  slug: string,             // URL-safe identifier
  profile: {                // Public profile
    website?: string,
    contactEmail: string,   // Required for app publishing
    description?: string,
    logo?: string
  },
  members: [{               // Organization members
    user: ObjectId,         // Reference to User
    role: 'admin' | 'member',
    joinedAt: Date
  }],
  pendingInvites: [{        // Unaccepted invitations
    email: string,
    role: 'admin' | 'member',
    token: string,          // JWT for acceptance
    invitedBy: ObjectId,
    invitedAt: Date,
    expiresAt: Date,
    emailSentCount: number,
    lastEmailSentAt?: Date
  }]
}

​

Field Purposes

​

name & slug

• name: Human-readable organization name
• slug: URL-safe identifier (e.g., “mentra-labs” from “Mentra Labs”)
• Used in: Developer portal URLs, API references

​

profile

• contactEmail: Required for app store publishing, support contact
• website: Company website for credibility
• description: About the organization
• logo: Visual identity in app listings

​

members

• user: Reference to User document
• role: Permission level (admin can manage org, member can publish apps)
• joinedAt: Membership start date

​

pendingInvites

• email: Invitee’s email address
• token: Secure acceptance token
• expiresAt: Invitation validity period
• emailSentCount: Retry tracking for failed deliveries

​

Usage Patterns

​

App Publishing

// App model references organization
{
  organizationId: ObjectId('org123'),
  // Previously: developerId: 'user@example.com'
}

​

Team Collaboration

• Admins: Manage members, apps, billing
• Members: Publish and update apps

​

Enterprise Features

• Centralized app management
• Shared API keys
• Team-wide analytics
• Consolidated billing

​

Relationships

​

With Users

• Many-to-many via members array
• Each user has a defaultOrg (personal organization)
• Users can belong to multiple organizations

​

With Apps

• One-to-many: Organization owns many apps
• Apps published under organization name
• Shared across all organization members

​

Common Queries

// Find user's organizations
Organization.findByMember(userId)

// Check permissions
Organization.hasRole(orgId, userId, 'admin')

// Validate membership
Organization.isMember(orgId, userId)

​

Slug Generation

• “Mentra Labs” → “mentra-labs”
• “AI Vision Inc.” → “ai-vision-inc”
• Ensures uniqueness across system