# sushmitha-katika-dev/build-flow architecture

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

- Interactive diagram: https://gitdiagram.com/sushmitha-katika-dev/build-flow
- Repository: https://github.com/sushmitha-katika-dev/build-flow

## Overview

BuildFlow is a construction-operations platform whose main workflow turns project and site activity into finance records and reporting. Users enter through the React SPA and API gateway; domain services manage projects, workers, materials, equipment, and finances. The README documents asynchronous operational events through Kafka into Finance and Reporting, with Redis caching dashboard data. Service internals and several cross-service details are not sampled, so the graph uses README-backed relationships and does not infer unshown calls.

Main entry points: [`backend/api-gateway/src/main/java/com/buildflow/gateway/filter/JwtAuthenticationFilter.java`](https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/api-gateway/src/main/java/com/buildflow/gateway/filter/JwtAuthenticationFilter.java) (API gateway), [`backend/finance-service/src/main/java/com/buildflow/finance/controller/ExpenseController.java`](https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/finance-service/src/main/java/com/buildflow/finance/controller/ExpenseController.java) (Expenses and payments), [`backend/reporting-service/src/main/java/com/buildflow/reporting/controller/DashboardController.java`](https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/reporting-service/src/main/java/com/buildflow/reporting/controller/DashboardController.java) (Reports and dashboards), [`backend/equipment-service/src/main/java/com/buildflow/equipment/dto/event/EquipmentUsageEvent.java`](https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/equipment-service/src/main/java/com/buildflow/equipment/dto/event/EquipmentUsageEvent.java) (Site activity events)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User interface"]
  node_spa["React SPA<br/>[App.tsx]"]
end

subgraph group_access["Access and identity"]
  node_gateway["API gateway"]
  node_auth["Authentication and RBAC"]
end

subgraph group_operations["Site operations"]
  node_projects["Project management"]
  node_workforce["Workforce and attendance"]
  node_inventory["Materials and stock"]
  node_equipment["Equipment and usage"]
  node_siteevents["Site activity events"]
end

subgraph group_insights["Finance and insights"]
  node_finance["Expenses and payments"]
  node_financemsg["Finance event consumers"]
  node_profitloss["Project P&amp;L"]
  node_reporting["Reports and dashboards"]
  node_reportcache["Dashboard cache"]
end

subgraph group_infrastructure["Shared infrastructure"]
  node_kafka["Event messaging<br/>[KafkaConfig.java]"]
  node_redis[("Redis")]
  node_service_db[("Service databases")]
end

node_users(("Construction users"))

node_users -->|"use"| node_spa
node_spa -->|"send requests"| node_gateway
node_gateway -->|"route requests"| node_auth
node_gateway -->|"route requests"| node_projects
node_gateway -->|"route requests"| node_workforce
node_gateway -->|"route requests"| node_inventory
node_gateway -->|"route requests"| node_equipment
node_gateway -->|"route requests"| node_finance
node_gateway -->|"route requests"| node_reporting
node_workforce -.->|"publish attendance"| node_siteevents
node_inventory -.->|"publish consumption"| node_siteevents
node_equipment -.->|"publish usage"| node_siteevents
node_siteevents -->|"send events"| node_kafka
node_kafka -->|"deliver events"| node_financemsg
node_financemsg -->|"record expenses"| node_finance
node_finance -.->|"calculate profitability"| node_profitloss
node_kafka -->|"deliver events"| node_reporting
node_reporting -.->|"cache dashboards"| node_reportcache
node_reportcache -->|"read and write"| node_redis
node_auth -.->|"persist identity"| node_service_db
node_projects -.->|"persist projects"| node_service_db
node_workforce -.->|"persist workforce"| node_service_db
node_inventory -.->|"persist inventory"| node_service_db
node_equipment -.->|"persist equipment"| node_service_db
node_finance -.->|"persist finance"| node_service_db
node_reporting -.->|"read service data"| node_service_db

click node_spa "https://github.com/sushmitha-katika-dev/build-flow/blob/main/frontend/src/App.tsx"
click node_gateway "https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/api-gateway/src/main/java/com/buildflow/gateway/filter/JwtAuthenticationFilter.java"
click node_auth "https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/auth-service/src/main/java/com/buildflow/auth/controller/AuthController.java"
click node_projects "https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/project-service/src/main/java/com/buildflow/project/controller/ProjectController.java"
click node_workforce "https://github.com/sushmitha-katika-dev/build-flow/tree/main/backend/workforce-service/src/main/java/com/buildflow/workforce/controller"
click node_inventory "https://github.com/sushmitha-katika-dev/build-flow/tree/main/backend/inventory-service/src/main/java/com/buildflow/inventory/controller"
click node_equipment "https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/equipment-service/src/main/java/com/buildflow/equipment/controller/EquipmentController.java"
click node_siteevents "https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/equipment-service/src/main/java/com/buildflow/equipment/dto/event/EquipmentUsageEvent.java"
click node_kafka "https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/equipment-service/src/main/java/com/buildflow/equipment/config/KafkaConfig.java"
click node_finance "https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/finance-service/src/main/java/com/buildflow/finance/controller/ExpenseController.java"
click node_financemsg "https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/finance-service/src/main/java/com/buildflow/finance/messaging/WorkforceKafkaConsumer.java"
click node_profitloss "https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/finance-service/src/main/java/com/buildflow/finance/service/impl/ProfitLossServiceImpl.java"
click node_reporting "https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/reporting-service/src/main/java/com/buildflow/reporting/controller/DashboardController.java"
click node_reportcache "https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/reporting-service/src/main/java/com/buildflow/reporting/cache/DashboardCacheService.java"

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_spa,node_users toneBlue
class node_gateway,node_auth toneAmber
class node_projects,node_workforce,node_inventory,node_equipment,node_siteevents toneMint
class node_finance,node_financemsg,node_profitloss,node_reporting,node_reportcache toneRose
class node_kafka,node_redis,node_service_db toneIndigo
```

## Components

### User interface

- [React SPA](https://github.com/sushmitha-katika-dev/build-flow/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`

