# ebgaio/condominio_promenade architecture

> Architecture diagram of the GitHub repository ebgaio/condominio_promenade, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ebgaio/condominio_promenade
- Repository: https://github.com/ebgaio/condominio_promenade

## Overview

This is an Android condominium-finance application. The principal workflow is to maintain condominium, apartment, resident, and expense data; create a monthly closing; calculate allocations and apartment statements; then review history or prepare email summaries. The tree also shows recurring temporary expenses and installment management. The README is only a brief product description, and most feature code was not sampled, so feature-to-feature links below are dashed where their runtime calls could not be verified. Sampled database and dependency-injection wiring supports the storage relationships shown.

Main entry points: [`app/src/main/java/br/com/edificiopromenade/presentation/navigation`](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/navigation) (App navigation), [`app/src/main/java/br/com/edificiopromenade/domain/usecase`](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/domain/usecase) (Domain operations), [`app/src/main/java/br/com/edificiopromenade/data/local/database/AppDatabase.kt`](https://github.com/ebgaio/condominio_promenade/blob/main/app/src/main/java/br/com/edificiopromenade/data/local/database/AppDatabase.kt) (Room database), [`app/src/main/java/br/com/edificiopromenade/data/repository/impl`](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/data/repository/impl) (Repository implementations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_activity["Android entry<br/>[MainActivity.kt]"]
  node_navigation["App navigation"]
  node_initialization["Initial setup"]
end

subgraph group_management["Condominium management"]
  node_condominium["Condominium settings"]
  node_apartments["Apartments"]
  node_residents["Resident records"]
end

subgraph group_finance["Financial workflow"]
  node_expense_types["Expense types"]
  node_expenses["Monthly expenses"]
  node_expense_items["Expense items"]
  node_temporary_expenses["Recurring installments"]
  node_closing["Monthly closing"]
  node_allocation["Monthly allocation"]
  node_statements["Apartment statements"]
  node_history["Financial history"]
  node_email["Email summaries"]
  node_usecases["Domain operations"]
end

subgraph group_persistence["Data and persistence"]
  node_repositories["Repository implementations"]
  node_repository_bindings["Repository bindings"]
  node_daos["Room DAOs"]
  node_entities["Room entities"]
  node_database[("Room database<br/>[AppDatabase.kt]")]
  node_database_bindings["Database providers<br/>[DatabaseModule.kt]"]
end

node_resident(("Administrator"))

node_resident -.->|"opens app"| node_activity
node_activity -->|"loads navigation"| node_navigation
node_navigation -.->|"routes to"| node_initialization
node_navigation -.->|"routes to"| node_condominium
node_navigation -.->|"routes to"| node_apartments
node_navigation -.->|"routes to"| node_residents
node_navigation -.->|"routes to"| node_expense_types
node_navigation -.->|"routes to"| node_expenses
node_navigation -.->|"routes to"| node_expense_items
node_navigation -.->|"routes to"| node_temporary_expenses
node_navigation -.->|"routes to"| node_closing
node_navigation -.->|"routes to"| node_statements
node_navigation -.->|"routes to"| node_history
node_navigation -.->|"routes to"| node_email
node_condominium -.->|"requests operations"| node_usecases
node_apartments -.->|"requests operations"| node_usecases
node_residents -.->|"requests operations"| node_usecases
node_expenses -.->|"requests operations"| node_usecases
node_expense_items -.->|"requests operations"| node_usecases
node_temporary_expenses -.->|"requests operations"| node_usecases
node_closing -.->|"requests operations"| node_usecases
node_statements -.->|"requests operations"| node_usecases
node_history -.->|"requests operations"| node_usecases
node_email -.->|"requests operations"| node_usecases
node_usecases -.->|"uses repositories"| node_repositories
node_repository_bindings -->|"binds implementations"| node_repositories
node_repositories -.->|"accesses data"| node_daos
node_database -->|"exposes"| node_daos
node_database -->|"stores"| node_entities
node_database_bindings -->|"provides"| node_database

click node_activity "https://github.com/ebgaio/condominio_promenade/blob/main/app/src/main/java/br/com/edificiopromenade/MainActivity.kt"
click node_navigation "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/navigation"
click node_initialization "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/initialization"
click node_condominium "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/condominio"
click node_apartments "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/apartment"
click node_residents "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/moradores"
click node_expense_types "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/tipodespesa"
click node_expenses "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/despesa"
click node_expense_items "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/despesaitem"
click node_temporary_expenses "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/despesatemporaria"
click node_closing "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/fechamento"
click node_allocation "https://github.com/ebgaio/condominio_promenade/blob/main/app/src/main/java/br/com/edificiopromenade/domain/usecase/fechamento/CalcularRateioMensalUseCase.kt"
click node_statements "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/demonstrativo"
click node_history "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/history"
click node_email "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/email"
click node_usecases "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/domain/usecase"
click node_repositories "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/data/repository/impl"
click node_repository_bindings "https://github.com/ebgaio/condominio_promenade/blob/main/app/src/main/java/br/com/edificiopromenade/di/RepositoryModule.kt"
click node_daos "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/data/local/dao"
click node_entities "https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/data/local/entity"
click node_database "https://github.com/ebgaio/condominio_promenade/blob/main/app/src/main/java/br/com/edificiopromenade/data/local/database/AppDatabase.kt"
click node_database_bindings "https://github.com/ebgaio/condominio_promenade/blob/main/app/src/main/java/br/com/edificiopromenade/di/DatabaseModule.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_activity,node_navigation,node_initialization toneBlue
class node_condominium,node_apartments,node_residents toneAmber
class node_expense_types,node_expenses,node_expense_items,node_temporary_expenses,node_closing,node_allocation,node_statements,node_history,node_email,node_usecases toneMint
class node_repositories,node_repository_bindings,node_daos,node_entities,node_database,node_database_bindings toneRose
class node_resident toneIndigo
```

## Components

### Application

- [Android entry](https://github.com/ebgaio/condominio_promenade/blob/main/app/src/main/java/br/com/edificiopromenade/MainActivity.kt): `app/src/main/java/br/com/edificiopromenade/MainActivity.kt`
- [App navigation](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/navigation): `app/src/main/java/br/com/edificiopromenade/presentation/navigation`
- [Initial setup](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/initialization): `app/src/main/java/br/com/edificiopromenade/presentation/initialization`

### Condominium management

- [Condominium settings](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/condominio): `app/src/main/java/br/com/edificiopromenade/presentation/condominio`
- [Apartments](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/apartment): `app/src/main/java/br/com/edificiopromenade/presentation/apartment`
- [Resident records](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/moradores): `app/src/main/java/br/com/edificiopromenade/presentation/moradores`

### Financial workflow

- [Expense types](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/tipodespesa): `app/src/main/java/br/com/edificiopromenade/presentation/tipodespesa`
- [Monthly expenses](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/despesa): `app/src/main/java/br/com/edificiopromenade/presentation/despesa`
- [Expense items](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/despesaitem): `app/src/main/java/br/com/edificiopromenade/presentation/despesaitem`
- [Recurring installments](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/despesatemporaria): `app/src/main/java/br/com/edificiopromenade/presentation/despesatemporaria`
- [Monthly closing](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/fechamento): `app/src/main/java/br/com/edificiopromenade/presentation/fechamento`
- [Monthly allocation](https://github.com/ebgaio/condominio_promenade/blob/main/app/src/main/java/br/com/edificiopromenade/domain/usecase/fechamento/CalcularRateioMensalUseCase.kt): `app/src/main/java/br/com/edificiopromenade/domain/usecase/fechamento/CalcularRateioMensalUseCase.kt`
- [Apartment statements](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/demonstrativo): `app/src/main/java/br/com/edificiopromenade/presentation/demonstrativo`
- [Financial history](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/history): `app/src/main/java/br/com/edificiopromenade/presentation/history`
- [Email summaries](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/presentation/email): `app/src/main/java/br/com/edificiopromenade/presentation/email`
- [Domain operations](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/domain/usecase): `app/src/main/java/br/com/edificiopromenade/domain/usecase`

### Data and persistence

- [Repository implementations](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/data/repository/impl): `app/src/main/java/br/com/edificiopromenade/data/repository/impl`
- [Repository bindings](https://github.com/ebgaio/condominio_promenade/blob/main/app/src/main/java/br/com/edificiopromenade/di/RepositoryModule.kt): `app/src/main/java/br/com/edificiopromenade/di/RepositoryModule.kt`
- [Room DAOs](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/data/local/dao): `app/src/main/java/br/com/edificiopromenade/data/local/dao`
- [Room entities](https://github.com/ebgaio/condominio_promenade/tree/main/app/src/main/java/br/com/edificiopromenade/data/local/entity): `app/src/main/java/br/com/edificiopromenade/data/local/entity`
- [Room database](https://github.com/ebgaio/condominio_promenade/blob/main/app/src/main/java/br/com/edificiopromenade/data/local/database/AppDatabase.kt): `app/src/main/java/br/com/edificiopromenade/data/local/database/AppDatabase.kt`
- [Database providers](https://github.com/ebgaio/condominio_promenade/blob/main/app/src/main/java/br/com/edificiopromenade/di/DatabaseModule.kt): `app/src/main/java/br/com/edificiopromenade/di/DatabaseModule.kt`

### Other components

- **Administrator**

## Connections

- Administrator → Android entry: opens app
- Android entry → App navigation: loads navigation (evidence: `app/src/main/java/br/com/edificiopromenade/MainActivity.kt`)
- App navigation → Initial setup: routes to
- App navigation → Condominium settings: routes to
- App navigation → Apartments: routes to
- App navigation → Resident records: routes to
- App navigation → Expense types: routes to
- App navigation → Monthly expenses: routes to
- App navigation → Expense items: routes to
- App navigation → Recurring installments: routes to
- App navigation → Monthly closing: routes to
- App navigation → Apartment statements: routes to
- App navigation → Financial history: routes to
- App navigation → Email summaries: routes to
- Condominium settings → Domain operations: requests operations
- Apartments → Domain operations: requests operations
- Resident records → Domain operations: requests operations
- Monthly expenses → Domain operations: requests operations (evidence: `app/src/main/java/br/com/edificiopromenade/presentation/despesa/DespesaViewModel.kt`)
- Expense items → Domain operations: requests operations (evidence: `app/src/main/java/br/com/edificiopromenade/presentation/despesaitem/DespesaItemViewModel.kt`)
- Recurring installments → Domain operations: requests operations (evidence: `app/src/main/java/br/com/edificiopromenade/presentation/despesatemporaria/DespesaTemporariaViewModel.kt`)
- Monthly closing → Domain operations: requests operations (evidence: `app/src/main/java/br/com/edificiopromenade/presentation/fechamento/NovoFechamentoViewModel.kt`)
- Apartment statements → Domain operations: requests operations
- Financial history → Domain operations: requests operations
- Email summaries → Domain operations: requests operations
- Domain operations → Repository implementations: uses repositories
- Repository bindings → Repository implementations: binds implementations (evidence: `app/src/main/java/br/com/edificiopromenade/di/RepositoryModule.kt`)
- Repository implementations → Room DAOs: accesses data (evidence: `app/src/main/java/br/com/edificiopromenade/data/repository/impl/ExclusaoDespesaRepositoryImpl.kt`)
- Room database → Room DAOs: exposes (evidence: `app/src/main/java/br/com/edificiopromenade/data/local/database/AppDatabase.kt`)
- Room database → Room entities: stores (evidence: `app/src/main/java/br/com/edificiopromenade/data/local/database/AppDatabase.kt`)
- Database providers → Room database: provides (evidence: `app/src/main/java/br/com/edificiopromenade/di/DatabaseModule.kt`)
