How el-hash97/tools-locator works
Tool Locator is a browser-based tool inventory and locating app. Workers search and filter tools, inspect their stored location and floor plan, then scan a QR label to reach the return flow. Admins sign in to manage tools, categories, locations, floor-plan zones, and printable QR labels. Data currently flows through a repository abstraction to browser localStorage; the source excerpts do not establish a remote backend or the detailed operations of every unsampled page.
Main entry points: DataProvider.tsx Data Context · App.tsx Route App · Home.tsx Tool Search · Return.tsx Return Flow
Components 28
Find Tools
- Tool Search
src/pages/Home.tsx - Tool Results
src/components/ToolCard.tsx - Floor Plan
src/components/Denah.tsx - Tool Details
src/pages/ToolDetail.tsx - Name Matching
src/lib/fuzzy.ts - Location Formatting
src/lib/format.ts
QR Return
- QR Scan
src/pages/Scan.tsx - QR Parsing
src/lib/qr.ts - Return Flow
src/pages/Return.tsx
Admin Management
- Admin Login
src/pages/admin/Login.tsx - Admin Navigation
src/pages/admin/AdminLayout.tsx - Tool Management
src/pages/admin/Tools.tsx - Category Management
src/pages/admin/Categories.tsx - Location Management
src/pages/admin/Locations.tsx - Zone Management
src/pages/admin/Zones.tsx - QR Labels
src/pages/admin/Labels.tsx - Photo Input
src/components/PhotoInput.tsx
Data and Access
- Route App
src/App.tsx - Session Auth
src/auth/AuthProvider.tsx - Route Guard
src/auth/RequireAuth.tsx - Data Context
src/data/DataProvider.tsx - Repository Contract
src/data/repository.ts - Local Repository
src/data/mockRepository.ts - Browser Storage
src/data/mockRepository.ts - Seed Records
src/data/seed.ts - Domain Types
src/data/types.ts
Other components
- Worker
- Administrator
Connections 43
- Worker → Route App: opens
src/App.tsx - Administrator → Route App: opens
src/App.tsx - Route App → Tool Search: routes to
src/App.tsx - Route App → Tool Details: routes to
src/App.tsx - Route App → QR Scan: routes to
src/App.tsx - Route App → Return Flow: routes to
src/App.tsx - Route App → Admin Login: routes to
src/App.tsx - Route App → Route Guard: protects routes
src/App.tsx - Route Guard → Session Auth: checks session
src/auth/RequireAuth.tsx - Admin Login → Session Auth: signs in
src/pages/admin/Login.tsx - Route App → Data Context: provides data
src/App.tsx - Tool Search → Data Context: reads inventory
src/pages/Home.tsx - Tool Search → Name Matching: matches names
src/pages/Home.tsx - Tool Search → Tool Results: renders results
src/pages/Home.tsx - Tool Search → Floor Plan: renders plan
src/pages/Home.tsx - Tool Search → Location Formatting: formats locations
src/pages/Home.tsx - Tool Details → Data Context: reads tool data
src/pages/ToolDetail.tsx - QR Scan → QR Parsing: parses scans
src/pages/Scan.tsx - QR Scan → Return Flow: navigates to
- Return Flow → Data Context: reads and updates
src/pages/Return.tsx - Return Flow → Floor Plan: renders location
src/pages/Return.tsx - Return Flow → Location Formatting: formats locations
src/pages/Return.tsx - Admin Navigation → Session Auth: signs out
src/pages/admin/AdminLayout.tsx - Tool Management → Data Context: manages tools
src/pages/admin/Tools.tsx - Tool Management → Photo Input: collects photos
src/pages/admin/Tools.tsx - Category Management → Data Context: manages categories
src/pages/admin/Categories.tsx - Location Management → Data Context: manages locations
src/pages/admin/Locations.tsx - Location Management → Floor Plan: uses floor plan
src/pages/admin/Locations.tsx - Zone Management → Data Context: manages zones
src/pages/admin/Zones.tsx - Zone Management → Floor Plan: uses floor plan
src/pages/admin/Zones.tsx - QR Labels → Data Context: reads tool data
src/pages/admin/Labels.tsx - Data Context → Repository Contract: implements contract
src/data/DataProvider.tsx - Data Context → Local Repository: selects repository
src/data/DataProvider.tsx - Local Repository → Browser Storage: reads and writes
src/data/mockRepository.ts - Local Repository → Seed Records: initializes from
src/data/mockRepository.ts - Local Repository → Domain Types: uses domain types
src/data/mockRepository.ts - Repository Contract → Domain Types: defines data shapes
src/data/repository.ts - Session Auth → Seed Records: checks credentials
src/auth/AuthProvider.tsx - Session Auth → Domain Types: uses session type
src/auth/AuthProvider.tsx - Floor Plan → Domain Types: renders zones
src/components/Denah.tsx - Location Formatting → Domain Types: formats location type
src/lib/format.ts - QR Labels → QR Parsing: builds label URLs
src/pages/admin/Labels.tsx - Tool Management → QR Parsing: previews QR
src/pages/admin/Tools.tsx