# michaelparks03/3dlabmanager architecture

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

- Interactive diagram: https://gitdiagram.com/michaelparks03/3dlabmanager
- Repository: https://github.com/michaelparks03/3dlabmanager

## Overview

The tree contains a 3D lab/equipment manager frontend in Archive, a FastAPI admin-auth and health API, and a smaller frontend with lab, ticket, and login screens. The archived app’s routes expose inventory browsing, item details, 3D lab maps, and admin management; sampled code shows item administration using Supabase and uploads. The API implements admin sessions and health routing. No README or sampled HTTP client establishes a connection between either frontend and that API, so they are shown as separate surfaces. Some frontend capabilities are inferred from routes and filenames, not unsampled implementation.

Main entry points: [`Archive/frontend/src/App.jsx`](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/App.jsx) (App Router), [`src/frontend/src/App.jsx`](https://github.com/michaelparks03/3dlabmanager/blob/main/src/frontend/src/App.jsx) (Portal Router), [`Archive/frontend/src/pages/admin/ItemsAdmin.jsx`](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/admin/ItemsAdmin.jsx) (Item Administration), [`src/backend/app/features/auth/router.py`](https://github.com/michaelparks03/3dlabmanager/blob/main/src/backend/app/features/auth/router.py) (Auth Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inventory["Lab Inventory"]
  node_archive_app["App Router<br/>[App.jsx]"]
  node_home["Home<br/>[Home.jsx]"]
  node_items["Item Catalog<br/>[Items.jsx]"]
  node_item_detail["Item Details<br/>[ItemDetail.jsx]"]
  node_lab_map["3D Lab Map<br/>[Map3d.jsx]"]
  node_map_index["Lab Map Index<br/>[Map3dIndex.jsx]"]
  node_equipment_data["Equipment Data<br/>[supabaseItems.js]"]
  node_lab_data["Lab Data<br/>[supabaseLabs.js]"]
  node_supabase["Supabase Client<br/>[supabase.js]"]
end

subgraph group_admin["Admin and Auth"]
  node_auth_context["Auth Context<br/>[AuthContext.jsx]"]
  node_auth_page["Sign-in Page<br/>[Auth.jsx]"]
  node_admin_router["Admin Routing<br/>[App.jsx]"]
  node_items_admin["Item Administration<br/>[ItemsAdmin.jsx]"]
  node_labs_admin["Lab Administration<br/>[LabsAdmin.jsx]"]
  node_models_admin["Model Administration<br/>[ModelsAdmin.jsx]"]
  node_issues_admin["Issue Administration<br/>[IssuesAdmin.jsx]"]
  node_users_admin["User Administration<br/>[UsersAdmin.jsx]"]
  node_reports_admin["Reports<br/>[ReportsAdmin.jsx]"]
end

subgraph group_api["Backend API"]
  node_api_app["API Application<br/>[main.py]"]
  node_auth_router["Auth Routes<br/>[router.py]"]
  node_auth_service["Admin Auth Service<br/>[service.py]"]
  node_database[("SQL Database<br/>[db.py]")]
  node_health_router["Health Route<br/>[router.py]"]
  node_api_schemas["API Schemas<br/>[schemas.py]"]
  node_error_handlers["Error Handling<br/>[errors.py]"]
end

subgraph group_portal["Lab Portal"]
  node_portal_app["Portal Router<br/>[App.jsx]"]
  node_portal_home["Home Search<br/>[Home.jsx]"]
  node_search["Search Control<br/>[Search.jsx]"]
  node_labs_page["Labs Page<br/>[Labs.jsx]"]
  node_tickets_page["Tickets Page<br/>[Tickets.jsx]"]
  node_ticket_card["Ticket Card<br/>[Ticket.jsx]"]
  node_login_page["Login Page<br/>[Login.jsx]"]
end

node_user(("User"))

node_user -->|"uses"| node_archive_app
node_archive_app -->|"routes to"| node_home
node_archive_app -->|"routes to"| node_items
node_archive_app -->|"routes to"| node_item_detail
node_archive_app -->|"routes to"| node_map_index
node_archive_app -->|"routes to"| node_lab_map
node_archive_app -->|"routes to"| node_auth_page
node_archive_app -->|"routes to"| node_admin_router
node_admin_router -->|"routes to"| node_items_admin
node_admin_router -->|"routes to"| node_users_admin
node_admin_router -->|"routes to"| node_labs_admin
node_admin_router -->|"routes to"| node_issues_admin
node_admin_router -->|"routes to"| node_models_admin
node_items_admin -->|"loads and saves"| node_equipment_data
node_items_admin -->|"loads labs"| node_lab_data
node_items_admin -->|"uploads through"| node_supabase
node_labs_admin -->|"uses"| node_lab_data
node_auth_context -->|"authenticates with"| node_supabase
node_auth_page -->|"uses"| node_auth_context
node_api_app -->|"registers"| node_auth_router
node_api_app -->|"registers"| node_health_router
node_api_app -->|"registers"| node_error_handlers
node_auth_router -->|"calls"| node_auth_service
node_auth_service -->|"queries and updates"| node_database
node_auth_router -->|"receives sessions"| node_database
node_auth_router -->|"uses schemas"| node_api_schemas
node_health_router -->|"uses session"| node_database
node_user -->|"uses"| node_portal_app
node_portal_app -->|"routes to"| node_portal_home
node_portal_app -->|"routes to"| node_labs_page
node_portal_app -->|"routes to"| node_tickets_page
node_portal_app -->|"routes to"| node_login_page
node_portal_home -->|"renders"| node_search
node_tickets_page -->|"renders"| node_ticket_card

click node_archive_app "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/App.jsx"
click node_home "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/Home.jsx"
click node_items "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/Items.jsx"
click node_item_detail "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/ItemDetail.jsx"
click node_lab_map "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/Map3d.jsx"
click node_map_index "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/Map3dIndex.jsx"
click node_equipment_data "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/lib/supabaseItems.js"
click node_lab_data "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/lib/supabaseLabs.js"
click node_supabase "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/lib/supabase.js"
click node_auth_context "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/contexts/AuthContext.jsx"
click node_auth_page "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/Auth.jsx"
click node_admin_router "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/App.jsx"
click node_items_admin "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/admin/ItemsAdmin.jsx"
click node_labs_admin "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/admin/LabsAdmin.jsx"
click node_models_admin "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/admin/ModelsAdmin.jsx"
click node_issues_admin "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/admin/IssuesAdmin.jsx"
click node_users_admin "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/admin/UsersAdmin.jsx"
click node_reports_admin "https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/admin/ReportsAdmin.jsx"
click node_api_app "https://github.com/michaelparks03/3dlabmanager/blob/main/src/backend/app/main.py"
click node_auth_router "https://github.com/michaelparks03/3dlabmanager/blob/main/src/backend/app/features/auth/router.py"
click node_auth_service "https://github.com/michaelparks03/3dlabmanager/blob/main/src/backend/app/features/auth/service.py"
click node_database "https://github.com/michaelparks03/3dlabmanager/blob/main/src/backend/app/core/db.py"
click node_health_router "https://github.com/michaelparks03/3dlabmanager/blob/main/src/backend/app/features/health/router.py"
click node_api_schemas "https://github.com/michaelparks03/3dlabmanager/blob/main/src/backend/app/core/schemas.py"
click node_error_handlers "https://github.com/michaelparks03/3dlabmanager/blob/main/src/backend/app/core/errors.py"
click node_portal_app "https://github.com/michaelparks03/3dlabmanager/blob/main/src/frontend/src/App.jsx"
click node_portal_home "https://github.com/michaelparks03/3dlabmanager/blob/main/src/frontend/src/pages/Home.jsx"
click node_search "https://github.com/michaelparks03/3dlabmanager/blob/main/src/frontend/src/components/Search.jsx"
click node_labs_page "https://github.com/michaelparks03/3dlabmanager/blob/main/src/frontend/src/pages/Labs.jsx"
click node_tickets_page "https://github.com/michaelparks03/3dlabmanager/blob/main/src/frontend/src/pages/Tickets.jsx"
click node_ticket_card "https://github.com/michaelparks03/3dlabmanager/blob/main/src/frontend/src/components/Ticket.jsx"
click node_login_page "https://github.com/michaelparks03/3dlabmanager/blob/main/src/frontend/src/pages/Login.jsx"

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_archive_app,node_home,node_items,node_item_detail,node_lab_map,node_map_index,node_equipment_data,node_lab_data,node_supabase,node_user toneBlue
class node_auth_context,node_auth_page,node_admin_router,node_items_admin,node_labs_admin,node_models_admin,node_issues_admin,node_users_admin,node_reports_admin toneAmber
class node_api_app,node_auth_router,node_auth_service,node_database,node_health_router,node_api_schemas,node_error_handlers toneMint
class node_portal_app,node_portal_home,node_search,node_labs_page,node_tickets_page,node_ticket_card,node_login_page toneRose
```

## Components

### Lab Inventory

- [App Router](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/App.jsx): `Archive/frontend/src/App.jsx`
- [Home](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/Home.jsx): `Archive/frontend/src/pages/Home.jsx`
- [Item Catalog](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/Items.jsx): `Archive/frontend/src/pages/Items.jsx`
- [Item Details](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/ItemDetail.jsx): `Archive/frontend/src/pages/ItemDetail.jsx`
- [3D Lab Map](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/Map3d.jsx): `Archive/frontend/src/pages/Map3d.jsx`
- [Lab Map Index](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/Map3dIndex.jsx): `Archive/frontend/src/pages/Map3dIndex.jsx`
- [Equipment Data](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/lib/supabaseItems.js): `Archive/frontend/src/lib/supabaseItems.js`
- [Lab Data](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/lib/supabaseLabs.js): `Archive/frontend/src/lib/supabaseLabs.js`
- [Supabase Client](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/lib/supabase.js): `Archive/frontend/src/lib/supabase.js`

### Admin and Auth

- [Auth Context](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/contexts/AuthContext.jsx): `Archive/frontend/src/contexts/AuthContext.jsx`
- [Sign-in Page](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/Auth.jsx): `Archive/frontend/src/pages/Auth.jsx`
- [Admin Routing](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/App.jsx): `Archive/frontend/src/App.jsx`
- [Item Administration](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/admin/ItemsAdmin.jsx): `Archive/frontend/src/pages/admin/ItemsAdmin.jsx`
- [Lab Administration](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/admin/LabsAdmin.jsx): `Archive/frontend/src/pages/admin/LabsAdmin.jsx`
- [Model Administration](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/admin/ModelsAdmin.jsx): `Archive/frontend/src/pages/admin/ModelsAdmin.jsx`
- [Issue Administration](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/admin/IssuesAdmin.jsx): `Archive/frontend/src/pages/admin/IssuesAdmin.jsx`
- [User Administration](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/admin/UsersAdmin.jsx): `Archive/frontend/src/pages/admin/UsersAdmin.jsx`
- [Reports](https://github.com/michaelparks03/3dlabmanager/blob/main/Archive/frontend/src/pages/admin/ReportsAdmin.jsx): `Archive/frontend/src/pages/admin/ReportsAdmin.jsx`

### Backend API

- [API Application](https://github.com/michaelparks03/3dlabmanager/blob/main/src/backend/app/main.py): `src/backend/app/main.py`
- [Auth Routes](https://github.com/michaelparks03/3dlabmanager/blob/main/src/backend/app/features/auth/router.py): `src/backend/app/features/auth/router.py`
- [Admin Auth Service](https://github.com/michaelparks03/3dlabmanager/blob/main/src/backend/app/features/auth/service.py): `src/backend/app/features/auth/service.py`
- [SQL Database](https://github.com/michaelparks03/3dlabmanager/blob/main/src/backend/app/core/db.py): `src/backend/app/core/db.py`
- [Health Route](https://github.com/michaelparks03/3dlabmanager/blob/main/src/backend/app/features/health/router.py): `src/backend/app/features/health/router.py`
- [API Schemas](https://github.com/michaelparks03/3dlabmanager/blob/main/src/backend/app/core/schemas.py): `src/backend/app/core/schemas.py`
- [Error Handling](https://github.com/michaelparks03/3dlabmanager/blob/main/src/backend/app/core/errors.py): `src/backend/app/core/errors.py`

### Lab Portal

- [Portal Router](https://github.com/michaelparks03/3dlabmanager/blob/main/src/frontend/src/App.jsx): `src/frontend/src/App.jsx`
- [Home Search](https://github.com/michaelparks03/3dlabmanager/blob/main/src/frontend/src/pages/Home.jsx): `src/frontend/src/pages/Home.jsx`
- [Search Control](https://github.com/michaelparks03/3dlabmanager/blob/main/src/frontend/src/components/Search.jsx): `src/frontend/src/components/Search.jsx`
- [Labs Page](https://github.com/michaelparks03/3dlabmanager/blob/main/src/frontend/src/pages/Labs.jsx): `src/frontend/src/pages/Labs.jsx`
- [Tickets Page](https://github.com/michaelparks03/3dlabmanager/blob/main/src/frontend/src/pages/Tickets.jsx): `src/frontend/src/pages/Tickets.jsx`
- [Ticket Card](https://github.com/michaelparks03/3dlabmanager/blob/main/src/frontend/src/components/Ticket.jsx): `src/frontend/src/components/Ticket.jsx`
- [Login Page](https://github.com/michaelparks03/3dlabmanager/blob/main/src/frontend/src/pages/Login.jsx): `src/frontend/src/pages/Login.jsx`

### Other components

- **User**

## Connections

- User → App Router: uses (evidence: `Archive/frontend/src/App.jsx`)
- App Router → Home: routes to (evidence: `Archive/frontend/src/App.jsx`)
- App Router → Item Catalog: routes to (evidence: `Archive/frontend/src/App.jsx`)
- App Router → Item Details: routes to (evidence: `Archive/frontend/src/App.jsx`)
- App Router → Lab Map Index: routes to (evidence: `Archive/frontend/src/App.jsx`)
- App Router → 3D Lab Map: routes to (evidence: `Archive/frontend/src/App.jsx`)
- App Router → Sign-in Page: routes to (evidence: `Archive/frontend/src/App.jsx`)
- App Router → Admin Routing: routes to (evidence: `Archive/frontend/src/App.jsx`)
- Admin Routing → Item Administration: routes to (evidence: `Archive/frontend/src/App.jsx`)
- Admin Routing → User Administration: routes to (evidence: `Archive/frontend/src/App.jsx`)
- Admin Routing → Lab Administration: routes to (evidence: `Archive/frontend/src/App.jsx`)
- Admin Routing → Issue Administration: routes to (evidence: `Archive/frontend/src/App.jsx`)
- Admin Routing → Model Administration: routes to (evidence: `Archive/frontend/src/App.jsx`)
- Item Administration → Equipment Data: loads and saves (evidence: `Archive/frontend/src/pages/admin/ItemsAdmin.jsx`)
- Item Administration → Lab Data: loads labs (evidence: `Archive/frontend/src/pages/admin/ItemsAdmin.jsx`)
- Item Administration → Supabase Client: uploads through
- Lab Administration → Lab Data: uses (evidence: `Archive/frontend/src/pages/admin/LabsAdmin.jsx`)
- Auth Context → Supabase Client: authenticates with (evidence: `Archive/frontend/src/contexts/AuthContext.jsx`)
- Sign-in Page → Auth Context: uses (evidence: `Archive/frontend/src/pages/Auth.jsx`)
- API Application → Auth Routes: registers (evidence: `src/backend/app/main.py`)
- API Application → Health Route: registers (evidence: `src/backend/app/main.py`)
- API Application → Error Handling: registers (evidence: `src/backend/app/main.py`)
- Auth Routes → Admin Auth Service: calls (evidence: `src/backend/app/features/auth/router.py`)
- Admin Auth Service → SQL Database: queries and updates (evidence: `src/backend/app/features/auth/service.py`)
- Auth Routes → SQL Database: receives sessions (evidence: `src/backend/app/features/auth/router.py`)
- Auth Routes → API Schemas: uses schemas (evidence: `src/backend/app/features/auth/router.py`)
- Health Route → SQL Database: uses session (evidence: `src/backend/app/features/health/router.py`)
- User → Portal Router: uses (evidence: `src/frontend/src/App.jsx`)
- Portal Router → Home Search: routes to (evidence: `src/frontend/src/App.jsx`)
- Portal Router → Labs Page: routes to (evidence: `src/frontend/src/App.jsx`)
- Portal Router → Tickets Page: routes to (evidence: `src/frontend/src/App.jsx`)
- Portal Router → Login Page: routes to (evidence: `src/frontend/src/App.jsx`)
- Home Search → Search Control: renders (evidence: `src/frontend/src/pages/Home.jsx`)
- Tickets Page → Ticket Card: renders (evidence: `src/frontend/src/pages/Tickets.jsx`)
