How riemarseruelas/3dmap works
Company Street View is an internal, role-based plant navigation and configuration application. Employees sign in, choose a site and area, then navigate linked 360° panoramas; administrators configure locations, maps, Tour/Safety information, and image assets. The backend keeps live map configuration and tracking records in PostgreSQL and image files under public/uploads, with optional multiresolution optimization and manual unused-file cleanup. Edges follow shown frontend routing/API calls or README-documented behavior; unsampled implementation details are not inferred.
Main entry points: App.jsx Route and access control · index.cjs HTTP API and routing · streetViewAdminStorage.js Map and asset API client · storage.cjs Upload and file operations
Components 20
Navigation experience
- Route and access control
src/App.jsx - Sign-in
src/pages/LoginPage.jsx - Site selection
src/pages/KioskPage.jsx - Area map
src/pages/AreaMapPage.jsx - Viewer page
src/pages/StreetViewPage.jsx - 360° navigation
src/components/StreetViewer.jsx
Admin configuration
- Admin site setup
src/pages/AdminPage.jsx - Location and mode setup
src/pages/AdminAreaConfigPage.jsx - Image maintenance
src/components/ImageMaintenancePanel.jsx
Application services
- Map and asset API client
src/utils/streetViewAdminStorage.js - Auth and session client
src/utils/auth.js - Usage session tracker
src/utils/usageSession.js - HTTP API and routing
server/index.cjs - Authentication service
server/auth.cjs - Upload and file operations
server/storage.cjs - Panorama tiling
server/multires.cjs
Storage and tracking
- Map and asset repository
server/repository.cjs - PostgreSQL access and schema
server/db.cjs - Image file store
public/uploads
Other components
- Employee / Admin
Connections 28
- Employee / Admin → Route and access control: uses
README.md - Route and access control → Sign-in: routes to
src/App.jsx - Route and access control → Site selection: routes to
src/App.jsx - Route and access control → Area map: routes to
src/App.jsx - Route and access control → Viewer page: routes to
src/App.jsx - Route and access control → Admin site setup: routes to
src/App.jsx - Route and access control → Location and mode setup: routes to
src/App.jsx - Sign-in → Auth and session client: authenticates via
src/pages/LoginPage.jsx - Auth and session client → HTTP API and routing: calls auth endpoints
src/utils/auth.js - Route and access control → Usage session tracker: tracks usage with
src/App.jsx - Usage session tracker → HTTP API and routing: posts session events
src/utils/usageSession.js - Area map → Map and asset API client: loads map data
src/pages/AreaMapPage.jsx - Viewer page → 360° navigation: renders
src/pages/StreetViewPage.jsx - Admin site setup → Map and asset API client: saves map setup
src/pages/AdminPage.jsx - Location and mode setup → Map and asset API client: configures locations
src/pages/AdminAreaConfigPage.jsx - Location and mode setup → Image maintenance: hosts
src/pages/AdminAreaConfigPage.jsx - Image maintenance → Map and asset API client: uses
src/components/ImageMaintenancePanel.jsx - Map and asset API client → HTTP API and routing: calls map and asset APIs
src/utils/streetViewAdminStorage.js - HTTP API and routing → Authentication service: delegates auth
server/index.cjs - HTTP API and routing → Map and asset repository: reads and saves state
server/index.cjs - HTTP API and routing → Upload and file operations: handles assets
server/index.cjs - HTTP API and routing → PostgreSQL access and schema: initializes and checks
server/index.cjs - Upload and file operations → Map and asset repository: registers assets
server/storage.cjs - Upload and file operations → Panorama tiling: generates tiles
server/storage.cjs - Map and asset repository → PostgreSQL access and schema: queries and updates
server/repository.cjs - Upload and file operations → Image file store: stores and manages files
README.md - 360° navigation → Image file store: loads panorama images
README.md - Map and asset repository → Image file store: tracks file references
README.md