Scaling Flutter: hướng dẫn thực chiến về feature-based architecture trên multiple repositories

1.The Core & Shared Repositories (The Foundation)
/organization_root
│
├── core_domain/                # Business Logic & Interfaces (The "Brains")
│   ├── lib/
│   │   ├── src/
│   │   │   ├── transponder/
│   │   │   │   ├── app_transponder.dart  # Abstract interface definition
│   │   │   │   └── app_event.dart        # Base event classes
│   │   │   ├── models/                   # Global entities (e.g., User, Order)
│   │   │   └── failures/                 # Shared error/exception handling
│   │   └── core_domain.dart              # Main barrel file
│   └── pubspec.yaml
│
├── core_ui/                    # The Design System (The "Look")
│   ├── assets/                 # Shared fonts, icons, and logos
│   ├── lib/
│   │   ├── src/
│   │   │   ├── theme/
│   │   │   │   ├── app_colors.dart       # Brand color palette
│   │   │   │   └── app_typography.dart   # Text styles
│   │   │   └── widgets/                  # Atomic UI components
│   │   │       ├── custom_button.dart
│   │   │       └── loading_indicator.dart
│   │   └── core_ui.dart                  # Main barrel file
│   └── pubspec.yaml
│
└── core_infrastructure/        # Third-party & System Wrappers (The "Tools")
    ├── lib/
    │   ├── src/
    │   │   ├── network/
    │   │   │   ├── api_client.dart       # Dio or Http wrapper
    │   │   │   └── endpoints.dart        # Shared API constants
    │   │   ├── storage/
    │   │   │   └── local_storage.dart    # Shared preferences or Hive setup
    │   │   └── analytics/
    │   │       └── firebase_logger.dart  # Analytics wrapper
    │   └── core_infrastructure.dart
    └── pubspec.yaml

2.The Features Repositories (The Building Blocks)
/organization_root
│
├── feature_checkout/           # Business domain for payments & orders
│   ├── lib/
│   │   ├── src/
│   │   │   ├── data/           # Repositories & Data Sources (API calls)
│   │   │   ├── domain/         # Use Cases & Local Entities
│   │   │   └── presentation/   # UI, State Management & Controllers
│   │   │       ├── checkout_screen.dart
│   │   │       └── checkout_controller.dart  <-- Broadcasts OrderPlacedEvent
│   │   └── feature_checkout.dart
│   ├── test/                   # Isolated unit & widget tests
│   └── pubspec.yaml            # Depends on core_domain, core_ui, core_infra
│
├── feature_dashboard/          # Business domain for overview & stats
│   ├── lib/
│   │   ├── src/
│   │   │   ├── domain/
│   │   │   └── presentation/
│   │   │       ├── dashboard_screen.dart
│   │   │       └── activity_badge.dart      <-- Listens for OrderPlacedEvent
│   │   └── feature_dashboard.dart
│   ├── test/
│   └── pubspec.yaml            # Depends on core_domain, core_ui
│
└── feature_auth/               # Business domain for login & registration
    ├── lib/
    │   ├── src/
    │   │   ├── domain/
    │   │   └── presentation/
    │   │       └── login_screen.dart
    │   └── feature_auth.dart
    ├── test/
    └── pubspec.yaml

3. The Host Application (The Glue)
/organization_root
│
└── host_app/                   # The main executable Flutter project
    ├── lib/
    │   ├── src/
    │   │   ├── di/             # The Wiring Room
    │   │   │   ├── injection.dart        # GetIt setup; Implements AppTransponder
    │   │   │   └── feature_modules.dart  # Inits individual feature dependencies
    │   │   │
    │   │   ├── routing/        # The Map
    │   │   │   ├── app_router.dart       # GoRouter/AutoRoute; Imports feature screens
    │   │   │   └── routes.dart           # Route name constants
    │   │   │
    │   │   ├── app.dart        # The Root Widget (MaterialApp, Theme setup)
    │   │   └── config/         # Environment flavors (dev, staging, prod)
    │   │
    │   └── main.dart           # Entry point: runs app and triggers DI
    │
    ├── assets/                 # App icons and splash screens
    ├── test_driver/            # Integration tests (testing the whole flow)
    └── pubspec.yaml            # The Master List (Depends on ALL Core & Features)

dependencies:
  flutter:
    sdk: flutter
  core_ui:
    git:
      url: git@github.com:your-org/core_ui.git
      ref: main 
  feature_auth:
    git:
      url: git@github.com:your-org/feature_auth.git
      ref: v1.2.0 # Always pin to a specific tag or commit for stability!

// Inside core_domain repo
abstract class AppTransponder {
  Stream<AppEvent> get events;
  void broadcast(AppEvent event);
}
abstract class AppEvent {}
class UserLoggedOutEvent extends AppEvent {}
class OrderPlacedEvent extends AppEvent {
  final String orderId;
  OrderPlacedEvent(this.orderId);
}

// Inside feature_checkout repo
class CheckoutController {
  final AppTransponder transponder;
  CheckoutController(this.transponder);
  Future<void> submitOrder(OrderData data) async {
    // ... logic to process payment and submit order
    final newOrderId = "ORD-12345";
    
    // Broadcast the success to the rest of the app
    transponder.broadcast(OrderPlacedEvent(newOrderId));
  }
}

// Inside feature_dashboard repo
class DashboardActivityBadge extends StatelessWidget {
  final AppTransponder transponder = locator<AppTransponder>();
  @override
  Widget build(BuildContext context) {
    return StreamBuilder<AppEvent>(
      stream: transponder.events.where((e) => e is OrderPlacedEvent),
      builder: (context, snapshot) {
        if (snapshot.hasData) {
          // A new order was placed, show the notification dot!
          return const Icon(Icons.notifications_active, color: Colors.red);
        }
        return const Icon(Icons.notifications_none);
      }
    );
  }
}

// Inside host_app repo
class DefaultAppTransponder implements AppTransponder {
  final _controller = StreamController<AppEvent>.broadcast();
  @override
  Stream<AppEvent> get events => _controller.stream;
  @override
  void broadcast(AppEvent event) => _controller.add(event);
}
// Initialization in main.dart or your DI setup file
locator.registerSingleton<AppTransponder>(DefaultAppTransponder());

{
  "folders": [
    { "path": "../host_app" },
    { "path": "../core_ui" },
    { "path": "../core_infrastructure" },
    { "path": "../feature_auth" }
  ]
}