// Create a user with rich profile
const user = await User.create({{
  email: 'mountain.lover@boulder.co',
  profile: {{
    firstName: 'Alex',
    lastName: 'Mountain',
    favoriteTrail: 'Chautauqua',
    preferredBeer: 'Dale\\'s Pale Ale',
    timezone: 'America/Denver'
  }},
  roles: ['hiker', 'beer-enthusiast']
}});

// Find users with powerful search
const activeClimbers = await User.where({{
  status: 'active',
  'profile.interests': 'climbing'
}}).limit(100).get();

// Bulk operations that don't timeout
await User.whereIn('id', inactiveIds)
  .update({{ status: 'suspended' }});

// This is how simple it should be
await user.assignRole('editor');
await user.grantPermission('posts:write');
await user.revokePermission('users:delete');

// Check permissions anywhere in your app
if (user.can('posts:publish')) {{
  // Let them publish!
  await publishPost(post);
}}

// Role hierarchies made easy
const adminRole = await Role.create({{
  name: 'admin',
  permissions: ['*'], // All permissions
  inherits: ['editor'] // Inherits editor permissions
}});

// Bulk role assignments
await User.whereIn('id', moderatorIds)
  .assignRole('moderator');

// Users can belong to multiple tenants
const userTenants = await user.getTenants();

// Switch context instantly
await user.switchToTenant('acme-corp');

// Tenant-specific roles and permissions
await user.assignRole('admin', {{ tenant: 'acme-corp' }});
await user.assignRole('viewer', {{ tenant: 'startup-inc' }});

// Query users within tenant scope
const acmeUsers = await User.forTenant('acme-corp')
  .where('status', 'active')
  .get();

// Cross-tenant analytics
const globalStats = await User.crossTenant()
  .groupBy('tenant')
  .count();

// Get comprehensive user analytics
const analytics = await User.analytics({{
  period: '30d',
  metrics: ['growth', 'engagement', 'churn']
}});

console.log(analytics);
// {{
//   totalUsers: 125847,
//   growth: {{ rate: 15.2, trend: 'up' }},
//   engagement: {{ daily: 45.8, weekly: 78.2 }},
//   churn: {{ rate: 3.1, prediction: 'stable' }},
//   cohorts: [
//     {{ month: '2024-01', retention: 85.2 }},
//     {{ month: '2024-02', retention: 87.1 }}
//   ]
// }}

// Real-time user activity
const liveStats = await User.realTimeStats();
// {{ activeNow: 1247, signingUp: 12, engaging: 856 }}