### Access and identity

- [API gateway](https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/api-gateway/src/main/java/com/buildflow/gateway/filter/JwtAuthenticationFilter.java): `backend/api-gateway/src/main/java/com/buildflow/gateway/filter/JwtAuthenticationFilter.java`
- [Authentication and RBAC](https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/auth-service/src/main/java/com/buildflow/auth/controller/AuthController.java): `backend/auth-service/src/main/java/com/buildflow/auth/controller/AuthController.java`

### Site operations

- [Project management](https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/project-service/src/main/java/com/buildflow/project/controller/ProjectController.java): `backend/project-service/src/main/java/com/buildflow/project/controller/ProjectController.java`
- [Workforce and attendance](https://github.com/sushmitha-katika-dev/build-flow/tree/main/backend/workforce-service/src/main/java/com/buildflow/workforce/controller): `backend/workforce-service/src/main/java/com/buildflow/workforce/controller`
- [Materials and stock](https://github.com/sushmitha-katika-dev/build-flow/tree/main/backend/inventory-service/src/main/java/com/buildflow/inventory/controller): `backend/inventory-service/src/main/java/com/buildflow/inventory/controller`
- [Equipment and usage](https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/equipment-service/src/main/java/com/buildflow/equipment/controller/EquipmentController.java): `backend/equipment-service/src/main/java/com/buildflow/equipment/controller/EquipmentController.java`
- [Site activity events](https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/equipment-service/src/main/java/com/buildflow/equipment/dto/event/EquipmentUsageEvent.java): `backend/equipment-service/src/main/java/com/buildflow/equipment/dto/event/EquipmentUsageEvent.java`

### Finance and insights

- [Expenses and payments](https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/finance-service/src/main/java/com/buildflow/finance/controller/ExpenseController.java): `backend/finance-service/src/main/java/com/buildflow/finance/controller/ExpenseController.java`
- [Finance event consumers](https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/finance-service/src/main/java/com/buildflow/finance/messaging/WorkforceKafkaConsumer.java): `backend/finance-service/src/main/java/com/buildflow/finance/messaging/WorkforceKafkaConsumer.java`
- [Project P&L](https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/finance-service/src/main/java/com/buildflow/finance/service/impl/ProfitLossServiceImpl.java): `backend/finance-service/src/main/java/com/buildflow/finance/service/impl/ProfitLossServiceImpl.java`
- [Reports and dashboards](https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/reporting-service/src/main/java/com/buildflow/reporting/controller/DashboardController.java): `backend/reporting-service/src/main/java/com/buildflow/reporting/controller/DashboardController.java`
- [Dashboard cache](https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/reporting-service/src/main/java/com/buildflow/reporting/cache/DashboardCacheService.java): `backend/reporting-service/src/main/java/com/buildflow/reporting/cache/DashboardCacheService.java`

### Shared infrastructure

- [Event messaging](https://github.com/sushmitha-katika-dev/build-flow/blob/main/backend/equipment-service/src/main/java/com/buildflow/equipment/config/KafkaConfig.java): `backend/equipment-service/src/main/java/com/buildflow/equipment/config/KafkaConfig.java`
- **Redis**
- **Service databases**

### Other components

- **Construction users**

## Connections

- Construction users → React SPA: use (evidence: `README.md`)
- React SPA → API gateway: send requests (evidence: `README.md`)
- API gateway → Authentication and RBAC: route requests (evidence: `README.md`)
- API gateway → Project management: route requests (evidence: `README.md`)
- API gateway → Workforce and attendance: route requests (evidence: `README.md`)
- API gateway → Materials and stock: route requests (evidence: `README.md`)
- API gateway → Equipment and usage: route requests (evidence: `README.md`)
- API gateway → Expenses and payments: route requests (evidence: `README.md`)
- API gateway → Reports and dashboards: route requests (evidence: `README.md`)
- Workforce and attendance → Site activity events: publish attendance (evidence: `README.md`)
- Materials and stock → Site activity events: publish consumption (evidence: `README.md`)
- Equipment and usage → Site activity events: publish usage (evidence: `README.md`)
- Site activity events → Event messaging: send events (evidence: `README.md`)
- Event messaging → Finance event consumers: deliver events (evidence: `README.md`)
- Finance event consumers → Expenses and payments: record expenses (evidence: `README.md`)
- Expenses and payments → Project P&L: calculate profitability (evidence: `README.md`)
- Event messaging → Reports and dashboards: deliver events (evidence: `README.md`)
- Reports and dashboards → Dashboard cache: cache dashboards (evidence: `README.md`)
- Dashboard cache → Redis: read and write (evidence: `backend/reporting-service/src/main/java/com/buildflow/reporting/cache/DashboardCacheService.java`)
- Authentication and RBAC → Service databases: persist identity (evidence: `README.md`)
- Project management → Service databases: persist projects (evidence: `README.md`)
- Workforce and attendance → Service databases: persist workforce (evidence: `README.md`)
- Materials and stock → Service databases: persist inventory (evidence: `README.md`)
- Equipment and usage → Service databases: persist equipment (evidence: `README.md`)
- Expenses and payments → Service databases: persist finance (evidence: `README.md`)
- Reports and dashboards → Service databases: read service data (evidence: `README.md`)
