accesses_weebi 1.0.1

User access management package for Weebi - allows admins to manage user permissions and access to boutiques/chains

Accesses Weebi Package

A Flutter package for managing user access permissions to boutiques and chains in the Weebi ecosystem. This package provides a comprehensive interface for administrators to control which users have access to specific chains and boutiques.

Features

• User Access Management: View and edit user permissions for boutiques and chains
• Hierarchical Access Control: Support for both full access and limited access models
• Chain-Based Organization: Manage access at the chain level with automatic boutique inclusion
• Real-time Updates: Live permission updates with provider-based state management
• Beautiful UI: Modern Material Design 3 interface with intuitive controls

Architecture

The accesses package depends on both users_weebi and boutiques_weebi packages:

accesses_weebi
├── users_weebi (for user management)
├── boutiques_weebi (for boutique/chain data)
└── protos_weebi (for UserPermissions protobuf)

This separation ensures:

• users_weebi: Handles user CRUD operations
• boutiques_weebi: Handles boutique/chain CRUD operations
• accesses_weebi: Manages user access permissions (depends on both)

Core Components

AccessProvider

Central state management for user access operations:

• Loads users and boutiques/chains
• Manages UserPermissions cache
• Handles permission updates
• Provides access validation methods

AccessListWidget

Displays a searchable list of users for access management:

• Search functionality
• Current user identification
• Navigation to individual user access

UserAccessWidget

Comprehensive interface for managing individual user access:

• Full access vs. limited access toggle
• Hierarchical chain/boutique selection
• Visual access summary
• Save/update permissions

Usage

Basic Integration

import 'package:accesses_weebi/accesses_weebi.dart';

// Add to your MaterialApp routes
MaterialApp(
  routes: {
    ...AccessRoutes.getProviderRoutes(
      getCurrentUserId: (context) => context.read<CloudHub>().userId,
    ),
  },
)

// Setup providers
MultiProvider(
  providers: [
    ChangeNotifierProvider(create: (_) => UserProvider()),
    ChangeNotifierProvider(create: (_) => BoutiqueProvider()),
    ChangeNotifierProxyProvider2<UserProvider, BoutiqueProvider, AccessProvider>(
      create: (context) => AccessProvider(
        userProvider: context.read<UserProvider>(),
        boutiqueProvider: context.read<BoutiqueProvider>(),
      ),
      update: (context, userProvider, boutiqueProvider, previous) =>
          previous ?? AccessProvider(
            userProvider: userProvider,
            boutiqueProvider: boutiqueProvider,
          ),
    ),
  ],
  child: YourApp(),
)

Standalone Access Management

// Create a complete standalone access management app
AccessRoutes.createStandaloneAccessApp(
  currentUserId: 'admin-user-id',
  title: 'User Access Management',
)

Navigation

// Navigate to access management list
AccessRoutes.navigateToAccessList(context);

// Navigate to specific user access
AccessRoutes.navigateToUserAccess(context, userObject);

// Show user access as modal
AccessRoutes.showUserAccessModal(context, userObject);

Direct Widget Usage

// Access list widget
AccessListWidget(
  currentUserId: 'admin-user-id',
  onRefresh: () => print('Refreshed'),
)

// User access widget
UserAccessWidget(
  user: userObject,
)

Permission Model

The package works with the UserPermissions protobuf model:

Full Access

// User has access to all chains and boutiques
UserPermissions with AccessFull(hasFullAccess: true)

Limited Access

// User has access to specific chains and boutiques
UserPermissions with AccessLimited(
  chainIds: ['chain1', 'chain2'],
  boutiqueIds: ['boutique1', 'boutique3']
)

Key Features

Hierarchical Selection

• Selecting a chain automatically selects all its boutiques
• Deselecting a boutique automatically deselects its parent chain
• Visual indicators show partial vs. full chain selection

Access Summary

Real-time summary showing:

• Number of accessible chains
• Number of accessible boutiques
• Access level (Full/Limited)

Search & Filter

• Search users by name or email
• Real-time filtering
• Empty state handling

Error Handling

• Graceful error handling for network failures
• Retry mechanisms
• User-friendly error messages

Example

See example/access_example.dart for complete implementation examples including:

• Standalone access management app
• Integrated access management
• Modal access management
• Provider setup patterns

Development

The package follows Flutter best practices:

• Provider-based state management
• Proper lifecycle management
• Error boundary handling
• Material Design 3 compliance
• Accessibility support

For more examples and detailed API documentation, see the /example folder and inline code documentation.