# chocolatchan/mebanking architecture

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

- Interactive diagram: https://gitdiagram.com/chocolatchan/mebanking
- Repository: https://github.com/chocolatchan/mebanking

## Overview

M.Ebanking is an Android banking app skeleton with local Room persistence, domain services, and Compose screens. The principal workflow is a customer signing in, viewing accounts, and initiating a transfer; the transaction service validates and authenticates it before the repository executes it against local data. The tree also shows bill payment, chatbot, branch navigation, simulator, and face-recognition capabilities. Those areas are represented without asserting unshown call chains; several UI and integration links remain unverified because their sources were not excerpted.

Main entry points: [`app/src/main/java/com/mebanking/app/domain/service/DefaultTransactionService.kt`](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/domain/service/DefaultTransactionService.kt) (Transaction service), [`app/src/main/java/com/mebanking/app/data/local`](https://github.com/chocolatchan/mebanking/tree/master/app/src/main/java/com/mebanking/app/data/local) (DAOs and entities), [`app/src/main/java/com/mebanking/app/ui/MEbankingApp.kt`](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/ui/MEbankingApp.kt) (Compose root), [`app/src/main/java/com/mebanking/app/ui/auth/LoginScreen.kt`](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/ui/auth/LoginScreen.kt) (Login screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["App and UI"]
  node_entry["App entry<br/>[MainActivity.kt]"]
  node_compose["Compose root<br/>[MEbankingApp.kt]"]
  node_loginui["Login screen<br/>[LoginScreen.kt]"]
  node_transferui["Transfer screen<br/>[TransferScreen.kt]"]
  node_bankingui["Banking screens"]
end

subgraph group_domain["Domain services"]
  node_auth["Authentication<br/>[AuthService.kt]"]
  node_session["Session manager<br/>[SessionManager.kt]"]
  node_transaction["Transaction service"]
  node_authpolicy["Transaction policy"]
  node_domainmodels["Domain models"]
  node_accountservice["Account service<br/>[AccountService.kt]"]
end

subgraph group_data["Data and persistence"]
  node_transactionrepo["Transaction repository"]
  node_authrepo["Auth repository<br/>[AuthRepository.kt]"]
  node_database[("Room database<br/>[AppDatabase.kt]")]
  node_localdata["DAOs and entities"]
end

subgraph group_capabilities["Banking capabilities"]
  node_bills["Bill payment"]
  node_chatbot["Banking chatbot"]
  node_branchnav["Branch navigation"]
  node_simulator["Banking simulator"]
  node_biometrics["Face recognition"]
end

node_customer(("Customer"))

node_customer -->|"opens app"| node_entry
node_entry -->|"launches"| node_compose
node_compose -.->|"hosts"| node_loginui
node_compose -.->|"hosts"| node_bankingui
node_customer -.->|"signs in"| node_loginui
node_loginui -.->|"submits credentials"| node_auth
node_auth -->|"delegates login"| node_session
node_session -->|"reads credentials"| node_authrepo
node_authrepo -->|"queries users"| node_localdata
node_database -->|"provides DAOs"| node_localdata
node_customer -.->|"requests transfer"| node_transferui
node_transferui -.->|"submits transfer"| node_transaction
node_transaction -->|"evaluates policy"| node_authpolicy
node_transaction -->|"executes transfer"| node_transactionrepo
node_transaction -->|"checks accounts"| node_localdata
node_transactionrepo -->|"uses database"| node_database
node_accountservice -->|"uses account data"| node_localdata
node_customer -.->|"pays bills"| node_bills
node_customer -.->|"asks questions"| node_chatbot
node_customer -.->|"finds branches"| node_branchnav
node_customer -.->|"simulates banking"| node_simulator
node_customer -.->|"authenticates biometrically"| node_biometrics

click node_entry "https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/MainActivity.kt"
click node_compose "https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/ui/MEbankingApp.kt"
click node_loginui "https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/ui/auth/LoginScreen.kt"
click node_transferui "https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/ui/transfer/TransferScreen.kt"
click node_bankingui "https://github.com/chocolatchan/mebanking/tree/master/app/src/main/java/com/mebanking/app/ui"
click node_auth "https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/domain/service/AuthService.kt"
click node_session "https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/domain/service/SessionManager.kt"
click node_transaction "https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/domain/service/DefaultTransactionService.kt"
click node_authpolicy "https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/domain/service/TransactionAuthenticationPolicy.kt"
click node_domainmodels "https://github.com/chocolatchan/mebanking/tree/master/app/src/main/java/com/mebanking/app/domain/model"
click node_accountservice "https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/domain/service/AccountService.kt"
click node_transactionrepo "https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/data/repository/DefaultTransactionRepository.kt"
click node_authrepo "https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/data/repository/AuthRepository.kt"
click node_database "https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/data/local/AppDatabase.kt"
click node_localdata "https://github.com/chocolatchan/mebanking/tree/master/app/src/main/java/com/mebanking/app/data/local"
click node_bills "https://github.com/chocolatchan/mebanking/tree/master/app/src/main/java/com/mebanking/app/ui/bills"
click node_chatbot "https://github.com/chocolatchan/mebanking/tree/master/app/src/main/java/com/mebanking/app/ui/chatbot"
click node_branchnav "https://github.com/chocolatchan/mebanking/tree/master/app/src/main/java/com/mebanking/app/domain/navigation"
click node_simulator "https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/domain/service/DefaultSimulatorService.kt"
click node_biometrics "https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/domain/service/FaceRecognitionService.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_entry,node_compose,node_loginui,node_transferui,node_bankingui toneBlue
class node_auth,node_session,node_transaction,node_authpolicy,node_domainmodels,node_accountservice toneAmber
class node_transactionrepo,node_authrepo,node_database,node_localdata toneMint
class node_bills,node_chatbot,node_branchnav,node_simulator,node_biometrics toneRose
class node_customer toneIndigo
```

## Components

### App and UI

- [App entry](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/MainActivity.kt): `app/src/main/java/com/mebanking/app/MainActivity.kt`
- [Compose root](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/ui/MEbankingApp.kt): `app/src/main/java/com/mebanking/app/ui/MEbankingApp.kt`
- [Login screen](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/ui/auth/LoginScreen.kt): `app/src/main/java/com/mebanking/app/ui/auth/LoginScreen.kt`
- [Transfer screen](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/ui/transfer/TransferScreen.kt): `app/src/main/java/com/mebanking/app/ui/transfer/TransferScreen.kt`
- [Banking screens](https://github.com/chocolatchan/mebanking/tree/master/app/src/main/java/com/mebanking/app/ui): `app/src/main/java/com/mebanking/app/ui`

### Domain services

- [Authentication](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/domain/service/AuthService.kt): `app/src/main/java/com/mebanking/app/domain/service/AuthService.kt`
- [Session manager](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/domain/service/SessionManager.kt): `app/src/main/java/com/mebanking/app/domain/service/SessionManager.kt`
- [Transaction service](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/domain/service/DefaultTransactionService.kt): `app/src/main/java/com/mebanking/app/domain/service/DefaultTransactionService.kt`
- [Transaction policy](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/domain/service/TransactionAuthenticationPolicy.kt): `app/src/main/java/com/mebanking/app/domain/service/TransactionAuthenticationPolicy.kt`
- [Domain models](https://github.com/chocolatchan/mebanking/tree/master/app/src/main/java/com/mebanking/app/domain/model): `app/src/main/java/com/mebanking/app/domain/model`
- [Account service](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/domain/service/AccountService.kt): `app/src/main/java/com/mebanking/app/domain/service/AccountService.kt`

### Data and persistence

- [Transaction repository](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/data/repository/DefaultTransactionRepository.kt): `app/src/main/java/com/mebanking/app/data/repository/DefaultTransactionRepository.kt`
- [Auth repository](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/data/repository/AuthRepository.kt): `app/src/main/java/com/mebanking/app/data/repository/AuthRepository.kt`
- [Room database](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/data/local/AppDatabase.kt): `app/src/main/java/com/mebanking/app/data/local/AppDatabase.kt`
- [DAOs and entities](https://github.com/chocolatchan/mebanking/tree/master/app/src/main/java/com/mebanking/app/data/local): `app/src/main/java/com/mebanking/app/data/local`

### Banking capabilities

- [Bill payment](https://github.com/chocolatchan/mebanking/tree/master/app/src/main/java/com/mebanking/app/ui/bills): `app/src/main/java/com/mebanking/app/ui/bills`
- [Banking chatbot](https://github.com/chocolatchan/mebanking/tree/master/app/src/main/java/com/mebanking/app/ui/chatbot): `app/src/main/java/com/mebanking/app/ui/chatbot`
- [Branch navigation](https://github.com/chocolatchan/mebanking/tree/master/app/src/main/java/com/mebanking/app/domain/navigation): `app/src/main/java/com/mebanking/app/domain/navigation`
- [Banking simulator](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/domain/service/DefaultSimulatorService.kt): `app/src/main/java/com/mebanking/app/domain/service/DefaultSimulatorService.kt`
- [Face recognition](https://github.com/chocolatchan/mebanking/blob/master/app/src/main/java/com/mebanking/app/domain/service/FaceRecognitionService.kt): `app/src/main/java/com/mebanking/app/domain/service/FaceRecognitionService.kt`

### Other components

- **Customer**

## Connections

- Customer → App entry: opens app (evidence: `app/src/main/java/com/mebanking/app/MainActivity.kt`)
- App entry → Compose root: launches (evidence: `app/src/main/java/com/mebanking/app/MainActivity.kt`)
- Compose root → Login screen: hosts
- Compose root → Banking screens: hosts
- Customer → Login screen: signs in
- Login screen → Authentication: submits credentials
- Authentication → Session manager: delegates login (evidence: `app/src/main/java/com/mebanking/app/domain/service/AuthService.kt`)
- Session manager → Auth repository: reads credentials (evidence: `app/src/main/java/com/mebanking/app/domain/service/SessionManager.kt`)
- Auth repository → DAOs and entities: queries users (evidence: `app/src/main/java/com/mebanking/app/data/repository/AuthRepository.kt`)
- Room database → DAOs and entities: provides DAOs (evidence: `app/src/main/java/com/mebanking/app/data/local/AppDatabase.kt`)
- Customer → Transfer screen: requests transfer
- Transfer screen → Transaction service: submits transfer
- Transaction service → Transaction policy: evaluates policy (evidence: `app/src/main/java/com/mebanking/app/domain/service/DefaultTransactionService.kt`)
- Transaction service → Transaction repository: executes transfer (evidence: `app/src/main/java/com/mebanking/app/domain/service/DefaultTransactionService.kt`)
- Transaction service → DAOs and entities: checks accounts (evidence: `app/src/main/java/com/mebanking/app/domain/service/DefaultTransactionService.kt`)
- Transaction repository → Room database: uses database (evidence: `app/src/main/java/com/mebanking/app/data/repository/DefaultTransactionRepository.kt`)
- Account service → DAOs and entities: uses account data (evidence: `app/src/main/java/com/mebanking/app/domain/service/AccountService.kt`)
- Customer → Bill payment: pays bills
- Customer → Banking chatbot: asks questions
- Customer → Branch navigation: finds branches
- Customer → Banking simulator: simulates banking
- Customer → Face recognition: authenticates biometrically
