# anoja-builds/buildwis3 architecture

> Architecture diagram of the GitHub repository anoja-builds/buildwis3, 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/anoja-builds/buildwis3
- Repository: https://github.com/anoja-builds/buildwis3

## Overview

BuildWise is a construction materials management platform spanning material requests and approvals, supplier quotations and procurement, delivery and receiving, and quality inspection with non-conformance handling. The documented workflow runs from request through approval, quotation, procurement, delivery, receiving, and inspection. The React web app and Flutter mobile app serve users through an ASP.NET API backed by PostgreSQL; Python agents provide planning, procurement, delivery-discrepancy, and quality-risk analysis. The graph reflects README workflow claims and available source-index references; several subsystem implementations were not sampled, so some documented links are shown without source-level detail.

Main entry points: [`backend/BuildWise.Api/Program.cs`](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Program.cs) (ASP.NET API), [`backend/BuildWise.Api/Controllers/DeliveriesController.cs`](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Controllers/DeliveriesController.cs) (Delivery and receiving), [`backend/BuildWise.Api/Controllers/MaterialRequestsController.cs`](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Controllers/MaterialRequestsController.cs) (Material requests), [`ai/buildwise-agent-service/app/main.py`](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/ai/buildwise-agent-service/app/main.py) (Python agent service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User Clients"]
  node_web["React web app<br/>[App.jsx]"]
  node_mobile["Flutter mobile app"]
end

subgraph group_request["Request Management"]
  node_requests["Material requests"]
  node_request_ui["Request interface"]
end

subgraph group_procurement["Procurement"]
  node_suppliers_quotes["Suppliers and quotations"]
  node_procurement_workflow["Procurement workflow"]
  node_procurement_ui["Procurement interface<br/>[ProcurementApp.jsx]"]
  node_planning_agent["Planning and procurement agents<br/>[planning_agent.py]"]
end

subgraph group_delivery["Delivery Management"]
  node_delivery["Delivery and receiving"]
  node_delivery_ui["Delivery interface"]
  node_delivery_agent["Delivery discrepancy agent<br/>[delivery_agent.py]"]
end

subgraph group_quality["Quality Management"]
  node_quality["Inspection and non-conformance"]
  node_quality_ui["Quality interface<br/>[QualityApp.jsx]"]
  node_quality_agent["Quality risk agent<br/>[quality_agent.py]"]
end

subgraph group_platform["API and Data"]
  node_api["ASP.NET API<br/>[Program.cs]"]
  node_database[("PostgreSQL data model")]
  node_agent_api["Python agent service<br/>[main.py]"]
end

node_users(("Construction users"))

node_users -->|"uses"| node_web
node_users -->|"uses"| node_mobile
node_web -.->|"calls API"| node_api
node_mobile -.->|"calls API"| node_api
node_api -.->|"routes requests"| node_requests
node_api -.->|"routes quotations"| node_suppliers_quotes
node_api -->|"routes deliveries"| node_delivery
node_request_ui -->|"submits requests"| node_requests
node_requests -->|"advances to approval"| node_suppliers_quotes
node_suppliers_quotes -.->|"supports procurement"| node_procurement_workflow
node_procurement_ui -.->|"manages procurement"| node_procurement_workflow
node_procurement_workflow -->|"orders materials"| node_delivery
node_delivery_ui -->|"records receiving"| node_delivery
node_delivery -->|"sends for inspection"| node_quality
node_quality_ui -.->|"manages inspection"| node_quality
node_requests -->|"reads and writes"| node_database
node_suppliers_quotes -->|"reads and writes"| node_database
node_delivery -->|"reads and writes"| node_database
node_quality -.->|"persists quality records"| node_database
node_api -.->|"requests analysis"| node_agent_api
node_agent_api -->|"dispatches planning"| node_planning_agent
node_agent_api -->|"dispatches discrepancies"| node_delivery_agent
node_agent_api -->|"dispatches risk analysis"| node_quality_agent
node_requests -->|"requests planning advice"| node_planning_agent
node_delivery -->|"requests discrepancy analysis"| node_delivery_agent
node_planning_agent -.->|"returns recommendations"| node_agent_api

click node_web "https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/web/buildwise-web/src/App.jsx"
click node_mobile "https://github.com/anoja-builds/buildwis3/tree/ui/final-figma-flutter/mobile/buildwise_mobile"
click node_requests "https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Controllers/MaterialRequestsController.cs"
click node_request_ui "https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/web/buildwise-web/src/Features/MaterialRequests/pages/MaterialRequestsPage.jsx"
click node_suppliers_quotes "https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Controllers/QuotationsController.cs"
click node_procurement_workflow "https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Services/ProcurementWorkflowService.cs"
click node_procurement_ui "https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/web/buildwise-web/src/Features/procurement/pages/ProcurementApp.jsx"
click node_delivery "https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Controllers/DeliveriesController.cs"
click node_delivery_ui "https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/web/buildwise-web/src/Features/deliveries/pages/DeliveryDashboard.jsx"
click node_quality "https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Services/QualityInspectionService.cs"
click node_quality_ui "https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/web/buildwise-web/src/Features/quality/QualityApp.jsx"
click node_api "https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Program.cs"
click node_database "https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Data/ApplicationDbContext.cs"
click node_agent_api "https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/ai/buildwise-agent-service/app/main.py"
click node_planning_agent "https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/ai/buildwise-agent-service/app/planning_agent.py"
click node_delivery_agent "https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/ai/buildwise-agent-service/app/delivery_agent.py"
click node_quality_agent "https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/ai/buildwise-agent-service/app/quality_agent.py"

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_web,node_mobile,node_users toneBlue
class node_requests,node_request_ui toneAmber
class node_suppliers_quotes,node_procurement_workflow,node_procurement_ui,node_planning_agent toneMint
class node_delivery,node_delivery_ui,node_delivery_agent toneRose
class node_quality,node_quality_ui,node_quality_agent toneIndigo
class node_api,node_database,node_agent_api toneTeal
```

## Components

### User Clients

- [React web app](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/web/buildwise-web/src/App.jsx): `web/buildwise-web/src/App.jsx`
- [Flutter mobile app](https://github.com/anoja-builds/buildwis3/tree/ui/final-figma-flutter/mobile/buildwise_mobile): `mobile/buildwise_mobile`

### Request Management

- [Material requests](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Controllers/MaterialRequestsController.cs): `backend/BuildWise.Api/Controllers/MaterialRequestsController.cs`
- [Request interface](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/web/buildwise-web/src/Features/MaterialRequests/pages/MaterialRequestsPage.jsx): `web/buildwise-web/src/Features/MaterialRequests/pages/MaterialRequestsPage.jsx`

### Procurement

- [Suppliers and quotations](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Controllers/QuotationsController.cs): `backend/BuildWise.Api/Controllers/QuotationsController.cs`
- [Procurement workflow](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Services/ProcurementWorkflowService.cs): `backend/BuildWise.Api/Services/ProcurementWorkflowService.cs`
- [Procurement interface](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/web/buildwise-web/src/Features/procurement/pages/ProcurementApp.jsx): `web/buildwise-web/src/Features/procurement/pages/ProcurementApp.jsx`
- [Planning and procurement agents](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/ai/buildwise-agent-service/app/planning_agent.py): `ai/buildwise-agent-service/app/planning_agent.py`

### Delivery Management

- [Delivery and receiving](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Controllers/DeliveriesController.cs): `backend/BuildWise.Api/Controllers/DeliveriesController.cs`
- [Delivery interface](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/web/buildwise-web/src/Features/deliveries/pages/DeliveryDashboard.jsx): `web/buildwise-web/src/Features/deliveries/pages/DeliveryDashboard.jsx`
- [Delivery discrepancy agent](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/ai/buildwise-agent-service/app/delivery_agent.py): `ai/buildwise-agent-service/app/delivery_agent.py`

### Quality Management

- [Inspection and non-conformance](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Services/QualityInspectionService.cs): `backend/BuildWise.Api/Services/QualityInspectionService.cs`
- [Quality interface](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/web/buildwise-web/src/Features/quality/QualityApp.jsx): `web/buildwise-web/src/Features/quality/QualityApp.jsx`
- [Quality risk agent](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/ai/buildwise-agent-service/app/quality_agent.py): `ai/buildwise-agent-service/app/quality_agent.py`

### API and Data

- [ASP.NET API](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Program.cs): `backend/BuildWise.Api/Program.cs`
- [PostgreSQL data model](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/backend/BuildWise.Api/Data/ApplicationDbContext.cs): `backend/BuildWise.Api/Data/ApplicationDbContext.cs`
- [Python agent service](https://github.com/anoja-builds/buildwis3/blob/ui/final-figma-flutter/ai/buildwise-agent-service/app/main.py): `ai/buildwise-agent-service/app/main.py`

### Other components

- **Construction users**

## Connections

- Construction users → React web app: uses (evidence: `README.md`)
- Construction users → Flutter mobile app: uses (evidence: `README.md`)
- React web app → ASP.NET API: calls API
- Flutter mobile app → ASP.NET API: calls API
- ASP.NET API → Material requests: routes requests
- ASP.NET API → Suppliers and quotations: routes quotations
- ASP.NET API → Delivery and receiving: routes deliveries (evidence: `backend/BuildWise.Api/Controllers/DeliveriesController.cs`)
- Request interface → Material requests: submits requests (evidence: `README.md`)
- Material requests → Suppliers and quotations: advances to approval (evidence: `README.md`)
- Suppliers and quotations → Procurement workflow: supports procurement
- Procurement interface → Procurement workflow: manages procurement
- Procurement workflow → Delivery and receiving: orders materials (evidence: `README.md`)
- Delivery interface → Delivery and receiving: records receiving (evidence: `README.md`)
- Delivery and receiving → Inspection and non-conformance: sends for inspection (evidence: `README.md`)
- Quality interface → Inspection and non-conformance: manages inspection
- Material requests → PostgreSQL data model: reads and writes (evidence: `backend/BuildWise.Api/Controllers/MaterialRequestsController.cs`)
- Suppliers and quotations → PostgreSQL data model: reads and writes (evidence: `backend/BuildWise.Api/Controllers/QuotationsController.cs`)
- Delivery and receiving → PostgreSQL data model: reads and writes (evidence: `backend/BuildWise.Api/Controllers/DeliveriesController.cs`)
- Inspection and non-conformance → PostgreSQL data model: persists quality records
- ASP.NET API → Python agent service: requests analysis (evidence: `README.md`)
- Python agent service → Planning and procurement agents: dispatches planning (evidence: `ai/buildwise-agent-service/app/main.py`)
- Python agent service → Delivery discrepancy agent: dispatches discrepancies (evidence: `ai/buildwise-agent-service/app/main.py`)
- Python agent service → Quality risk agent: dispatches risk analysis (evidence: `ai/buildwise-agent-service/app/main.py`)
- Material requests → Planning and procurement agents: requests planning advice (evidence: `backend/BuildWise.Api/Controllers/MaterialRequestsController.cs`)
- Delivery and receiving → Delivery discrepancy agent: requests discrepancy analysis (evidence: `backend/BuildWise.Api/Controllers/DeliveriesController.cs`)
- Planning and procurement agents → Python agent service: returns recommendations (evidence: `ai/buildwise-agent-service/app/main.py`)
