# samyak811/expensetrackerapp architecture

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

- Interactive diagram: https://gitdiagram.com/samyak811/expensetrackerapp
- Repository: https://github.com/samyak811/expensetrackerapp

## Overview

ExpenseTrackerApp is a mobile expense-management platform whose main flow runs from user interaction through gateway routing to expense processing and persistence; it also supports AI extraction from entered text or bank SMS. The graph preserves documented authentication, profile, analytics, Kafka, and cloud-deployment capabilities. Some backend services and gateway components are represented from README documentation because their implementation files are absent from the supplied tree; edges are limited to documented or excerpted relationships.

Main entry points: [`Backend/ExpenseService/app/src/main/java/com/expense/service/ExpenseService.java`](https://github.com/samyak811/expensetrackerapp/blob/main/Backend/ExpenseService/app/src/main/java/com/expense/service/ExpenseService.java) (Expense service), [`Frontend/ExpenseTrackerFrontend/App.tsx`](https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/App.tsx) (Mobile app), [`Backend/dsService/src/app/service/messageService.py`](https://github.com/samyak811/expensetrackerapp/blob/main/Backend/dsService/src/app/service/messageService.py) (DS message service), [`Infrastructure/CDK/lib/expense-services-stack.ts`](https://github.com/samyak811/expensetrackerapp/blob/main/Infrastructure/CDK/lib/expense-services-stack.ts) (Data services deployment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Mobile app"]
  node_app["Mobile app<br/>[App.tsx]"]
  node_auth_ui["Login and signup"]
  node_home["Expense home<br/>[Home.tsx]"]
  node_add_expense["Add expense<br/>[AddExpense.tsx]"]
  node_analytics["Analytics<br/>[Analytics.tsx]"]
  node_profile["Profile<br/>[Profile.tsx]"]
  node_expense_details["Expense details<br/>[ExpenseDetails.tsx]"]
  node_ui_primitives["UI primitives"]
  node_expense_dto_mobile["Expense DTO<br/>[ExpenseDto.ts]"]
  node_theme["App theme<br/>[theme.ts]"]
end

subgraph group_backend["Backend services"]
  node_gateway["Kong gateway"]
  node_auth_service["Auth service"]
  node_user_service["User service"]
  node_expense_controller["Expense API"]
  node_expense_service["Expense service"]
  node_expense_model["Expense model<br/>[Expense.java]"]
  node_expense_repository["Expense repository"]
  node_expense_dto["Expense DTO<br/>[ExpenseDto.java]"]
end

subgraph group_ai["AI extraction"]
  node_ds_service["DS message service<br/>[messageService.py]"]
  node_message_utils["Message classifier<br/>[messageUtils.py]"]
  node_llm_service["LLM extraction<br/>[llmService.py]"]
  node_expense_schema["Extracted expense schema<br/>[Expense.py]"]
end

subgraph group_data["Messaging and storage"]
  node_kafka["Apache Kafka"]
  node_mysql[("MySQL")]
end

subgraph group_platform["Cloud platform"]
  node_deploy_stack["Backend deployment"]
  node_data_stack["Data services deployment"]
end

node_user(("User"))
node_sms(("Bank SMS"))
node_gemini{{"Google Gemini"}}
node_aws{{"AWS ECS and VPC"}}

node_user -->|"uses"| node_app
node_sms -->|"delivers messages"| node_app
node_app -->|"posts SMS text"| node_ds_service
node_app -->|"sends requests"| node_gateway
node_gateway -->|"routes requests"| node_auth_service
node_gateway -->|"routes requests"| node_user_service
node_gateway -->|"routes requests"| node_expense_controller
node_gateway -->|"routes requests"| node_ds_service
node_user -->|"authenticates"| node_auth_ui
node_user -->|"views expenses"| node_home
node_user -->|"adds expenses"| node_add_expense
node_user -->|"views analytics"| node_analytics
node_user -->|"manages profile"| node_profile
node_user -->|"views details"| node_expense_details
node_home -->|"fetches expenses"| node_expense_controller
node_expense_controller -->|"calls"| node_expense_service
node_expense_service -->|"reads and writes"| node_expense_repository
node_expense_service -->|"maps records"| node_expense_model
node_expense_service -->|"maps requests"| node_expense_dto
node_ds_service -->|"classifies with"| node_message_utils
node_ds_service -->|"extracts with"| node_llm_service
node_llm_service -->|"invokes model"| node_gemini
node_llm_service -->|"structures output"| node_expense_schema
node_expense_service -->|"persists records"| node_mysql
node_expense_service -.->|"uses event messaging"| node_kafka
node_deploy_stack -->|"creates services"| node_aws
node_data_stack -->|"creates data services"| node_aws
node_data_stack -->|"deploys"| node_mysql
node_data_stack -->|"deploys"| node_kafka

click node_app "https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/App.tsx"
click node_auth_ui "https://github.com/samyak811/expensetrackerapp/tree/main/Frontend/ExpenseTrackerFrontend/src/app/pages"
click node_home "https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/src/app/pages/Home.tsx"
click node_add_expense "https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/src/app/pages/AddExpense.tsx"
click node_analytics "https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/src/app/pages/Analytics.tsx"
click node_profile "https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/src/app/pages/Profile.tsx"
click node_expense_details "https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/src/app/pages/ExpenseDetails.tsx"
click node_ui_primitives "https://github.com/samyak811/expensetrackerapp/tree/main/Frontend/ExpenseTrackerFrontend/src/app/components"
click node_expense_dto_mobile "https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/src/app/dto/ExpenseDto.ts"
click node_theme "https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/src/app/theme/theme.ts"
click node_auth_service "https://github.com/samyak811/expensetrackerapp/tree/main/Backend/AuthService"
click node_user_service "https://github.com/samyak811/expensetrackerapp/tree/main/Backend/UserService"
click node_expense_controller "https://github.com/samyak811/expensetrackerapp/blob/main/Backend/ExpenseService/app/src/main/java/com/expense/controller/ExpenseController.java"
click node_expense_service "https://github.com/samyak811/expensetrackerapp/blob/main/Backend/ExpenseService/app/src/main/java/com/expense/service/ExpenseService.java"
click node_expense_model "https://github.com/samyak811/expensetrackerapp/blob/main/Backend/ExpenseService/app/src/main/java/com/expense/entites/Expense.java"
click node_expense_repository "https://github.com/samyak811/expensetrackerapp/blob/main/Backend/ExpenseService/app/src/main/java/com/expense/repository/ExpenseRepository.java"
click node_expense_dto "https://github.com/samyak811/expensetrackerapp/blob/main/Backend/ExpenseService/app/src/main/java/com/expense/dto/ExpenseDto.java"
click node_ds_service "https://github.com/samyak811/expensetrackerapp/blob/main/Backend/dsService/src/app/service/messageService.py"
click node_message_utils "https://github.com/samyak811/expensetrackerapp/blob/main/Backend/dsService/src/app/utils/messageUtils.py"
click node_llm_service "https://github.com/samyak811/expensetrackerapp/blob/main/Backend/dsService/src/app/service/llmService.py"
click node_expense_schema "https://github.com/samyak811/expensetrackerapp/blob/main/Backend/dsService/src/app/service/Expense.py"
click node_deploy_stack "https://github.com/samyak811/expensetrackerapp/blob/main/Infrastructure/CDK/lib/expense-backend-services-stack.ts"
click node_data_stack "https://github.com/samyak811/expensetrackerapp/blob/main/Infrastructure/CDK/lib/expense-services-stack.ts"

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_app,node_auth_ui,node_home,node_add_expense,node_analytics,node_profile,node_expense_details,node_ui_primitives,node_expense_dto_mobile,node_theme,node_user toneBlue
class node_gateway,node_auth_service,node_user_service,node_expense_controller,node_expense_service,node_expense_model,node_expense_repository,node_expense_dto toneAmber
class node_ds_service,node_message_utils,node_llm_service,node_expense_schema toneMint
class node_kafka,node_mysql toneRose
class node_deploy_stack,node_data_stack,node_sms,node_gemini,node_aws toneIndigo
```

## Components

### Mobile app

- [Mobile app](https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/App.tsx): `Frontend/ExpenseTrackerFrontend/App.tsx`
- [Login and signup](https://github.com/samyak811/expensetrackerapp/tree/main/Frontend/ExpenseTrackerFrontend/src/app/pages): `Frontend/ExpenseTrackerFrontend/src/app/pages`
- [Expense home](https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/src/app/pages/Home.tsx): `Frontend/ExpenseTrackerFrontend/src/app/pages/Home.tsx`
- [Add expense](https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/src/app/pages/AddExpense.tsx): `Frontend/ExpenseTrackerFrontend/src/app/pages/AddExpense.tsx`
- [Analytics](https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/src/app/pages/Analytics.tsx): `Frontend/ExpenseTrackerFrontend/src/app/pages/Analytics.tsx`
- [Profile](https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/src/app/pages/Profile.tsx): `Frontend/ExpenseTrackerFrontend/src/app/pages/Profile.tsx`
- [Expense details](https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/src/app/pages/ExpenseDetails.tsx): `Frontend/ExpenseTrackerFrontend/src/app/pages/ExpenseDetails.tsx`
- [UI primitives](https://github.com/samyak811/expensetrackerapp/tree/main/Frontend/ExpenseTrackerFrontend/src/app/components): `Frontend/ExpenseTrackerFrontend/src/app/components`
- [Expense DTO](https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/src/app/dto/ExpenseDto.ts): `Frontend/ExpenseTrackerFrontend/src/app/dto/ExpenseDto.ts`
- [App theme](https://github.com/samyak811/expensetrackerapp/blob/main/Frontend/ExpenseTrackerFrontend/src/app/theme/theme.ts): `Frontend/ExpenseTrackerFrontend/src/app/theme/theme.ts`

### Backend services

- **Kong gateway**
- [Auth service](https://github.com/samyak811/expensetrackerapp/tree/main/Backend/AuthService): `Backend/AuthService`
- [User service](https://github.com/samyak811/expensetrackerapp/tree/main/Backend/UserService): `Backend/UserService`
- [Expense API](https://github.com/samyak811/expensetrackerapp/blob/main/Backend/ExpenseService/app/src/main/java/com/expense/controller/ExpenseController.java): `Backend/ExpenseService/app/src/main/java/com/expense/controller/ExpenseController.java`
- [Expense service](https://github.com/samyak811/expensetrackerapp/blob/main/Backend/ExpenseService/app/src/main/java/com/expense/service/ExpenseService.java): `Backend/ExpenseService/app/src/main/java/com/expense/service/ExpenseService.java`
- [Expense model](https://github.com/samyak811/expensetrackerapp/blob/main/Backend/ExpenseService/app/src/main/java/com/expense/entites/Expense.java): `Backend/ExpenseService/app/src/main/java/com/expense/entites/Expense.java`
- [Expense repository](https://github.com/samyak811/expensetrackerapp/blob/main/Backend/ExpenseService/app/src/main/java/com/expense/repository/ExpenseRepository.java): `Backend/ExpenseService/app/src/main/java/com/expense/repository/ExpenseRepository.java`
- [Expense DTO](https://github.com/samyak811/expensetrackerapp/blob/main/Backend/ExpenseService/app/src/main/java/com/expense/dto/ExpenseDto.java): `Backend/ExpenseService/app/src/main/java/com/expense/dto/ExpenseDto.java`

### AI extraction

- [DS message service](https://github.com/samyak811/expensetrackerapp/blob/main/Backend/dsService/src/app/service/messageService.py): `Backend/dsService/src/app/service/messageService.py`
- [Message classifier](https://github.com/samyak811/expensetrackerapp/blob/main/Backend/dsService/src/app/utils/messageUtils.py): `Backend/dsService/src/app/utils/messageUtils.py`
- [LLM extraction](https://github.com/samyak811/expensetrackerapp/blob/main/Backend/dsService/src/app/service/llmService.py): `Backend/dsService/src/app/service/llmService.py`
- [Extracted expense schema](https://github.com/samyak811/expensetrackerapp/blob/main/Backend/dsService/src/app/service/Expense.py): `Backend/dsService/src/app/service/Expense.py`

### Messaging and storage

- **Apache Kafka**
- **MySQL**

### Cloud platform

- [Backend deployment](https://github.com/samyak811/expensetrackerapp/blob/main/Infrastructure/CDK/lib/expense-backend-services-stack.ts): `Infrastructure/CDK/lib/expense-backend-services-stack.ts`
- [Data services deployment](https://github.com/samyak811/expensetrackerapp/blob/main/Infrastructure/CDK/lib/expense-services-stack.ts): `Infrastructure/CDK/lib/expense-services-stack.ts`

### Other components

- **User**
- **Bank SMS**
- **Google Gemini**
- **AWS ECS and VPC**

## Connections

- User → Mobile app: uses (evidence: `README.md`)
- Bank SMS → Mobile app: delivers messages (evidence: `Frontend/ExpenseTrackerFrontend/App.tsx`)
- Mobile app → DS message service: posts SMS text (evidence: `Frontend/ExpenseTrackerFrontend/App.tsx`)
- Mobile app → Kong gateway: sends requests (evidence: `README.md`)
- Kong gateway → Auth service: routes requests (evidence: `README.md`)
- Kong gateway → User service: routes requests (evidence: `README.md`)
- Kong gateway → Expense API: routes requests (evidence: `README.md`)
- Kong gateway → DS message service: routes requests (evidence: `README.md`)
- User → Login and signup: authenticates (evidence: `README.md`)
- User → Expense home: views expenses (evidence: `README.md`)
- User → Add expense: adds expenses (evidence: `README.md`)
- User → Analytics: views analytics (evidence: `README.md`)
- User → Profile: manages profile (evidence: `README.md`)
- User → Expense details: views details (evidence: `README.md`)
- Expense home → Expense API: fetches expenses (evidence: `Frontend/ExpenseTrackerFrontend/src/app/pages/Home.tsx`)
- Expense API → Expense service: calls (evidence: `Backend/ExpenseService/app/src/main/java/com/expense/controller/ExpenseController.java`)
- Expense service → Expense repository: reads and writes (evidence: `Backend/ExpenseService/app/src/main/java/com/expense/service/ExpenseService.java`)
- Expense service → Expense model: maps records (evidence: `Backend/ExpenseService/app/src/main/java/com/expense/service/ExpenseService.java`)
- Expense service → Expense DTO: maps requests (evidence: `Backend/ExpenseService/app/src/main/java/com/expense/service/ExpenseService.java`)
- DS message service → Message classifier: classifies with (evidence: `Backend/dsService/src/app/service/messageService.py`)
- DS message service → LLM extraction: extracts with (evidence: `Backend/dsService/src/app/service/messageService.py`)
- LLM extraction → Google Gemini: invokes model (evidence: `Backend/dsService/src/app/service/llmService.py`)
- LLM extraction → Extracted expense schema: structures output (evidence: `Backend/dsService/src/app/service/llmService.py`)
- Expense service → MySQL: persists records (evidence: `README.md`)
- Expense service → Apache Kafka: uses event messaging (evidence: `README.md`)
- Backend deployment → AWS ECS and VPC: creates services (evidence: `Infrastructure/CDK/lib/expense-backend-services-stack.ts`)
- Data services deployment → AWS ECS and VPC: creates data services (evidence: `Infrastructure/CDK/lib/expense-services-stack.ts`)
- Data services deployment → MySQL: deploys (evidence: `Infrastructure/CDK/lib/expense-services-stack.ts`)
- Data services deployment → Apache Kafka: deploys (evidence: `Infrastructure/CDK/lib/expense-services-stack.ts`)
