# tsaeeeee/metrotech-interportal architecture

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

- Interactive diagram: https://gitdiagram.com/tsaeeeee/metrotech-interportal
- Repository: https://github.com/tsaeeeee/metrotech-interportal

## Overview

Metrotech Interportal is a local DCIM rack-builder: users create accounts, manage datacenters, then map rooms, racks, devices, ports, and cable connections. Authentication and datacenter records use SQLite, while rack inventory and connectivity use a local JSON database. The protected datacenter view coordinates inventory editing and rack placement; dedicated components render device faceplates and cabling. Edges reflect shown calls, imports, or README-documented storage behavior; unsampled implementation details are not inferred.

Main entry points: [`src/routes/_protected/dc/$dcId.tsx`](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/routes/_protected/dc/%24dcId.tsx) (Datacenter workspace), [`src/features/database/database-service.ts`](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/database/database-service.ts) (Inventory service), [`src/features/auth/auth-service.ts`](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/auth/auth-service.ts) (Auth service), [`src/features/editor/components/asset-form.tsx`](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/editor/components/asset-form.tsx) (Asset editor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access &amp; Routing"]
  node_route_tree["Route registry<br/>[routeTree.gen.ts]"]
  node_login["Login<br/>[login.tsx]"]
  node_signup["Signup<br/>[signup.tsx]"]
  node_auth["Auth service<br/>[auth-service.ts]"]
  node_sqlite[("SQLite store<br/>[sqlite.ts]")]
end

subgraph group_places["Datacenter Management"]
  node_dashboard["Datacenter dashboard<br/>[index.tsx]"]
  node_dc_service["Datacenter service"]
  node_dc_sqlite[("Datacenter records<br/>[sqlite.ts]")]
end

subgraph group_inventory["Inventory &amp; Layout"]
  node_dc_view["Datacenter workspace<br/>[$dcId.tsx]"]
  node_inventory_service["Inventory service"]
  node_json_store[("Inventory JSON")]
  node_asset_form["Asset editor<br/>[asset-form.tsx]"]
  node_asset_palette["Asset palette<br/>[asset-palette.tsx]"]
  node_navigator["Infrastructure navigator"]
  node_rack_grid["Rack layout<br/>[rack-u-grid.tsx]"]
  node_rack_device["Rack device<br/>[rack-device.tsx]"]
  node_faceplate["Device faceplate"]
end

subgraph group_connectivity["Ports &amp; Cabling"]
  node_cable_overlay["Cable overlay<br/>[cable-overlay.tsx]"]
  node_port_faceplate["Port faceplate<br/>[port-faceplate.tsx]"]
end

node_user(("Operator"))

node_user -->|"signs in"| node_login
node_user -->|"creates account"| node_signup
node_login -->|"authenticates"| node_auth
node_signup -->|"registers"| node_auth
node_auth -->|"reads/writes"| node_sqlite
node_user -->|"manages datacenters"| node_dashboard
node_dashboard -->|"loads datacenters"| node_dc_service
node_dc_service -->|"checks session"| node_auth
node_dc_service -->|"reads/writes"| node_dc_sqlite
node_user -->|"maps infrastructure"| node_dc_view
node_dc_view -->|"loads datacenter"| node_dc_service
node_dc_view -->|"requests inventory"| node_inventory_service
node_inventory_service -->|"requires session"| node_auth
node_inventory_service -->|"reads/writes"| node_json_store
node_dc_view -->|"opens editor"| node_asset_form
node_asset_form -->|"saves assets"| node_inventory_service
node_dc_view -->|"shows library"| node_asset_palette
node_dc_view -->|"shows hierarchy"| node_navigator
node_dc_view -->|"renders rack"| node_rack_grid
node_rack_grid -->|"renders devices"| node_rack_device
node_rack_device -->|"renders faceplate"| node_faceplate
node_rack_grid -->|"renders cabling"| node_cable_overlay
node_asset_form -->|"renders ports"| node_port_faceplate
node_asset_form -->|"connects ports"| node_inventory_service
node_route_tree -->|"registers route"| node_login
node_route_tree -->|"registers route"| node_signup

click node_route_tree "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/routeTree.gen.ts"
click node_login "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/routes/login.tsx"
click node_signup "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/routes/signup.tsx"
click node_auth "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/auth/auth-service.ts"
click node_sqlite "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/auth/sqlite.ts"
click node_dashboard "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/routes/_protected/index.tsx"
click node_dc_service "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/datacenters/datacenter-service.ts"
click node_dc_sqlite "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/auth/sqlite.ts"
click node_dc_view "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/routes/_protected/dc/%24dcId.tsx"
click node_inventory_service "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/database/database-service.ts"
click node_json_store "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/database/database-service.ts"
click node_asset_form "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/editor/components/asset-form.tsx"
click node_asset_palette "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/editor/components/asset-palette.tsx"
click node_navigator "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/navigation/components/infrastructure-navigator.tsx"
click node_rack_grid "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/racks/components/rack-u-grid.tsx"
click node_rack_device "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/racks/components/rack-device.tsx"
click node_faceplate "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/racks/components/device-faceplate.tsx"
click node_cable_overlay "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/connectivity/components/cable-overlay.tsx"
click node_port_faceplate "https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/connectivity/components/port-faceplate.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_route_tree,node_login,node_signup,node_auth,node_sqlite toneBlue
class node_dashboard,node_dc_service,node_dc_sqlite toneAmber
class node_dc_view,node_inventory_service,node_json_store,node_asset_form,node_asset_palette,node_navigator,node_rack_grid,node_rack_device,node_faceplate toneMint
class node_cable_overlay,node_port_faceplate toneRose
class node_user toneIndigo
```

## Components

### Access & Routing

- [Route registry](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/routeTree.gen.ts): `src/routeTree.gen.ts`
- [Login](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/routes/login.tsx): `src/routes/login.tsx`
- [Signup](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/routes/signup.tsx): `src/routes/signup.tsx`
- [Auth service](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/auth/auth-service.ts): `src/features/auth/auth-service.ts`
- [SQLite store](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/auth/sqlite.ts): `src/features/auth/sqlite.ts`

### Datacenter Management

- [Datacenter dashboard](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/routes/_protected/index.tsx): `src/routes/_protected/index.tsx`
- [Datacenter service](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/datacenters/datacenter-service.ts): `src/features/datacenters/datacenter-service.ts`
- [Datacenter records](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/auth/sqlite.ts): `src/features/auth/sqlite.ts`

### Inventory & Layout

- [Datacenter workspace](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/routes/_protected/dc/%24dcId.tsx): `src/routes/_protected/dc/$dcId.tsx`
- [Inventory service](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/database/database-service.ts): `src/features/database/database-service.ts`
- [Inventory JSON](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/database/database-service.ts): `src/features/database/database-service.ts`
- [Asset editor](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/editor/components/asset-form.tsx): `src/features/editor/components/asset-form.tsx`
- [Asset palette](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/editor/components/asset-palette.tsx): `src/features/editor/components/asset-palette.tsx`
- [Infrastructure navigator](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/navigation/components/infrastructure-navigator.tsx): `src/features/navigation/components/infrastructure-navigator.tsx`
- [Rack layout](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/racks/components/rack-u-grid.tsx): `src/features/racks/components/rack-u-grid.tsx`
- [Rack device](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/racks/components/rack-device.tsx): `src/features/racks/components/rack-device.tsx`
- [Device faceplate](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/racks/components/device-faceplate.tsx): `src/features/racks/components/device-faceplate.tsx`

### Ports & Cabling

- [Cable overlay](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/connectivity/components/cable-overlay.tsx): `src/features/connectivity/components/cable-overlay.tsx`
- [Port faceplate](https://github.com/tsaeeeee/metrotech-interportal/blob/main/src/features/connectivity/components/port-faceplate.tsx): `src/features/connectivity/components/port-faceplate.tsx`

### Other components

- **Operator**

## Connections

- Operator → Login: signs in
- Operator → Signup: creates account
- Login → Auth service: authenticates (evidence: `src/routes/login.tsx`)
- Signup → Auth service: registers (evidence: `src/routes/signup.tsx`)
- Auth service → SQLite store: reads/writes (evidence: `src/features/auth/auth-service.ts`)
- Operator → Datacenter dashboard: manages datacenters (evidence: `README.md`)
- Datacenter dashboard → Datacenter service: loads datacenters (evidence: `src/routes/_protected/index.tsx`)
- Datacenter service → Auth service: checks session (evidence: `src/features/datacenters/datacenter-service.ts`)
- Datacenter service → Datacenter records: reads/writes (evidence: `src/features/datacenters/datacenter-service.ts`)
- Operator → Datacenter workspace: maps infrastructure (evidence: `README.md`)
- Datacenter workspace → Datacenter service: loads datacenter (evidence: `src/routes/_protected/dc/$dcId.tsx`)
- Datacenter workspace → Inventory service: requests inventory (evidence: `src/routes/_protected/dc/$dcId.tsx`)
- Inventory service → Auth service: requires session (evidence: `src/features/database/database-service.ts`)
- Inventory service → Inventory JSON: reads/writes (evidence: `README.md`)
- Datacenter workspace → Asset editor: opens editor (evidence: `src/routes/_protected/dc/$dcId.tsx`)
- Asset editor → Inventory service: saves assets (evidence: `src/features/editor/components/asset-form.tsx`)
- Datacenter workspace → Asset palette: shows library (evidence: `src/routes/_protected/dc/$dcId.tsx`)
- Datacenter workspace → Infrastructure navigator: shows hierarchy (evidence: `src/routes/_protected/dc/$dcId.tsx`)
- Datacenter workspace → Rack layout: renders rack (evidence: `src/routes/_protected/dc/$dcId.tsx`)
- Rack layout → Rack device: renders devices (evidence: `src/features/racks/components/rack-u-grid.tsx`)
- Rack device → Device faceplate: renders faceplate (evidence: `src/features/racks/components/rack-device.tsx`)
- Rack layout → Cable overlay: renders cabling (evidence: `src/features/racks/components/rack-u-grid.tsx`)
- Asset editor → Port faceplate: renders ports (evidence: `src/features/editor/components/asset-form.tsx`)
- Asset editor → Inventory service: connects ports (evidence: `src/features/editor/components/asset-form.tsx`)
- Route registry → Login: registers route (evidence: `src/routeTree.gen.ts`)
- Route registry → Signup: registers route (evidence: `src/routeTree.gen.ts`)
