# nagireddyrakesh842-maker/bioguard-ai architecture

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

- Interactive diagram: https://gitdiagram.com/nagireddyrakesh842-maker/bioguard-ai
- Repository: https://github.com/nagireddyrakesh842-maker/bioguard-ai

## Overview

BioGuard AI is presented as a hospital biomedical-waste compliance dashboard. Staff navigate from the app shell to scan a bin, choose a waste category, and review audit records; dashboards, compliance views, and facility-management screens provide broader oversight. The tree and excerpts show client-side routes, UI state, and export actions, but no demonstrated persistent backend or external scanning service. Unsampled route capabilities are included by their exact tree paths; links between them are shown only where excerpts document them.

Main entry points: [`routeTree.gen.ts`](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/routeTree.gen.ts) (Route registry), [`app.scanner.tsx`](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.scanner.tsx) (Bin scanner), [`app.dashboard.tsx`](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.dashboard.tsx) (Dashboard), [`app.audits.tsx`](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.audits.tsx) (Audit log)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["App runtime"]
  node_router["Router setup<br/>[router.tsx]"]
  node_route_tree["Route registry<br/>[routeTree.gen.ts]"]
  node_app_shell["App shell<br/>[__root.tsx]"]
  node_request_runtime["Request middleware<br/>[start.ts]"]
end

subgraph group_audit["Audits and compliance"]
  node_scanner["Bin scanner<br/>[app.scanner.tsx]"]
  node_audits["Audit log<br/>[app.audits.tsx]"]
  node_compliance["Compliance view<br/>[app.compliance.tsx]"]
  node_heatmap["Compliance heatmap"]
  node_alerts["Alerts<br/>[app.alerts.tsx]"]
end

subgraph group_facilities["Facility operations"]
  node_hospitals["Hospitals<br/>[app.hospitals.tsx]"]
  node_wards["Wards<br/>[app.wards.tsx]"]
  node_bins["Waste bins<br/>[app.bins.tsx]"]
end

subgraph group_oversight["Reporting and administration"]
  node_dashboard["Dashboard<br/>[app.dashboard.tsx]"]
  node_analytics["Analytics<br/>[app.analytics.tsx]"]
  node_reports["Reports<br/>[app.reports.tsx]"]
  node_users["User management<br/>[app.users.tsx]"]
  node_settings["Workspace settings<br/>[app.settings.tsx]"]
end

node_staff(("Hospital staff"))

node_router -->|"uses routes"| node_route_tree
node_route_tree -.->|"registers shell"| node_app_shell
node_route_tree -->|"registers route"| node_scanner
node_route_tree -->|"registers route"| node_audits
node_route_tree -->|"registers route"| node_compliance
node_route_tree -->|"registers route"| node_dashboard
node_route_tree -->|"registers route"| node_analytics
node_route_tree -->|"registers route"| node_reports
node_route_tree -->|"registers route"| node_alerts
node_route_tree -->|"registers route"| node_hospitals
node_route_tree -->|"registers route"| node_wards
node_route_tree -->|"registers route"| node_bins
node_route_tree -->|"registers route"| node_users
node_route_tree -->|"registers route"| node_settings
node_staff -.->|"opens app"| node_router
node_staff -.->|"submits scan"| node_scanner
node_scanner -->|"links to log"| node_audits
node_dashboard -->|"links to scan"| node_scanner
node_dashboard -->|"links to reports"| node_reports
node_audits -->|"links to scan"| node_scanner
node_compliance -->|"renders"| node_heatmap
node_dashboard -->|"renders"| node_heatmap
node_hospitals -->|"links to wards"| node_wards
node_wards -->|"links to bins"| node_bins

