# akashcp111/take-the-key-lead architecture

> Architecture diagram of the GitHub repository akashcp111/take-the-key-lead, 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/akashcp111/take-the-key-lead
- Repository: https://github.com/akashcp111/take-the-key-lead

## Overview

KEYGUARD is an offline browser-based room-key register. Staff use its dashboard and routed views to register keys, issue them with due times, record returns, and review inventory, active issues, due-soon/overdue reports, search results, and history. The application component presents these views and uses the keyguard service, which validates records and persists the register in browser storage. The README documents local-device persistence and demo-data reset. Server-side error handling is a separate supporting layer; several route and service details are based on excerpts and documentation rather than complete source inspection.

Main entry points: [`src/components/keyguard-app.tsx`](https://github.com/akashcp111/take-the-key-lead/blob/main/src/components/keyguard-app.tsx) (Register interface), [`src/components/ui/sidebar.tsx`](https://github.com/akashcp111/take-the-key-lead/blob/main/src/components/ui/sidebar.tsx) (Sidebar primitive), [`src/server.ts`](https://github.com/akashcp111/take-the-key-lead/blob/main/src/server.ts) (Request handler), [`src/routes`](https://github.com/akashcp111/take-the-key-lead/tree/main/src/routes) (Route views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["App routing"]
  node_routes["Route views"]
  node_route_tree["Route tree<br/>[routeTree.gen.ts]"]
  node_router["Router setup<br/>[router.tsx]"]
  node_route_meta["Route metadata<br/>[route-meta.ts]"]
end

subgraph group_workflows["Register workflows"]
  node_app["Register interface<br/>[keyguard-app.tsx]"]
  node_dashboard["Dashboard<br/>[index.tsx]"]
  node_inventory["Key inventory<br/>[keys.tsx]"]
  node_registration["Key registration<br/>[keys.register.tsx]"]
  node_issue["Issue keys<br/>[issue.tsx]"]
  node_issued["Issued keys<br/>[issued.tsx]"]
  node_return["Key returns<br/>[return.tsx]"]
  node_due_soon["Due soon<br/>[due-soon.tsx]"]
  node_overdue["Overdue report<br/>[overdue.tsx]"]
  node_search["Register search<br/>[search.tsx]"]
  node_history["Activity history<br/>[history.tsx]"]
  node_ui_button["Button primitive<br/>[button.tsx]"]
  node_ui_input["Input primitive<br/>[input.tsx]"]
  node_ui_separator["Separator primitive<br/>[separator.tsx]"]
  node_ui_sheet["Sheet primitive<br/>[sheet.tsx]"]
  node_ui_sidebar["Sidebar primitive<br/>[sidebar.tsx]"]
  node_ui_tooltip["Tooltip primitive<br/>[tooltip.tsx]"]
  node_mobile["Mobile detection<br/>[use-mobile.tsx]"]
end

subgraph group_state["Register state"]
  node_service["Keyguard service"]
  node_browser_store[("Browser storage")]
  node_domain_errors["Domain errors<br/>[keyguard-errors.ts]"]
end

subgraph group_support["Runtime support"]
  node_error_capture["Error capture<br/>[error-capture.ts]"]
  node_error_page["Error page<br/>[error-page.ts]"]
  node_server["Request handler<br/>[server.ts]"]
  node_start["App start<br/>[start.ts]"]
  node_reporting["Error reporting"]
end

node_staff(("Office staff"))

node_staff -->|"opens views"| node_routes
node_routes -->|"registered in"| node_route_tree
node_router -->|"loads routes"| node_route_tree
node_dashboard -->|"renders"| node_app
node_inventory -->|"renders"| node_app
node_registration -->|"renders"| node_app
node_issue -->|"renders"| node_app
node_issued -->|"renders"| node_app
node_return -->|"renders"| node_app
node_due_soon -->|"renders"| node_app
node_overdue -->|"renders"| node_app
node_search -->|"renders"| node_app
node_history -->|"renders"| node_app
node_app -->|"reads register"| node_service
node_service -->|"loads and saves"| node_browser_store
node_service -->|"throws errors"| node_domain_errors
node_app -->|"renders controls"| node_ui_button
node_ui_sidebar -->|"checks viewport"| node_mobile
node_ui_sidebar -->|"renders mobile panel"| node_ui_sheet
node_ui_sidebar -->|"renders tooltips"| node_ui_tooltip
node_server -->|"consumes captured error"| node_error_capture
node_server -->|"renders fallback"| node_error_page
node_start -->|"uses fallback"| node_error_page
node_routes -->|"sets page metadata"| node_route_meta
node_app -.->|"uses inputs"| node_ui_input
node_app -.->|"uses separators"| node_ui_separator
node_server -.->|"reports errors"| node_reporting

click node_routes "https://github.com/akashcp111/take-the-key-lead/tree/main/src/routes"
click node_route_tree "https://github.com/akashcp111/take-the-key-lead/blob/main/src/routeTree.gen.ts"
click node_router "https://github.com/akashcp111/take-the-key-lead/blob/main/src/router.tsx"
click node_app "https://github.com/akashcp111/take-the-key-lead/blob/main/src/components/keyguard-app.tsx"
click node_dashboard "https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/index.tsx"
click node_inventory "https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/keys.tsx"
click node_registration "https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/keys.register.tsx"
click node_issue "https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/issue.tsx"
click node_issued "https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/issued.tsx"
click node_return "https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/return.tsx"
click node_due_soon "https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/due-soon.tsx"
click node_overdue "https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/overdue.tsx"
click node_search "https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/search.tsx"
click node_history "https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/history.tsx"
click node_service "https://github.com/akashcp111/take-the-key-lead/blob/main/src/lib/keyguard-service.ts"
click node_domain_errors "https://github.com/akashcp111/take-the-key-lead/blob/main/src/lib/keyguard-errors.ts"
click node_ui_button "https://github.com/akashcp111/take-the-key-lead/blob/main/src/components/ui/button.tsx"
click node_ui_input "https://github.com/akashcp111/take-the-key-lead/blob/main/src/components/ui/input.tsx"
click node_ui_separator "https://github.com/akashcp111/take-the-key-lead/blob/main/src/components/ui/separator.tsx"
click node_ui_sheet "https://github.com/akashcp111/take-the-key-lead/blob/main/src/components/ui/sheet.tsx"
click node_ui_sidebar "https://github.com/akashcp111/take-the-key-lead/blob/main/src/components/ui/sidebar.tsx"
click node_ui_tooltip "https://github.com/akashcp111/take-the-key-lead/blob/main/src/components/ui/tooltip.tsx"
click node_mobile "https://github.com/akashcp111/take-the-key-lead/blob/main/src/hooks/use-mobile.tsx"
click node_error_capture "https://github.com/akashcp111/take-the-key-lead/blob/main/src/lib/error-capture.ts"
click node_error_page "https://github.com/akashcp111/take-the-key-lead/blob/main/src/lib/error-page.ts"
click node_server "https://github.com/akashcp111/take-the-key-lead/blob/main/src/server.ts"
click node_start "https://github.com/akashcp111/take-the-key-lead/blob/main/src/start.ts"
click node_reporting "https://github.com/akashcp111/take-the-key-lead/blob/main/src/lib/lovable-error-reporting.ts"
click node_route_meta "https://github.com/akashcp111/take-the-key-lead/blob/main/src/lib/route-meta.ts"

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_routes,node_route_tree,node_router,node_route_meta toneBlue
class node_app,node_dashboard,node_inventory,node_registration,node_issue,node_issued,node_return,node_due_soon,node_overdue,node_search,node_history,node_ui_button,node_ui_input,node_ui_separator,node_ui_sheet,node_ui_sidebar,node_ui_tooltip,node_mobile toneAmber
class node_service,node_browser_store,node_domain_errors toneMint
class node_error_capture,node_error_page,node_server,node_start,node_reporting toneRose
class node_staff toneIndigo
```

## Components

### App routing

- [Route views](https://github.com/akashcp111/take-the-key-lead/tree/main/src/routes): `src/routes`
- [Route tree](https://github.com/akashcp111/take-the-key-lead/blob/main/src/routeTree.gen.ts): `src/routeTree.gen.ts`
- [Router setup](https://github.com/akashcp111/take-the-key-lead/blob/main/src/router.tsx): `src/router.tsx`
- [Route metadata](https://github.com/akashcp111/take-the-key-lead/blob/main/src/lib/route-meta.ts): `src/lib/route-meta.ts`

### Register workflows

- [Register interface](https://github.com/akashcp111/take-the-key-lead/blob/main/src/components/keyguard-app.tsx): `src/components/keyguard-app.tsx`
- [Dashboard](https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [Key inventory](https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/keys.tsx): `src/routes/keys.tsx`
- [Key registration](https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/keys.register.tsx): `src/routes/keys.register.tsx`
- [Issue keys](https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/issue.tsx): `src/routes/issue.tsx`
- [Issued keys](https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/issued.tsx): `src/routes/issued.tsx`
- [Key returns](https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/return.tsx): `src/routes/return.tsx`
- [Due soon](https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/due-soon.tsx): `src/routes/due-soon.tsx`
- [Overdue report](https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/overdue.tsx): `src/routes/overdue.tsx`
- [Register search](https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/search.tsx): `src/routes/search.tsx`
- [Activity history](https://github.com/akashcp111/take-the-key-lead/blob/main/src/routes/history.tsx): `src/routes/history.tsx`
- [Button primitive](https://github.com/akashcp111/take-the-key-lead/blob/main/src/components/ui/button.tsx): `src/components/ui/button.tsx`
- [Input primitive](https://github.com/akashcp111/take-the-key-lead/blob/main/src/components/ui/input.tsx): `src/components/ui/input.tsx`
- [Separator primitive](https://github.com/akashcp111/take-the-key-lead/blob/main/src/components/ui/separator.tsx): `src/components/ui/separator.tsx`
- [Sheet primitive](https://github.com/akashcp111/take-the-key-lead/blob/main/src/components/ui/sheet.tsx): `src/components/ui/sheet.tsx`
- [Sidebar primitive](https://github.com/akashcp111/take-the-key-lead/blob/main/src/components/ui/sidebar.tsx): `src/components/ui/sidebar.tsx`
- [Tooltip primitive](https://github.com/akashcp111/take-the-key-lead/blob/main/src/components/ui/tooltip.tsx): `src/components/ui/tooltip.tsx`
- [Mobile detection](https://github.com/akashcp111/take-the-key-lead/blob/main/src/hooks/use-mobile.tsx): `src/hooks/use-mobile.tsx`

### Register state

- [Keyguard service](https://github.com/akashcp111/take-the-key-lead/blob/main/src/lib/keyguard-service.ts): `src/lib/keyguard-service.ts`
- **Browser storage**
- [Domain errors](https://github.com/akashcp111/take-the-key-lead/blob/main/src/lib/keyguard-errors.ts): `src/lib/keyguard-errors.ts`

### Runtime support

- [Error capture](https://github.com/akashcp111/take-the-key-lead/blob/main/src/lib/error-capture.ts): `src/lib/error-capture.ts`
- [Error page](https://github.com/akashcp111/take-the-key-lead/blob/main/src/lib/error-page.ts): `src/lib/error-page.ts`
- [Request handler](https://github.com/akashcp111/take-the-key-lead/blob/main/src/server.ts): `src/server.ts`
- [App start](https://github.com/akashcp111/take-the-key-lead/blob/main/src/start.ts): `src/start.ts`
- [Error reporting](https://github.com/akashcp111/take-the-key-lead/blob/main/src/lib/lovable-error-reporting.ts): `src/lib/lovable-error-reporting.ts`

### Other components

- **Office staff**

## Connections

- Office staff → Route views: opens views
- Route views → Route tree: registered in (evidence: `src/routeTree.gen.ts`)
- Router setup → Route tree: loads routes (evidence: `src/router.tsx`)
- Dashboard → Register interface: renders (evidence: `src/routes/index.tsx`)
- Key inventory → Register interface: renders (evidence: `src/routes/keys.tsx`)
- Key registration → Register interface: renders (evidence: `src/routes/keys.register.tsx`)
- Issue keys → Register interface: renders (evidence: `src/routes/issue.tsx`)
- Issued keys → Register interface: renders (evidence: `src/routes/issued.tsx`)
- Key returns → Register interface: renders (evidence: `src/routes/return.tsx`)
- Due soon → Register interface: renders (evidence: `src/routes/due-soon.tsx`)
- Overdue report → Register interface: renders (evidence: `src/routes/overdue.tsx`)
- Register search → Register interface: renders (evidence: `src/routes/search.tsx`)
- Activity history → Register interface: renders (evidence: `src/routes/history.tsx`)
- Register interface → Keyguard service: reads register (evidence: `src/components/keyguard-app.tsx`)
- Keyguard service → Browser storage: loads and saves
- Keyguard service → Domain errors: throws errors (evidence: `src/lib/keyguard-service.ts`)
- Register interface → Button primitive: renders controls (evidence: `src/components/keyguard-app.tsx`)
- Sidebar primitive → Mobile detection: checks viewport (evidence: `src/components/ui/sidebar.tsx`)
- Sidebar primitive → Sheet primitive: renders mobile panel (evidence: `src/components/ui/sidebar.tsx`)
- Sidebar primitive → Tooltip primitive: renders tooltips (evidence: `src/components/ui/sidebar.tsx`)
- Request handler → Error capture: consumes captured error (evidence: `src/server.ts`)
- Request handler → Error page: renders fallback (evidence: `src/server.ts`)
- App start → Error page: uses fallback (evidence: `src/start.ts`)
- Route views → Route metadata: sets page metadata (evidence: `src/routes/search.tsx`)
- Register interface → Input primitive: uses inputs
- Register interface → Separator primitive: uses separators
- Request handler → Error reporting: reports errors
