# gargharshit304-lab/solar_installation_management_system architecture

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

- Interactive diagram: https://gitdiagram.com/gargharshit304-lab/solar_installation_management_system
- Repository: https://github.com/gargharshit304-lab/solar_installation_management_system

## Overview

SolarOS is an enterprise solar-installation operations app, organized around a customer-to-project workflow: sales captures inquiries, field staff survey sites, engineering reviews feasibility, and approved proposals become orders that proceed through inventory, dispatch, installation, warranty, and finance. Role-aware routing exposes these capabilities alongside owner administration, AI operations, and reporting. The README documents the domain workflow; source excerpts and the SOURCE INDEX support selected UI and state connections. Many page implementations were not sampled, so their internal calls are not inferred.

Main entry points: [`src/App.tsx`](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/App.tsx) (Role-based routes), [`src/context/AppContext.tsx`](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/context/AppContext.tsx) (Application state), [`src/pages/engineering/EngineeringDashboardPage.tsx`](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/engineering/EngineeringDashboardPage.tsx) (Engineering review), [`src/pages/SalesDashboardPage.tsx`](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/SalesDashboardPage.tsx) (Sales CRM)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sales["Sales and Surveys"]
  node_sales["Sales CRM"]
  node_customers["Customer profiles<br/>[CustomersPage.tsx]"]
  node_surveys["Site surveys"]
  node_field["Field survey workspace"]
  node_engineering["Engineering review"]
  node_quotations["Quotation builder<br/>[QuotationsPage.tsx]"]
  node_engineeringmodal["Engineering decision"]
  node_fielddashboard["Technician dashboard"]
end

subgraph group_operations["Project Operations"]
  node_orders["Orders and payments"]
  node_inventory["Inventory and serials<br/>[InventoryPage.tsx]"]
  node_dispatch["Material dispatch<br/>[DispatchPage.tsx]"]
  node_installations["Installation execution"]
  node_warranty["Warranty coverage<br/>[WarrantyPage.tsx]"]
  node_service["Service complaints"]
end

subgraph group_enterprise["Business Management"]
  node_workforce["Workforce management<br/>[WorkforcePage.tsx]"]
  node_finance["Project finance<br/>[FinancePage.tsx]"]
  node_reports["Reports and KPIs<br/>[ReportsPage.tsx]"]
  node_ai["AI operations center"]
  node_owner["Owner administration"]
end

subgraph group_app["Application Core"]
  node_routing["Role-based routes<br/>[App.tsx]"]
  node_context["Application state<br/>[AppContext.tsx]"]
  node_mockdata["Demo operational data<br/>[mockData.ts]"]
  node_layout["Navigation and shell<br/>[AppLayout.tsx]"]
end

node_staff(("SolarOS users"))

node_staff -->|"uses"| node_routing
node_routing -->|"routes to"| node_sales
node_routing -->|"routes to"| node_surveys
node_routing -->|"routes to"| node_fielddashboard
node_routing -->|"routes to"| node_engineering
node_sales -->|"requests survey"| node_surveys
node_fielddashboard -->|"opens workspace"| node_field
node_surveys -->|"submits for review"| node_engineering
node_engineering -->|"opens review"| node_engineeringmodal
node_engineering -->|"approves feasibility"| node_quotations
node_sales -->|"creates proposals"| node_quotations
node_quotations -->|"converts approved quote"| node_orders
node_orders -->|"allocates materials"| node_inventory
node_inventory -->|"supplies dispatch"| node_dispatch
node_dispatch -->|"delivers to site"| node_installations
node_dispatch -->|"starts coverage"| node_warranty
node_installations -->|"records project costs"| node_finance
node_warranty -->|"informs coverage"| node_service
node_staff -->|"navigates"| node_layout
node_layout -->|"hosts routes"| node_routing
node_routing -->|"provides state"| node_context
node_context -->|"initializes from"| node_mockdata
node_sales -->|"reads and updates"| node_context
node_customers -->|"reads and updates"| node_context
node_fielddashboard -->|"reads and updates"| node_context
node_engineering -->|"reads survey state"| node_context
node_service -->|"reads service data"| node_context
node_staff -->|"administers"| node_owner
node_staff -->|"manages workforce"| node_workforce
node_staff -->|"reviews reports"| node_reports
node_staff -->|"queries operations"| node_ai