click node_router "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/router.tsx"
click node_route_tree "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/routeTree.gen.ts"
click node_app_shell "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/__root.tsx"
click node_request_runtime "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/start.ts"
click node_scanner "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.scanner.tsx"
click node_audits "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.audits.tsx"
click node_compliance "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.compliance.tsx"
click node_heatmap "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/ComplianceHeatmap.tsx"
click node_alerts "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.alerts.tsx"
click node_dashboard "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.dashboard.tsx"
click node_analytics "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.analytics.tsx"
click node_reports "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.reports.tsx"
click node_hospitals "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.hospitals.tsx"
click node_wards "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.wards.tsx"
click node_bins "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.bins.tsx"
click node_users "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.users.tsx"
click node_settings "https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.settings.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_router,node_route_tree,node_app_shell,node_request_runtime toneBlue
class node_scanner,node_audits,node_compliance,node_heatmap,node_alerts toneAmber
class node_hospitals,node_wards,node_bins toneMint
class node_dashboard,node_analytics,node_reports,node_users,node_settings toneRose
class node_staff toneIndigo
```

## Components

### App runtime

- [Router setup](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/router.tsx): `router.tsx`
- [Route registry](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/routeTree.gen.ts): `routeTree.gen.ts`
- [App shell](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/__root.tsx): `__root.tsx`
- [Request middleware](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/start.ts): `start.ts`

### Audits and compliance

- [Bin scanner](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.scanner.tsx): `app.scanner.tsx`
- [Audit log](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.audits.tsx): `app.audits.tsx`
- [Compliance view](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.compliance.tsx): `app.compliance.tsx`
- [Compliance heatmap](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/ComplianceHeatmap.tsx): `ComplianceHeatmap.tsx`
- [Alerts](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.alerts.tsx): `app.alerts.tsx`

### Facility operations

- [Hospitals](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.hospitals.tsx): `app.hospitals.tsx`
- [Wards](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.wards.tsx): `app.wards.tsx`
- [Waste bins](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.bins.tsx): `app.bins.tsx`

### Reporting and administration

- [Dashboard](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.dashboard.tsx): `app.dashboard.tsx`
- [Analytics](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.analytics.tsx): `app.analytics.tsx`
- [Reports](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.reports.tsx): `app.reports.tsx`
- [User management](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.users.tsx): `app.users.tsx`
- [Workspace settings](https://github.com/nagireddyrakesh842-maker/bioguard-ai/blob/main/app.settings.tsx): `app.settings.tsx`

### Other components

- **Hospital staff**

## Connections

- Router setup → Route registry: uses routes (evidence: `router.tsx`)
- Route registry → App shell: registers shell
- Route registry → Bin scanner: registers route (evidence: `routeTree.gen.ts`)
- Route registry → Audit log: registers route (evidence: `routeTree.gen.ts`)
- Route registry → Compliance view: registers route (evidence: `routeTree.gen.ts`)
- Route registry → Dashboard: registers route (evidence: `routeTree.gen.ts`)
- Route registry → Analytics: registers route (evidence: `routeTree.gen.ts`)
- Route registry → Reports: registers route (evidence: `routeTree.gen.ts`)
- Route registry → Alerts: registers route (evidence: `routeTree.gen.ts`)
- Route registry → Hospitals: registers route (evidence: `routeTree.gen.ts`)
- Route registry → Wards: registers route (evidence: `routeTree.gen.ts`)
- Route registry → Waste bins: registers route (evidence: `routeTree.gen.ts`)
- Route registry → User management: registers route (evidence: `routeTree.gen.ts`)
- Route registry → Workspace settings: registers route (evidence: `routeTree.gen.ts`)
- Hospital staff → Router setup: opens app
- Hospital staff → Bin scanner: submits scan
- Bin scanner → Audit log: links to log (evidence: `app.audits.tsx`)
- Dashboard → Bin scanner: links to scan (evidence: `app.dashboard.tsx`)
- Dashboard → Reports: links to reports (evidence: `app.dashboard.tsx`)
- Audit log → Bin scanner: links to scan (evidence: `app.audits.tsx`)
- Compliance view → Compliance heatmap: renders (evidence: `app.compliance.tsx`)
- Dashboard → Compliance heatmap: renders (evidence: `app.dashboard.tsx`)
- Hospitals → Wards: links to wards (evidence: `app.hospitals.tsx`)
- Wards → Waste bins: links to bins (evidence: `app.wards.tsx`)
