How akashcp111/take-the-key-lead works
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: keyguard-app.tsx Register interface · sidebar.tsx Sidebar primitive · server.ts Request handler · routes Route views
Components 31
App routing
- Route views
src/routes - Route tree
src/routeTree.gen.ts - Router setup
src/router.tsx - Route metadata
src/lib/route-meta.ts
Register workflows
- Register interface
src/components/keyguard-app.tsx - Dashboard
src/routes/index.tsx - Key inventory
src/routes/keys.tsx - Key registration
src/routes/keys.register.tsx - Issue keys
src/routes/issue.tsx - Issued keys
src/routes/issued.tsx - Key returns
src/routes/return.tsx - Due soon
src/routes/due-soon.tsx - Overdue report
src/routes/overdue.tsx - Register search
src/routes/search.tsx - Activity history
src/routes/history.tsx - Button primitive
src/components/ui/button.tsx - Input primitive
src/components/ui/input.tsx - Separator primitive
src/components/ui/separator.tsx - Sheet primitive
src/components/ui/sheet.tsx - Sidebar primitive
src/components/ui/sidebar.tsx - Tooltip primitive
src/components/ui/tooltip.tsx - Mobile detection
src/hooks/use-mobile.tsx
Register state
- Keyguard service
src/lib/keyguard-service.ts - Browser storage
- Domain errors
src/lib/keyguard-errors.ts
Runtime support
- Error capture
src/lib/error-capture.ts - Error page
src/lib/error-page.ts - Request handler
src/server.ts - App start
src/start.ts - Error reporting
src/lib/lovable-error-reporting.ts
Other components
- Office staff
Connections 27
- Office staff → Route views: opens views
- Route views → Route tree: registered in
src/routeTree.gen.ts - Router setup → Route tree: loads routes
src/router.tsx - Dashboard → Register interface: renders
src/routes/index.tsx - Key inventory → Register interface: renders
src/routes/keys.tsx - Key registration → Register interface: renders
src/routes/keys.register.tsx - Issue keys → Register interface: renders
src/routes/issue.tsx - Issued keys → Register interface: renders
src/routes/issued.tsx - Key returns → Register interface: renders
src/routes/return.tsx - Due soon → Register interface: renders
src/routes/due-soon.tsx - Overdue report → Register interface: renders
src/routes/overdue.tsx - Register search → Register interface: renders
src/routes/search.tsx - Activity history → Register interface: renders
src/routes/history.tsx - Register interface → Keyguard service: reads register
src/components/keyguard-app.tsx - Keyguard service → Browser storage: loads and saves
- Keyguard service → Domain errors: throws errors
src/lib/keyguard-service.ts - Register interface → Button primitive: renders controls
src/components/keyguard-app.tsx - Sidebar primitive → Mobile detection: checks viewport
src/components/ui/sidebar.tsx - Sidebar primitive → Sheet primitive: renders mobile panel
src/components/ui/sidebar.tsx - Sidebar primitive → Tooltip primitive: renders tooltips
src/components/ui/sidebar.tsx - Request handler → Error capture: consumes captured error
src/server.ts - Request handler → Error page: renders fallback
src/server.ts - App start → Error page: uses fallback
src/start.ts - Route views → Route metadata: sets page metadata
src/routes/search.tsx - Register interface → Input primitive: uses inputs
- Register interface → Separator primitive: uses separators
- Request handler → Error reporting: reports errors