click node_routing "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/App.tsx"
click node_sales "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/SalesDashboardPage.tsx"
click node_customers "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/CustomersPage.tsx"
click node_surveys "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/SiteSurveysPage.tsx"
click node_field "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/components/field/SiteSurveyWorkspaceModal.tsx"
click node_engineering "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/engineering/EngineeringDashboardPage.tsx"
click node_quotations "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/QuotationsPage.tsx"
click node_orders "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/OrdersPaymentsPage.tsx"
click node_inventory "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/InventoryPage.tsx"
click node_dispatch "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/DispatchPage.tsx"
click node_installations "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/InstallationsPage.tsx"
click node_warranty "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/WarrantyPage.tsx"
click node_service "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/ServiceComplaintsPage.tsx"
click node_workforce "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/WorkforcePage.tsx"
click node_finance "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/FinancePage.tsx"
click node_reports "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/ReportsPage.tsx"
click node_ai "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/AiCommandCenterPage.tsx"
click node_owner "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/owner/ApprovalsRequestsPage.tsx"
click node_context "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/context/AppContext.tsx"
click node_mockdata "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/data/mockData.ts"
click node_layout "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/components/layout/AppLayout.tsx"
click node_engineeringmodal "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/engineering/EngineeringReviewModal.tsx"
click node_fielddashboard "https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/field/FieldDashboardPage.tsx"

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_sales,node_customers,node_surveys,node_field,node_engineering,node_quotations,node_engineeringmodal,node_fielddashboard,node_staff toneBlue
class node_orders,node_inventory,node_dispatch,node_installations,node_warranty,node_service toneAmber
class node_workforce,node_finance,node_reports,node_ai,node_owner toneMint
class node_routing,node_context,node_mockdata,node_layout toneRose
```

## Components

### Sales and Surveys

- [Sales CRM](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/SalesDashboardPage.tsx): `src/pages/SalesDashboardPage.tsx`
- [Customer profiles](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/CustomersPage.tsx): `src/pages/CustomersPage.tsx`
- [Site surveys](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/SiteSurveysPage.tsx): `src/pages/SiteSurveysPage.tsx`
- [Field survey workspace](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/components/field/SiteSurveyWorkspaceModal.tsx): `src/components/field/SiteSurveyWorkspaceModal.tsx`
- [Engineering review](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/engineering/EngineeringDashboardPage.tsx): `src/pages/engineering/EngineeringDashboardPage.tsx`
- [Quotation builder](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/QuotationsPage.tsx): `src/pages/QuotationsPage.tsx`
- [Engineering decision](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/engineering/EngineeringReviewModal.tsx): `src/pages/engineering/EngineeringReviewModal.tsx`
- [Technician dashboard](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/field/FieldDashboardPage.tsx): `src/pages/field/FieldDashboardPage.tsx`

### Project Operations

- [Orders and payments](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/OrdersPaymentsPage.tsx): `src/pages/OrdersPaymentsPage.tsx`
- [Inventory and serials](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/InventoryPage.tsx): `src/pages/InventoryPage.tsx`
- [Material dispatch](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/DispatchPage.tsx): `src/pages/DispatchPage.tsx`
- [Installation execution](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/InstallationsPage.tsx): `src/pages/InstallationsPage.tsx`
- [Warranty coverage](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/WarrantyPage.tsx): `src/pages/WarrantyPage.tsx`
- [Service complaints](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/ServiceComplaintsPage.tsx): `src/pages/ServiceComplaintsPage.tsx`

### Business Management

- [Workforce management](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/WorkforcePage.tsx): `src/pages/WorkforcePage.tsx`
- [Project finance](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/FinancePage.tsx): `src/pages/FinancePage.tsx`
- [Reports and KPIs](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/ReportsPage.tsx): `src/pages/ReportsPage.tsx`
- [AI operations center](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/AiCommandCenterPage.tsx): `src/pages/AiCommandCenterPage.tsx`
- [Owner administration](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/pages/owner/ApprovalsRequestsPage.tsx): `src/pages/owner/ApprovalsRequestsPage.tsx`

### Application Core

- [Role-based routes](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/App.tsx): `src/App.tsx`
- [Application state](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/context/AppContext.tsx): `src/context/AppContext.tsx`
- [Demo operational data](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/data/mockData.ts): `src/data/mockData.ts`
- [Navigation and shell](https://github.com/gargharshit304-lab/solar_installation_management_system/blob/main/src/components/layout/AppLayout.tsx): `src/components/layout/AppLayout.tsx`

### Other components

- **SolarOS users**

## Connections

- SolarOS users → Role-based routes: uses
- Role-based routes → Sales CRM: routes to (evidence: `src/App.tsx`)
- Role-based routes → Site surveys: routes to (evidence: `src/App.tsx`)
- Role-based routes → Technician dashboard: routes to (evidence: `src/App.tsx`)
- Role-based routes → Engineering review: routes to (evidence: `src/App.tsx`)
- Sales CRM → Site surveys: requests survey
- Technician dashboard → Field survey workspace: opens workspace (evidence: `src/pages/field/FieldDashboardPage.tsx`)
- Site surveys → Engineering review: submits for review
- Engineering review → Engineering decision: opens review (evidence: `src/pages/engineering/EngineeringDashboardPage.tsx`)
- Engineering review → Quotation builder: approves feasibility
- Sales CRM → Quotation builder: creates proposals (evidence: `src/pages/SalesDashboardPage.tsx`)
- Quotation builder → Orders and payments: converts approved quote
- Orders and payments → Inventory and serials: allocates materials
- Inventory and serials → Material dispatch: supplies dispatch
- Material dispatch → Installation execution: delivers to site
- Material dispatch → Warranty coverage: starts coverage
- Installation execution → Project finance: records project costs
- Warranty coverage → Service complaints: informs coverage
- SolarOS users → Navigation and shell: navigates
- Navigation and shell → Role-based routes: hosts routes (evidence: `src/components/layout/AppLayout.tsx`)
- Role-based routes → Application state: provides state (evidence: `src/App.tsx`)
- Application state → Demo operational data: initializes from (evidence: `src/context/AppContext.tsx`)
- Sales CRM → Application state: reads and updates (evidence: `src/pages/SalesDashboardPage.tsx`)
- Customer profiles → Application state: reads and updates (evidence: `src/pages/CustomersPage.tsx`)
- Technician dashboard → Application state: reads and updates (evidence: `src/pages/field/FieldDashboardPage.tsx`)
- Engineering review → Application state: reads survey state (evidence: `src/pages/engineering/EngineeringDashboardPage.tsx`)
- Service complaints → Application state: reads service data (evidence: `src/pages/ServiceComplaintsPage.tsx`)
- SolarOS users → Owner administration: administers
- SolarOS users → Workforce management: manages workforce
- SolarOS users → Reports and KPIs: reviews reports
- SolarOS users → AI operations center: queries operations
