How sushmitha-katika-dev/build-flow works
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: JwtAuthenticationFilter.java API gateway · ExpenseController.java Expenses and payments · DashboardController.java Reports and dashboards · EquipmentUsageEvent.java Site activity events
Components 17
User interface
- React SPA
frontend/src/App.tsx
Access and identity
- API gateway
backend/api-gateway/src/main/java/com/buildflow/gateway/filter/JwtAuthenticationFilter.java - Authentication and RBAC
backend/auth-service/src/main/java/com/buildflow/auth/controller/AuthController.java
Site operations
- Project management
backend/project-service/src/main/java/com/buildflow/project/controller/ProjectController.java - Workforce and attendance
backend/workforce-service/src/main/java/com/buildflow/workforce/controller - Materials and stock
backend/inventory-service/src/main/java/com/buildflow/inventory/controller - Equipment and usage
backend/equipment-service/src/main/java/com/buildflow/equipment/controller/EquipmentController.java - Site activity events
backend/equipment-service/src/main/java/com/buildflow/equipment/dto/event/EquipmentUsageEvent.java
Finance and insights
- Expenses and payments
backend/finance-service/src/main/java/com/buildflow/finance/controller/ExpenseController.java - Finance event consumers
backend/finance-service/src/main/java/com/buildflow/finance/messaging/WorkforceKafkaConsumer.java - Project P&L
backend/finance-service/src/main/java/com/buildflow/finance/service/impl/ProfitLossServiceImpl.java - Reports and dashboards
backend/reporting-service/src/main/java/com/buildflow/reporting/controller/DashboardController.java - Dashboard cache
backend/reporting-service/src/main/java/com/buildflow/reporting/cache/DashboardCacheService.java
Shared infrastructure
- Event messaging
backend/equipment-service/src/main/java/com/buildflow/equipment/config/KafkaConfig.java - Redis
- Service databases
Other components
- Construction users
Connections 26
- Construction users → React SPA: use
README.md - React SPA → API gateway: send requests
README.md - API gateway → Authentication and RBAC: route requests
README.md - API gateway → Project management: route requests
README.md - API gateway → Workforce and attendance: route requests
README.md - API gateway → Materials and stock: route requests
README.md - API gateway → Equipment and usage: route requests
README.md - API gateway → Expenses and payments: route requests
README.md - API gateway → Reports and dashboards: route requests
README.md - Workforce and attendance → Site activity events: publish attendance
README.md - Materials and stock → Site activity events: publish consumption
README.md - Equipment and usage → Site activity events: publish usage
README.md - Site activity events → Event messaging: send events
README.md - Event messaging → Finance event consumers: deliver events
README.md - Finance event consumers → Expenses and payments: record expenses
README.md - Expenses and payments → Project P&L: calculate profitability
README.md - Event messaging → Reports and dashboards: deliver events
README.md - Reports and dashboards → Dashboard cache: cache dashboards
README.md - Dashboard cache → Redis: read and write
backend/reporting-service/src/main/java/com/buildflow/reporting/cache/DashboardCacheService.java - Authentication and RBAC → Service databases: persist identity
README.md - Project management → Service databases: persist projects
README.md - Workforce and attendance → Service databases: persist workforce
README.md - Materials and stock → Service databases: persist inventory
README.md - Equipment and usage → Service databases: persist equipment
README.md - Expenses and payments → Service databases: persist finance
README.md - Reports and dashboards → Service databases: read service data
README.md