Code Architecture

<aside> 💡 Code Architecture will be referred to Clean Architecture by Uncle Bob.

</aside>

It consists of four main modules: App, Domain, Data, and Device.

Folder structure

Nothing in an inner circle can know anything at all about something in an outer circle.

lib/
    app/                          <--- application layer
        pages/                        <-- pages or screens
          sign_up/
	          views/
		          widgets/ <-- the entire widgets
		          login_0000.dart
		          sign_up_0111.dart
		          sign_up_0112.dart
		        controllers/
		        presenters/                  <--- usecase에서 반환된 결과를 
		      sign_up_details/
        utils/                        <--- 날짜, 데이터 연산 등의 가공
	        navigator.dart
	      providers/                    <--- 상태 관리 Provider 관련 로직
    data/ 
		    config/                       <--- 데이터와 관련된 모든 설정 값
			    dio.dart 
			    path.dart                         
        repositories/                 <--- 모든 API 호출
          data_auth_repo.dart           <-- example repo: handles all authentication
		    dto/                      <--- 데이터 형식 정의
    domain/                       <--- domain layer (business and enterprise) PURE DART
        entities/                 <--- 비즈니스 로직의 핵심 규칙, usecases에서 사용
          user.dart                   <-- example entity
          manager.dart                <-- example entity
        usecases/                   <--- 비즈니스 로직 구현
          user_usecase.dart          <-- example usecase extends `UseCase` or `CompletableUseCase`
    main.dart                     <--- entry point

Entity - UseCases - Presenter

아래는 엔티티가 유즈케이스를 거쳐 Presenter와 소통하는 Flutter 코드 예시입니다.

1. 엔티티 (Entity):

class UserEntity {
  final String name;
  final String email;

  UserEntity({required this.name, required this.email});
}

1. 유즈케이스 (Use Case):

import 'package:my_app/entities/user_entity.dart';

class GetUserUseCase {
  UserEntity getUserById(String userId) {
    // 여기서는 단순히 더미 데이터를 반환합니다.
    return UserEntity(name: 'John Doe', email: '[email protected]');
  }
}

1. 프레젠터 (Presenter):

import 'package:my_app/entities/user_entity.dart';
import 'package:my_app/use_cases/get_user_use_case.dart';

class UserPresenter {
  final GetUserUseCase getUserUseCase;

  UserPresenter({required this.getUserUseCase});

  void getUserInfo(String userId) {
    // 유즈케이스를 통해 사용자 정보를 가져옵니다.
    UserEntity user = getUserUseCase.getUserById(userId);

    // 사용자 정보를 UI에 표시하는 메서드를 호출합니다.
    displayUserInfo(user);
  }

  void displayUserInfo(UserEntity user) {
    // UI에 사용자 정보를 표시하는 로직을 구현합니다.
    print('User Name: ${user.name}, Email: ${user.email}');
  }
}

위 코드에서는 엔티티(UserEntity)가 유즈케이스(GetUserUseCase)를 통해 데이터를 처리하고, 그 결과를 프레젠터(UserPresenter)에게 전달합니다. 프레젠터는 전달받은 데이터를 가공하여 UI에 표시하는 역할을 합니다.

Controller - View - Presenter

아래는 Presenter와 Controller, 그리고 View가 어떻게 소통하는지를 보여주는 Dart 코드 예시입니다.