flowchart TD
    subgraph CompositionRoot ["Composition Root & DI"]
        Container["Infrastructure.Container (TServiceContainer)"]
    end

    subgraph UI ["Presentation Layer (View)"]
        BaseForm["View.Base.Crud (TfrmBaseCrud)"]
        Form["View.Customer (TfrmCustomer)"] -->|Visual Inheritance| BaseForm
        Form -->|Implements| IView["ICustomerView : IBaseCrudView<T>"]
        Form -->|Local MemTable| Grid["TcxGrid (DevExpress)"]
    end

    subgraph PresenterLayer ["Presenter & Orchestration Layer"]
        BasePresenter["Presenter.Base.Crud<T, V, R>"]
        Presenter["Presenter.Customer (TCustomerPresenter)"] -->|Inherits| BasePresenter
        Presenter -->|Updates / Notifies| IView
        Presenter -->|Delegates Persistence| IRepo["ICustomerRepository : IBaseRepository<T>"]
        Presenter -->|Manipulates| Domain["Model.Customer (TCustomer, TPhone)"]
        Presenter -->|Validates via| Validator["Commons.Validators (TValidator)"]
    end

    subgraph DataLayer ["Persistence & Infrastructure Layer"]
        IRepo -->|Implemented by| RepoImpl["Repository.Customer.FireDAC"]
        RepoImpl -->|Uses via DI| IConn["IConnection"]
        IConn -->|Implemented by| ConnImpl["Infrastructure.Connection.FireDAC"]
        ConnImpl -->|Acquires from Pool| FactoryImpl["Infrastructure.Factory.FireDAC (IConnectionFactory)"]
        FactoryImpl -->|Manages Pool| FDManager["FireDAC FDManager (PoolFirebird)"]
        FDManager -->|Physical Connection| FB["Firebird 5.0"]
    end

    Container -.->|Builds & Injects| Presenter
    Container -.->|Builds & Injects| RepoImpl
    Container -.->|Builds & Injects| ConnImpl

Docs/
└── CompositionRoot_DI.md                # 📖 Guia arquitetural de Injeção de Dependências e Composition Root
MVPCliente/
├── Bin/                                 # Executáveis compilados (Win32/Release/Debug)
├── DCU/                                 # DCUs unificadas e isoladas dos fontes
├── Database/
│   ├── Script_Firebird5.sql             # DDL (Sequences, Tabelas, ON DELETE CASCADE)
│   └── mvp_delphi.fdb                   # Banco de dados Firebird de exemplo
├── Source/
│   ├── Commons/
│   │   ├── Commons.Exceptions.pas       # Exceções de Domínio (EDomainException, EValidationException)
│   │   ├── Commons.Validators.pas       # Validador de CPF, CNPJ e Sanitizadores
│   │   └── Commons.Messages.pas         # Strings de recurso com resourcestring
│   ├── Model/
│   │   └── Model.Customer.pas           # Entidades POO puras (TCustomer, TPhone)
│   ├── Infrastructure/
│   │   ├── Infrastructure.Connection.Interfaces.pas # Interface IConnection
│   │   ├── Infrastructure.Connection.FireDAC.pas    # Implementação FireDAC
│   │   ├── Infrastructure.Factory.Interfaces.pas    # Interface IConnectionFactory
│   │   ├── Infrastructure.Factory.FireDAC.pas       # Pool no FDManager + Config.ini
│   │   └── Infrastructure.Container.pas             # Composition Root / DI Factory
│   ├── Repository/
│   │   ├── Repository.Base.Interfaces.pas           # IBaseRepository<T>
│   │   ├── Repository.Customer.Interfaces.pas       # ICustomerRepository
│   │   └── Repository.Customer.FireDAC.pas          # Repositório FireDAC transacional
│   ├── Presenter/
│   │   ├── Presenter.Base.Crud.pas                  # Base Presenter genérico CRUD com IsDirty
│   │   ├── Presenter.Customer.pas                   # Presenter especializado com validações
│   │   └── Presenter.Customer.Search.pas            # Presenter de Pesquisa de Clientes
│   └── View/
│       ├── View.Base.Interfaces.pas                 # IBaseCrudView<T>
│       ├── View.Base.Crud.pas / .dfm                # Form base visual com Dirty State (CloseQuery)
│       ├── View.Customer.Interfaces.pas             # ICustomerView
│       ├── View.Customer.pas / .dfm                 # Form cliente com cxGrid DevExpress
│       ├── View.Customer.Search.Interfaces.pas      # ICustomerSearchView
│       └── View.Customer.Search.pas / .dfm          # Form de pesquisa com cxGrid, AutoFilter e FindPanel
├── Tests/                               # 🧪 Suíte de Testes Unitários Automatizados
│   ├── MVPClienteTests.dpr              # DUnitX Console Test Runner
│   ├── MVPClienteTests.dproj            # Projeto de Testes Delphi
│   ├── Test.Presenter.Customer.pas      # Testes com Mocks para TCustomerPresenter
│   └── Test.Presenter.Customer.Search.pas # Testes com Mocks para TCustomerSearchPresenter
├── Config.ini                           # Parâmetros de conexão editáveis
├── MVPCliente_Icon.ico                  # Ícone moderno da aplicação
└── MVPCliente.dpr                       # Ponto de entrada da aplicação

[Database]
Path=[SEU_PATH]\mvp_delphi.fdb
Server=[IP_ADDRESS]
Port=[PORTA]
User_Name=[USER]
Password=[SENHA]
Pooled=True
PoolMaximumItems=[MAX_POOL]